Skip to main content
The TrackingToken contract is a single on-chain token registry that tracks synthetic position balances for each SmartAccount. Instead of querying external protocols (Blend, Aquarius, Soroswap) directly during health checks, the RiskEngine reads TrackingToken balances to determine a margin account’s external positions. Testnet address: CA24GDWO63ZXNMW5FLWF2KMZ5DCF3DO7J3RYABFICDIDHH4A342RD2TR

​
Tracked Symbols

SymbolRepresentsValue in risk model
BLEND_XLMXLM b-tokens held in Blend poolValued via b_rate × oracle price
BLEND_USDCUSDC b-tokens held in Blend poolValued via b_rate × oracle price
AQ_XLM_USDCAquarius XLM/USDC LP tokens$0 (no oracle feed)
SS_XLM_USDCSoroswap XLM/USDC LP tokens$0 (no oracle feed)
LP tokens (AQ_XLM_USDC, SS_XLM_USDC) are tracked to prevent double-counting but are valued at $0 in health factor calculations. Only Blend b-tokens receive non-zero collateral valuation.

​
Mint / Burn Flow

TrackingTokens are minted and burned by the AccountManager based on the return value from SmartAccount.execute(): 
SmartAccount.execute() → returns (success, token_delta)

if token_delta > 0:
    AccountManager → TrackingToken.mint(symbol, smart_account, token_delta)
if token_delta < 0:
    AccountManager → TrackingToken.burn(symbol, smart_account, -token_delta)
Blend deposit: mint BLEND_XLM equal to b-tokens received
Blend withdrawal: burn BLEND_XLM equal to b-tokens returned
Aquarius add liquidity: mint AQ_XLM_USDC equal to LP tokens received
Aquarius remove liquidity: burn AQ_XLM_USDC equal to LP tokens burned

​
Functions

​
initialize

fn initialize(
    env: Env,
    admin: Address,
    symbol: Symbol,
    decimals: u32,
    name: String,
) -> ()
One-time initialization per symbol. Sets the token info for a given tracking symbol.

​
mint

fn mint(
    env: Env,
    symbol: Symbol,
    to: Address,
    amount: i128,
) -> ()
Increases to’s balance for symbol by amount. Only callable by admin (AccountManager). Called when: A SmartAccount deposits into Blend or adds liquidity to Aquarius/Soroswap.

​
burn

fn burn(
    env: Env,
    symbol: Symbol,
    from: Address,
    amount: i128,
) -> ()
Decreases from’s balance for symbol by amount. Only callable by admin (AccountManager). Called when: A SmartAccount withdraws from Blend or removes liquidity from Aquarius/Soroswap.

​
balance

fn balance(env: Env, id: Address, symbol: Symbol) -> i128
Returns the tracking token balance for id and symbol. The primary read function used by RiskEngine during collateral valuation.

​
total_supply

fn total_supply(env: Env, symbol: Symbol) -> i128
Returns the total tracking tokens minted across all accounts for symbol.

​
admin

fn admin(env: Env) -> Address
Returns the admin address (AccountManager).

​
set_admin

fn set_admin(env: Env, new_admin: Address) -> ()
Changes the admin. Requires current admin auth.

​
Storage Layout

KeyTypeDescription
TokenInfo(Symbol){decimals, name, symbol}Metadata per symbol
AdminAddressAdmin (AccountManager)
TotalSupply(Symbol)i128Total minted per symbol
Balance(Address, Symbol)i128Per-account, per-symbol balance

​
Reading TrackingToken Balances (TypeScript)

const TRACKING_TOKEN = 'CA24GDWO63ZXNMW5FLWF2KMZ5DCF3DO7J3RYABFICDIDHH4A342RD2TR';

// Check how many Blend XLM b-tokens a smart account has
const blendXlmBalance = await simulateCall(
  TRACKING_TOKEN,
  'balance',
  [smartAccountAddress, Symbol('BLEND_XLM')]
);

// Check Aquarius LP position
const aqLpBalance = await simulateCall(
  TRACKING_TOKEN,
  'balance',
  [smartAccountAddress, Symbol('AQ_XLM_USDC')]
);