Registry - Vanna

Registry stores core addresses, trader-to-account membership, token aliases, asset metadata, token permissions, controller routes, controller TVL caps, and tracking metadata.

Discovery

Use get_protocol_config for batched core/token/protocol configuration; get_registered_assets, get_token_address_for, and get_lending_pool_for_symbol for market resolution; and get_tracking_meta for external-position valuation/unwind configuration. USDC price-feed aliases do not make distinct token contracts interchangeable. Account membership is written through AccountManager-authorized add_account, close_account, and update_account. There is no invented get_user_smart_account ABI: the frontend discovers account records using Registry storage and other supported fallbacks in MarginAccountService.

Governance

After finalize_registry_config, controller registration has a 48-hour queue delay. Token allowlist, asset metadata, and tracking metadata changes have a 24-hour queue delay. Before finalization, these queue methods apply configuration immediately as a bootstrap path. The queue methods accept proposed data; the corresponding apply methods consume the queued change after its deadline. Cancellation and immediate deregistration methods are available. Finalizing Registry configuration restricts subsequent changes to sensitive configuration. Admin succession uses proposal and acceptance. AssetMeta includes LTV and liquidation fields, but the current RiskEngine’s operative health threshold is a global 1.1. Do not infer per-asset weighted risk calculations solely from metadata fields. get_exec_gate batches target-to-controller lookup, probation TVL cap, and token permission checks. AccountManager’s current typed execution uses it directly.

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, admin: Address)

set_lendingpool_xlm

pub fn set_lendingpool_xlm(
        env: &Env,
        lendingpool_xlm: Address,
    ) -> Result<(), RegistryContractError>

set_smart_account_hash

pub fn set_smart_account_hash(
        env: &Env,
        smart_account_hash: BytesN<32>,
    ) -> Result<(), RegistryContractError>

set_accountmanager_contract

pub fn set_accountmanager_contract(
        env: &Env,
        account_manager_address: Address,
    ) -> Result<(), RegistryContractError>

set_lendingpool_usdc

pub fn set_lendingpool_usdc(
        env: &Env,
        lendingpool_usdc_address: Address,
    ) -> Result<(), RegistryContractError>

set_risk_engine_address

pub fn set_risk_engine_address(
        env: &Env,
        risk_engine_address: Address,
    ) -> Result<(), RegistryContractError>

set_rate_model_address

pub fn set_rate_model_address(
        env: &Env,
        rate_model_address: Address,
    ) -> Result<(), RegistryContractError>

set_oracle_contract_address

pub fn set_oracle_contract_address(
        env: &Env,
        oracle_contract_address: Address,
    ) -> Result<(), RegistryContractError>

set_native_xlm_contract_address

pub fn set_native_xlm_contract_address(
        env: &Env,
        xlm_contract_adddress: Address,
    ) -> Result<(), RegistryContractError>

set_native_usdc_contract_address

pub fn set_native_usdc_contract_address(
        env: &Env,
        usdc_contract_address: Address,
    ) -> Result<(), RegistryContractError>

set_blend_pool_address

pub fn set_blend_pool_address(
        env: &Env,
        blend_pool_address: Address,
    ) -> Result<(), RegistryContractError>

set_tracking_token_contract_addr

pub fn set_tracking_token_contract_addr(
        env: &Env,
        tracking_token_contract_addr: Address,
    ) -> Result<(), RegistryContractError>

set_aquarius_router_address

pub fn set_aquarius_router_address(
        env: &Env,
        aquarius_router_address: Address,
    ) -> Result<(), RegistryContractError>

set_aquarius_pool_index

pub fn set_aquarius_pool_index(
        env: &Env,
        pool_index: BytesN<32>,
    ) -> Result<(), RegistryContractError>

get_lendingpool_xlm

pub fn get_lendingpool_xlm(env: &Env) -> Result<Address, RegistryContractError>

get_smart_account_hash

pub fn get_smart_account_hash(env: &Env) -> Result<BytesN<32>, RegistryContractError>

get_accountmanager_contract

pub fn get_accountmanager_contract(env: &Env) -> Result<Address, RegistryContractError>

get_lendingpool_usdc

pub fn get_lendingpool_usdc(env: &Env) -> Result<Address, RegistryContractError>

get_risk_engine_address

pub fn get_risk_engine_address(env: &Env) -> Result<Address, RegistryContractError>

get_rate_model_address

