alphafi

name	alphafi
description	This skill should be used when the user asks about AlphaFi, AlphaFi vaults, AlphaFi yield, ALPHA token staking, auto-compounding vaults on Sui, or wants to integrate with AlphaFi. Covers Cetus CLMM vaults, Navi lending vaults, Bluefin perps vaults, ALPHA token staking pool, receipt-based positions, and auto-compounding strategies.

AlphaFi on Sui

AlphaFi is a yield optimization protocol on Sui that provides auto-compounding vaults built on top of other DeFi protocols. Users deposit assets into strategy-specific pools, receive xToken shares tracked by Receipt NFTs, and earn auto-compounded yields. Strategies include Cetus CLMM concentrated liquidity, Navi lending, Bluefin perps liquidity, and ALPHA token staking.

Package IDs

Package	Original ID	Description
Core (Cetus + Navi + ALPHA)	0x9bbd650b8442abb082c20f3bc95a9434a8d47b4bef98b0832dab57c1a8ba7123	Cetus CLMM vaults, Navi lending vaults, ALPHA staking pool, distributor
Bluefin Vaults	0x066648edaf473d6cc14b7ab46f56b673be4e44f9c940f70b6bacd7848808859b	Bluefin-based concentrated liquidity vaults
AlphaLend	0x45564ea956f9b25890a5c1c3a199c8d86aabd5291b34723fb662283419ee2f4d	Single-asset leveraged lending loop vaults

Source Files

Decompiled Move source:

• Core (v29): packages/mainnet_most_used/0xa9/8ddf10b9eebf500c7e9a7ffd30358928b4617df6e179b817efebea1fff604e/decompiled_modules/
• Bluefin (v21): packages/mainnet_most_used/0x57/69fdace205e2a37375b8bc46f839c20780c136f036d227f5a09ab5bd206908/decompiled_modules/
• AlphaLend (v5): packages/mainnet_most_used/0xa5/3b109f1a9ec129cd194cc82108d911feae2da45758619ab06559692d56bc7d/decompiled_modules/

Architecture

• Pool<T0, T1> (Cetus/Bluefin): Shared object for a CLMM pair vault. Tracks xTokenSupply (u128), tokensInvested (u128 liquidity), per-type acc_rewards_per_xtoken, and deposit/withdrawal fees.
• Pool (Navi/ALPHA): Single-asset pool for lending or staking. Tracks xTokenSupply (u64), tokensInvested (u64), and rewards.
• Receipt: Owned NFT representing a user's position in a pool. Contains xTokenBalance, last_acc_reward_per_xtoken for pending reward calculation, and pool_id. For ALPHA pool, also has locked_balance (LinkedTable of lock timestamps to xToken amounts) and unlocked_xtokens.
• Investor<T0, T1>: Shared object that manages the actual Cetus/Bluefin position (tick range, balances, Cetus Position stored as dynamic field). Handles auto-compounding, rebalancing, and fee collection.
• Distributor: Shared object that manages ALPHA token emission, pool reward allocation, fee wallets, and airdrop distribution. Contains an Allocator for per-pool reward scheduling.
• ALPHA token: 0xfe3afec26c59e874f3c1d60b8203cb3852d2bb2aa415df9548b8d688e6683f93::alpha::ALPHA

Key Design: xToken Share Model

• Deposits mint xTokens proportional to: deposited_value * 1e36 / exchange_rate
• Withdrawals burn xTokens and return: xTokens * exchange_rate / 1e36
• Exchange rate: tokensInvested * 1e36 / xTokenSupply (1e36 precision)
• Rewards accumulate via acc_rewards_per_xtoken (1e36 precision per xToken)

Constants

• Exchange rate precision: 1e36 (1_000_000_000_000_000_000_000_000_000_000_000_000)
• Fee denominator: 10000 (basis points)
• ALPHA pool default instant_withdraw_fee: 5000 (50%)
• ALPHA pool lock period: 100 days (8_640_000_000 ms)
• Version object required for all operations

Key Modules

