@t2000/sdk 0.51.0 → 0.52.0

package/README.md

@@ -92,10 +92,10 @@ const agent = T2000.fromPrivateKey('suiprivkey1q...');
 | `agent.balance()` | Available USDC + savings + gas reserve | `BalanceResponse` |
 | `agent.send({ to, amount, asset? })` | Transfer USDC to any Sui address | `SendResult` |
 | `agent.receive({ amount?, currency?, memo?, label? })` | Generate payment request with Payment Kit URI (`sui:pay?...`), nonce for duplicate prevention | `PaymentRequest` |
-| `agent.save({ amount, protocol? })` | Deposit **USDC** to savings (earn APY). Auto-selects best rate or specify `protocol`. `amount` can be `'all'`. | `SaveResult` |
-| `agent.withdraw({ amount, asset? })` | Withdraw from savings. `amount` can be `'all'`. Optional `asset` for multi-asset withdrawals (default: USDC). | `WithdrawResult` |
-| `agent.borrow({ amount })` | Borrow USDC against collateral | `BorrowResult` |
-| `agent.repay({ amount })` | Repay outstanding debt in USDC. `amount` can be `'all'`. | `RepayResult` |
+| `agent.save({ amount, asset?, protocol? })` | Deposit **USDC or USDsui** to NAVI savings (v0.51.0+). `asset` defaults to `'USDC'`. Auto-selects best rate or specify `protocol`. `amount` can be `'all'`. | `SaveResult` |
+| `agent.withdraw({ amount, asset? })` | Withdraw from savings. `amount` can be `'all'`. Optional `asset` (default: USDC; also supports USDsui plus legacy USDe / SUI). | `WithdrawResult` |
+| `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` |
@@ -263,11 +263,11 @@ Options like `pin`, `keyPath`, and `rpcUrl` are passed directly to `T2000.create
 
 Token metadata and **tiers** live in `token-registry.ts` (`COIN_REGISTRY`). **17 tokens** total:
 
-- **Tier 1:** USDC — save, borrow, send, swap.
+- **Tier 1 (saveable / borrowable):** USDC, USDsui — save, borrow, send, swap. USDsui is a strategic exception (v0.51.0+) because NAVI runs a separate USDsui pool that often quotes a different APY than USDC. Repay symmetry is enforced (USDsui debt → USDsui repay).
 - **Tier 2 (15):** SUI, wBTC, ETH, GOLD, DEEP, WAL, NS, IKA, CETUS, NAVX, vSUI, haSUI, afSUI, LOFI, MANIFEST — send and swap only (not for new save/borrow deposits).
 - **Legacy (no tier):** USDT, USDe, USDSUI — display and withdraw of existing positions; still send/swap where applicable.
 
-Six tokens were removed from the registry (FDUSD, AUSD, BUCK, BLUB, SCA, TURBOS). **`STABLE_ASSETS`** is `['USDC']` only.
+Six tokens were removed from the registry (FDUSD, AUSD, BUCK, BLUB, SCA, TURBOS). `STABLE_ASSETS = ['USDC']` (the canonical USD unit for balance aggregation), but **`OPERATION_ASSETS.save` and `OPERATION_ASSETS.borrow` accept both `'USDC'` and `'USDsui'`** (v0.51.0+). Use `isAllowedAsset(op, asset)` / `assertAllowedAsset(op, asset)` to validate.
 
 ```typescript
 import {

package/dist/adapters/index.d.cts

@@ -1,6 +1,6 @@
 import { L as LendingAdapter, a as LendingRates, b as AdapterPositions, A as AdapterCapability, H as HealthInfo, c as AdapterTxResult, P as PendingReward } from '../descriptors-DkKhitk_.cjs';
 export { d as ProtocolDescriptor, e as allDescriptors, n as naviDescriptor } from '../descriptors-DkKhitk_.cjs';
-import { c as MaxWithdrawResult, M as MaxBorrowResult } from '../types-DlNEW8w1.cjs';
+import { c as MaxWithdrawResult, M as MaxBorrowResult } from '../types-DVVns7_w.cjs';
 import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
 

package/dist/adapters/index.d.ts

@@ -1,6 +1,6 @@
 import { L as LendingAdapter, a as LendingRates, b as AdapterPositions, A as AdapterCapability, H as HealthInfo, c as AdapterTxResult, P as PendingReward } from '../descriptors-DkKhitk_.js';
 export { d as ProtocolDescriptor, e as allDescriptors, n as naviDescriptor } from '../descriptors-DkKhitk_.js';
-import { c as MaxWithdrawResult, M as MaxBorrowResult } from '../types-DlNEW8w1.js';
+import { c as MaxWithdrawResult, M as MaxBorrowResult } from '../types-DVVns7_w.js';
 import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
 

package/dist/browser.d.cts

@@ -1,5 +1,5 @@
-export { A as ALL_NAVI_ASSETS, a as AutoTopUpResult, B as BPS_DENOMINATOR, C as CLOCK_ID, b as COIN_REGISTRY, c as ClassifyBalanceChange, d as ClassifyResult, e as CoinMeta, D as DEFAULT_NETWORK, f as DEFAULT_SAFEGUARD_CONFIG, E as ETH_TYPE, g as ExtractedTransfer, F as FeeOperation, G as GAS_RESERVE_MIN, h as GasExecutionResult, i as GasRequestType, j as GasSponsorResponse, k as GasStatusResponse, I as IKA_TYPE, K as KNOWN_TARGETS, l as KeypairSigner, L as LABEL_PATTERNS, m as LOFI_TYPE, M as MANIFEST_TYPE, n as MIST_PER_SUI, N as NAVX_TYPE, O as OUTBOUND_OPS, P as ProtocolFeeInfo, S as STABLE_ASSETS, o as SUI_DECIMALS, p as SUI_TYPE, q as SUPPORTED_ASSETS, r as SafeguardConfig, s as SafeguardError, t as SafeguardErrorDetails, u as SafeguardRule, v as SimulationResult, w as StableAsset, x as SuiRpcTxBlock, y as SupportedAsset, T as T2000Error, z as T2000ErrorCode, H as T2000ErrorData, J as TOKEN_MAP, Q as TransactionSigner, R as TxDirection, U as TxMetadata, V as USDC_DECIMALS, W as USDC_TYPE, X as USDE_TYPE, Y as USDSUI_TYPE, Z as USDT_TYPE, _ as WAL_TYPE, $ as WBTC_TYPE, a0 as ZkLoginProof, a1 as ZkLoginSigner, a2 as addCollectFeeToTx, a3 as calculateFee, a4 as classifyAction, a5 as classifyLabel, a6 as classifyTransaction, a7 as executeAutoTopUp, a8 as executeWithGas, a9 as extractTransferDetails, aa as extractTxCommands, ab as extractTxSender, ac as fallbackLabel, ad as formatAssetAmount, ae as formatSui, af as formatUsd, ag as getDecimals, ah as getDecimalsForCoinType, ai as getGasStatus, aj as getTier, ak as isSupported, al as isTier1, am as isTier2, an as mapMoveAbortCode, ao as mapWalletError, ap as mistToSui, aq as parseSuiRpcTx, ar as rawToStable, as as rawToUsdc, at as refineLendingLabel, au as resolveSymbol, av as resolveTokenType, aw as shouldAutoTopUp, ax as stableToRaw, ay as suiToMist, az as truncateAddress, aA as usdcToRaw, aB as validateAddress } from './token-registry-D-j_Rg4S.cjs';
-export { A as AssetRates, B as BalanceResponse, a as BorrowResult, C as ClaimRewardsResult, D as DepositInfo, E as EarningsResult, F as FundStatusResult, G as GasMethod, b as GasReserve, H as HealthFactorResult, M as MaxBorrowResult, c as MaxWithdrawResult, P as PayOptions, d as PayResult, e as PendingReward, f as PositionEntry, g as PositionsResult, R as RatesResult, h as RepayResult, S as SaveResult, i as SendResult, T as TransactionRecord, W as WithdrawResult } from './types-DlNEW8w1.cjs';
+export { A as ALL_NAVI_ASSETS, a as AutoTopUpResult, B as BPS_DENOMINATOR, C as CLOCK_ID, b as COIN_REGISTRY, c as ClassifyBalanceChange, d as ClassifyResult, e as CoinMeta, D as DEFAULT_NETWORK, f as DEFAULT_SAFEGUARD_CONFIG, E as ETH_TYPE, g as ExtractedTransfer, F as FeeOperation, G as GAS_RESERVE_MIN, h as GasExecutionResult, i as GasRequestType, j as GasSponsorResponse, k as GasStatusResponse, I as IKA_TYPE, K as KNOWN_TARGETS, l as KeypairSigner, L as LABEL_PATTERNS, m as LOFI_TYPE, M as MANIFEST_TYPE, n as MIST_PER_SUI, N as NAVX_TYPE, O as OUTBOUND_OPS, P as ProtocolFeeInfo, S as STABLE_ASSETS, o as SUI_DECIMALS, p as SUI_TYPE, q as SUPPORTED_ASSETS, r as SafeguardConfig, s as SafeguardError, t as SafeguardErrorDetails, u as SafeguardRule, v as SimulationResult, w as StableAsset, x as SuiRpcTxBlock, y as SupportedAsset, T as T2000Error, z as T2000ErrorCode, H as T2000ErrorData, J as TOKEN_MAP, Q as TransactionSigner, R as TxDirection, U as TxMetadata, V as USDC_DECIMALS, W as USDC_TYPE, X as USDE_TYPE, Y as USDSUI_TYPE, Z as USDT_TYPE, _ as WAL_TYPE, $ as WBTC_TYPE, a0 as ZkLoginProof, a1 as ZkLoginSigner, a2 as addCollectFeeToTx, a3 as calculateFee, a4 as classifyAction, a5 as classifyLabel, a6 as classifyTransaction, a7 as executeAutoTopUp, a8 as executeWithGas, a9 as extractTransferDetails, aa as extractTxCommands, ab as extractTxSender, ac as fallbackLabel, ad as formatAssetAmount, ae as formatSui, af as formatUsd, ag as getDecimals, ah as getDecimalsForCoinType, ai as getGasStatus, aj as getTier, ak as isSupported, al as isTier1, am as isTier2, an as mapMoveAbortCode, ao as mapWalletError, ap as mistToSui, aq as parseSuiRpcTx, ar as rawToStable, as as rawToUsdc, at as refineLendingLabel, au as resolveSymbol, av as resolveTokenType, aw as shouldAutoTopUp, ax as stableToRaw, ay as suiToMist, az as truncateAddress, aA as usdcToRaw, aB as validateAddress } from './token-registry-DWRdYf6m.cjs';
+export { A as AssetRates, B as BalanceResponse, a as BorrowResult, C as ClaimRewardsResult, D as DepositInfo, E as EarningsResult, F as FundStatusResult, G as GasMethod, b as GasReserve, H as HealthFactorResult, M as MaxBorrowResult, c as MaxWithdrawResult, P as PayOptions, d as PayResult, e as PendingReward, f as PositionEntry, g as PositionsResult, R as RatesResult, h as RepayResult, S as SaveResult, i as SendResult, T as TransactionRecord, W as WithdrawResult } from './types-DVVns7_w.cjs';
 import '@mysten/sui/keypairs/ed25519';
 import '@mysten/sui/jsonRpc';
 import '@mysten/sui/transactions';

package/dist/browser.d.ts

@@ -1,5 +1,5 @@
-export { A as ALL_NAVI_ASSETS, a as AutoTopUpResult, B as BPS_DENOMINATOR, C as CLOCK_ID, b as COIN_REGISTRY, c as ClassifyBalanceChange, d as ClassifyResult, e as CoinMeta, D as DEFAULT_NETWORK, f as DEFAULT_SAFEGUARD_CONFIG, E as ETH_TYPE, g as ExtractedTransfer, F as FeeOperation, G as GAS_RESERVE_MIN, h as GasExecutionResult, i as GasRequestType, j as GasSponsorResponse, k as GasStatusResponse, I as IKA_TYPE, K as KNOWN_TARGETS, l as KeypairSigner, L as LABEL_PATTERNS, m as LOFI_TYPE, M as MANIFEST_TYPE, n as MIST_PER_SUI, N as NAVX_TYPE, O as OUTBOUND_OPS, P as ProtocolFeeInfo, S as STABLE_ASSETS, o as SUI_DECIMALS, p as SUI_TYPE, q as SUPPORTED_ASSETS, r as SafeguardConfig, s as SafeguardError, t as SafeguardErrorDetails, u as SafeguardRule, v as SimulationResult, w as StableAsset, x as SuiRpcTxBlock, y as SupportedAsset, T as T2000Error, z as T2000ErrorCode, H as T2000ErrorData, J as TOKEN_MAP, Q as TransactionSigner, R as TxDirection, U as TxMetadata, V as USDC_DECIMALS, W as USDC_TYPE, X as USDE_TYPE, Y as USDSUI_TYPE, Z as USDT_TYPE, _ as WAL_TYPE, $ as WBTC_TYPE, a0 as ZkLoginProof, a1 as ZkLoginSigner, a2 as addCollectFeeToTx, a3 as calculateFee, a4 as classifyAction, a5 as classifyLabel, a6 as classifyTransaction, a7 as executeAutoTopUp, a8 as executeWithGas, a9 as extractTransferDetails, aa as extractTxCommands, ab as extractTxSender, ac as fallbackLabel, ad as formatAssetAmount, ae as formatSui, af as formatUsd, ag as getDecimals, ah as getDecimalsForCoinType, ai as getGasStatus, aj as getTier, ak as isSupported, al as isTier1, am as isTier2, an as mapMoveAbortCode, ao as mapWalletError, ap as mistToSui, aq as parseSuiRpcTx, ar as rawToStable, as as rawToUsdc, at as refineLendingLabel, au as resolveSymbol, av as resolveTokenType, aw as shouldAutoTopUp, ax as stableToRaw, ay as suiToMist, az as truncateAddress, aA as usdcToRaw, aB as validateAddress } from './token-registry-okyiJNWM.js';
-export { A as AssetRates, B as BalanceResponse, a as BorrowResult, C as ClaimRewardsResult, D as DepositInfo, E as EarningsResult, F as FundStatusResult, G as GasMethod, b as GasReserve, H as HealthFactorResult, M as MaxBorrowResult, c as MaxWithdrawResult, P as PayOptions, d as PayResult, e as PendingReward, f as PositionEntry, g as PositionsResult, R as RatesResult, h as RepayResult, S as SaveResult, i as SendResult, T as TransactionRecord, W as WithdrawResult } from './types-DlNEW8w1.js';
+export { A as ALL_NAVI_ASSETS, a as AutoTopUpResult, B as BPS_DENOMINATOR, C as CLOCK_ID, b as COIN_REGISTRY, c as ClassifyBalanceChange, d as ClassifyResult, e as CoinMeta, D as DEFAULT_NETWORK, f as DEFAULT_SAFEGUARD_CONFIG, E as ETH_TYPE, g as ExtractedTransfer, F as FeeOperation, G as GAS_RESERVE_MIN, h as GasExecutionResult, i as GasRequestType, j as GasSponsorResponse, k as GasStatusResponse, I as IKA_TYPE, K as KNOWN_TARGETS, l as KeypairSigner, L as LABEL_PATTERNS, m as LOFI_TYPE, M as MANIFEST_TYPE, n as MIST_PER_SUI, N as NAVX_TYPE, O as OUTBOUND_OPS, P as ProtocolFeeInfo, S as STABLE_ASSETS, o as SUI_DECIMALS, p as SUI_TYPE, q as SUPPORTED_ASSETS, r as SafeguardConfig, s as SafeguardError, t as SafeguardErrorDetails, u as SafeguardRule, v as SimulationResult, w as StableAsset, x as SuiRpcTxBlock, y as SupportedAsset, T as T2000Error, z as T2000ErrorCode, H as T2000ErrorData, J as TOKEN_MAP, Q as TransactionSigner, R as TxDirection, U as TxMetadata, V as USDC_DECIMALS, W as USDC_TYPE, X as USDE_TYPE, Y as USDSUI_TYPE, Z as USDT_TYPE, _ as WAL_TYPE, $ as WBTC_TYPE, a0 as ZkLoginProof, a1 as ZkLoginSigner, a2 as addCollectFeeToTx, a3 as calculateFee, a4 as classifyAction, a5 as classifyLabel, a6 as classifyTransaction, a7 as executeAutoTopUp, a8 as executeWithGas, a9 as extractTransferDetails, aa as extractTxCommands, ab as extractTxSender, ac as fallbackLabel, ad as formatAssetAmount, ae as formatSui, af as formatUsd, ag as getDecimals, ah as getDecimalsForCoinType, ai as getGasStatus, aj as getTier, ak as isSupported, al as isTier1, am as isTier2, an as mapMoveAbortCode, ao as mapWalletError, ap as mistToSui, aq as parseSuiRpcTx, ar as rawToStable, as as rawToUsdc, at as refineLendingLabel, au as resolveSymbol, av as resolveTokenType, aw as shouldAutoTopUp, ax as stableToRaw, ay as suiToMist, az as truncateAddress, aA as usdcToRaw, aB as validateAddress } from './token-registry-BortlMRr.js';
+export { A as AssetRates, B as BalanceResponse, a as BorrowResult, C as ClaimRewardsResult, D as DepositInfo, E as EarningsResult, F as FundStatusResult, G as GasMethod, b as GasReserve, H as HealthFactorResult, M as MaxBorrowResult, c as MaxWithdrawResult, P as PayOptions, d as PayResult, e as PendingReward, f as PositionEntry, g as PositionsResult, R as RatesResult, h as RepayResult, S as SaveResult, i as SendResult, T as TransactionRecord, W as WithdrawResult } from './types-DVVns7_w.js';
 import '@mysten/sui/keypairs/ed25519';
 import '@mysten/sui/jsonRpc';
 import '@mysten/sui/transactions';

package/dist/index.cjs

@@ -7180,19 +7180,24 @@ var T2000 = class _T2000 extends eventemitter3.EventEmitter {
     if (params.amount === "all") {
       return this._repayAllBorrows(borrows);
     }
-    borrows.sort((a, b2) => b2.apy - a.apy);
-    const target = borrows[0];
+    const eligible = params.asset ? borrows.filter((b2) => b2.asset === params.asset) : borrows;
+    if (eligible.length === 0) {
+      throw new exports.T2000Error("NO_COLLATERAL", `No outstanding ${params.asset} borrow to repay`);
+    }
+    eligible.sort((a, b2) => b2.apy - a.apy);
+    const target = eligible[0];
     const adapter = this.registry.getLending(target.protocolId);
     if (!adapter) throw new exports.T2000Error("PROTOCOL_UNAVAILABLE", `Protocol ${target.protocolId} not found`);
     const repayAmount = Math.min(params.amount, target.amount);
+    const targetAssetInfo = SUPPORTED_ASSETS[target.asset] ?? SUPPORTED_ASSETS.USDC;
     const gasResult = await executeWithGas(this.client, this._signer, async () => {
       if (adapter.addRepayToTx) {
         const tx2 = new transactions.Transaction();
         tx2.setSender(this._address);
-        const usdcCoins = await this._fetchCoins(SUPPORTED_ASSETS.USDC.type);
-        if (usdcCoins.length === 0) throw new exports.T2000Error("INSUFFICIENT_BALANCE", "No USDC coins");
-        const merged = this._mergeCoinsInTx(tx2, usdcCoins);
-        const raw = BigInt(Math.floor(repayAmount * 10 ** SUPPORTED_ASSETS.USDC.decimals));
+        const coins = await this._fetchCoins(targetAssetInfo.type);
+        if (coins.length === 0) throw new exports.T2000Error("INSUFFICIENT_BALANCE", `No ${targetAssetInfo.displayName} coins`);
+        const merged = this._mergeCoinsInTx(tx2, coins);
+        const raw = BigInt(Math.floor(repayAmount * 10 ** targetAssetInfo.decimals));
         const [repayCoin] = tx2.splitCoins(merged, [raw]);
         await adapter.addRepayToTx(tx2, this._address, repayCoin, target.asset);
         return tx2;
@@ -7201,11 +7206,12 @@ var T2000 = class _T2000 extends eventemitter3.EventEmitter {
       return tx;
     });
     const hf = await adapter.getHealth(this._address);
-    this.emitBalanceChange("USDC", repayAmount, "repay", gasResult.digest);
+    this.emitBalanceChange(target.asset, repayAmount, "repay", gasResult.digest);
     return {
       success: true,
       tx: gasResult.digest,
       amount: repayAmount,
+      asset: target.asset,
       remainingDebt: hf.borrowed,
       gasCost: gasResult.gasCostSui,
       gasMethod: gasResult.gasMethod
@@ -7224,15 +7230,20 @@ var T2000 = class _T2000 extends eventemitter3.EventEmitter {
       if (canPTB) {
         const tx = new transactions.Transaction();
         tx.setSender(this._address);
-        const usdcCoins = await this._fetchCoins(SUPPORTED_ASSETS.USDC.type);
-        let usdcMerged;
-        if (usdcCoins.length > 0) {
-          usdcMerged = this._mergeCoinsInTx(tx, usdcCoins);
+        const assetMerged = /* @__PURE__ */ new Map();
+        const uniqueAssets = Array.from(new Set(entries.map((e) => e.borrow.asset)));
+        for (const asset of uniqueAssets) {
+          const info = SUPPORTED_ASSETS[asset];
+          if (!info) throw new exports.T2000Error("ASSET_NOT_SUPPORTED", `Cannot repay unknown asset: ${asset}`);
+          const coins = await this._fetchCoins(info.type);
+          if (coins.length === 0) throw new exports.T2000Error("INSUFFICIENT_BALANCE", `No ${info.displayName} coins for repayment`);
+          assetMerged.set(asset, this._mergeCoinsInTx(tx, coins));
         }
         for (const { borrow, adapter } of entries) {
-          const raw = BigInt(Math.floor(borrow.amount * 10 ** SUPPORTED_ASSETS.USDC.decimals));
-          if (!usdcMerged) throw new exports.T2000Error("INSUFFICIENT_BALANCE", "No USDC for repayment");
-          const [repayCoin] = tx.splitCoins(usdcMerged, [raw]);
+          const info = SUPPORTED_ASSETS[borrow.asset];
+          const merged = assetMerged.get(borrow.asset);
+          const raw = BigInt(Math.floor(borrow.amount * 10 ** info.decimals));
+          const [repayCoin] = tx.splitCoins(merged, [raw]);
           await adapter.addRepayToTx(tx, this._address, repayCoin, borrow.asset);
           totalRepaid += borrow.amount;
         }
@@ -7248,11 +7259,13 @@ var T2000 = class _T2000 extends eventemitter3.EventEmitter {
     });
     const firstAdapter = entries[0]?.adapter;
     const hf = firstAdapter ? await firstAdapter.getHealth(this._address) : { borrowed: 0 };
-    this.emitBalanceChange("USDC", totalRepaid, "repay", gasResult.digest);
+    const dominantAsset = entries.reduce((acc, e) => acc.amount >= e.borrow.amount ? acc : e.borrow, entries[0]?.borrow ?? { asset: "USDC", amount: 0 }).asset;
+    this.emitBalanceChange(dominantAsset, totalRepaid, "repay", gasResult.digest);
     return {
       success: true,
       tx: gasResult.digest,
       amount: totalRepaid,
+      asset: dominantAsset,
       remainingDebt: hf.borrowed,
       gasCost: gasResult.gasCostSui,
       gasMethod: gasResult.gasMethod