@t2000/sdk 0.6.0 → 0.7.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 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

@@ -5,6 +5,28 @@ var bcs = require('@mysten/sui/bcs');
 var aggregatorSdk = require('@cetusprotocol/aggregator-sdk');
 var utils = require('@mysten/sui/utils');
 
+// src/errors.ts
+var T2000Error = class extends Error {
+  code;
+  data;
+  retryable;
+  constructor(code, message, data, retryable = false) {
+    super(message);
+    this.name = "T2000Error";
+    this.code = code;
+    this.data = data;
+    this.retryable = retryable;
+  }
+  toJSON() {
+    return {
+      error: this.code,
+      message: this.message,
+      ...this.data && { data: this.data },
+      retryable: this.retryable
+    };
+  }
+};
+
 // src/adapters/registry.ts
 var ProtocolRegistry = class {
   lending = /* @__PURE__ */ new Map();
@@ -27,7 +49,7 @@ var ProtocolRegistry = class {
       }
     }
     if (candidates.length === 0) {
-      throw new Error(`No lending adapter supports saving ${asset}`);
+      throw new T2000Error("ASSET_NOT_SUPPORTED", `No lending adapter supports saving ${asset}`);
     }
     candidates.sort((a, b) => b.rate.saveApy - a.rate.saveApy);
     return candidates[0];
@@ -45,7 +67,7 @@ var ProtocolRegistry = class {
       }
     }
     if (candidates.length === 0) {
-      throw new Error(`No lending adapter supports borrowing ${asset}`);
+      throw new T2000Error("ASSET_NOT_SUPPORTED", `No lending adapter supports borrowing ${asset}`);
     }
     candidates.sort((a, b) => a.rate.borrowApy - b.rate.borrowApy);
     return candidates[0];
@@ -62,7 +84,7 @@ var ProtocolRegistry = class {
       }
     }
     if (candidates.length === 0) {
-      throw new Error(`No swap adapter supports ${from} \u2192 ${to}`);
+      throw new T2000Error("ASSET_NOT_SUPPORTED", `No swap adapter supports ${from} \u2192 ${to}`);
     }
     candidates.sort((a, b) => b.quote.expectedOutput - a.quote.expectedOutput);
     return candidates[0];