Module	Purpose
alphafi_cetus_pool	Pool<T0,T1> for Cetus CLMM: deposit, withdraw, claim rewards
alphafi_cetus_investor	Investor<T0,T1>: manages Cetus position, auto-compound, rebalance
alphafi_navi_pool	Pool for Navi lending: deposit, withdraw, reward claiming
alphafi_navi_investor	Investor: manages Navi lending position, auto-compound
alphapool	Pool for ALPHA staking with lock periods and airdrops
alphafi_bluefin_type_1_pool	Pool<T0,T1> for Bluefin: deposit, withdraw
alphafi_bluefin_type_1_investor	Investor for Bluefin positions
distributor	ALPHA emission, reward allocation, fee wallets, airdrop
allocator	Per-pool reward scheduling and distribution
converter	Internal swap helper (uses Cetus pools)

Common Integration Patterns

Deposit to Cetus Vault (get Receipt)

// Returns Option<Receipt> - new or updated
let receipt_opt = alphafi_cetus_pool::deposit<CoinA, CoinB>(
    version,           // &Version
    option::none(),    // Option<Receipt> (none for new, some for existing)
    pool,              // &mut Pool<CoinA, CoinB>
    coin_a,            // Coin<CoinA>
    coin_b,            // Coin<CoinB>
    distributor,       // &mut Distributor
    investor,          // &mut Investor<CoinA, CoinB>
    cetus_global_config,
    cetus_rewarder_vault,
    cetus_pool_b_sui,  // Cetus pool for reward swap
    cetus_pool_cetus_sui,
    cetus_pool_a_b,    // The actual Cetus CLMM pool
    clock,
    ctx
);
// Transfer receipt to sender
alphafi_cetus_pool::transfer_receipt(version, receipt_opt, ctx);

Withdraw from Cetus Vault

let receipt_opt = alphafi_cetus_pool::withdraw<CoinA, CoinB>(
    version,
    receipt,           // Receipt (consumed)
    alpha_receipt_opt, // Option<alphapool::Receipt> for ALPHA rewards
    pool,
    alpha_pool,        // &mut alphapool::Pool<ALPHA>
    distributor,
    investor,
    xtoken_amount,     // u128 amount of xTokens to withdraw
    cetus_global_config, cetus_pool_a_b,
    clock, ctx
);

Deposit to Navi Vault

let receipt_opt = alphafi_navi_pool::deposit<CoinType>(
    version,
    option::none(),    // Option<Receipt>
    pool,              // &mut Pool<CoinType>
    coin,              // Coin<CoinType>
    investor,          // &mut Investor<CoinType>
    distributor,
    navi_oracle,       // &PriceOracle
    navi_storage,      // &mut Storage
    navi_pool,         // &mut navi::Pool<CoinType>
    asset_id,          // u8 (Navi asset index)
    navi_incentive_v3, navi_incentive_v2,
    clock, ctx
);

Deposit ALPHA to Staking Pool

// Deposits are locked for ~100 days; early withdraw incurs 50% fee
alphapool::user_deposit(
    version,
    option::none(),    // Option<Receipt> (none for new)
    alpha_pool,        // &mut Pool<ALPHA>
    distributor,
    alpha_coin,        // Coin<ALPHA>
    clock, ctx
);

Withdraw ALPHA from Staking Pool

// instant_withdraw = true: withdraw locked balance with fee penalty
// instant_withdraw = false: only withdraw unlocked balance
alphapool::user_withdraw(
    version,
    receipt,           // Receipt (consumed)
    alpha_pool,        // &mut Pool<ALPHA>
    distributor,
    xtoken_amount,     // u64
    clock,
    instant_withdraw,  // bool
    ctx
);

Claim ALPHA Airdrop

alphapool::claim_airdrop(
    version, receipt, alpha_pool, distributor, clock, ctx
);

Related Skills

• cetus -- Cetus CLMM pools (underlying DEX for Cetus vaults)
• navi -- Navi Protocol lending (underlying for Navi vaults)
• bluefin -- Bluefin perps (underlying for Bluefin vaults)
• sui-framework -- Core Sui types (Coin, Balance, Clock)