Skip to main content
The Registry is a central address book. Every protocol contract resolves peer contract addresses through the Registry at runtime rather than storing them as constructor constants. This enables safe protocol upgrades — updating a Registry entry propagates to all contracts automatically. Testnet address: CC35XWCH7SCQROTNW7PA6HZKP4JMNSVV2K7CX3HY2PSI2MI2ZQQH73ID

​
Stored Addresses

The Registry stores addresses for every protocol component:
KeyDescription
LendingPoolXLMXLM lending pool contract
LendingPoolUSDCUSDC lending pool contract
LendingPoolAquariusUSDCAquarius USDC lending pool
LendingPoolSoroswapUSDCSoroswap USDC lending pool
RiskEngineContractRisk Engine contract
RateModelContractRate Model contract
OracleContractOracle (Reflector passthrough)
AccountManagerContractAccount Manager
SmartAccountContractHashWASM hash used to deploy new SmartAccounts
NativeXLMAddressXLM Stellar Asset Contract (SAC)
USDCAddressUSDC token contract
BlendPoolAddressExternal: Blend Capital pool
TrackingTokenAddressTracking Token contract
AquariusRouterAddressExternal: Aquarius router
AquariusPoolIndexAquarius pool pool_index
TreasuryProtocol treasury address

​
Account Management Functions

The Registry also stores user account data.

​
add_account

fn add_account(env: Env, trader: Address, smart_account: Address) -> ()
Records a new SmartAccount for trader. Called by AccountManager during create_account(). Authorization: AccountManager only

​
update_account

fn update_account(env: Env, trader: Address, smart_account: Address) -> ()
Updates the active SmartAccount address for trader. Called when reusing an inactive account.

​
get_accounts

fn get_accounts(env: Env, trader: Address) -> Vec<Address>
Returns all SmartAccount addresses ever associated with trader (active and historical). This is the primary way to look up a user’s margin account address.

​
get_smart_account_hash

fn get_smart_account_hash(env: Env) -> BytesN<32>
Returns the WASM hash used to deploy new SmartAccount instances.

​
Address Getter Functions

Each stored address has a corresponding getter: 
fn get_lending_pool_xlm(env: Env) -> Address
fn get_lending_pool_usdc(env: Env) -> Address

fn get_risk_engine(env: Env) -> Address
fn get_rate_model(env: Env) -> Address
fn get_oracle(env: Env) -> Address
fn get_account_manager(env: Env) -> Address
fn get_tracking_token(env: Env) -> Address
fn get_treasury(env: Env) -> Address
fn get_native_xlm(env: Env) -> Address
fn get_usdc(env: Env) -> Address

fn get_blend_pool(env: Env) -> Address
// ... and corresponding has_*_address() booleans

​
Address Setter Functions

Each stored address has a setter callable by the admin: 
fn set_lending_pool_xlm(env: Env, address: Address) -> ()
fn set_lending_pool_usdc(env: Env, address: Address) -> ()
// ... etc.
All setters require admin authorization.

​
Querying the Registry (TypeScript Example)

import { Contract, SorobanRpc } from '@stellar/stellar-sdk';

const REGISTRY = 'CC35XWCH7SCQROTNW7PA6HZKP4JMNSVV2K7CX3HY2PSI2MI2ZQQH73ID';
const server = new SorobanRpc.Server('https://soroban-testnet.stellar.org');

// Find a user's margin account
const result = await server.simulateTransaction(
  buildTransaction(userAddress, REGISTRY, 'get_accounts', [userAddressArg])
);

const accounts = scValToNative(result.result.retval); // Address[]