@@ -128,28 +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";
-
-// src/errors.ts
-var T2000Error = class extends Error {
-  code;
-  data;
-  retryable;
-  constructor(code, message, data, retryable = false) {
-    super(message);
-    this.name = "T2000Error";
-    this.code = code;
-    this.data = data;
-    this.retryable = retryable;
-  }
-  toJSON() {
-    return {
-      error: this.code,
-      message: this.message,
-      ...this.data && { data: this.data },
-      retryable: this.retryable
-    };
-  }
-};
+var CETUS_PACKAGE = "0x1eabed72c53feb3805120a081dc15963c204dc8d091542592abaf7a35689b2fb";
+var SENTINEL = {
+  PACKAGE: "0x88b83f36dafcd5f6dcdcf1d2cb5889b03f61264ab3cee9cae35db7aa940a21b7"};
 
 // src/utils/format.ts
 function usdcToRaw(amount) {
@@ -252,6 +255,24 @@ async function getUsdcPool() {
   if (!usdc) throw new T2000Error("PROTOCOL_UNAVAILABLE", "USDC pool not found on NAVI");
   return usdc;
 }
+function addOracleUpdate(tx, config, pool) {
+  const feed = config.oracle.feeds?.find((f2) => f2.assetId === pool.id);
+  if (!feed) {
+    throw new T2000Error("PROTOCOL_UNAVAILABLE", `Oracle feed not found for asset ${pool.token?.symbol ?? pool.id}`);
+  }
+  tx.moveCall({
+    target: `${config.oracle.packageId}::oracle_pro::update_single_price_v2`,
+    arguments: [
+      tx.object(CLOCK),
+      tx.object(config.oracle.oracleConfig),
+      tx.object(config.oracle.priceOracle),
+      tx.object(config.oracle.supraOracleHolder),
+      tx.object(feed.pythPriceInfoObject),
+      tx.object(config.oracle.switchboardAggregator),
+      tx.pure.address(feed.feedId)
+    ]
+  });
+}
 function rateToApy(rawRate) {
   if (!rawRate || rawRate === "0") return 0;
   return Number(BigInt(rawRate)) / 10 ** RATE_DECIMALS * 100;
@@ -274,7 +295,7 @@ function compoundBalance(rawBalance, currentIndex) {
   if (!rawBalance || !currentIndex || currentIndex === "0") return 0;
   const scale = BigInt("1" + "0".repeat(RATE_DECIMALS));
   const half = scale / 2n;
-  const result = (rawBalance * scale + half) / BigInt(currentIndex);
+  const result = (rawBalance * BigInt(currentIndex) + half) / scale;
   return Number(result) / 10 ** NAVI_BALANCE_DECIMALS;
 }
 async function getUserState(client, address) {
@@ -317,6 +338,9 @@ function mergeCoins(tx, coins) {
   return primary;
 }
 async function buildSaveTx(client, address, amount, options = {}) {
+  if (!amount || amount <= 0 || !Number.isFinite(amount)) {
+    throw new T2000Error("INVALID_AMOUNT", "Save amount must be a positive number");
+  }
   const rawAmount = Number(usdcToRaw(amount));
   const [config, pool] = await Promise.all([getConfig(), getUsdcPool()]);
   const coins = await fetchCoins(client, address, USDC_TYPE);
@@ -357,6 +381,7 @@ async function buildWithdrawTx(client, address, amount) {
   const rawAmount = Number(usdcToRaw(effectiveAmount));
   const tx = new transactions.Transaction();
   tx.setSender(address);
+  addOracleUpdate(tx, config, pool);
   const [balance] = tx.moveCall({
     target: `${config.package}::incentive_v3::withdraw_v2`,
     arguments: [
@@ -381,10 +406,14 @@ async function buildWithdrawTx(client, address, amount) {
   return { tx, effectiveAmount };
 }
 async function buildBorrowTx(client, address, amount, options = {}) {
+  if (!amount || amount <= 0 || !Number.isFinite(amount)) {
+    throw new T2000Error("INVALID_AMOUNT", "Borrow amount must be a positive number");
+  }
   const rawAmount = Number(usdcToRaw(amount));
   const [config, pool] = await Promise.all([getConfig(), getUsdcPool()]);
   const tx = new transactions.Transaction();
   tx.setSender(address);
+  addOracleUpdate(tx, config, pool);
   const [balance] = tx.moveCall({
     target: `${config.package}::incentive_v3::borrow_v2`,
     arguments: [
@@ -405,16 +434,23 @@ async function buildBorrowTx(client, address, amount, options = {}) {
     arguments: [balance],
     typeArguments: [pool.suiCoinType]
   });
+  if (options.collectFee) {
+    addCollectFeeToTx(tx, borrowedCoin, "borrow");
+  }
   tx.transferObjects([borrowedCoin], address);
   return tx;
 }
 async function buildRepayTx(client, address, amount) {
+  if (!amount || amount <= 0 || !Number.isFinite(amount)) {
+    throw new T2000Error("INVALID_AMOUNT", "Repay amount must be a positive number");
+  }
   const rawAmount = Number(usdcToRaw(amount));
   const [config, pool] = await Promise.all([getConfig(), getUsdcPool()]);
   const coins = await fetchCoins(client, address, USDC_TYPE);
   if (coins.length === 0) throw new T2000Error("INSUFFICIENT_BALANCE", "No USDC coins to repay with");
   const tx = new transactions.Transaction();
   tx.setSender(address);
+  addOracleUpdate(tx, config, pool);
   const coinObj = mergeCoins(tx, coins);
   tx.moveCall({
     target: `${config.package}::incentive_v3::entry_repay`,
@@ -553,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";
@@ -571,7 +623,7 @@ var NaviAdapter = class {
     const rates = await getRates(this.client);
     const key = asset.toUpperCase();
     const r = rates[key];
-    if (!r) throw new Error(`NAVI does not support ${asset}`);
+    if (!r) throw new T2000Error("ASSET_NOT_SUPPORTED", `NAVI does not support ${asset}`);
     return { asset, saveApy: r.saveApy, borrowApy: r.borrowApy };
   }
   async getPositions(address) {
@@ -697,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";
@@ -751,6 +815,20 @@ var LENDING_MARKET_TYPE = "0xf95b06141ed4a174f239417323bde3f209b972f5930d8521ea3
 var SUILEND_PACKAGE = "0xf95b06141ed4a174f239417323bde3f209b972f5930d8521ea38a52aff3a6ddf";
 var UPGRADE_CAP_ID = "0x3d4ef1859c3ee9fc72858f588b56a09da5466e64f8cc4e90a7b3b909fba8a7ae";
 var FALLBACK_PUBLISHED_AT = "0xd2a67633ccb8de063163e25bcfca242929caf5cf1a26c2929dab519ee0b8f331";
+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];
@@ -1128,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