SmartAccount

Each margin account is a separate contract holding real tokens and accounting state for its trader. It is controlled through AccountManager and registered controller callbacks; the owner does not have unrestricted arbitrary-call access.

Ledger and snapshots

The V2 ledger uses token contract addresses for plain assets and tracking symbols for external positions. This prevents similarly named test tokens from sharing a balance. Debt is represented by lending-pool shares; get_borrowed_token_debt resolves the pool and reads its debt value. Batched getters expose collateral lists, debt lists, ledger balances, and valuation snapshots. Blend underlying and LP USD caches reduce cross-contract calls on constrained execution paths. A cached valuation is not proof of a current market quote. Manager refresh methods update these caches; liquidation uses a separate valuation path.

Custody and callbacks

authorize_and_call permits registered controller execution. manager_authorize_and_call is the manager-controlled counterpart. update_tokens_in and update_tokens_out apply controller deltas to the collateral ledger. Swap credits may be capped at oracle input value, so a raw token balance and accounted collateral need not match. sync_tracking_for_target maintains external-position membership; Blend callbacks refresh underlying estimates. repay_borrowed_token_to_pool transfers account-held tokens and decrements collateral by the native amount actually paid, with a minimum native unit for positive dust repayment.

Closing and sweeping

sweep_to moves held direct collateral. transfer_held_token_to permits LP seizure during liquidation. sweep_to_split exists, but the current AccountManager liquidation path calls sweep_to, not the split helper. close_account on AccountManager performs external unwind and deactivation; repayment and liquidation alone do not close the account.

Function signatures

These signatures are copied from the reviewed Rust implementation. env is supplied by Soroban and is not a transaction argument. Result errors and panics must be handled by the caller; simulation does not guarantee later execution. Public methods include privileged and internal-contract callbacks, not just user entrypoints.

__constructor

pub fn __constructor(
        env: Env,
        account_manager: Address,
        registry_contract: Address,
        user_address: Address,
    )

deactivate_account

pub fn deactivate_account(env: &Env) -> Result<(), SmartAccountError>

activate_account

pub fn activate_account(env: &Env) -> Result<(), SmartAccountError>

remove_borrowed_token_balance

pub fn remove_borrowed_token_balance(
        env: Env,
        token_symbol: Symbol,
        amount_wad: u128,
    ) -> Result<(), SmartAccountError>

remove_collateral_token_balance

pub fn remove_collateral_token_balance(
        env: &Env,
        user_address: Address,
        token_symbol: Symbol,
        amount_wad: u128,
    ) -> Result<(), SmartAccountError>

sweep_to

pub fn sweep_to(env: &Env, to_address: Address) -> Result<(), SmartAccountError>

transfer_held_token_to

pub fn transfer_held_token_to(
        env: &Env,
        to_address: Address,
        token_address: Address,
        amount: i128,
    ) -> Result<(), SmartAccountError>

sweep_to_split

pub fn sweep_to_split(
        env: &Env,
        to_first: Address,
        to_second: Address,
        to_first_bps: u32,
    ) -> Result<(), SmartAccountError>

has_debt

pub fn has_debt(env: &Env) -> bool

set_has_debt

pub fn set_has_debt(env: &Env, has_debt: bool)

get_all_borrowed_tokens

pub fn get_all_borrowed_tokens(env: &Env) -> Vec<Symbol>

get_asset_lists

pub fn get_asset_lists(env: &Env) -> (Vec<Symbol>, Vec<Symbol>)

get_collateral_ledger_snapshot

pub fn get_collateral_ledger_snapshot(env: &Env) -> (Vec<Symbol>, Vec<U256>)

get_debt_snapshot

pub fn get_debt_snapshot(env: &Env) -> (Vec<Symbol>, Vec<U256>)

get_health_snapshot

pub fn get_health_snapshot(
        env: &Env,
    ) -> (Vec<Symbol>, Vec<U256>, Vec<Symbol>, Vec<U256>)

get_valuation_snapshot

