@t2000/cli 3.1.0 → 3.2.0

package/README.md

@@ -1,6 +1,6 @@
 # @t2000/cli
 
-A bank account for AI agents on Sui. Guided setup, MCP integration for Claude Desktop / Cursor / Windsurf, send USDC, earn yield, borrow, and pay for APIs. USDC in, USDC out.
+The Agentic Wallet for AI agents on Sui. Guided setup, MCP integration for Claude Desktop / Cursor / Windsurf, send USDC, earn yield, borrow, and pay for APIs. USDC in, USDC out.
 
 [![npm](https://img.shields.io/npm/v/@t2000/cli)](https://www.npmjs.com/package/@t2000/cli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
@@ -23,7 +23,7 @@ t2000 init
 
   ┌─────────────────────────────────────────┐
   │  Welcome to t2000                       │
-  │  A bank account for AI agents           │
+  │  Agentic Wallet for AI agents           │
   └─────────────────────────────────────────┘
 
   Step 1 of 3 — Create wallet
@@ -33,7 +33,7 @@ t2000 init
   ✓ Network  Sui mainnet
   ✓ Checking  ✓ Savings  ✓ Credit
 
-  🎉 Bank account created
+  🎉 Agentic Wallet created
   Address: 0x8b3e...d412
 
   ℹ Fund your wallet with SUI for gas + USDC to transact.
@@ -117,6 +117,8 @@ t2000 init
 | `t2000 mcp uninstall` | Remove MCP config from AI platforms |
 | `t2000 mcp` | Start MCP server (stdio — used by AI platforms, not run manually) |
 
+See the [MCP setup guide](../../docs/mcp-setup.md) for manual configuration.
+
 ### Config (dot-notation)
 
 | Command | Description |
@@ -129,15 +131,14 @@ t2000 init
 
 | Command | Description |
 |---------|-------------|
-| `t2000 init` | Create a new agent bank account (Ed25519 keypair, AES-256-GCM encrypted) |
 | `t2000 lock` | Lock agent — freeze all operations |
 | `t2000 unlock` | Unlock agent — resume operations (requires PIN) |
 | `t2000 balance` | Show available USDC + savings + gas reserve |
 | `t2000 balance --show-limits` | Include maxWithdraw, maxBorrow, and health factor |
 | `t2000 address` | Show wallet address |
-| `t2000 deposit` | Show funding instructions |
-| `t2000 import` | Import an existing bank account from private key |
-| `t2000 export` | Export private key (raw Ed25519 hex) |
+| `t2000 fund` | Show how to fund your Agentic Wallet (receive address + supported networks) |
+| `t2000 import` | Import an existing wallet from private key |
+| `t2000 export` | Export private key (bech32 `suiprivkey1...` format) |
 | `t2000 history` | Transaction history |
 
 ### Transfers
@@ -209,21 +210,6 @@ The local `~/.t2000/contacts.json` alias map is being retired. **Use SuiNS inste
 | `t2000 config get [key]` | Show a config value (omit key for all) |
 | `t2000 config set <key> <value>` | Set a config value |
 
-### MCP Server
-
-```bash
-# Auto-configure Claude Desktop + Cursor
-t2000 mcp install
-
-# Remove MCP config
-t2000 mcp uninstall
-
-# Start MCP server (used by AI platforms, not typically run directly)
-t2000 mcp
-```
-
-Safeguard enforced. See [MCP setup guide](../../docs/mcp-setup.md) for details.
-
 ### HTTP API Server
 
 ```bash
@@ -270,7 +256,7 @@ Config is stored at `~/.t2000/config.json`.
 
 | Variable | Description |
 |----------|-------------|
-| `T2000_PIN` | Bank account PIN (skip interactive prompt) |
+| `T2000_PIN` | Agentic Wallet PIN (skip interactive prompt) |
 | `T2000_PRIVATE_KEY` | Private key for `t2000 import` (skip interactive prompt) |
 
 ## Gas
@@ -295,12 +281,17 @@ Audric (the consumer product on top of the SDK) charges a small overlay fee on s
 ## Examples
 
 ```bash
-# Full DeFi cycle
+# Full DeFi cycle (USDC)
 t2000 save all               # Deposit all available USDC
 t2000 borrow 40              # Borrow against it
 t2000 repay 40               # Pay it back
 t2000 withdraw all            # Get everything out (USDC by default; pass --asset USDsui for USDsui)
 
+# Save / borrow / repay in USDsui (strategic stable, v0.51.0+)
+t2000 save 50 --asset USDsui          # Deposit USDsui to NAVI
+t2000 borrow 20 --asset USDsui        # Borrow USDsui against collateral
+t2000 repay all --asset USDsui        # Repay all USDsui debts (must match borrow asset)
+
 # Automation-friendly (no prompts, JSON output)
 t2000 balance --json
 t2000 save 10 --yes --json

package/dist/{chunk-R7KXQRHQ.js → chunk-ZH6PX6WS.js}

@@ -16937,6 +16937,63 @@ var init_cetus_swap = __esm({
     clientCache = /* @__PURE__ */ new Map();
   }
 });
+var swap_quote_exports = {};
+__export(swap_quote_exports, {
+  getSwapQuote: () => getSwapQuote
+});
+async function getSwapQuote(params) {
+  const { findSwapRoute: findSwapRoute2, resolveTokenType: resolveTokenType2 } = await Promise.resolve().then(() => (init_cetus_swap(), cetus_swap_exports));
+  const fromType = resolveTokenType2(params.from);
+  const toType = resolveTokenType2(params.to);
+  if (!fromType) {
+    throw new T2000Error(
+      "ASSET_NOT_SUPPORTED",
+      `Unknown token: ${params.from}. Provide the symbol (USDC, SUI, ...) or full coin type.`
+    );
+  }
+  if (!toType) {
+    throw new T2000Error(
+      "ASSET_NOT_SUPPORTED",
+      `Unknown token: ${params.to}. Provide the symbol (USDC, SUI, ...) or full coin type.`
+    );
+  }
+  const byAmountIn = params.byAmountIn ?? true;
+  const fromDecimals = getDecimalsForCoinType(fromType);
+  const rawAmount = BigInt(Math.floor(params.amount * 10 ** fromDecimals));
+  const route = await findSwapRoute2({
+    walletAddress: params.walletAddress,
+    from: fromType,
+    to: toType,
+    amount: rawAmount,
+    byAmountIn,
+    providers: params.providers
+  });
+  if (!route) throw new T2000Error("SWAP_FAILED", `No swap route found for ${params.from} -> ${params.to}.`);
+  if (route.insufficientLiquidity) {
+    throw new T2000Error("SWAP_FAILED", `Insufficient liquidity for ${params.from} -> ${params.to}.`);
+  }
+  const toDecimals = getDecimalsForCoinType(toType);
+  const fromAmount = Number(route.amountIn) / 10 ** fromDecimals;
+  const toAmount = Number(route.amountOut) / 10 ** toDecimals;
+  const routeDesc = route.routerData.paths?.map((p) => p.provider).filter(Boolean).slice(0, 3).join(" + ") ?? "Cetus Aggregator";
+  const { serializeCetusRoute: serializeCetusRoute2 } = await Promise.resolve().then(() => (init_cetus_swap(), cetus_swap_exports));
+  const serializedRoute = serializeCetusRoute2(route, { fromCoinType: fromType, toCoinType: toType });
+  return {
+    fromToken: params.from,
+    toToken: params.to,
+    fromAmount,
+    toAmount,
+    priceImpact: route.priceImpact,
+    route: routeDesc,
+    serializedRoute
+  };
+}
+var init_swap_quote = __esm({
+  "src/swap-quote.ts"() {
+    init_errors();
+    init_token_registry();
+  }
+});
 init_errors();
 var MIST_PER_SUI = 1000000000n;
 var SUI_DECIMALS = 9;
@@ -17001,7 +17058,8 @@ var SUPPORTED_ASSETS = {
     displayName: "XAUM"
   }
 };
