@t2000/sdk 1.0.0 → 1.1.0

package/README.md

@@ -277,7 +277,7 @@ isSupported(USDT_TYPE); // false (legacy — no tier)
 getTier(SUI_TYPE); // 2
 ```
 
-Swap uses Cetus Aggregator V3 (with a **0.1% t2000 overlay fee** on executed swaps). Use `COIN_REGISTRY`, `getDecimalsForCoinType()`, `resolveSymbol()`, and `resolveTokenType()` for token data.
+Swap uses Cetus Aggregator V3. Per-call `overlayFee` is opt-in — the SDK and CLI never charge fees by default. Consumer apps that want to charge an overlay (e.g. Audric) pass `overlayFee: { rate: 10n, receiver: T2000_OVERLAY_FEE_WALLET }` to `findSwapRoute` / `buildSwapTx`. Use `COIN_REGISTRY`, `getDecimalsForCoinType()`, `resolveSymbol()`, and `resolveTokenType()` for token data.
 
 ## Error Handling
 
@@ -318,20 +318,20 @@ SMOKE=1 pnpm --filter @t2000/sdk test -- src/__smoke__
 
 ## Protocol Fees
 
-| Operation | Fee | Notes |
-|-----------|-----|-------|
-| Save (deposit) | 0.10% | Protocol fee on deposit |
-| Borrow | 0.05% | Protocol fee on loan |
-| Withdraw | Free | |
-| Repay | Free | |
-| Send | Free | |
-| Receive | Free | QR payment request generation, no fee |
-| Swap | 0.10% | t2000 overlay on swap amount; Cetus Aggregator network fees still apply |
-| Stake (vSUI) | Free | VOLO protocol fees only |
-| Unstake (vSUI) | Free | |
-| Pay (MPP) | Free | Agent pays the API price, no t2000 surcharge |
-
-Fees are collected by the t2000 protocol treasury on-chain.
+> **The SDK and CLI are fee-free by design (as of `@t2000/sdk@1.1.0`, B5 v2 / 2026-04-30).** Direct SDK / CLI calls — `t2000 save`, `t2000 borrow`, `t2000 swap`, plus `T2000.save()` / `T2000.borrow()` / `swapExecute()` from any third-party integrator — never charge a t2000 protocol fee. The CLI is dev-focused tooling and intentionally has no monetization.
+
+Fees only apply when the **Audric** consumer app calls these primitives. Audric layers a fee transfer step (`addFeeTransfer`) inside the same PTB and routes the USDC to `T2000_OVERLAY_FEE_WALLET`.
+
+| Operation | Audric fee | SDK / CLI fee | Notes |
+|-----------|-----------|--------------|-------|
+| 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. |
+
+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 PTB. The t2000 server-side indexer detects the on-chain USDC inflow and records a `ProtocolFeeLedger` row — no off-chain submission is involved. The deprecated `t2000::treasury::collect_fee` Move call is no longer used.
+
+Need to charge an overlay fee in your own consumer app? Import `addFeeTransfer` and `T2000_OVERLAY_FEE_WALLET` from `@t2000/sdk` (or use your own receiver address — the SDK never assumes the t2000 treasury).
 
 ## MCP Server
 

package/dist/adapters/descriptors.d.cts

@@ -1,3 +1,3 @@
-export { d as ProtocolDescriptor, e as allDescriptors, n as naviDescriptor } from '../descriptors-3YmGYl63.cjs';
+export { d as ProtocolDescriptor, e as allDescriptors, n as naviDescriptor } from '../descriptors-BnbL3xN8.cjs';
 import '@mysten/sui/transactions';
 import '@mysten/sui/jsonRpc';

package/dist/adapters/descriptors.d.ts

@@ -1,3 +1,3 @@
-export { d as ProtocolDescriptor, e as allDescriptors, n as naviDescriptor } from '../descriptors-3YmGYl63.js';
+export { d as ProtocolDescriptor, e as allDescriptors, n as naviDescriptor } from '../descriptors-BnbL3xN8.js';
 import '@mysten/sui/transactions';
 import '@mysten/sui/jsonRpc';

package/dist/adapters/index.cjs

@@ -432,8 +432,6 @@ var T2000Error = class extends Error {
 };
 
 // src/constants.ts
-var SAVE_FEE_BPS = 10n;
-var BORROW_FEE_BPS = 5n;
 var SUPPORTED_ASSETS = {
   USDC: {
     type: "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
@@ -492,9 +490,9 @@ var SUPPORTED_ASSETS = {
 };
 var STABLE_ASSETS = ["USDC"];
 var ALL_NAVI_ASSETS = Object.keys(SUPPORTED_ASSETS);
-var T2000_PACKAGE_ID = process.env.T2000_PACKAGE_ID ?? "0xd775fcc66eae26797654d435d751dea56b82eeb999de51fd285348e573b968ad";
-var T2000_CONFIG_ID = process.env.T2000_CONFIG_ID ?? "0x08ba26f0d260b5edf6a19c71492b3eb914906a7419baf2df1426765157e5862a";
-var T2000_TREASURY_ID = process.env.T2000_TREASURY_ID ?? "0xf420ec0dcad44433042fb56e1413fb88d3ff65be94fcf425ef9ff750164590e8";
+process.env.T2000_PACKAGE_ID ?? "0xd775fcc66eae26797654d435d751dea56b82eeb999de51fd285348e573b968ad";
+process.env.T2000_CONFIG_ID ?? "0x08ba26f0d260b5edf6a19c71492b3eb914906a7419baf2df1426765157e5862a";
+process.env.T2000_OVERLAY_FEE_WALLET ?? "0x5366efbf2b4fe5767fe2e78eb197aa5f5d138d88ac3333fbf3f80a1927da473a";
 process.env.T2000_API_URL ?? "https://api.t2000.ai";
 
 // src/adapters/registry.ts
@@ -4231,30 +4229,6 @@ async function Ct(e, n, o) {
   return a;
 }
 
-// src/protocols/protocolFee.ts
-var FEE_RATES = {
-  save: SAVE_FEE_BPS,
-  borrow: BORROW_FEE_BPS
-};
-var OP_CODES = {
-  save: 0,
-  borrow: 2
-};
-function addCollectFeeToTx(tx, paymentCoin, operation) {
-  const bps = FEE_RATES[operation];
-  if (bps <= 0n) return;
-  tx.moveCall({
-    target: `${T2000_PACKAGE_ID}::treasury::collect_fee`,
-    typeArguments: [SUPPORTED_ASSETS.USDC.type],
-    arguments: [
-      tx.object(T2000_TREASURY_ID),
-      tx.object(T2000_CONFIG_ID),
-      paymentCoin,
-      tx.pure.u8(OP_CODES[operation])
-    ]
-  });
-}
-
 // src/protocols/navi.ts
 var MIN_HEALTH_FACTOR = 1.5;
 function sdkOptions(client) {
@@ -4435,9 +4409,6 @@ async function buildSaveTx(client, address, amount, options = {}) {
   const tx = new transactions.Transaction();
   tx.setSender(address);
   const coinObj = mergeCoins(tx, coins);
-  if (options.collectFee) {
-    addCollectFeeToTx(tx, coinObj, "save");
-  }
   const rawAmount = Math.min(Number(stableToRaw(amount, assetInfo.decimals)), Number(totalBalance));
   try {
     await Ce(tx, assetInfo.type, coinObj, {
@@ -4467,7 +4438,7 @@ async function buildWithdrawTx(client, address, amount, options = {}) {
   }
   const tx = new transactions.Transaction();
   tx.setSender(address);
-  await refreshOracle(tx, client, address);
+  await refreshOracle(tx, client, address, { skipPythUpdate: options.skipPythUpdate });
   try {
     const coin = await Qe(tx, assetInfo.type, rawAmount, sdkOptions(client));
     tx.transferObjects([coin], address);
@@ -4496,7 +4467,7 @@ async function addWithdrawToTx(tx, client, address, amount, options = {}) {
     });
     return { coin, effectiveAmount: 0 };
   }
-  await refreshOracle(tx, client, address);
+  await refreshOracle(tx, client, address, { skipPythUpdate: options.skipPythUpdate });
   try {
     const coin = await Qe(tx, assetInfo.type, rawAmount, sdkOptions(client));
     return { coin, effectiveAmount };
@@ -4508,9 +4479,6 @@ async function addWithdrawToTx(tx, client, address, amount, options = {}) {
 async function addSaveToTx(tx, _client, _address, coin, options = {}) {
   const asset = options.asset ?? "USDC";
   const assetInfo = resolveAssetInfo(asset);
-  if (options.collectFee) {
-    addCollectFeeToTx(tx, coin, "save");
-  }
   try {
     await Ce(tx, assetInfo.type, coin, { env: "prod" });
   } catch (err) {
@@ -4521,7 +4489,7 @@ async function addSaveToTx(tx, _client, _address, coin, options = {}) {
 async function addRepayToTx(tx, client, address, coin, options = {}) {
   const asset = options.asset ?? "USDC";
   const assetInfo = resolveAssetInfo(asset);
-  await refreshOracle(tx, client, address);
+  await refreshOracle(tx, client, address, { skipPythUpdate: options.skipPythUpdate });
   try {
     await xe(tx, assetInfo.type, coin, { env: "prod" });
   } catch (err) {
@@ -4538,12 +4506,9 @@ async function buildBorrowTx(client, address, amount, options = {}) {
   const rawAmount = Number(stableToRaw(amount, assetInfo.decimals));
   const tx = new transactions.Transaction();
   tx.setSender(address);
-  await refreshOracle(tx, client, address);
+  await refreshOracle(tx, client, address, { skipPythUpdate: options.skipPythUpdate });
   try {
     const borrowedCoin = await Xe(tx, assetInfo.type, rawAmount, sdkOptions(client));
-    if (options.collectFee) {
-      addCollectFeeToTx(tx, borrowedCoin, "borrow");
-    }
     tx.transferObjects([borrowedCoin], address);
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
@@ -4551,6 +4516,22 @@ async function buildBorrowTx(client, address, amount, options = {}) {
   }
   return tx;
 }
+async function addBorrowToTx(tx, client, address, amount, options = {}) {
+  if (!amount || amount <= 0 || !Number.isFinite(amount)) {
+    throw new T2000Error("INVALID_AMOUNT", "Borrow amount must be a positive number");
+  }
+  const asset = options.asset ?? "USDC";
+  const assetInfo = resolveAssetInfo(asset);
+  const rawAmount = Number(stableToRaw(amount, assetInfo.decimals));
+  await refreshOracle(tx, client, address, { skipPythUpdate: options.skipPythUpdate });
+  try {
+    const borrowedCoin = await Xe(tx, assetInfo.type, rawAmount, sdkOptions(client));
+    return borrowedCoin;
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    throw new T2000Error("PROTOCOL_UNAVAILABLE", `NAVI borrow failed: ${msg}`);
+  }
+}
 async function buildRepayTx(client, address, amount, options = {}) {
   if (!amount || amount <= 0 || !Number.isFinite(amount)) {
     throw new T2000Error("INVALID_AMOUNT", "Repay amount must be a positive number");
@@ -4569,7 +4550,10 @@ async function buildRepayTx(client, address, amount, options = {}) {
   const coinObj = mergeCoins(tx, coins);
   const rawAmount = Math.min(rawRequested, Number(totalBalance));
   const [repayCoin] = tx.splitCoins(coinObj, [rawAmount]);
-  await refreshOracle(tx, client, address, { skipOracle: options.skipOracle });
+  await refreshOracle(tx, client, address, {
+    skipOracle: options.skipOracle,
+    skipPythUpdate: options.skipPythUpdate
+  });
   try {
     await xe(tx, assetInfo.type, repayCoin, {
       ...sdkOptions(client),
@@ -4727,14 +4711,17 @@ var NaviAdapter = class {
   async getHealth(address) {
     return getHealthFactor(this.client, address);
   }
-  async buildSaveTx(address, amount, asset, options) {
+  async buildSaveTx(address, amount, asset) {
     const normalized = normalizeAsset(asset);
-    const tx = await buildSaveTx(this.client, address, amount, { ...options, asset: normalized });
+    const tx = await buildSaveTx(this.client, address, amount, { asset: normalized });
     return { tx };
   }
-  async buildWithdrawTx(address, amount, asset) {
+  async buildWithdrawTx(address, amount, asset, options) {
     const normalized = normalizeAsset(asset);
-    const result = await buildWithdrawTx(this.client, address, amount, { asset: normalized });
+    const result = await buildWithdrawTx(this.client, address, amount, {
+      asset: normalized,
+      skipPythUpdate: options?.skipPythUpdate
+    });
     return { tx: result.tx, effectiveAmount: result.effectiveAmount };
   }
   async buildBorrowTx(address, amount, asset, options) {
@@ -4746,7 +4733,8 @@ var NaviAdapter = class {
     const normalized = normalizeAsset(asset);
     const tx = await buildRepayTx(this.client, address, amount, {
       asset: normalized,
-      skipOracle: options?.skipOracle
+      skipOracle: options?.skipOracle,
+      skipPythUpdate: options?.skipPythUpdate
     });
     return { tx };
   }
@@ -4756,17 +4744,30 @@ var NaviAdapter = class {
   async maxBorrow(address, _asset) {
     return maxBorrowAmount(this.client, address);
   }
-  async addWithdrawToTx(tx, address, amount, asset) {
+  async addWithdrawToTx(tx, address, amount, asset, options) {
     const normalized = normalizeAsset(asset);
-    return addWithdrawToTx(tx, this.client, address, amount, { asset: normalized });
+    return addWithdrawToTx(tx, this.client, address, amount, {
+      asset: normalized,
+      skipPythUpdate: options?.skipPythUpdate
+    });
+  }
+  async addSaveToTx(tx, address, coin, asset) {
+    const normalized = normalizeAsset(asset);
+    return addSaveToTx(tx, this.client, address, coin, { asset: normalized });
   }
-  async addSaveToTx(tx, address, coin, asset, options) {
+  async addBorrowToTx(tx, address, amount, asset, options) {
     const normalized = normalizeAsset(asset);
-    return addSaveToTx(tx, this.client, address, coin, { ...options, asset: normalized });
+    return addBorrowToTx(tx, this.client, address, amount, {
+      asset: normalized,
+      skipPythUpdate: options?.skipPythUpdate
+    });
   }
-  async addRepayToTx(tx, address, coin, asset) {
+  async addRepayToTx(tx, address, coin, asset, options) {
     const normalized = normalizeAsset(asset);
-    return addRepayToTx(tx, this.client, address, coin, { asset: normalized });
+    return addRepayToTx(tx, this.client, address, coin, {
+      asset: normalized,
+      skipPythUpdate: options?.skipPythUpdate
+    });
   }
   async getPendingRewards(address) {
     return getPendingRewards(this.client, address);