pub fn get_rate_model_address(env: &Env) -> Result<Address, RegistryContractError>

get_oracle_contract_address

pub fn get_oracle_contract_address(env: &Env) -> Result<Address, RegistryContractError>

get_xlm_contract_address

pub fn get_xlm_contract_address(env: &Env) -> Result<Address, RegistryContractError>

get_usdc_contract_address

pub fn get_usdc_contract_address(env: &Env) -> Result<Address, RegistryContractError>

get_blend_pool_address

pub fn get_blend_pool_address(env: &Env) -> Result<Address, RegistryContractError>

get_aquarius_router_address

pub fn get_aquarius_router_address(env: &Env) -> Result<Address, RegistryContractError>

set_soroswap_router_address

pub fn set_soroswap_router_address(
        env: &Env,
        soroswap_router_address: Address,
    ) -> Result<(), RegistryContractError>

get_soroswap_router_address

pub fn get_soroswap_router_address(env: &Env) -> Result<Address, RegistryContractError>

get_aquarius_pool_index

pub fn get_aquarius_pool_index(env: &Env) -> Result<BytesN<32>, RegistryContractError>

has_tracking_token_contract_addr

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

get_tracking_token_contract_addr

pub fn get_tracking_token_contract_addr(env: &Env) -> Result<Address, RegistryContractError>

get_admin

pub fn get_admin(env: &Env) -> Result<Address, RegistryContractError>

propose_admin

pub fn propose_admin(env: &Env, proposed: Address) -> Result<(), RegistryContractError>

accept_admin

pub fn accept_admin(env: &Env) -> Result<(), RegistryContractError>

get_proposed_admin

pub fn get_proposed_admin(env: &Env) -> Option<Address>

get_timelock_durations

pub fn get_timelock_durations(_env: &Env) -> (u64, u64)

upgrade

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

add_account

pub fn add_account(
        env: &Env,
        trader: Address,
        smart_account: Address,
    ) -> Result<bool, RegistryContractError>

close_account

pub fn close_account(
        env: &Env,
        trader: Address,
        smart_account: Address,
    ) -> Result<bool, RegistryContractError>

update_account

pub fn update_account(
        env: &Env,
        trader: Address,
        smart_account: Address,
    ) -> Result<bool, RegistryContractError>

set_iscollateral_allowed

pub fn set_iscollateral_allowed(env: &Env, token_symbol: Symbol, allowed: bool)

get_iscollateral_allowed

pub fn get_iscollateral_allowed(env: &Env, token_symbol: Symbol) -> bool

is_collateral_explicitly_revoked

pub fn is_collateral_explicitly_revoked(env: &Env, token_symbol: Symbol) -> bool

set_controller_facade

pub fn set_controller_facade(env: &Env, facade: Address)

get_controller_facade

pub fn get_controller_facade(env: &Env) -> Address

has_controller_facade

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

is_registry_config_finalized

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

finalize_registry_config

pub fn finalize_registry_config(env: &Env)

queue_register_controller

pub fn queue_register_controller(
        env: &Env,
        target: Address,
        controller: Address,
        tvl_cap_usd_wad: u128,
    )

register_controller

pub fn register_controller(env: &Env, target: Address)

cancel_register_controller

pub fn cancel_register_controller(env: &Env, target: Address)

deregister_controller

pub fn deregister_controller(env: &Env, target: Address)

get_controller_for

pub fn get_controller_for(env: &Env, target: Address) -> Option<Address>

get_controller_tvl_cap

pub fn get_controller_tvl_cap(env: &Env, controller: Address) -> Option<u128>

get_protocol_config

pub fn get_protocol_config(env: &Env) -> vanna_common::types::ProtocolConfig

get_revoked_flags

pub fn get_revoked_flags(env: &Env, symbols: Vec<Symbol>) -> Vec<bool>

get_exec_gate

pub fn get_exec_gate(
        env: &Env,
        target: Address,
        tokens: Vec<Address>,
    ) -> vanna_common::types::ExecGate

queue_set_token_allowed

pub fn queue_set_token_allowed(env: &Env, token_addr: Address, allowed: bool)

set_token_allowed

pub fn set_token_allowed(env: &Env, token_addr: Address)

cancel_set_token_allowed

pub fn cancel_set_token_allowed(env: &Env, token_addr: Address)

deregister_token

pub fn deregister_token(env: &Env, token_addr: Address)

is_token_allowed

