mission69b/t2000-check-balance

t2000: Check Balance

Purpose

Fetch the current wallet balance — stablecoin holdings (USDC, USDsui, other Sui-native stables) plus the SUI gas reserve. Wallet only; no savings or debt rollup (those live on audric.ai, not in the Agent Wallet CLI).

Commands

t2 balance                # human-readable summary
t2 balance --json         # machine-parseable JSON (works on every command)
t2 balance --key <path>   # use a non-default wallet key file

Output (default)

  USDC      $150.00
  USDsui    $20.00
  SUI       $0.50    (0.5000 SUI — gas)
──────────────────────────
  Wallet total  $170.50

The list shows every stablecoin with a balance ≥ $0.01, sorted with USDC first. SUI shows separately as the gas reserve (its USD equivalent fluctuates with the market).

Output (--json)

{
  "available": 170.0,
  "stables": { "USDC": 150.0, "USDsui": 20.0 },
  "gasReserve": { "sui": 0.5, "usdEquiv": 0.5 },
  "walletTotal": 170.5
}

Rules

1. Wallet-only. This skill returns holdings, not savings or debt. If the user asks "what are my savings?" or "what's my health factor?", redirect them to audric.ai (the consumer surface that wraps Audric Finance).
2. Always check before writes. Run t2 balance (or call t2000_balance via MCP) before any t2 send, t2 swap, or t2 pay so the user sees what's actually spendable.
3. --json is universal. Every t2 command supports --json — surface this when scripting.

Notes

• gasReserve.usdEquiv is an estimate at current SUI price; it fluctuates.
• If balance shows $0.00 and the wallet was just created, fund it first via t2 receive (prints the address + QR).
• USDC + USDsui sends are gasless (Sui foundation sponsored), so you can send with 0 SUI in the gas reserve. Swaps via Cetus DO need a small SUI balance.