haedal

name

haedal

description

This skill should be used when the user asks about Haedal, haSUI liquid staking, haWAL liquid staking, Haedal PMM (Proactive Market Maker), Haedal HMM (Hybrid Market Maker), or wants to integrate with Haedal on Sui. Covers SUI liquid staking to haSUI, instant/delayed unstaking, PMM oracle-driven swaps, HMM v1/v2 swaps, DEX aggregator routing across Cetus/DeepBook/Turbos/FlowX/Kriya, and LSD swap adapters.

Haedal on Sui

Haedal is a liquid staking and DEX protocol on Sui. Its core product is haSUI -- a liquid staking token representing staked SUI that accrues validator rewards automatically. Haedal also operates oracle-driven market maker pools (PMM/HMM) and a DEX aggregator router that routes swaps across multiple Sui DEXes.

Package IDs

Package	Original ID	Latest Version ID	Description
Liquid Staking (haSUI)	0xbde4ba4c2e274a60ce15c1cfff9e5c42e41654ac8b6d906a57efa4bd3c29f47d	0x19e6ea7f5ced4f090e20da794cc80349a03e638940ddb95155a4e301f5f4967c (v7)	Core staking, hasui token, config, vault, interface entry points
DEX Router	0xeffc8ae61f439bb34c9b905ff8f29ec56873dcedf81c7123ff2f1f67c45ec302	0x40e457bc65a398d2db7026881358fcb7cfa2f1bb052bca41f46c55a1103f2d6f (v18)	Haedal swap adapter for Cetus, DeepBookV3, Turbos, FlowX, Kriya, etc.
PMM Router	0x43811be4677f5a5de7bf2dac740c10abddfaa524aee6b18e910eeadda8a2f6ae	0xe450c157978058fc23078941924ad91bfe3022db6243ffa432f7209ad5bc9889 (v20)	Haedal PMM swap wrappers (oracle_driven_pool v1), aggregator adapters
HMM v2 Router	0x368d13376443a8051b22b42a9125f6a3bc836422bb2d9c4a53984b8d6624c326	0x2e227a3cbc6715518b18ed339d2f967153674b7b257da114ca62c72b2011258a (v15)	Haedal HMM v2 swap wrappers (oracle_driven_pool v2), aggregator adapters
HMM/haSUI Aggregator	0xc9337637c28d901b471dde1bae9f4427044c0be72a4bc652daa029e64965088b	0x0c347031c6731ef63ea4e5f402f844c312f7ab02a72a857f73fc7d105d0a1495 (v4)	Router-integrated haSUI swap, HMM swap, haWAL swap adapters
PMM Aggregator v2	0x3239061b389dcc35be021bb13d174da82fafcc87bf3d8e176e6c62619311a90c	0x6cc001bc430cb1fcb0379bed1ffd0668f35728b362caf0d5f9d9701975b2096a (v11)	PMM swap with additional DEX adapters (Bluefin, Momentum, Obric)
PMM Aggregator v3	0x6257c58feabffe3e1fa17c6a287b999405fbcfc0f3fb389783f481c514aec0ca	0x5aafdf9cfa7c5c4dc78b309d7ebe4882904265e516f903a66fd33466dc4d616c (v2)	PMM swap returning remainder coin, additional DEX adapters
LSD Swap Adapters	0x48393b16be854688f6c54ba562530e278f154ba1f49edc267402ec75e4bff105	same (v1)	Aggregator adapters for haSUI LSD, Aftermath, AlphaFi, Scallop, Volo, SpringSUI

Source Files

Decompiled Move source locations (relative to repo root):

• Liquid Staking: packages/mainnet_most_used/0x19/e6ea7f5ced4f090e20da794cc80349a03e638940ddb95155a4e301f5f4967c/decompiled_modules/
• DEX Router: packages/mainnet_most_used/0x40/e457bc65a398d2db7026881358fcb7cfa2f1bb052bca41f46c55a1103f2d6f/decompiled_modules/
• PMM Router: packages/mainnet_most_used/0xe4/50c157978058fc23078941924ad91bfe3022db6243ffa432f7209ad5bc9889/decompiled_modules/
• HMM v2 Router: packages/mainnet_most_used/0x2e/227a3cbc6715518b18ed339d2f967153674b7b257da114ca62c72b2011258a/decompiled_modules/
• HMM/haSUI Aggregator: packages/mainnet_most_used/0x0c/347031c6731ef63ea4e5f402f844c312f7ab02a72a857f73fc7d105d0a1495/decompiled_modules/
• LSD Adapters: packages/mainnet_most_used/0x48/393b16be854688f6c54ba562530e278f154ba1f49edc267402ec75e4bff105/decompiled_modules/

Architecture

• Staking (shared object): Central liquid staking contract. Holds SUI vaults, manages validator delegation, mints/burns haSUI via a TreasuryCap. Tracks total_staked, total_rewards, exchange rate between SUI and haSUI.
• HASUI: Fungible coin type (0xbde4...::hasui::HASUI) with 9 decimals. Supply is controlled by the Staking object's TreasuryCap.
• UnstakeTicket: Owned object representing a delayed unstake request. Contains claim_epoch and sui_amount; must wait 1-2 epochs to claim.
• Vault: Internal balance wrapper used for SUI vault management (sui_vault, claim_sui_vault, protocol_sui_vault, service_sui_vault).
• StakingConfig: Stores fee parameters (deposit_fee, reward_fee, service_fee, withdraw_time_limit, validator_count).
• oracle_driven_pool::Pool<T0, T1>: PMM pools from external packages (0xa0e3b0... for v1, 0x9525de... for v2). Uses Pyth price oracles for pricing.
• Exchange Rate: total_sui * 1_000_000 / stsui_supply. 1 haSUI is always worth >= 1 SUI as rewards accrue.