pub fn get_valuation_snapshot(
        env: &Env,
    ) -> (
        Vec<Symbol>,
        Vec<U256>,
        Vec<Symbol>,
        Vec<U256>,
        Vec<Symbol>,
        Vec<U256>,
        Vec<Symbol>,
        Vec<U256>,
    )

set_lp_usd_wad_cache

pub fn set_lp_usd_wad_cache(env: &Env, lp_symbol: Symbol, usd_wad: U256)

refresh_lp_cache_all

pub fn refresh_lp_cache_all(env: &Env, lp_symbols: Vec<Symbol>, lp_usd_wads: Vec<U256>)

debt_usd_wad_cache

pub fn debt_usd_wad_cache(env: &Env) -> U256

refresh_usd_valuation_cache

pub fn refresh_usd_valuation_cache(env: &Env)

refresh_blend_underlying_wad

pub fn refresh_blend_underlying_wad(env: &Env, tracking_symbol: Symbol)

refresh_blend_cache_all

pub fn refresh_blend_cache_all(env: &Env)

is_deposit_borrow_precheck

pub fn is_deposit_borrow_precheck(
        env: &Env,
        deposit_symbol: Symbol,
        deposit_amount_wad: U256,
        borrow_symbol: Symbol,
        borrow_amount_wad: U256,
        live_debt: bool,
    ) -> bool

is_borrow_precheck

pub fn is_borrow_precheck(env: &Env, borrow_symbol: Symbol, borrow_amount_wad: U256) -> bool

refresh_token_directory

pub fn refresh_token_directory(env: &Env)

get_assets

pub fn get_assets(env: &Env) -> Vec<AssetKey>

get_collateral_token_addrs

pub fn get_collateral_token_addrs(env: &Env) -> Vec<Address>

get_borrows

pub fn get_borrows(env: &Env) -> Vec<Address>

get_collateral_balance

pub fn get_collateral_balance(env: &Env, token: Address) -> U256

migrate_ledger_to_v2

pub fn migrate_ledger_to_v2(env: &Env) -> Result<(), SmartAccountError>

authorize_and_call

pub fn authorize_and_call(
        env: &Env,
        target: Address,
        func: Symbol,
        args: Vec<Val>,
        auth_entries: Vec<InvokerContractAuthEntry>,
    ) -> Val

manager_authorize_and_call

pub fn manager_authorize_and_call(
        env: &Env,
        target: Address,
        func: Symbol,
        args: Vec<Val>,
        auth_entries: Vec<InvokerContractAuthEntry>,
    ) -> Val

update_tokens_in

pub fn update_tokens_in(
        env: &Env,
        tokens: Vec<Address>,
        amounts_wad: Vec<U256>,
        max_asset_cap_wad: U256,
    ) -> bool

update_tokens_out

pub fn update_tokens_out(env: &Env, tokens: Vec<Address>, amounts_wad: Vec<U256>)

sync_tracking_for_target

pub fn sync_tracking_for_target(
        env: &Env,
        target: Address,
        tracking_symbol: Symbol,
        keep_tracked: bool,
    )

refresh_blend_cache_for_target

pub fn refresh_blend_cache_for_target(env: &Env, target: Address, tracking_symbol: Symbol)

add_borrowed_token

pub fn add_borrowed_token(env: &Env, token_symbol: Symbol) -> Result<(), SmartAccountError>

record_new_borrow

pub fn record_new_borrow(env: &Env, borrowed_sym: Symbol, max_asset_cap_wad: U256) -> bool

remove_borrowed_token

pub fn remove_borrowed_token(env: &Env, token_symbol: Symbol) -> Result<(), SmartAccountError>

get_all_collateral_tokens

pub fn get_all_collateral_tokens(env: &Env) -> Vec<Symbol>

add_collateral_token

pub fn add_collateral_token(env: &Env, token_symbol: Symbol) -> Result<(), SmartAccountError>

remove_collateral_token

pub fn remove_collateral_token(env: &Env, token_symbol: Symbol) -> Result<(), SmartAccountError>

