PRODUCT_FACTS.md — Single Source of Truth

Every README, docs page, skill file, and marketing material MUST match this file. When a product fact changes, update this file FIRST, then propagate.

For CLI output formatting (primitives, precision, header styles, exact output per command), see CLI_UX_SPEC.md.

Source: derived from actual source code in packages/*/src/. Last verified: 2026-04-14

Version

Package	Version
`@t2000/sdk`	`0.36.0`
`@t2000/engine`	`0.36.0`
`@t2000/cli`	`0.36.0`
`@suimpp/mpp`	`0.3.1`
`@t2000/mcp`	`0.36.0`
Agent Skills	`3.0`

Agent Skills

Fact	Value
Install command	`npx skills add mission69b/t2000-skills`
Repo	`https://github.com/mission69b/t2000-skills`
Skill count	12
Skills	`t2000-check-balance`, `t2000-send`, `t2000-receive`, `t2000-save`, `t2000-withdraw`, `t2000-borrow`, `t2000-repay`, `t2000-pay`, `t2000-safeguards`, `t2000-mcp`, `t2000-contacts`, `t2000-engine`
Supported platforms	Claude Code, Cursor, Codex, Copilot, Amp, Cline, Gemini CLI, VS Code, + more
Source (monorepo)	`t2000-skills/` — auto-synced to standalone repo via GitHub Action

Fees

Operation	BPS	Rate	Notes
Save	10	0.1%	Protocol fee on deposit
Borrow	5	0.05%	Protocol fee on loan
Withdraw	—	Free
Repay	—	Free
Send	—	Free
Receive	—	Free	Payment request generation is local; uses Sui Payment Kit (`sui:pay?` URIs) for QR codes
Swap	10	0.1%	t2000 overlay fee on swap (`overlayFeeRate` / `overlayFeeReceiver` in `cetus-swap.ts`); Cetus Aggregator network fees still apply
Stake (vSUI)	—	Free	VOLO protocol fees only
Unstake (vSUI)	—	Free
Pay (MPP)	—	Free	Agent pays the API price, no t2000 surcharge

Source: packages/sdk/src/constants.ts → SAVE_FEE_BPS, BORROW_FEE_BPS

Fees are collected on-chain via t2000::treasury::collect_fee() within the same PTB as the operation. The Move function takes &mut Coin<T> and splits the fee into the Treasury's internal Balance<T>.

Architecture

Programmable Transaction Blocks (PTBs)

All multi-step operations use single atomic PTBs. If any step fails, the entire transaction reverts — no funds left in intermediate states.

Operation	PTB Composition
Save	Collect fee → deposit USDC — single PTB
Withdraw	Withdraw USDC from protocol → transfer — single PTB
Repay	Split USDC → repay debt — single PTB
Withdraw all	Withdraw all USDC positions → merge → transfer — single PTB

Dust Filtering

Positions with value ≤ $0.005 are filtered out of positions() display to avoid showing near-zero remnants from rounding.

Composable Adapter Methods

Protocol adapters expose composable PTB methods alongside standalone transaction builders:

Method	Description
`addWithdrawToTx(tx, ...)`	Adds withdraw commands to existing PTB, returns `TransactionObjectArgument`
`addSaveToTx(tx, ...)`	Adds deposit commands, accepts coin as `TransactionObjectArgument`
`addRepayToTx(tx, ...)`	Adds repay commands, accepts coin as `TransactionObjectArgument`

Source: packages/sdk/src/adapters/types.ts, packages/sdk/src/t2000.ts

Protocol Adapters

t2000 uses an MCP-first integration model for DeFi protocol reads, with thin transaction builders for writes.

Adapter	Type	Capabilities	Status
NAVI (`navi`)	Lending	save, withdraw, borrow, repay; claim rewards	Built-in
Cetus Aggregator V3	Swap	Multi-DEX swap routing (20+ DEXs); t2000 0.1% overlay on swaps (`overlayFeeRate` / `overlayFeeReceiver`)	Built-in
VOLO	Liquid Staking	Stake SUI → vSUI, unstake vSUI → SUI	Built-in
DefiLlama	Market Data	Token prices, yields, TVL, protocol info, fees	Built-in (engine)

LendingAdapter interface: save, withdraw, borrow, repay, getRates, getPositions, getHealth, getPendingRewards, addClaimRewardsToTx
ProtocolRegistry auto-selects best rates across registered adapters
CLI --protocol <name> flag on save/withdraw/borrow/repay to pin a specific protocol
Third-party adapters can be registered via agent.registerAdapter(new MyAdapter())
Cetus SDK (@cetusprotocol/aggregator-sdk) is isolated to packages/sdk/src/protocols/cetus-swap.ts
VOLO uses thin tx builders (direct Move calls) — no SDK dependency
DefiLlama uses free public REST API (coins.llama.fi, yields.llama.fi, api.llama.fi)

Source: packages/sdk/src/adapters/, packages/sdk/src/protocols/, packages/engine/src/tools/defillama.ts

Supported Assets

All token metadata (type, decimals, symbol, optional tier) lives in a single canonical registry: packages/sdk/src/token-registry.ts → COIN_REGISTRY. When adding a new token, add ONE entry there — everything else derives from it.

Tier model

Tier 1 (1 token): USDC — financial layer (save, borrow, send, swap, MPP, etc.).
Tier 2 (13 swap assets): SUI, wBTC, ETH, GOLD, DEEP, WAL, NS, IKA, CETUS, NAVX, vSUI, LOFI, MANIFEST — send and swap; not used for new save/borrow deposits.
Legacy (no tier, 3 tokens): USDT, USDe, USDSUI — kept for accurate display and withdraw of existing positions; not tier-gated for new Tier 1/2 flows.

17 tokens in COIN_REGISTRY. Removed from the registry: haSUI, afSUI, FDUSD, AUSD, BUCK, BLUB, SCA, TURBOS.

Tier	Symbols	Send	Save	Borrow	Swap
1	USDC	✅	✅ (USDC only)	✅ (USDC only)	✅
2	SUI, wBTC, ETH, GOLD, DEEP, WAL, NS, IKA, CETUS, NAVX, vSUI, LOFI, MANIFEST	✅	—	—	✅
Legacy	USDT, USDe, USDSUI	✅	—	—	✅

New save and borrow flows accept USDC only (SDK throws INVALID_ASSET if another asset is requested). Withdraw still supports legacy positions. Swap routing uses Cetus Aggregator V3 (with t2000 overlay fee — see Fees).

Key SDK exports from token-registry.ts:

COIN_REGISTRY — full registry (Record<string, CoinMeta>)
isTier1(coinType), isTier2(coinType), isSupported(coinType), getTier(coinType)
getDecimalsForCoinType(coinType) — decimals lookup with suffix fallback
resolveSymbol(coinType) — friendly name from full coin type
resolveTokenType(name) — name → full coin type
TOKEN_MAP — case-insensitive name → type mapping
Type constants: SUI_TYPE, USDC_TYPE, USDT_TYPE, USDSUI_TYPE, ETH_TYPE, WAL_TYPE, IKA_TYPE, LOFI_TYPE, MANIFEST_TYPE, etc.

STABLE_ASSETS in constants.ts is ['USDC'] only (stable display and balance breakdowns).

Source: packages/sdk/src/token-registry.ts, packages/sdk/src/constants.ts

CLI Commands

Syntax (exact signatures from Commander.js)

Command	Syntax	Notes
init	`t2000 init`	Options: `--name <name>`, `--no-sponsor`
balance	`t2000 balance`	Options: `--show-limits`
send	`t2000 send <amount> <asset> [to] <address>`	`to` keyword is optional
save	`t2000 save <amount>`	Deposits USDC to NAVI lending. Alias: `supply`. `amount` accepts `all`.
withdraw	`t2000 withdraw <amount> [--asset TOKEN]`	Withdraws from NAVI lending. `amount` accepts `all`. `--asset` for specific token.
borrow	`t2000 borrow <amount>`	USDC only
repay	`t2000 repay <amount>`	Repays with USDC. `amount` accepts `all`
pay	`t2000 pay <url>`	Options: `--method`, `--data`, `--header`, `--max-price`, `--timeout`, `--dry-run`
history	`t2000 history`	Options: `--limit <n>` (default: 20)
earnings	`t2000 earnings`
fund-status	`t2000 fund-status`
health	`t2000 health`
rates	`t2000 rates`
positions	`t2000 positions`
deposit	`t2000 deposit`	Shows funding instructions
receive	`t2000 receive`	Options: `--amount <n>`, `--currency <sym>`, `--memo <text>`, `--label <text>`, `--key <path>`
address	`t2000 address`
serve	`t2000 serve`	Options: `--port` (default: 3001), `--rate-limit` (default: 10)
config get	`t2000 config get [key]`	Omit key for all
config set	`t2000 config set <key> <value>`
export	`t2000 export`	Options: `--yes` to skip confirmation
import	`t2000 import`
lock	`t2000 lock`	Clear saved session
contacts	`t2000 contacts`	List saved contacts
contacts add	`t2000 contacts add <name> <address>`	Save a named contact
contacts remove	`t2000 contacts remove <name>`	Remove a contact
claim-rewards	`t2000 claim-rewards`	Claim pending protocol rewards
swap	`t2000 swap <amount> <from> [for] <to>`	Swap tokens via Cetus Aggregator. Options: `--slippage <pct>` (default: 1%)
swap-quote	`t2000 swap-quote <amount> <from> [for] <to>`	Preview swap quote (read-only, no execution)
stake	`t2000 stake <amount>`	Stake SUI for vSUI (VOLO liquid staking, min 1 SUI)
unstake	`t2000 unstake <amount>`	Unstake vSUI back to SUI. `amount` accepts `all`
earn	`t2000 earn`	Show all earning opportunities — savings yield
mcp install	`t2000 mcp install`	Auto-configure MCP in Claude Desktop + Cursor
mcp uninstall	`t2000 mcp uninstall`	Remove t2000 MCP config from platforms
mcp	`t2000 mcp`	Start MCP server (stdio transport, used by AI platforms)

Global Flags

Flag	Description
`--json`	Machine-readable JSON output
`--yes` / `-y`	Skip confirmation prompts
`--key <path>`	Key file path (default: `~/.t2000/wallet.key`)

CLI Output Formats (canonical examples)

balance:

  Available:  $4.00  (checking — spendable)
  Savings:    $1.00  (earning 3.31% APY)
  Gas:        1.04 SUI    (~$0.98)
  ──────────────────────────────────────
  Total:      $5.98
  Earning ~$0.01/day

save:

  ✓ Saved $1.00 USDC to best rate
  ✓ Protocol fee: $0.00 USDC (0.1%)
  ✓ Current APY: 3.31%
  ✓ Savings balance: $1.00 USDC
  Tx:  https://suiscan.xyz/mainnet/tx/<digest>

borrow:

  ✓ Borrowed $0.20 USDC
  Health Factor:  4.24
  Tx:  https://suiscan.xyz/mainnet/tx/<digest>

repay:

  ✓ Repaid $0.20 USDC
  Remaining Debt:  $0.00
  Tx:  https://suiscan.xyz/mainnet/tx/<digest>

send:

  ✓ Sent $10.00 USDC → 0x8b3e...d412
  Gas:  0.0042 SUI (self-funded)
  Balance:  $90.00 USDC
  Tx:  https://suiscan.xyz/mainnet/tx/<digest>

swap:

  ✓ Swapped 10 SUI for 38.4200 USDC
  Route:  SUI → USDC (Cetus)
  Gas:    0.0031 SUI (self-funded)
  Tx:  https://suiscan.xyz/mainnet/tx/<digest>

stake:

  ✓ Staked 5 SUI for 4.7619 vSUI
  ✓ APY: 3.85%
  Gas:    0.0028 SUI (self-funded)
  Tx:  https://suiscan.xyz/mainnet/tx/<digest>

unstake:

  ✓ Unstaked 4.7619 vSUI
  ✓ Received 5.0500 SUI
  Gas:    0.0028 SUI (self-funded)
  Tx:  https://suiscan.xyz/mainnet/tx/<digest>

receive:

  ✓ Payment Request

  $25.00 USDC

  Address:   0x8b3e...d412
  Network:   Sui Mainnet
  Nonce:     a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d
  Memo:      Office supplies

  Payment URI: sui:pay?receiver=0x8b3e...&amount=25000000&coinType=0xdba3...::usdc::USDC&nonce=a1b2...

  Share this URI or scan the QR to pay via any Sui wallet.

pay:

  → GET https://api.example.com/data
  ← 402 Payment Required: $0.01 USDC (Sui)
  ✓ Paid $0.01 USDC (tx: 0xabc123ab...)
  ← 200 OK  [820ms]

SDK Methods

Construction

Method	Signature	Description
`T2000.create()`	`(options?: T2000Options): Promise<T2000>`	Load existing wallet. Key options: `pin`, `keyPath`, `rpcUrl`
`T2000.init()`	`(options: { pin: string; keyPath?: string; name?: string; sponsored?: boolean }): Promise<{ agent: T2000; address: string; sponsored: boolean }>`	Create new wallet
`T2000.fromPrivateKey()`	`(privateKey: string, options?: { rpcUrl?: string }): T2000`	From raw key

Wallet

Method	Params	Returns
`balance()`	—	`BalanceResponse`
`send()`	`{ to, amount, asset? }`	`SendResult`
`history()`	`{ limit? }`	`TransactionRecord[]`
`address()`	— (sync)	`string`
`deposit()`	—	`DepositInfo`
`receive()`	`{ amount?, currency?, memo?, label? }`	`PaymentRequest` — address, nonce, Payment Kit URI (`sui:pay?...`), display text

Savings

Method	Params	Returns
`save()`	`{ amount: number \| 'all', protocol? }`	`SaveResult` — USDC only; non-USDC `asset` throws `INVALID_ASSET`
`withdraw()`	`{ amount: number \| 'all', asset?: string }`	`WithdrawResult`
`maxWithdraw()`	—	`MaxWithdrawResult`

Credit

Method	Params	Returns
`borrow()`	`{ amount }`	`BorrowResult`
`repay()`	`{ amount: number \| 'all' }`	`RepayResult`
`maxBorrow()`	—	`MaxBorrowResult`
`healthFactor()`	—	`HealthFactorResult`

Swap

Method	Params	Returns
`swap()`	`{ from, to, amount, byAmountIn?, slippage? }`	`SwapResult`

Liquid Staking (VOLO)

Method	Params	Returns
`stakeVSui()`	`{ amount }`	`StakeVSuiResult`
`unstakeVSui()`	`{ amount: number \| 'all' }`	`UnstakeVSuiResult`

Info

Method	Params	Returns
`rates()`	—	`RatesResult`
`allRatesAcrossAssets()`	—	`Array<{ protocol, asset, rates }>`
`positions()`	—	`PositionsResult`
`earnings()`	—	`EarningsResult`
`fundStatus()`	—	`FundStatusResult`

Safeguards

Method	Description
`agent.enforcer.getConfig()`	Returns current `SafeguardConfig`
`agent.enforcer.isConfigured()`	`true` if any limit is non-zero
`agent.enforcer.set(key, value)`	Set `maxPerTx`, `maxDailySend`, or `locked`
`agent.enforcer.lock()`	Freeze all operations
`agent.enforcer.unlock()`	Resume operations
`agent.enforcer.check(metadata)`	Validate a `TxMetadata` against rules
`agent.enforcer.recordUsage(amount)`	Record outbound USDC for daily tracking

Getters

Getter	Returns
`agent.suiClient`	`SuiJsonRpcClient`
`agent.signer`	`Ed25519Keypair`
`agent.enforcer`	`SafeguardEnforcer`

Events

Event	Description
`yield`	Yield earned notification
`balanceChange`	Balance changed
`healthWarning`	HF dropping, attention recommended
`healthCritical`	HF dangerous, action required
`gasAutoTopUp`	Auto-topped up gas via USDC→SUI conversion
`gasStationFallback`	Gas resolution fell back to sponsor
`error`	SDK error

SDK Types (key interfaces)

interface T2000Options {
  pin?: string;           // PIN to decrypt key file
  keyPath?: string;       // Path to key file (default: ~/.t2000/wallet.key)
  rpcUrl?: string;        // Custom Sui RPC URL
  passphrase?: string;    // @deprecated — use pin
  network?: 'mainnet' | 'testnet';
  sponsored?: boolean;
  name?: string;
}

interface BalanceResponse {
  available: number;
  stables: Record<string, number>;  // Per-stablecoin breakdown
  savings: number;
  gasReserve: { sui: number; usdEquiv: number };  // GasReserve
  total: number;
}

interface SendResult {
  success: boolean;
  tx: string;
  amount: number;
  to: string;
  gasCost: number;
  gasCostUnit: string;
  gasMethod: 'self-funded' | 'sponsored' | 'auto-topup';
  balance: BalanceResponse;
}

interface SaveResult {
  success: boolean; tx: string; amount: number;
  apy: number; fee: number; gasCost: number;
  gasMethod: GasMethod; savingsBalance: number;
}

interface WithdrawResult {
  success: boolean; tx: string; amount: number;
  gasCost: number; gasMethod: GasMethod;
}

interface BorrowResult {
  success: boolean; tx: string; amount: number;
  fee: number; healthFactor: number;
  gasCost: number; gasMethod: GasMethod;
}

interface RepayResult {
  success: boolean; tx: string; amount: number;
  remainingDebt: number; gasCost: number; gasMethod: GasMethod;
}

interface SwapResult {
  success: boolean; tx: string;
  fromToken: string; toToken: string;
  fromAmount: number; toAmount: number;
  priceImpact: number; route: string;
  gasCost: number; gasMethod: GasMethod;
}

interface StakeVSuiResult {
  success: boolean; tx: string;
  amountSui: number; vSuiReceived: number;
  apy: number; gasCost: number; gasMethod: GasMethod;
}

interface UnstakeVSuiResult {
  success: boolean; tx: string;
  vSuiAmount: number; suiReceived: number;
  gasCost: number; gasMethod: GasMethod;
}

interface PaymentRequest {
  address: string;
  network: string;
  amount: number | null;
  currency: string;
  memo: string | null;
  label: string | null;
  qrUri: string;
  displayText: string;
}

Source: packages/sdk/src/types.ts

Error Codes

Code	Description	Retryable
`INSUFFICIENT_BALANCE`	Not enough USDC	No
`INSUFFICIENT_GAS`	Not enough SUI for gas	Yes
`INVALID_ADDRESS`	Bad Sui address	No
`INVALID_AMOUNT`	Amount <= 0 or NaN	No
`INVALID_ASSET`	Save called with a non-USDC asset (borrow is USDC-only by API)	No
`WALLET_NOT_FOUND`	No key file at path	No
`WALLET_LOCKED`	Wrong PIN	No
`WALLET_EXISTS`	Key already exists at path	No
`SPONSOR_FAILED`	Sponsorship request failed	Yes
`SPONSOR_RATE_LIMITED`	Too many sponsor requests	Yes
`SPONSOR_UNAVAILABLE`	Sponsor service down	Yes
`GAS_STATION_UNAVAILABLE`	Gas station unreachable	Yes
`GAS_FEE_EXCEEDED`	Gas cost > $0.05 ceiling	No
`AUTO_TOPUP_FAILED`	USDC→SUI gas conversion failed	Yes
`SIMULATION_FAILED`	Dry-run failed	No
`TRANSACTION_FAILED`	On-chain execution failed	No
`HEALTH_FACTOR_TOO_LOW`	Borrow would risk liquidation	No
`WITHDRAW_WOULD_LIQUIDATE`	Withdraw would drop HF below safe	No
`NO_COLLATERAL`	No savings to borrow against	No
`PROTOCOL_PAUSED`	t2000 contract paused	No
`PROTOCOL_UNAVAILABLE`	NAVI unavailable	Yes
`RPC_ERROR`	Sui RPC error	Yes
`RPC_UNREACHABLE`	Sui RPC unreachable	Yes
`PRICE_EXCEEDS_LIMIT`	MPP price > maxPrice	No
`UNSUPPORTED_NETWORK`	MPP server not on Sui	No
`PAYMENT_EXPIRED`	MPP payment window expired	Yes
`DUPLICATE_PAYMENT`	MPP nonce already used	No
`FACILITATOR_REJECTION`	Facilitator rejected payment	No
`FACILITATOR_TIMEOUT`	Facilitator timed out	Yes
`SWAP_NO_ROUTE`	No swap route found (insufficient liquidity or unsupported pair)	No
`SWAP_FAILED`	Swap execution or routing error	Yes
`SAFEGUARD_BLOCKED`	Safeguard rule violated (locked, maxPerTx, maxDailySend)	No
`UNKNOWN`	Unclassified error	Yes

Source: packages/sdk/src/errors.ts

Move Contract Abort Codes

Code	Meaning
1	Protocol is temporarily paused (`EPAUSED`)
2	Amount must be greater than zero (`EZERO_AMOUNT`)
3	Invalid operation type (`EINVALID_OPERATION`)
4	Fee rate exceeds maximum (`EFEE_RATE_TOO_HIGH`)
5	Insufficient treasury balance (`EINSUFFICIENT_TREASURY`)
6	Not authorized (`ENOT_AUTHORIZED`)
7	Package version mismatch (`EVERSION_MISMATCH`)
8	Timelock is active (`ETIMELOCK_ACTIVE`)
9	No pending change to execute (`ENO_PENDING_CHANGE`)
10	Already at current version (`EALREADY_MIGRATED`)
1503	Invalid withdrawal amount (zero or dust balance)

Source: packages/sdk/src/errors.ts → mapMoveAbortCode(), packages/contracts/sources/errors.move

Constants

Constant	Value	Description
`MIST_PER_SUI`	`1_000_000_000n`	SUI base units per SUI
`SUI_DECIMALS`	`9`
`USDC_DECIMALS`	`6`
`BPS_DENOMINATOR`	`10_000n`	Basis points denominator
`PRECISION`	`1_000_000_000_000_000_000n` (10^18)	Reward math precision (matches contract)
`MIN_DEPOSIT`	`1_000_000n` (1 USDC)	Minimum deposit
`GAS_RESERVE_USDC`	`1_000_000n` ($1)	USDC reserved for gas on `save all`
`AUTO_TOPUP_THRESHOLD`	`50_000_000n` (0.05 SUI)	SUI balance below this triggers topup
`AUTO_TOPUP_AMOUNT`	`1_000_000n` ($1 USDC)	USDC amount converted per top-up
`AUTO_TOPUP_MIN_USDC`	`2_000_000n` ($2)	Min USDC required to trigger topup
`BOOTSTRAP_LIMIT`	`10`	Max sponsored bootstrap transactions
`GAS_FEE_CEILING_USD`	`$0.05`	Max gas fee before rejection
`CLOCK_ID`	`'0x6'`	Sui Clock shared object
`STABLE_ASSETS`	`['USDC']`	Stablecoins used for balance breakdown / stable-specific logic
`DEFAULT_RATE_LIMIT`	`10 req/s`	Default HTTP API rate limit (CLI `--rate-limit` default)

Source: packages/sdk/src/constants.ts (core constants), packages/cli/src/commands/*.ts (CLI defaults)

Contract Object IDs (Mainnet)

t2000 Protocol

Object	ID
Package	`0xd775fcc66eae26797654d435d751dea56b82eeb999de51fd285348e573b968ad`
Config	`0x08ba26f0d260b5edf6a19c71492b3eb914906a7419baf2df1426765157e5862a`
Treasury (USDC)	`0xf420ec0dcad44433042fb56e1413fb88d3ff65be94fcf425ef9ff750164590e8`

Note: AdminCap and UpgradeCap IDs are intentionally omitted — stored in .env.local only. The IDs above are the canonical mainnet IDs in use today; they are mirrored in packages/sdk/src/constants.ts (T2000_PACKAGE_ID, T2000_CONFIG_ID, T2000_TREASURY_ID) and infra/server-task-definition.json. An earlier abandoned package (0xab92e9f1...) and its associated Config / Treasury are no longer referenced by any code path. Contract Version: 1 (set in packages/contracts/sources/constants.move). Source and the active on-chain Config + Treasury are all at v1. The next package upgrade — when there's a real reason to ship one — should bump VERSION and call migrate_config + migrate_treasury with AdminCap so the new package's assert_version rejects calls into the previous binary.

Treasury Functions (v2)

Function	Description
`collect_fee<T>()`	Called in PTB — splits fee from `&mut Coin<T>` into `Balance<T>`
`receive_coins<T>()`	Admin recovery of coins sent via `transferObjects` (object-owned)
`withdraw_fees<T>()`	Admin withdraw from treasury balance (requires AdminCap)
`migrate_treasury<T>()`	Version bump guard — call after package upgrade (requires AdminCap)

MPP Payments (Sui Payment Kit)

Object	ID
Package	`0xbc126f1535fba7d641cb9150ad9eae93b104972586ba20f3c60bfe0e53b69bc6`
Payment Registry	`0x4009dd17305ed1b33352b808e9d0e9eb94d09085b2d5ec0f395c5cdfa2271291`

MPP uses peer-to-peer verification via mppx; no facilitator URL or verify/settle endpoints.

Infrastructure

Component	URL / Location
Website	`https://t2000.ai` (Vercel)
Docs	`https://t2000.ai/docs`
API	`https://api.t2000.ai` (ECS Fargate, ALB)
npm (SDK)	`https://www.npmjs.com/package/@t2000/sdk`
npm (CLI)	`https://www.npmjs.com/package/@t2000/cli`
npm (MPP)	`https://www.npmjs.com/package/@suimpp/mpp`
GitHub	`https://github.com/mission69b/t2000`
Network	Sui mainnet

Gas Resolution Chain

Self-funded — agent has enough SUI
Auto-topup — SUI < 0.05 and USDC >= $2 → convert $1 USDC to SUI (conversion is sponsored)
Sponsored — fallback for bootstrap (up to 10 txs)

MPP Payments

Fact	Value
Package	`@suimpp/mpp`
SDK method	`agent.pay()`
CLI command	`t2000 pay <url>`
MCP tool	`t2000_pay`
Flow	request → 402 → mppx pays via Sui USDC → credential → retry → response
Replay protection	On-chain nonce via Sui Payment Kit

Engine (Audric)

Fact	Value
Package	`@t2000/engine`
Version	`0.36.0`
Description	Agent engine for conversational finance — powers Audric
Entry point	`@t2000/engine` (ESM only)
Build	tsup → ESM bundle
Test framework	Vitest
Test count	250

Engine Public Exports

Export	Type	Purpose
`QueryEngine`	class	Stateful conversation loop with tool dispatch, thinking, guards
`validateHistory`	function	Pre-flight message history validation
`AnthropicProvider`	class	Streaming LLM provider (Anthropic Claude, extended thinking)
`buildTool`	function	Typed tool factory with Zod + JSON schema
`runTools`	function	Parallel reads / serial writes orchestration
`TxMutex`	class	Transaction serialization lock
`CostTracker`	class	Token usage + USD cost tracking
`MemorySessionStore`	class	In-memory session store with TTL
`McpClientManager`	class	Multi-server MCP client with caching
`McpResponseCache`	class	Client-side TTL cache for MCP responses
`adaptMcpTool`	function	Convert MCP tool → engine Tool
`buildMcpTools`	function	Convert engine tools → MCP descriptors
`registerEngineTools`	function	Register engine tools on MCP server
`serializeSSE` / `parseSSE`	function	SSE wire format
`engineToSSE`	function	Adapt QueryEngine → SSE stream
`estimateTokens`	function	Rough token estimation
`compactMessages`	function	Context window compaction (ContextBudget)
`fetchTokenPrices`	function	Batch USD prices from DefiLlama (single price source)
`clearPriceCache`	function	Clear the DefiLlama price cache
`getDefaultTools`	function	All 50 built-in tools (38 read, 12 write)
`DEFAULT_SYSTEM_PROMPT`	string	Audric system prompt
`classifyEffort`	function	Adaptive thinking effort classifier
`ContextBudget`	class	Context window budget tracking + compaction trigger
`RecipeRegistry`	class	YAML skill recipe loader + longest-trigger matching
`runGuards`	function	Pre/post-execution guard runner (9 guards, 3 tiers)
`applyToolFlags`	function	Apply `ToolFlags` to tool definitions
`buildProfileContext`	function	User financial profile → prompt context
`buildMemoryContext`	function	Episodic user memory → prompt context

Reasoning Engine (Phase 1-3 — Shipped)

Feature	Module	Description
Adaptive thinking	`classify-effort.ts`	Routes queries to `low`/`medium`/`high` thinking effort based on financial complexity
Prompt caching	`engine.ts`	System prompt + tool definitions cached across turns (Anthropic cache_control)
Guard runner	`guards.ts`	9 guards across 3 priority tiers (Safety > Financial > UX): retry, irreversibility, balance, health factor, large transfer, slippage, cost, artifact preview, stale data
Tool flags	`tool-flags.ts`	`ToolFlags` interface (mutating, requiresBalance, affectsHealth, irreversible, producesArtifact, costAware, maxRetries) on all tools
Preflight validation	`preflight` on Tool	Input validation gate on `send_transfer`, `swap_execute`, `pay_api`, `borrow`, `save_deposit`
Skill recipes	`recipes/registry.ts`	YAML recipe loader, `RecipeRegistry` with longest-trigger-match-wins, `toPromptContext()`
Context compaction	`context.ts`	`ContextBudget` (200k limit, 85% compact, 70% warn), LLM summarizer + truncation fallback

Extended thinking is always on for Sonnet/Opus (adaptive mode). ENABLE_THINKING env flag removed in Audric 2.0 Phase A.

Engine Tool Names

Read Tools (38)	Write Tools (12)
`render_canvas`	`save_deposit`
`balance_check`	`withdraw`
`savings_info`	`send_transfer`
`health_check`	`borrow`
`rates_info`	`repay_debt`
`transaction_history`	`claim_rewards`
`swap_quote`	`pay_api`
`volo_stats`	`swap_execute`
`mpp_services`	`volo_stake`
`web_search`	`volo_unstake`
`explain_tx`	`save_contact`
`portfolio_analysis`
`protocol_deep_dive`
`defillama_yield_pools`
`defillama_protocol_info`
`defillama_token_prices`
`defillama_price_change`
`defillama_chain_tvl`
`defillama_protocol_fees`
`defillama_sui_protocols`
`allowance_status`
`toggle_allowance`
`update_daily_limit`
`update_permissions`
`create_payment_link`
`list_payment_links`
`cancel_payment_link`
`create_invoice`
`list_invoices`
`cancel_invoice`
`spending_analytics`
`yield_summary`
`activity_summary`
`create_schedule`
`list_schedules`
`cancel_schedule`
`pattern_status`
`record_advice`	`pause_pattern`

Engine Event Types

text_delta, thinking_delta, thinking_done, tool_start, tool_result, pending_action, canvas, turn_complete, usage, error

Engine Permission Levels

Level	Behavior
`auto`	Executes without user approval
`confirm`	Yields `pending_action`, client executes and resumes via `resumeWithToolResult`
`explicit`	Manual-only — not dispatched by LLM

MCP Server (AI Integration)

Fact	Value
Package	`@t2000/mcp`
Version	`0.36.0`
Tool count	50 (38 read, 12 write) — mirrors engine tool set
Description	MCP-first financial tools for AI agents. Non-custodial. Part of the t2000 infrastructure behind Audric.
Transport	stdio
Safeguard enforced	Yes — all tool calls pass through `SafeguardEnforcer` before execution
Setup	`t2000 init` (guided wizard — wallet + MCP + safeguards in one command)
MCP auto-configured during init	Yes — Step 2 of init wizard auto-writes configs for Claude Desktop, Cursor, Windsurf
Standalone MCP install	`t2000 mcp install` (for reconfiguring or adding platforms after init)
Manual config	`{ "mcpServers": { "t2000": { "command": "t2000", "args": ["mcp"] } } }`
Remove	`t2000 mcp uninstall`
Start server	`t2000 mcp` (stdio transport, used by AI platforms)

FilesExpand file tree

PRODUCT_FACTS.md

Latest commit

History