@t2000/sdk 0.9.4 → 0.9.5

package/README.md

@@ -232,7 +232,7 @@ Every operation (send, save, borrow, repay, withdraw) routes through a 3-step ga
 
 Every transaction result includes a `gasMethod` field (`'self-funded'` | `'auto-topup'` | `'sponsored'`) indicating which strategy was used.
 
-**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.
+**Architecture:** Each protocol operation (NAVI, Suilend, Cetus, send) exposes both `buildXxxTx()` (standalone transaction) and `addXxxToTx()` (composable PTB) functions. Multi-step operations (save with auto-convert, withdraw with auto-swap, rebalance) compose multiple protocol calls into a single atomic PTB. `executeWithGas()` handles execution with the gas fallback chain. If any step within a PTB fails, the entire transaction reverts — no funds left in intermediate states.
 
 ## Configuration
 
@@ -275,7 +275,7 @@ Common error codes: `INSUFFICIENT_BALANCE` · `INVALID_ADDRESS` · `INVALID_AMOU
 ## Testing
 
 ```bash
-# Run all SDK unit tests (262 tests)
+# Run all SDK unit tests (367 tests)
 pnpm --filter @t2000/sdk test
 ```
 
@@ -291,6 +291,13 @@ pnpm --filter @t2000/sdk test
 | `send.test.ts` | Send transaction building and validation |
 | `manager.test.ts` | Gas resolution chain (self-fund, auto-topup, sponsored fallback) |
 | `autoTopUp.test.ts` | Auto-topup threshold logic and swap execution |
+| `compliance.test.ts` | Adapter contract compliance (49 checks across all adapters) |
+| `registry.test.ts` | Best rates, multi-protocol routing, quote aggregation |
+| `cetus.test.ts` | Cetus swap adapter (metadata, quotes, transaction building) |
+| `suilend.test.ts` | Suilend adapter (rates, positions, obligation lifecycle) |
+| `t2000.integration.test.ts` | End-to-end flows (save, withdraw, borrow, repay, rebalance, auto-swap) |
+| `protocolFee.test.ts` | Protocol fee calculation and collection |
+| `sentinel.test.ts` | Sentinel attack flow, listing, fee parsing |
 | `serialization.test.ts` | Transaction JSON serialization roundtrip |
 
 ## Protocol Fees
@@ -299,7 +306,7 @@ pnpm --filter @t2000/sdk test
 |-----------|-----|-------|
 | Save (deposit) | 0.10% | Protocol fee on deposit |
 | Borrow | 0.05% | Protocol fee on loan |
-| Swap | **Free** | Only standard Cetus pool fees |
+| Swap (internal) | **Free** | Cetus pool fees only; used internally by rebalance/auto-convert |
 | Withdraw | Free | |
 | Repay | Free | |
 | Send | Free | |

package/dist/adapters/index.cjs

@@ -392,7 +392,7 @@ function compoundBalance(rawBalance, currentIndex) {
   const result = (rawBalance * BigInt(currentIndex) + half) / scale;
   return Number(result) / 10 ** NAVI_BALANCE_DECIMALS;
 }
-async function getUserState(client, address) {
+async function getUserState(client, address, includeZero = false) {
   const config = await getConfig();
   const tx = new transactions.Transaction();
   tx.moveCall({
@@ -405,11 +405,13 @@ async function getUserState(client, address) {
   });
   const decoded = decodeDevInspect(result, bcs.bcs.vector(UserStateInfo));
   if (!decoded) return [];
-  return decoded.map((s) => ({
+  const mapped = decoded.map((s) => ({
     assetId: s.asset_id,
     supplyBalance: toBigInt(s.supply_balance),
     borrowBalance: toBigInt(s.borrow_balance)
-  })).filter((s) => s.supplyBalance !== 0n || s.borrowBalance !== 0n);
+  }));
+  if (includeZero) return mapped;
+  return mapped.filter((s) => s.supplyBalance !== 0n || s.borrowBalance !== 0n);
 }
 async function fetchCoins(client, owner, coinType) {
   const all = [];
@@ -466,20 +468,20 @@ async function buildSaveTx(client, address, amount, options = {}) {
 async function buildWithdrawTx(client, address, amount, options = {}) {
   const asset = options.asset ?? "USDC";
   const assetInfo = SUPPORTED_ASSETS[asset];
-  const [config, pool, pools, states] = await Promise.all([
+  const [config, pool, pools, allStates] = await Promise.all([
     getConfig(),
     getPool(asset),
     getPools(),
-    getUserState(client, address)
+    getUserState(client, address, true)
   ]);
-  const assetState = states.find((s) => s.assetId === pool.id);
+  const assetState = allStates.find((s) => s.assetId === pool.id);
   const deposited = assetState ? compoundBalance(assetState.supplyBalance, pool.currentSupplyIndex) : 0;
   const effectiveAmount = Math.min(amount, Math.max(0, deposited - WITHDRAW_DUST_BUFFER));
   if (effectiveAmount <= 0) throw new T2000Error("NO_COLLATERAL", `Nothing to withdraw for ${assetInfo.displayName} on NAVI`);
   const rawAmount = Number(stableToRaw(effectiveAmount, assetInfo.decimals));
   const tx = new transactions.Transaction();
   tx.setSender(address);
-  addOracleUpdatesForPositions(tx, config, pools, states, pool);
+  addOracleUpdatesForPositions(tx, config, pools, allStates, pool);
   const [balance] = tx.moveCall({
     target: `${config.package}::incentive_v3::withdraw_v2`,
     arguments: [
@@ -506,18 +508,18 @@ async function buildWithdrawTx(client, address, amount, options = {}) {
 async function addWithdrawToTx(tx, client, address, amount, options = {}) {
   const asset = options.asset ?? "USDC";
   const assetInfo = SUPPORTED_ASSETS[asset];
-  const [config, pool, pools, states] = await Promise.all([
+  const [config, pool, pools, allStates] = await Promise.all([
     getConfig(),
     getPool(asset),
     getPools(),
-    getUserState(client, address)
+    getUserState(client, address, true)
   ]);
-  const assetState = states.find((s) => s.assetId === pool.id);
+  const assetState = allStates.find((s) => s.assetId === pool.id);
   const deposited = assetState ? compoundBalance(assetState.supplyBalance, pool.currentSupplyIndex) : 0;
   const effectiveAmount = Math.min(amount, Math.max(0, deposited - WITHDRAW_DUST_BUFFER));
   if (effectiveAmount <= 0) throw new T2000Error("NO_COLLATERAL", `Nothing to withdraw for ${assetInfo.displayName} on NAVI`);
   const rawAmount = Number(stableToRaw(effectiveAmount, assetInfo.decimals));
-  addOracleUpdatesForPositions(tx, config, pools, states, pool);
+  addOracleUpdatesForPositions(tx, config, pools, allStates, pool);
   const [balance] = tx.moveCall({
     target: `${config.package}::incentive_v3::withdraw_v2`,
     arguments: [
@@ -598,15 +600,15 @@ async function buildBorrowTx(client, address, amount, options = {}) {
   const asset = options.asset ?? "USDC";
   const assetInfo = SUPPORTED_ASSETS[asset];
   const rawAmount = Number(stableToRaw(amount, assetInfo.decimals));
-  const [config, pool, pools, states] = await Promise.all([
+  const [config, pool, pools, allStates] = await Promise.all([
     getConfig(),
     getPool(asset),
     getPools(),
-    getUserState(client, address)
+    getUserState(client, address, true)
   ]);
   const tx = new transactions.Transaction();
   tx.setSender(address);
-  addOracleUpdatesForPositions(tx, config, pools, states, pool);
+  addOracleUpdatesForPositions(tx, config, pools, allStates, pool);
   const [balance] = tx.moveCall({
     target: `${config.package}::incentive_v3::borrow_v2`,
     arguments: [