get_collateral_token_balance

pub fn get_collateral_token_balance(env: &Env, token_symbol: Symbol) -> U256

set_collateral_token_balance

pub fn set_collateral_token_balance(
        env: &Env,
        token_symbol: Symbol,
        balance_wad: U256,
    ) -> Result<(), SmartAccountError>

credit_borrow_collateral

pub fn credit_borrow_collateral(
        env: &Env,
        token_symbol: Symbol,
        received_wad: U256,
        max_asset_cap_wad: U256,
    ) -> bool

credit_deposit_collateral

pub fn credit_deposit_collateral(
        env: &Env,
        token_symbol: Symbol,
        actual_deposited_wad: U256,
        max_asset_cap_wad: U256,
    ) -> bool

record_borrow_and_credit

pub fn record_borrow_and_credit(
        env: &Env,
        borrowed_sym: Symbol,
        received_wad: U256,
        gross_borrow_wad: U256,
        max_asset_cap_wad: U256,
    ) -> bool

apply_deposit_borrow_ledger

pub fn apply_deposit_borrow_ledger(
        env: &Env,
        deposit_token: Symbol,
        deposit_wad: U256,
        borrowed_sym: Symbol,
        borrow_received_wad: U256,
        gross_borrow_wad: U256,
        max_asset_cap_wad: U256,
        include_deposit: bool,
        include_borrow: bool,
    ) -> bool

sync_tracking_collateral

pub fn sync_tracking_collateral(
        env: &Env,
        tracking_symbol: Symbol,
        max_asset_cap_wad: U256,
        keep_tracked: bool,
    ) -> bool

get_borrowed_token_debt

pub fn get_borrowed_token_debt(
        env: &Env,
        token_symbol: Symbol,
    ) -> Result<U256, SmartAccountError>

clear_account_state

pub fn clear_account_state(env: &Env) -> Result<(), SmartAccountError>

repay_borrowed_token_to_pool

pub fn repay_borrowed_token_to_pool(
        env: Env,
        token_symbol: Symbol,
        amount_wad: u128,
    ) -> Result<(), SmartAccountError>

is_account_active

pub fn is_account_active(env: &Env) -> bool

upgrade

pub fn upgrade(env: &Env, new_wasm_hash: BytesN<32>)

Source reference

Protocol_V1_Soroban_testnet/contracts/SmartAccountContract/src/smart_account.rs

​Ledger and snapshots

​Custody and callbacks

​Closing and sweeping

​Function signatures

​__constructor

​deactivate_account

​activate_account

​remove_borrowed_token_balance

​remove_collateral_token_balance

​sweep_to

​transfer_held_token_to

​sweep_to_split

​has_debt

​set_has_debt

​get_all_borrowed_tokens

​get_asset_lists

​get_collateral_ledger_snapshot

​get_debt_snapshot

​get_health_snapshot

​get_valuation_snapshot

​set_lp_usd_wad_cache

​refresh_lp_cache_all

​debt_usd_wad_cache

​refresh_usd_valuation_cache

​refresh_blend_underlying_wad

​refresh_blend_cache_all

​is_deposit_borrow_precheck

​is_borrow_precheck

​refresh_token_directory

​get_assets

​get_collateral_token_addrs

​get_borrows

​get_collateral_balance

​migrate_ledger_to_v2

​authorize_and_call

​manager_authorize_and_call

​update_tokens_in

​update_tokens_out

​sync_tracking_for_target

​refresh_blend_cache_for_target

​add_borrowed_token

​record_new_borrow

​remove_borrowed_token

​get_all_collateral_tokens

​add_collateral_token

​remove_collateral_token

​get_collateral_token_balance

​set_collateral_token_balance

​credit_borrow_collateral

​credit_deposit_collateral

​record_borrow_and_credit

​apply_deposit_borrow_ledger

​sync_tracking_collateral

​get_borrowed_token_debt

​clear_account_state

​repay_borrowed_token_to_pool

​is_account_active

​upgrade

​Source reference