@t2000/sdk 3.1.1 → 3.3.0

package/README.md

@@ -1,6 +1,6 @@
 # @t2000/sdk
 
-The complete TypeScript SDK for AI agent bank accounts on Sui. Send USDC, earn yield via NAVI, and borrow against collateral — all from a single class. USDC in, USDC out.
+The complete TypeScript SDK for Agentic Wallets on Sui. Send USDC, earn yield via NAVI, and borrow against collateral — all from a single class. USDC in, USDC out.
 
 In Audric, this SDK powers **Audric Passport** (wallet, signing), **Audric Finance** (NAVI lending/borrowing builders, Cetus swap), and **Audric Pay** (USDC transfers, payment links), and is wrapped by `@t2000/engine` to implement **Audric Intelligence**'s Agent Harness.
 
@@ -26,7 +26,7 @@ yarn add @t2000/sdk
 ```typescript
 import { T2000 } from '@t2000/sdk';
 
-// Create a new bank account
+// Create a new Agentic Wallet
 const { agent, address } = await T2000.init({ pin: 'my-secret' });
 
 // Or load an existing one
@@ -56,7 +56,7 @@ await agent.withdraw({ amount: 25 });
 
 ### `T2000.init(options)` — Create a new wallet
 
-Creates a new bank account (generates keypair, encrypts, and saves to disk). Fund the returned address with a small amount of SUI for gas (Mercuryo: https://exchange.mercuryo.io/?widget_id=89960d1a-8db7-49e5-8823-4c5e01c1cea2) plus USDC to transact.
+Creates a new Agentic Wallet (generates keypair, encrypts, and saves to disk). Fund the returned address with a small amount of SUI for gas (Mercuryo: https://exchange.mercuryo.io/?widget_id=89960d1a-8db7-49e5-8823-4c5e01c1cea2) plus USDC to transact.
 
 ```typescript
 const { agent, address } = await T2000.init({
@@ -67,7 +67,7 @@ const { agent, address } = await T2000.init({
 
 ### `T2000.create(options)` — Load an existing wallet
 
-Loads an existing bank account from an encrypted key file. Throws `WALLET_NOT_FOUND` if no wallet exists.
+Loads an existing Agentic Wallet from an encrypted key file. Throws `WALLET_NOT_FOUND` if no wallet exists.
 
 ```typescript
 const agent = await T2000.create({
@@ -99,8 +99,6 @@ const agent = T2000.fromPrivateKey('suiprivkey1q...');
 | `agent.borrow({ amount, asset? })` | Borrow **USDC or USDsui** against collateral (v0.51.0+). `asset` defaults to `'USDC'`. | `BorrowResult` |
 | `agent.repay({ amount, asset? })` | Repay outstanding **USDC or USDsui** debt (v0.51.1+). Pass `asset` to target a specific debt; omit for highest-APY repay. **Symmetry enforced:** USDsui debt is repaid with USDsui coins (and USDC with USDC). `amount` can be `'all'`. | `RepayResult` |
 | `agent.swap({ from, to, amount, slippage? })` | Swap tokens via Cetus Aggregator (20+ DEXs). User-friendly names or full coin types. | `SwapResult` |
-| `agent.stakeVSui({ amount })` | Stake SUI for vSUI via VOLO liquid staking (min 1 SUI) | `StakeVSuiResult` |
-| `agent.unstakeVSui({ amount })` | Unstake vSUI back to SUI. `amount` can be `'all'`. | `UnstakeVSuiResult` |
 | `agent.exportKey()` | Export private key (bech32 format) | `string` |
 
 ### Query Methods
@@ -309,7 +307,6 @@ t2000 uses an MCP-first integration model: NAVI MCP for reads, thin transaction
 |----------|------------|----------|
 | NAVI | MCP (reads) + thin tx builders (writes) | Lending positions, deposits, withdrawals, borrows, rewards |
 | Cetus Aggregator V3 | `@cetusprotocol/aggregator-sdk` (isolated) | Multi-DEX swap routing — overlay fee on swaps (`cetus-swap.ts`) |
-| VOLO | Thin tx builders (direct Move calls) | Stake SUI → vSUI, unstake vSUI → SUI |
 
 ## Testing
 
@@ -332,7 +329,7 @@ Fees only apply when the **Audric** consumer app calls these primitives. Audric
 | Save (deposit) | 0.10% | Free | USDC only; USDsui save is free in Audric too |
 | Borrow | 0.05% | Free | USDC only; USDsui borrow is free in Audric too |
 | Swap | 0.10% | Free | Audric passes Cetus `overlayFee`. CLI omits it. Cetus Aggregator network fees still apply both ways. |
-| Withdraw / Repay / Send / Receive / Stake / Unstake / Pay (MPP) | Free | Free | No surcharge anywhere. |
+| Withdraw / Repay / Send / Receive / Pay (MPP) | Free | Free | No surcharge anywhere. |
 
 How Audric collects fees: `prepare/route.ts` calls `addFeeTransfer(tx, paymentCoin, FEE_BPS, T2000_OVERLAY_FEE_WALLET, amount)` for save/borrow and passes `overlayFee.receiver = T2000_OVERLAY_FEE_WALLET` for swaps. Both flows produce a USDC transfer to the treasury wallet inside the same atomic Payment Intent. The t2000 server-side indexer detects the on-chain USDC inflow and records a `ProtocolFeeLedger` row — no off-chain submission is involved.
 

package/dist/adapters/index.cjs

@@ -488,7 +488,7 @@ var SUPPORTED_ASSETS = {
     displayName: "XAUM"
   }
 };
-var STABLE_ASSETS = ["USDC"];
+var SAVEABLE_ASSETS = ["USDC", "USDsui"];
 var ALL_NAVI_ASSETS = Object.keys(SUPPORTED_ASSETS);
 process.env.T2000_OVERLAY_FEE_WALLET ?? "0x5366efbf2b4fe5767fe2e78eb197aa5f5d138d88ac3333fbf3f80a1927da473a";
 process.env.T2000_API_URL ?? "https://api.t2000.ai";
@@ -536,7 +536,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;
@@ -556,7 +556,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()) {