volo

name	volo
description	This skill should be used when the user asks about Volo, voloSUI, vSUI, CERT token, Volo staking, or wants to integrate with Volo liquid staking on Sui. Covers SUI staking, vSUI minting/burning, validator delegation, exchange rate queries, and unstake tickets.

Volo Liquid Staking on Sui

Volo is a liquid staking protocol on Sui. Users deposit SUI and receive CERT (vSUI) -- a yield-bearing liquid staking token that accrues staking rewards over time. Volo distributes staked SUI across multiple validators with configurable weights.

Package IDs

Package	ID	Description
Core	0x549e8b69270defbfafd4f94e17ec44cdbdd99820b33bda2278dea3b9a32d3f55	NativePool, StakePool, CERT token, validator management

Source Files

Decompiled Move source: packages/mainnet_most_used/0x68/d22cf8bdbcd11ecba1e094922873e4080d4d11133e2443fddda0bfd11dae20/decompiled_modules/

Architecture

Volo has two staking systems:

StakePool (v2, recommended)

• StakePool: Shared object managing staked SUI across validators with instant stake/unstake
• ValidatorPool: Internal pool distributing SUI across validators by weight
• FeeConfig: Configurable fee structure (stake, unstake, reward, redistribution fees in BPS)
• Supports boosted rewards via additional SUI deposits

NativePool (v1, legacy)

• NativePool: Original staking pool with delayed unstaking via tickets
• UnstakeTicket: NFT representing a pending withdrawal, unlocks after a certain epoch

CERT Token (vSUI)

• CERT: The liquid staking token (9 decimals), symbol "vSUI"
• Metadata: Shared object tracking CERT total supply
• Exchange rate: vSUI/SUI = total_lst_supply / total_sui_supply
• Rate increases over time as staking rewards accrue

Key Modules

Module	Purpose
stake_pool	v2 staking: stake, unstake, delegate_stake, ratio queries, rebalance
native_pool	v1 staking: stake, mint_ticket/burn_ticket, ratio queries
cert	CERT (vSUI) token type, supply tracking
unstake_ticket	Delayed unstake ticket for v1 (epoch-locked)
validator_pool	Validator set management, weight-based delegation
fee_config	Fee configuration (stake/unstake/reward fees in BPS)
ownership	OwnerCap, OperatorCap for admin operations
manage	Version gating, pause control
math	Ratio calculations, share conversions

Common Integration Patterns

Stake SUI for vSUI (v2 - recommended)

// Programmable: returns Coin<CERT>
let vsui = stake_pool::stake(
    stake_pool, cert_metadata, sui_system, sui_coin, ctx
);

// Entry: auto-transfers to sender
stake_pool::stake_entry(
    stake_pool, cert_metadata, sui_system, sui_coin, ctx
);

// Delegate to specific validator (still returns from pool, not direct)
let vsui = stake_pool::delegate_stake(
    stake_pool, cert_metadata, sui_system, sui_coin, validator_addr, ctx
);

Unstake vSUI for SUI (v2 - instant)

// Programmable: returns Coin<SUI>
let sui = stake_pool::unstake(
    stake_pool, cert_metadata, sui_system, cert_coin, ctx
);

// Entry: auto-transfers to sender
stake_pool::unstake_entry(
    stake_pool, cert_metadata, sui_system, cert_coin, ctx
);

Stake SUI for vSUI (v1 - legacy)

// Entry
native_pool::stake(pool, cert_metadata, sui_system, sui_coin, ctx);

// Programmable
let vsui = native_pool::stake_non_entry(pool, cert_metadata, sui_system, sui_coin, ctx);

Unstake vSUI (v1 - delayed via ticket)

// Step 1: Mint an unstake ticket (locks CERT, returns ticket with unlock_epoch)
native_pool::mint_ticket(pool, cert_metadata, cert_coin, ctx);

// Step 2: After unlock_epoch, burn ticket to receive SUI
native_pool::burn_ticket(pool, sui_system, ticket, ctx);

Query Exchange Rate

// v2: How many vSUI per 1 SUI (in 9-decimal units)
let ratio = stake_pool::get_ratio(stake_pool, cert_metadata);  // vSUI per 1 SUI

// v2: How many SUI per 1 vSUI
let ratio_rev = stake_pool::get_ratio_reverse(stake_pool, cert_metadata);

// v2: Preview output amount (is_stake = true for SUI->vSUI, false for vSUI->SUI)
let amount_out = stake_pool::get_amount_out(stake_pool, cert_metadata, amount_in, is_stake);

// v2: Convert amounts
let lst_amount = stake_pool::sui_amount_to_lst_amount(stake_pool, cert_metadata, sui_amount);
let sui_amount = stake_pool::lst_amount_to_sui_amount(stake_pool, cert_metadata, lst_amount);

// v1: Ratio as u256 (scaled)
let ratio = native_pool::get_ratio(pool, cert_metadata);

Query Pool State

// v2
let total_sui = stake_pool::total_sui_supply(stake_pool);
let total_lst = stake_pool::total_lst_supply(cert_metadata);
let total_fees = stake_pool::total_fees(stake_pool);

// v1
let total_staked = native_pool::get_total_staked(pool);
let total_rewards = native_pool::get_total_rewards(pool);
let pending = native_pool::get_pending(pool);

UnstakeTicket Queries (v1)

let unlock_epoch = unstake_ticket::get_unlock_epoch(ticket);
let value = unstake_ticket::get_value(ticket);
let fee = unstake_ticket::get_unstake_fee(ticket);
let is_ready = unstake_ticket::is_unlocked(ticket, ctx);

Related Skills

• haedal -- Alternative LST protocol on Sui (haSUI)
• blizzard -- Alternative LST protocol for Walrus (WAL)
• aftermath -- Aftermath Finance (afSUI staking)
• sui-framework -- SuiSystem staking primitives