pub fn is_token_allowed(env: &Env, token_addr: Address) -> bool

queue_set_asset_meta

pub fn queue_set_asset_meta(env: &Env, token_addr: Address, meta: AssetMeta)

set_asset_meta

pub fn set_asset_meta(env: &Env, token_addr: Address)

cancel_set_asset_meta

pub fn cancel_set_asset_meta(env: &Env, token_addr: Address)

get_asset_meta

pub fn get_asset_meta(env: &Env, token_addr: Address) -> Option<AssetMeta>

get_registered_assets

pub fn get_registered_assets(env: &Env) -> Vec<RegisteredAsset>

backfill_asset_list

pub fn backfill_asset_list(env: &Env, tokens: Vec<Address>)

get_token_address_for

pub fn get_token_address_for(env: &Env, symbol: Symbol) -> Option<Address>

get_price_feed_for

pub fn get_price_feed_for(env: &Env, symbol: Symbol) -> Option<Symbol>

register_token_alias

pub fn register_token_alias(env: &Env, symbol: Symbol, address: Address)

get_lending_pool_for

pub fn get_lending_pool_for(env: &Env, token_addr: Address) -> Option<Address>

get_lending_pool_for_symbol

pub fn get_lending_pool_for_symbol(env: &Env, symbol: Symbol) -> Option<Address>

queue_set_tracking_meta

pub fn queue_set_tracking_meta(env: &Env, symbol: Symbol, meta: TrackingMeta)

set_tracking_meta

pub fn set_tracking_meta(env: &Env, symbol: Symbol)

cancel_set_tracking_meta

pub fn cancel_set_tracking_meta(env: &Env, symbol: Symbol)

deregister_tracking_meta

pub fn deregister_tracking_meta(env: &Env, symbol: Symbol)

get_tracking_meta

pub fn get_tracking_meta(env: &Env, symbol: Symbol) -> Option<TrackingMeta>

get_blend_tracking_symbol_for

pub fn get_blend_tracking_symbol_for(env: &Env, token_addr: Address) -> Option<Symbol>

is_tracking_symbol

pub fn is_tracking_symbol(env: &Env, symbol: Symbol) -> bool

get_all_tracking_symbols

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

Source reference

Protocol_V1_Soroban_testnet/contracts/RegistryContract/src/registry.rs

​Discovery

​Governance

​Function signatures

​__constructor

​set_lendingpool_xlm

​set_smart_account_hash

​set_accountmanager_contract

​set_lendingpool_usdc

​set_risk_engine_address

​set_rate_model_address

​set_oracle_contract_address

​set_native_xlm_contract_address

​set_native_usdc_contract_address

​set_blend_pool_address

​set_tracking_token_contract_addr

​set_aquarius_router_address

​set_aquarius_pool_index

​get_lendingpool_xlm

​get_smart_account_hash

​get_accountmanager_contract

​get_lendingpool_usdc

​get_risk_engine_address

​get_rate_model_address

​get_oracle_contract_address

​get_xlm_contract_address

​get_usdc_contract_address

​get_blend_pool_address

​get_aquarius_router_address

​set_soroswap_router_address

​get_soroswap_router_address

​get_aquarius_pool_index

​has_tracking_token_contract_addr

​get_tracking_token_contract_addr

​get_admin

​propose_admin

​accept_admin

​get_proposed_admin

​get_timelock_durations

​upgrade

​add_account

​close_account

​update_account

​set_iscollateral_allowed

​get_iscollateral_allowed

​is_collateral_explicitly_revoked

​set_controller_facade

​get_controller_facade

​has_controller_facade

​is_registry_config_finalized

​finalize_registry_config

​queue_register_controller

​register_controller

​cancel_register_controller

​deregister_controller

​get_controller_for

​get_controller_tvl_cap

​get_protocol_config

​get_revoked_flags

​get_exec_gate

​queue_set_token_allowed

​set_token_allowed

​cancel_set_token_allowed

​deregister_token

​is_token_allowed

​queue_set_asset_meta

​set_asset_meta

​cancel_set_asset_meta

​get_asset_meta

​get_registered_assets

​backfill_asset_list

​get_token_address_for

​get_price_feed_for

​register_token_alias

​get_lending_pool_for

​get_lending_pool_for_symbol

​queue_set_tracking_meta

​set_tracking_meta

​cancel_set_tracking_meta

​deregister_tracking_meta

​get_tracking_meta