Key Modules

Module	Package	Purpose
staking	Liquid Staking	Core staking logic: request_stake_coin, request_unstake_instant_coin, request_unstake_delay, claim_v2, exchange rate queries
hasui	Liquid Staking	HASUI coin type definition (OTW pattern)
interface	Liquid Staking	Entry point wrappers: request_stake, request_unstake_instant_v2, request_unstake_delay, claim_v2
config	Liquid Staking	StakingConfig struct and fee getters
vault	Liquid Staking	Internal balance vault operations
haedal	DEX Router	SUI-to-haSUI swap (swap_a2b) and haSUI-to-SUI swap (swap_b2a) via staking
cetus	DEX Router	Cetus CLMM swap adapter with flash swap support
deepbookv3	DEX Router	DeepBook V3 swap adapter
haedalpmm	PMM Router	PMM swap via oracle_driven_pool v1 (sell_base_coin / sell_quote_coin)
haedal_hmm_v2	HMM v2 Router	HMM v2 swap via oracle_driven_pool v2
haedal_hmm	HMM Aggregator	HMM swap integrated with router SwapContext
hasui	HMM Aggregator	haSUI swap integrated with router SwapContext
hawal	HMM Aggregator	haWAL (WAL liquid staking) swap via router
haedal_lsd	LSD Adapters	LSD swap adapter for haSUI staking/unstaking

Common Integration Patterns

Stake SUI to get haSUI

// Entry function: deposits SUI, receives haSUI
// validator can be @0x0 to let protocol choose
public entry fun request_stake(
    system_state: &mut SuiSystemState,
    staking: &mut Staking,
    sui_coin: Coin<SUI>,
    validator: address,
    ctx: &mut TxContext
)

// Programmable version returning haSUI coin
let hasui_coin = staking::request_stake_coin(
    system_state, staking, sui_coin, @0x0, ctx
);

Unstake haSUI to SUI (instant)

// Instant unstake: burns haSUI, returns SUI immediately (with service fee)
public entry fun request_unstake_instant_v2(
    system_state: &mut SuiSystemState,
    staking: &mut Staking,
    hasui_coin: Coin<HASUI>,
    ctx: &mut TxContext
)

// Programmable version
let sui_coin = staking::request_unstake_instant_coin(
    system_state, staking, hasui_coin, ctx
);

Unstake haSUI to SUI (delayed, no fee)

// Delayed unstake: burns haSUI, creates UnstakeTicket claimable after 1-2 epochs
staking::request_unstake_delay(staking, clock, hasui_coin, ctx);

// Claim after epoch passes
staking::claim_v2(system_state, staking, unstake_ticket, ctx);

PMM Swap (oracle-driven)

// Swap base to quote via Haedal PMM (uses Pyth price feeds)
let coin_out = haedalpmm::swap_a2b<TokenA, TokenB>(
    pool,           // &mut oracle_driven_pool::Pool<T0, T1>
    price_info_a,   // &PriceInfoObject (Pyth)
    price_info_b,   // &PriceInfoObject (Pyth)
    coin_in,        // Coin<T0>
    clock,          // &Clock
    ctx
);

// HMM v2 variant (single price oracle)
let coin_out = haedal_hmm_v2::swap_a2b<T0, T1>(
    pool, price_info, coin_in, clock, ctx
);

Query Exchange Rate

// Get haSUI/SUI exchange rate (scaled by 1_000_000)
let rate = staking::get_exchange_rate(staking);

// Convert SUI amount to haSUI amount
let hasui_amount = staking::get_stsui_by_sui(staking, sui_amount);

// Convert haSUI amount to SUI amount
let sui_amount = staking::get_sui_by_stsui(staking, hasui_amount);

Important Types

• 0xbde4ba4c2e274a60ce15c1cfff9e5c42e41654ac8b6d906a57efa4bd3c29f47d::hasui::HASUI -- the haSUI coin type
• 0xbde4ba4c2e274a60ce15c1cfff9e5c42e41654ac8b6d906a57efa4bd3c29f47d::staking::Staking -- shared staking object
• 0xa0e3b011012b80af4957afa30e556486eb3da0a7d96eeb733cf16ccd3aec32e0::oracle_driven_pool::Pool<T0, T1> -- PMM v1 pool
• 0x9525dec11fb79eaef17138ee0352dedf4ee817bc44893a9465e7bb217b45761::oracle_driven_pool::Pool<T0, T1> -- HMM v2 pool
• 0x8d97f1cd6ac663735be08d1d2b6d02a159e711586461306ce60a2b7a6a565a9e::price_info::PriceInfoObject -- Pyth price feed

Related Skills

• sui-framework -- Core Sui types (Coin, Balance, SUI, TxContext)
• cetus -- Cetus CLMM pools (used by Haedal DEX router)
• deepbook -- DeepBook CLOB (used by Haedal DEX router)
• turbos -- Turbos CLMM (used by Haedal DEX router)
• pyth -- Pyth oracle price feeds (used by PMM/HMM pools)
• flowx -- FlowX DEX (used by Haedal DEX router)
• kriya -- Kriya DEX (used by Haedal DEX router)