TOOLS

Token Discovery + Alias Manager

Discover wallet tokens, register deterministic aliases, and verify decimals/address resolution for balance and send workflows.

Human Flow

Discover tokens, register alias metadata, and verify alias lookup.

state: idle

Discover Tokens

discovered at: —

Native token on Base: ETH

Discovery Results

No discovery results yet. Run discovery to list owned tokens.

Register Alias

provide `address` or `mint`; decimals strongly recommended.

Last save: —

Alias Lookup

Resolve an alias to verify persisted decimals and address/mint.

Agent Flow

Exact SDK calls for discovery, alias registration, and alias lookup.

Discover Tokens

SDK method
CALLmoney.tokens
- Discovery auto-caches token symbols as aliases where possible.
- Use discovered decimals/address to avoid send/balance ambiguity.
# SDK method (no HTTP endpoint)
# Use JavaScript snippet instead.
Example success response
{
  "chain": "base",
  "network": "mainnet",
  "owned": [
    {
      "symbol": "USDC",
      "address": "0x...",
      "balance": "245.41",
      "rawBalance": "245410000",
      "decimals": 6
    }
  ],
  "note": ""
}
Example failure responses
Failure
{
  "code": "INVALID_PARAMS",
  "message": "Missing required param: chain"
}
Recovery: Provide a chain name.
Failure
{
  "chain": "base",
  "network": "mainnet",
  "owned": [],
  "note": "Chain \"base\" is not configured. Run setup first."
}
Recovery: Expected non-throw behavior. Setup first: await money.setup({ chain: "base" })

Register Alias

SDK method
CALLmoney.registerToken
- Alias name is uppercased for deterministic lookup.
- Decimals are persisted and used for unit conversions.
# SDK method (no HTTP endpoint)
# Use JavaScript snippet instead.
Example success response
{
  "saved": true,
  "token": {
    "chain": "base",
    "network": "mainnet",
    "name": "USDC",
    "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "decimals": 6
  }
}
Example failure responses
Failure
{
  "code": "INVALID_PARAMS",
  "message": "Either address or mint is required."
}
Recovery: Provide address for EVM/Fast or mint for Solana.
Failure
{
  "code": "CHAIN_NOT_CONFIGURED",
  "message": "Chain \"base\" is not configured."
}
Recovery: Run setup first: await money.setup({ chain: "base", network: "mainnet" })

Get Alias

SDK method
CALLmoney.getToken
- Lookup returns alias metadata with decimals and address/mint.
# SDK method (no HTTP endpoint)
# Use JavaScript snippet instead.
Example success response
{
  "token": {
    "chain": "base",
    "network": "mainnet",
    "name": "USDC",
    "address": "0x...",
    "decimals": 6
  },
  "found": true
}
Example failure responses
Failure
{
  "token": null,
  "found": false
}
Recovery: Alias not found. Register first, then retry lookup.
Failure
{
  "code": "CHAIN_NOT_CONFIGURED",
  "message": "Chain \"base\" is not configured."
}
Recovery: Run setup first: await money.setup({ chain: "base", network: "mainnet" })