@t2000/sdk 0.56.2 → 1.0.1

package/README.md

@@ -53,14 +53,12 @@ await agent.withdraw({ amount: 25 });
 
 ### `T2000.init(options)` — Create a new wallet
 
-Creates a new bank account (generates keypair, encrypts, and saves to disk).
+Creates a new bank account (generates keypair, encrypts, and saves to disk). Fund the returned address with a small amount of SUI for gas (Mercuryo: https://exchange.mercuryo.io/?widget_id=89960d1a-8db7-49e5-8823-4c5e01c1cea2) plus USDC to transact.
 
 ```typescript
-const { agent, address, sponsored } = await T2000.init({
-  pin: 'my-secret',       // Required — encrypts the key
+const { agent, address } = await T2000.init({
+  pin: 'my-secret',                // Required — encrypts the key
   keyPath: '~/.t2000/wallet.key',  // Optional — custom key file path
-  name: 'my-agent',       // Optional — agent name for sponsor registration
-  sponsored: true,         // Optional — register with gas station (default: true)
 });
 ```
 
@@ -193,14 +191,6 @@ agent.on('yield', (e) => {
   console.log(`Earned: $${e.earned}, total: $${e.total}`);
 });
 
-agent.on('gasAutoTopUp', (e) => {
-  console.log(`Auto-topped up gas: $${e.usdcSpent} USDC → ${e.suiReceived} SUI`);
-});
-
-agent.on('gasStationFallback', (e) => {
-  console.log(`Gas station fallback: ${e.reason}`);
-});
-
 agent.on('error', (e) => {
   console.error(`Error: ${e.code} — ${e.message}`);
 });
@@ -236,20 +226,13 @@ agent.suiClient;   // SuiJsonRpcClient instance
 agent.signer;      // Ed25519Keypair
 ```
 
-## Gas Abstraction
-
-Every operation (send, save, borrow, repay, withdraw) routes through a 3-step gas resolution chain via `executeWithGas()`. The agent never fails due to low gas if it has USDC or the Gas Station is reachable:
+## Gas
 
-| Step | Strategy | Condition | How it works |
-|------|----------|-----------|--------------|
-| 1 | **Self-funded** | SUI ≥ 0.05 | Uses the agent's own SUI for gas |
-| 2 | **Auto-topup** | SUI < 0.05, USDC ≥ $2 | Converts $1 USDC → SUI (currently disabled, falls back to step 3) |
-| 3 | **Sponsored** | Steps 1 & 2 fail | Gas Station sponsors the full transaction |
-| 4 | **Error** | All fail | Throws `INSUFFICIENT_GAS` |
+Every transaction is self-funded by the agent's wallet. Keep at least ~0.05 SUI on hand. If gas runs out the SDK throws `INSUFFICIENT_GAS` — top up via Mercuryo (https://exchange.mercuryo.io/?widget_id=89960d1a-8db7-49e5-8823-4c5e01c1cea2) or any Sui exchange.
 
-Every transaction result includes a `gasMethod` field (`'self-funded'` | `'auto-topup'` | `'sponsored'`) indicating which strategy was used.
+> **Audric web app exception:** Audric web users transact under Enoki gas sponsorship (zkLogin), so `INSUFFICIENT_GAS` is not a user-facing concern there. The SDK itself is sponsorship-agnostic — sponsorship is wired in at the host layer (Audric web), not inside `@t2000/sdk`.
 
-**Architecture:** Each protocol operation (NAVI, send) exposes both `buildXxxTx()` (standalone transaction) and `addXxxToTx()` (composable PTB) functions. Multi-step flows 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.
+**Architecture:** Each protocol operation (NAVI, send) exposes both `buildXxxTx()` (standalone transaction) and `addXxxToTx()` (composable PTB) functions. Multi-step flows compose multiple protocol calls into a single atomic PTB. If any step within a PTB fails, the entire transaction reverts — no funds left in intermediate states.
 
 ## Configuration
 
@@ -311,7 +294,7 @@ try {
 }
 ```
 
-Common error codes: `INSUFFICIENT_BALANCE` · `INVALID_ADDRESS` · `INVALID_AMOUNT` · `INVALID_ASSET` · `HEALTH_FACTOR_TOO_LOW` · `NO_COLLATERAL` · `WALLET_NOT_FOUND` · `WALLET_LOCKED` · `WALLET_EXISTS` · `SIMULATION_FAILED` · `TRANSACTION_FAILED` · `PROTOCOL_PAUSED` · `INSUFFICIENT_GAS` · `WITHDRAW_WOULD_LIQUIDATE` · `AUTO_TOPUP_FAILED` · `GAS_STATION_UNAVAILABLE` · `SWAP_NO_ROUTE` · `SWAP_FAILED`
+Common error codes: `INSUFFICIENT_BALANCE` · `INVALID_ADDRESS` · `INVALID_AMOUNT` · `INVALID_ASSET` · `HEALTH_FACTOR_TOO_LOW` · `NO_COLLATERAL` · `WALLET_NOT_FOUND` · `WALLET_LOCKED` · `WALLET_EXISTS` · `SIMULATION_FAILED` · `TRANSACTION_FAILED` · `PROTOCOL_PAUSED` · `INSUFFICIENT_GAS` · `WITHDRAW_WOULD_LIQUIDATE` · `SWAP_NO_ROUTE` · `SWAP_FAILED`
 
 ## Protocol Integration
 

package/dist/adapters/descriptors.d.cts

@@ -1,3 +1,3 @@
-export { d as ProtocolDescriptor, e as allDescriptors, n as naviDescriptor } from '../descriptors-DkKhitk_.cjs';
+export { d as ProtocolDescriptor, e as allDescriptors, n as naviDescriptor } from '../descriptors-CDVXo3BM.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-DkKhitk_.js';
+export { d as ProtocolDescriptor, e as allDescriptors, n as naviDescriptor } from '../descriptors-CDVXo3BM.js';
 import '@mysten/sui/transactions';
 import '@mysten/sui/jsonRpc';

package/dist/adapters/index.cjs

@@ -4277,8 +4277,6 @@ async function refreshOracle(tx, client, address, options) {
     const oracleOpts = {
       ...sdkOptions(client),
       throws: false,
-      // Pyth update uses tx.splitCoins(tx.gas, ...) which is incompatible
-      // with sponsored transactions where tx.gas belongs to the sponsor.
       updatePythPriceFeeds: !options?.skipPythUpdate
     };
     await mt(tx, address, pools, oracleOpts);
@@ -4469,7 +4467,7 @@ async function buildWithdrawTx(client, address, amount, options = {}) {
   }
   const tx = new transactions.Transaction();
   tx.setSender(address);
-  await refreshOracle(tx, client, address, { skipPythUpdate: options.sponsored });
+  await refreshOracle(tx, client, address, { skipPythUpdate: options.skipPythUpdate });
   try {
     const coin = await Qe(tx, assetInfo.type, rawAmount, sdkOptions(client));
     tx.transferObjects([coin], address);
@@ -4481,7 +4479,6 @@ async function buildWithdrawTx(client, address, amount, options = {}) {
 }
 async function addWithdrawToTx(tx, client, address, amount, options = {}) {
   const asset = options.asset ?? "USDC";
-  const sponsored = options.sponsored ?? true;
   const assetInfo = resolveAssetInfo(asset);
   const posResult = await getPositions(client, address);
   const supply = posResult.positions.find(
@@ -4499,7 +4496,7 @@ async function addWithdrawToTx(tx, client, address, amount, options = {}) {
     });
     return { coin, effectiveAmount: 0 };
   }
-  await refreshOracle(tx, client, address, { skipPythUpdate: sponsored });
+  await refreshOracle(tx, client, address, { skipPythUpdate: options.skipPythUpdate });
   try {
     const coin = await Qe(tx, assetInfo.type, rawAmount, sdkOptions(client));
     return { coin, effectiveAmount };
@@ -4523,9 +4520,8 @@ async function addSaveToTx(tx, _client, _address, coin, options = {}) {
 }
 async function addRepayToTx(tx, client, address, coin, options = {}) {
   const asset = options.asset ?? "USDC";
-  const sponsored = options.sponsored ?? true;
   const assetInfo = resolveAssetInfo(asset);
-  await refreshOracle(tx, client, address, { skipPythUpdate: sponsored });
+  await refreshOracle(tx, client, address, { skipPythUpdate: options.skipPythUpdate });
   try {
     await xe(tx, assetInfo.type, coin, { env: "prod" });
   } catch (err) {
@@ -4542,7 +4538,7 @@ 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, { skipPythUpdate: options.sponsored });
+  await refreshOracle(tx, client, address, { skipPythUpdate: options.skipPythUpdate });
   try {
     const borrowedCoin = await Xe(tx, assetInfo.type, rawAmount, sdkOptions(client));
     if (options.collectFee) {
@@ -4574,8 +4570,8 @@ async function buildRepayTx(client, address, amount, options = {}) {
   const rawAmount = Math.min(rawRequested, Number(totalBalance));
   const [repayCoin] = tx.splitCoins(coinObj, [rawAmount]);
   await refreshOracle(tx, client, address, {
-    skipPythUpdate: options.sponsored,
-    skipOracle: options.skipOracle
+    skipOracle: options.skipOracle,
+    skipPythUpdate: options.skipPythUpdate
   });
   try {
     await xe(tx, assetInfo.type, repayCoin, {
@@ -4741,7 +4737,10 @@ var NaviAdapter = class {
   }
   async buildWithdrawTx(address, amount, asset, options) {
     const normalized = normalizeAsset(asset);
-    const result = await buildWithdrawTx(this.client, address, amount, { asset: normalized, sponsored: options?.sponsored });
+    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) {
@@ -4753,8 +4752,8 @@ var NaviAdapter = class {
     const normalized = normalizeAsset(asset);
     const tx = await buildRepayTx(this.client, address, amount, {
       asset: normalized,
-      sponsored: options?.sponsored,
-      skipOracle: options?.skipOracle
+      skipOracle: options?.skipOracle,
+      skipPythUpdate: options?.skipPythUpdate
     });
     return { tx };
   }
@@ -4764,17 +4763,23 @@ 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, options) {
     const normalized = normalizeAsset(asset);
     return addSaveToTx(tx, this.client, address, coin, { ...options, asset: normalized });
   }
-  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);