-var STABLE_ASSETS = ["USDC"];
+var STABLE_ASSETS = ["USDC", "USDsui"];
+var SAVEABLE_ASSETS = ["USDC", "USDsui"];
 var ALL_NAVI_ASSETS = Object.keys(SUPPORTED_ASSETS);
 var OPERATION_ASSETS = {
   save: ["USDC", "USDsui"],
@@ -21754,7 +21812,7 @@ var ProtocolRegistry = class {
   }
   async bestSaveRateAcrossAssets() {
     const candidates = [];
-    for (const asset of STABLE_ASSETS) {
+    for (const asset of SAVEABLE_ASSETS) {
       for (const adapter of this.lending.values()) {
         if (!adapter.supportedAssets.includes(asset)) continue;
         if (!adapter.capabilities.includes("save")) continue;
@@ -21774,7 +21832,7 @@ var ProtocolRegistry = class {
   async allRatesAcrossAssets() {
     const results = [];
     const seen = /* @__PURE__ */ new Set();
-    for (const asset of STABLE_ASSETS) {
+    for (const asset of SAVEABLE_ASSETS) {
       if (seen.has(asset)) continue;
       seen.add(asset);
       for (const adapter of this.lending.values()) {
@@ -22522,36 +22580,24 @@ var T2000 = class _T2000 extends import_index.default {
       gasCost: gasResult.gasCostSui
     };
   }
+  /**
+   * [SPEC_AGENTIC_STACK P1 / SDK F2 — 2026-05-25]
+   * Thin wrapper around the standalone `getSwapQuote()`. Pre-Phase 1 this method
+   * was ~50 LoC duplicating `swap-quote.ts` — missing `serializedRoute` (SPEC 20.2
+   * fast-path) and the `providers` allow-list (Bug A fix / Pyth-dependent
+   * provider filter for sponsored callers). Routing both API surfaces through
+   * one implementation ensures fixes land for both.
+   */
   async swapQuote(params) {
-    const { findSwapRoute: findSwapRoute2, resolveTokenType: resolveTokenType2 } = await Promise.resolve().then(() => (init_cetus_swap(), cetus_swap_exports));
-    const fromType = resolveTokenType2(params.from);
-    const toType = resolveTokenType2(params.to);
-    if (!fromType) throw new T2000Error("ASSET_NOT_SUPPORTED", `Unknown token: ${params.from}. Provide the full coin type.`);
-    if (!toType) throw new T2000Error("ASSET_NOT_SUPPORTED", `Unknown token: ${params.to}. Provide the full coin type.`);
-    const byAmountIn = params.byAmountIn ?? true;
-    const fromDecimals = getDecimalsForCoinType(fromType);
-    const rawAmount = BigInt(Math.floor(params.amount * 10 ** fromDecimals));
-    const route = await findSwapRoute2({
+    const { getSwapQuote: getSwapQuote2 } = await Promise.resolve().then(() => (init_swap_quote(), swap_quote_exports));
+    return getSwapQuote2({
       walletAddress: this._address,
-      from: fromType,
-      to: toType,
-      amount: rawAmount,
-      byAmountIn
+      from: params.from,
+      to: params.to,
+      amount: params.amount,
+      byAmountIn: params.byAmountIn,
+      providers: params.providers
     });
-    if (!route) throw new T2000Error("SWAP_NO_ROUTE", `No swap route found for ${params.from} -> ${params.to}.`);
-    if (route.insufficientLiquidity) throw new T2000Error("SWAP_NO_ROUTE", `Insufficient liquidity for ${params.from} -> ${params.to}.`);
-    const toDecimals = getDecimalsForCoinType(toType);
-    const fromAmount = Number(route.amountIn) / 10 ** fromDecimals;
-    const toAmount = Number(route.amountOut) / 10 ** toDecimals;
-    const routeDesc = route.routerData.paths?.map((p) => p.provider).filter(Boolean).slice(0, 3).join(" + ") ?? "Cetus Aggregator";
-    return {
-      fromToken: params.from,
-      toToken: params.to,
-      fromAmount,
-      toAmount,
-      priceImpact: route.priceImpact,
-      route: routeDesc
-    };
   }
   // -- Wallet --
   address() {
@@ -22682,6 +22728,16 @@ var T2000 = class _T2000 extends import_index.default {
       ].join("\n")
     };
   }
+  /**
+   * [SPEC_AGENTIC_STACK P1 / SDK F2 (CLI rename support) — 2026-05-25]
+   * Preferred alias of `deposit()`. The CLI surface is `t2000 fund` post-Phase 1
+   * (more intuitive than "deposit" which sounds like a NAVI lending action).
+   * `deposit()` stays as the canonical method name for back-compat; it is NOT
+   * deprecated. This wrapper exists so SDK consumers can mirror CLI naming.
+   */
+  async fund() {
+    return this.deposit();
+  }
   receive(params) {
     const amount = params?.amount ?? null;
     const currency = params?.currency ?? "USDC";
@@ -23396,7 +23452,7 @@ var T2000 = class _T2000 extends import_index.default {
       this.emit("yield", {
         earned: result.dailyEarning,
         total: result.totalYieldEarned,
-        apy: result.currentApy / 100,
+        apy: result.currentApy,
         timestamp: Date.now()
       });
     }
@@ -24167,55 +24223,7 @@ function parseMoveAbort(errorStr) {
   }
   return { reason: errorStr };
 }
-init_errors();
-init_token_registry();
-async function getSwapQuote(params) {
-  const { findSwapRoute: findSwapRoute2, resolveTokenType: resolveTokenType2 } = await Promise.resolve().then(() => (init_cetus_swap(), cetus_swap_exports));
-  const fromType = resolveTokenType2(params.from);
-  const toType = resolveTokenType2(params.to);
-  if (!fromType) {
-    throw new T2000Error(
-      "ASSET_NOT_SUPPORTED",
-      `Unknown token: ${params.from}. Provide the symbol (USDC, SUI, ...) or full coin type.`
-    );
-  }
-  if (!toType) {
-    throw new T2000Error(
-      "ASSET_NOT_SUPPORTED",
-      `Unknown token: ${params.to}. Provide the symbol (USDC, SUI, ...) or full coin type.`
-    );
-  }
-  const byAmountIn = params.byAmountIn ?? true;
-  const fromDecimals = getDecimalsForCoinType(fromType);
-  const rawAmount = BigInt(Math.floor(params.amount * 10 ** fromDecimals));
-  const route = await findSwapRoute2({
-    walletAddress: params.walletAddress,
-    from: fromType,
-    to: toType,
-    amount: rawAmount,
-    byAmountIn,
-    providers: params.providers
-  });
-  if (!route) throw new T2000Error("SWAP_FAILED", `No swap route found for ${params.from} -> ${params.to}.`);
-  if (route.insufficientLiquidity) {
-    throw new T2000Error("SWAP_FAILED", `Insufficient liquidity for ${params.from} -> ${params.to}.`);
-  }
-  const toDecimals = getDecimalsForCoinType(toType);
-  const fromAmount = Number(route.amountIn) / 10 ** fromDecimals;
-  const toAmount = Number(route.amountOut) / 10 ** toDecimals;
-  const routeDesc = route.routerData.paths?.map((p) => p.provider).filter(Boolean).slice(0, 3).join(" + ") ?? "Cetus Aggregator";
-  const { serializeCetusRoute: serializeCetusRoute2 } = await Promise.resolve().then(() => (init_cetus_swap(), cetus_swap_exports));
-  const serializedRoute = serializeCetusRoute2(route, { fromCoinType: fromType, toCoinType: toType });
-  return {
-    fromToken: params.from,
-    toToken: params.to,
-    fromAmount,
-    toAmount,
-    priceImpact: route.priceImpact,
-    route: routeDesc,
-    serializedRoute
-  };
-}
+init_swap_quote();
 init_cetus_swap();
 init_token_registry();
 init_volo();
@@ -24328,6 +24336,7 @@ export {
   buildSwapTx,
   addSwapToTx,
   OVERLAY_FEE_RATE,
+  getSwapQuote,
   MIST_PER_SUI,
   SUI_DECIMALS,
   USDC_DECIMALS,
@@ -24337,6 +24346,7 @@ export {
   CLOCK_ID,
   SUPPORTED_ASSETS,
   STABLE_ASSETS,
+  SAVEABLE_ASSETS,
   ALL_NAVI_ASSETS,
   OPERATION_ASSETS,
   isAllowedAsset,
@@ -24423,7 +24433,6 @@ export {
   getFinancialSummary,
   simulateTransaction,
   throwIfSimulationFailed,
-  getSwapQuote,
   AUDRIC_PARENT_NAME,
   AUDRIC_PARENT_NFT_ID,
   validateLabel,
@@ -24455,4 +24464,4 @@ axios/dist/node/axios.cjs:
 @scure/bip39/index.js:
   (*! scure-bip39 - MIT License (c) 2022 Patricio Palladino, Paul Miller (paulmillr.com) *)
 */
-//# sourceMappingURL=chunk-R7KXQRHQ.js.map
+//# sourceMappingURL=chunk-ZH6PX6WS.js.map