Tracking Tokens

TrackingToken stores per-account, per-symbol external-position receipts. It is an accounting registry, not a freely transferable wallet token or a lending-pool vToken.

Metadata and balances

Initialization is per symbol. The contract has admin and deployer roles, with admin-authorized minters for controller operations. mint_by and burn_by require the specified authorized minter; mint and burn use the admin path. Freeze and supply/balance checks apply as implemented by each entrypoint. Registry metadata, not a fixed list in RiskEngine, determines what a symbol represents. Blend receipts track b-token units. AMM position accounting also consults actual LP token balances and synchronizes tracking membership; do not assume every LP operation mints synthetic receipts by the legacy execute() return value.

Configured symbol	Position
`BLEND_XLM`	Blend XLM supply
`BLEND_USDC`	Blend’s USDC supply
`AQ_XLM_USDC`	Aquarius XLM/AqUSDC LP
`SS_XLM_USDC`	Soroswap XLM/SoUSDC LP

Blend and registered AMM LP positions can contribute collateral value. Unpriced metadata and frozen/revoked positions are treated differently. See Risk Engine.

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

rotate_deployer

pub fn rotate_deployer(env: Env, new_deployer: Address)

initialize

pub fn initialize(
        env: Env,
        admin: Address,
        token_symbol: Symbol,
        decimal: u32,
        name: String,
    ) -> Result<(), TokenError>

admin

pub fn admin(env: Env) -> Address

set_admin

pub fn set_admin(env: Env, new_admin: Address) -> Result<(), TokenError>

decimals

pub fn decimals(env: Env, token_symbol: Symbol) -> u32

name

pub fn name(env: Env, token_symbol: Symbol) -> String

symbol

pub fn symbol(env: Env, token_symbol: Symbol) -> Symbol

balance

pub fn balance(env: Env, id: Address, token_symbol: Symbol) -> i128

total_supply

pub fn total_supply(env: Env, token_symbol: Symbol) -> i128

mint

pub fn mint(
        env: Env,
        token_symbol: Symbol,
        to: Address,
        amount: i128,
    ) -> Result<(), TokenError>

set_authorized_minter

pub fn set_authorized_minter(
        env: Env,
        minter: Address,
        authorized: bool,
    ) -> Result<(), TokenError>

is_authorized_minter

pub fn is_authorized_minter(env: Env, minter: Address) -> bool

mint_by

pub fn mint_by(
        env: Env,
        minter: Address,
        token_symbol: Symbol,
        to: Address,
        amount: i128,
    ) -> Result<(), TokenError>

burn_by

pub fn burn_by(
        env: Env,
        minter: Address,
        token_symbol: Symbol,
        from: Address,
        amount: i128,
    ) -> Result<(), TokenError>

burn

pub fn burn(
        env: Env,
        token_symbol: Symbol,
        from: Address,
        amount: i128,
    ) -> Result<(), TokenError>

burn_from

pub fn burn_from(
        env: Env,
        token_symbol: Symbol,
        from: Address,
        amount: i128,
    ) -> Result<(), TokenError>

set_frozen

pub fn set_frozen(env: Env, id: Address, freeze: bool) -> Result<(), TokenError>

frozen

pub fn frozen(env: Env, id: Address) -> bool

upgrade

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

Source reference

Protocol_V1_Soroban_testnet/contracts/TrackingTokenContract/src/tracking_token.rs

Introduction

Contract Reference

TypeScript Integration

Integration Guides

Tracking Tokens

Metadata and balances

Function signatures

__constructor

rotate_deployer

initialize

admin

set_admin

decimals

name

symbol

balance

total_supply

mint

set_authorized_minter

is_authorized_minter

mint_by

burn_by

burn

burn_from

set_frozen

frozen

upgrade

Source reference

​Metadata and balances

​Function signatures

​__constructor

​rotate_deployer

​initialize

​admin

​set_admin

​decimals

​name

​symbol

​balance

​total_supply

​mint

​set_authorized_minter

​is_authorized_minter

​mint_by

​burn_by

​burn

​burn_from

​set_frozen

​frozen

​upgrade

​Source reference

Metadata and balances

Function signatures

__constructor

rotate_deployer

initialize

admin

set_admin

decimals

name

symbol

balance

total_supply

mint

set_authorized_minter

is_authorized_minter

mint_by

burn_by

burn

burn_from

set_frozen

frozen

upgrade

Source reference