@t2000/sdk 0.6.2 → 0.7.1

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 Protocol, swap on Cetus DEX, borrow against collateral — all from a single class.
+The complete TypeScript SDK for AI agent bank accounts on Sui. Send USDC, earn yield via NAVI + Suilend, swap on Cetus DEX, borrow against collateral — all from a single class.
 
 [![npm](https://img.shields.io/npm/v/@t2000/sdk)](https://www.npmjs.com/package/@t2000/sdk)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
@@ -37,7 +37,7 @@ console.log(`$${balance.available} USDC available`);
 // Send USDC
 await agent.send({ to: '0x...', amount: 10 });
 
-// Save (earn yield via NAVI Protocol)
+// Save (earn yield — auto-selects best rate across NAVI + Suilend)
 await agent.save({ amount: 50, asset: 'USDC' });
 
 // Swap USDC → SUI (via Cetus DEX)
@@ -89,7 +89,7 @@ const agent = T2000.fromPrivateKey('suiprivkey1q...');
 | `agent.address()` | Wallet Sui address | `string` |
 | `agent.balance()` | Available USDC + savings + gas reserve | `BalanceResponse` |
 | `agent.send({ to, amount, asset? })` | Transfer USDC to any Sui address | `SendResult` |
-| `agent.save({ amount, asset })` | Deposit USDC to NAVI Protocol (earn APY). `amount` can be `'all'`. | `SaveResult` |
+| `agent.save({ amount, asset, protocol? })` | Deposit USDC to savings (earn APY). Auto-selects best rate or specify `protocol`. `amount` can be `'all'`. | `SaveResult` |
 | `agent.withdraw({ amount, asset })` | Withdraw USDC from savings. `amount` can be `'all'`. | `WithdrawResult` |
 | `agent.swap({ from, to, amount, maxSlippage? })` | Swap via Cetus CLMM DEX. `maxSlippage` in % (default: 3). | `SwapResult` |
 | `agent.swapQuote({ from, to, amount })` | Get swap quote without executing | `SwapQuote` |
@@ -103,7 +103,7 @@ const agent = T2000.fromPrivateKey('suiprivkey1q...');
 |--------|-------------|---------|
 | `agent.healthFactor()` | Lending health factor | `HealthFactorResult` |
 | `agent.earnings()` | Yield earned to date | `EarningsResult` |
-| `agent.rates()` | Current save/borrow APYs | `RatesResult` |
+| `agent.rates()` | Best save/borrow APYs across protocols | `RatesResult` |
 | `agent.positions()` | All open DeFi positions | `PositionsResult` |
 | `agent.fundStatus()` | Complete savings summary | `FundStatusResult` |
 | `agent.maxWithdraw()` | Max safe withdrawal amount | `MaxWithdrawResult` |
@@ -227,7 +227,7 @@ Every operation (send, save, borrow, repay, withdraw, swap) routes through a 3-s
 
 Every transaction result includes a `gasMethod` field (`'self-funded'` | `'auto-topup'` | `'sponsored'`) indicating which strategy was used.
 
-**Architecture:** Each protocol operation (NAVI, Cetus, send) exposes a `buildXxxTx()` function that returns a `Transaction` without executing it. `executeWithGas()` then handles execution with the fallback chain. This separation ensures gas management is consistent across all operations.
+**Architecture:** Each protocol operation (NAVI, Suilend, Cetus, send) exposes a `buildXxxTx()` function that returns a `Transaction` without executing it. `executeWithGas()` then handles execution with the fallback chain. This separation ensures gas management is consistent across all operations.
 
 ## Configuration
 
@@ -264,7 +264,7 @@ Common error codes: `INSUFFICIENT_BALANCE` · `INVALID_ADDRESS` · `INVALID_AMOU
 ## Testing
 
 ```bash
-# Run all SDK unit tests (122 tests)
+# Run all SDK unit tests (262 tests)
 pnpm --filter @t2000/sdk test
 ```
 

package/dist/adapters/index.cjs

@@ -150,6 +150,9 @@ var T2000_CONFIG_ID = process.env.T2000_CONFIG_ID ?? "0x408add9aa9322f93cfd87523
 var T2000_TREASURY_ID = process.env.T2000_TREASURY_ID ?? "0x3bb501b8300125dca59019247941a42af6b292a150ce3cfcce9449456be2ec91";
 process.env.T2000_API_URL ?? "https://api.t2000.ai";
 var CETUS_USDC_SUI_POOL = "0x51e883ba7c0b566a26cbc8a94cd33eb0abd418a77cc1e60ad22fd9b1f29cd2ab";
+var CETUS_PACKAGE = "0x1eabed72c53feb3805120a081dc15963c204dc8d091542592abaf7a35689b2fb";
+var SENTINEL = {
+  PACKAGE: "0x88b83f36dafcd5f6dcdcf1d2cb5889b03f61264ab3cee9cae35db7aa940a21b7"};
 
 // src/utils/format.ts
 function usdcToRaw(amount) {
@@ -586,6 +589,22 @@ async function maxBorrowAmount(client, addressOrKeypair) {
 }
 
 // src/adapters/navi.ts
+var descriptor = {
+  id: "navi",
+  name: "NAVI Protocol",
+  packages: [],
+  dynamicPackageId: true,
+  actionMap: {
+    "incentive_v3::entry_deposit": "save",
+    "incentive_v3::deposit": "save",
+    "incentive_v3::withdraw_v2": "withdraw",
+    "incentive_v3::entry_withdraw": "withdraw",
+    "incentive_v3::borrow_v2": "borrow",
+    "incentive_v3::entry_borrow": "borrow",
+    "incentive_v3::entry_repay": "repay",
+    "incentive_v3::repay": "repay"
+  }
+};
 var NaviAdapter = class {
   id = "navi";
   name = "NAVI Protocol";
@@ -730,6 +749,18 @@ function fallbackQuote(fromAsset, amount, poolPrice) {
 }
 
 // src/adapters/cetus.ts
+var descriptor2 = {
+  id: "cetus",
+  name: "Cetus DEX",
+  packages: [CETUS_PACKAGE],
+  actionMap: {
+    "router::swap": "swap",
+    "router::swap_ab_bc": "swap",
+    "router::swap_ab_cb": "swap",
+    "router::swap_ba_bc": "swap",
+    "router::swap_ba_cb": "swap"
+  }
+};
 var CetusAdapter = class {
   id = "cetus";
   name = "Cetus";
@@ -783,7 +814,21 @@ var LENDING_MARKET_ID = "0x84030d26d85eaa7035084a057f2f11f701b7e2e4eda87551becbc
 var LENDING_MARKET_TYPE = "0xf95b06141ed4a174f239417323bde3f209b972f5930d8521ea38a52aff3a6ddf::suilend::MAIN_POOL";
 var SUILEND_PACKAGE = "0xf95b06141ed4a174f239417323bde3f209b972f5930d8521ea38a52aff3a6ddf";
 var UPGRADE_CAP_ID = "0x3d4ef1859c3ee9fc72858f588b56a09da5466e64f8cc4e90a7b3b909fba8a7ae";
-var FALLBACK_PUBLISHED_AT = "0xd2a67633ccb8de063163e25bcfca242929caf5cf1a26c2929dab519ee0b8f331";
+var FALLBACK_PUBLISHED_AT = "0x3d4353f3bd3565329655e6b77bc2abfd31e558b86662ebd078ae453d416bc10f";
+var descriptor3 = {
+  id: "suilend",
+  name: "Suilend",
+  packages: [SUILEND_PACKAGE],
+  actionMap: {
+    "lending_market::deposit_liquidity_and_mint_ctokens": "save",
+    "lending_market::deposit_ctokens_into_obligation": "save",
+    "lending_market::create_obligation": "save",
+    "lending_market::withdraw_ctokens": "withdraw",
+    "lending_market::redeem_ctokens_and_withdraw_liquidity": "withdraw",
+    "lending_market::borrow": "borrow",
+    "lending_market::repay": "repay"
+  }
+};
 function interpolateRate(utilBreakpoints, aprBreakpoints, utilizationPct) {
   if (utilBreakpoints.length === 0) return 0;
   if (utilizationPct <= utilBreakpoints[0]) return aprBreakpoints[0];
@@ -1161,10 +1206,32 @@ var SuilendAdapter = class {
     return all;
   }
 };
+var descriptor4 = {
+  id: "sentinel",
+  name: "Sui Sentinel",
+  packages: [SENTINEL.PACKAGE],
+  actionMap: {
+    "sentinel::request_attack": "sentinel_attack",
+    "sentinel::consume_prompt": "sentinel_settle"
+  }
+};
+
+// src/adapters/index.ts
+var allDescriptors = [
+  descriptor,
+  descriptor3,
+  descriptor2,
+  descriptor4
+];
 
 exports.CetusAdapter = CetusAdapter;
 exports.NaviAdapter = NaviAdapter;
 exports.ProtocolRegistry = ProtocolRegistry;
 exports.SuilendAdapter = SuilendAdapter;
+exports.allDescriptors = allDescriptors;
+exports.cetusDescriptor = descriptor2;
+exports.naviDescriptor = descriptor;
+exports.sentinelDescriptor = descriptor4;
+exports.suilendDescriptor = descriptor3;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map