@t2000/sdk 1.0.1 → 1.1.0

package/dist/{token-registry-DAHghHh2.d.cts → types-Bx0uh6g9.d.cts}

@@ -2,6 +2,7 @@ import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
 import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
 import { T as TransactionRecord } from './types-jAD-e7Pq.cjs';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
+import { RouterDataV3 } from '@cetusprotocol/aggregator-sdk';
 
 /**
  * Abstract signing interface that decouples the SDK from any specific
@@ -153,6 +154,7 @@ declare function isAllowedAsset(op: Operation, asset: string): boolean;
  * Passing `undefined` (omitted) is always valid — defaults to USDC.
  */
 declare function assertAllowedAsset(op: Operation, asset: string | undefined): void;
+declare const T2000_OVERLAY_FEE_WALLET: string;
 declare const DEFAULT_NETWORK: "mainnet";
 declare const CETUS_USDC_SUI_POOL = "0x51e883ba7c0b566a26cbc8a94cd33eb0abd418a77cc1e60ad22fd9b1f29cd2ab";
 declare const GAS_RESERVE_MIN = 0.05;
@@ -381,59 +383,58 @@ interface SimulationResult {
 declare function simulateTransaction(client: SuiJsonRpcClient, tx: Transaction, sender: string): Promise<SimulationResult>;
 declare function throwIfSimulationFailed(sim: SimulationResult): void;
 
-type FeeOperation = 'save' | 'borrow';
+/**
+ * Protocol fee primitives — wallet-direct transfer model.
+ *
+ * [B5 v2 / @t2000/sdk@1.1.0 / 2026-04-30]
+ * Replaces the deprecated `t2000::treasury::collect_fee` Move call. Fees are now
+ * collected by splitting from the payment coin and transferring directly to the
+ * treasury wallet inside the same PTB. Atomic with the operation (PTB semantics);
+ * the wallet IS the ledger; the server-side indexer reads `balanceChanges` and
+ * writes a `ProtocolFeeLedger` row tagged with the operation classified from the
+ * tx's moveCall targets.
+ *
+ * The SDK / CLI never call this helper — they're fee-free by design (t2000 = infra
+ * brand, no opinion on fees). Audric's `prepare/route.ts` is the canonical caller.
+ *
+ * Pre-1.1.0 callers: `addCollectFeeToTx` and `reportFee` were removed in this
+ * release. Migration: replace `addCollectFeeToTx(tx, coin, op)` with
+ * `addFeeTransfer(tx, coin, FEE_BPS_FOR_OP, T2000_OVERLAY_FEE_WALLET)` BEFORE the
+ * NAVI deposit step (order matters — the deposit consumes the coin).
+ */
+
+type FeeOperation = 'save' | 'borrow' | 'swap';
 interface ProtocolFeeInfo {
     amount: number;
     asset: string;
     rate: number;
     rawAmount: bigint;
 }
+/**
+ * Compute the fee amount for a given operation against a USD-denominated input.
+ * Used pre-tx for receipt display + quote math. Does not modify any tx.
+ */
 declare function calculateFee(operation: FeeOperation, amount: number): ProtocolFeeInfo;
 /**
- * Add on-chain fee collection to an existing PTB via t2000::treasury::collect_fee().
- * The Move function splits the fee from the payment coin and stores it in the
- * Treasury's internal Balance<T>. Atomic — reverts with the operation if it fails.
+ * Split a fee from `paymentCoin` and transfer it to `receiver` inside the given PTB.
+ *
+ * **Order is load-bearing.** Call this BEFORE the protocol operation that consumes
+ * `paymentCoin` (e.g. NAVI deposit). `splitCoins` mutates the source coin in place,
+ * leaving the remainder for the protocol step. If you split AFTER the deposit,
+ * the deposit will have consumed the coin and the split will fail.
+ *
+ * Atomicity: `splitCoins` + `transferObjects` are PTB ops; if anything later in
+ * the PTB reverts, the fee transfer reverts too. Same atomicity guarantee as the
+ * deprecated `t2000::treasury::collect_fee` Move call.
+ *
+ * @param tx          Active PTB
+ * @param paymentCoin Coin to split the fee from (mutated in place)
+ * @param feeBps      Fee rate in basis points (e.g. `SAVE_FEE_BPS = 10n` = 0.1%)
+ * @param receiver    Treasury wallet address (typically `T2000_OVERLAY_FEE_WALLET`)
+ * @param amount      USD-denominated input amount (matches what was passed to the
+ *                    protocol operation; used to compute the raw fee amount)
  */
-declare function addCollectFeeToTx(tx: Transaction, paymentCoin: TransactionObjectArgument, operation: FeeOperation): void;
-
-type SafeguardRule = 'locked' | 'maxPerTx' | 'maxDailySend';
-interface SafeguardErrorDetails {
-    attempted?: number;
-    limit?: number;
-    current?: number;
-}
-declare class SafeguardError extends T2000Error {
-    readonly rule: SafeguardRule;
-    readonly details: SafeguardErrorDetails;
-    constructor(rule: SafeguardRule, details: SafeguardErrorDetails, message?: string);
-    toJSON(): {
-        error: "SAFEGUARD_BLOCKED";
-        message: string;
-        retryable: boolean;
-        data: {
-            attempted?: number;
-            limit?: number;
-            current?: number;
-            rule: SafeguardRule;
-        };
-    };
-}
-
-interface SafeguardConfig {
-    locked: boolean;
-    maxPerTx: number;
-    maxDailySend: number;
-    dailyUsed: number;
-    dailyResetDate: string;
-    maxLeverage?: number;
-    maxPositionSize?: number;
-}
-interface TxMetadata {
-    operation: 'send' | 'save' | 'withdraw' | 'borrow' | 'repay' | 'pay';
-    amount?: number;
-}
-declare const OUTBOUND_OPS: Set<"save" | "borrow" | "withdraw" | "repay" | "send" | "pay">;
-declare const DEFAULT_SAFEGUARD_CONFIG: SafeguardConfig;
+declare function addFeeTransfer(tx: Transaction, paymentCoin: TransactionObjectArgument, feeBps: bigint, receiver: string, amount: number): void;
 
 /**
  * Unified token registry — single source of truth for coin types, decimals, symbols, and tiers.
@@ -501,4 +502,112 @@ declare const IKA_TYPE: string;
 declare const LOFI_TYPE: string;
 declare const MANIFEST_TYPE: string;
 
-export { classifyAction as $, ALL_NAVI_ASSETS as A, BPS_DENOMINATOR as B, CLOCK_ID as C, DEFAULT_NETWORK as D, ETH_TYPE as E, type FeeOperation as F, GAS_RESERVE_MIN as G, USDC_TYPE as H, IKA_TYPE as I, USDE_TYPE as J, KNOWN_TARGETS as K, LABEL_PATTERNS as L, MANIFEST_TYPE as M, NAVX_TYPE as N, OUTBOUND_OPS as O, type ProtocolFeeInfo as P, USDSUI_TYPE as Q, USDT_TYPE as R, STABLE_ASSETS as S, T2000Error as T, USDC_DECIMALS as U, WBTC_TYPE as V, WAL_TYPE as W, ZkLoginSigner as X, addCollectFeeToTx as Y, type ZkLoginProof as Z, calculateFee as _, COIN_REGISTRY as a, classifyLabel as a0, classifyTransaction as a1, extractTransferDetails as a2, extractTxCommands as a3, extractTxSender as a4, fallbackLabel as a5, formatAssetAmount as a6, formatSui as a7, formatUsd as a8, getDecimals as a9, normalizeCoinType as aA, queryHistory as aB, queryTransaction as aC, simulateTransaction as aD, throwIfSimulationFailed as aE, getDecimalsForCoinType as aa, getTier as ab, isSupported as ac, isTier1 as ad, isTier2 as ae, mapMoveAbortCode as af, mapWalletError as ag, mistToSui as ah, parseSuiRpcTx as ai, rawToStable as aj, rawToUsdc as ak, refineLendingLabel as al, resolveSymbol as am, resolveTokenType as an, stableToRaw as ao, suiToMist as ap, truncateAddress as aq, usdcToRaw as ar, validateAddress as as, BORROW_FEE_BPS as at, CETUS_USDC_SUI_POOL as au, OPERATION_ASSETS as av, type Operation as aw, SAVE_FEE_BPS as ax, assertAllowedAsset as ay, isAllowedAsset as az, type ClassifyBalanceChange as b, type ClassifyResult as c, type CoinMeta as d, DEFAULT_SAFEGUARD_CONFIG as e, type ExtractedTransfer as f, KeypairSigner as g, LOFI_TYPE as h, MIST_PER_SUI as i, SUI_DECIMALS as j, SUI_TYPE as k, SUPPORTED_ASSETS as l, type SafeguardConfig as m, SafeguardError as n, type SafeguardErrorDetails as o, type SafeguardRule as p, type SimulationResult as q, type StableAsset as r, type SuiRpcTxBlock as s, type SupportedAsset as t, type T2000ErrorCode as u, type T2000ErrorData as v, TOKEN_MAP as w, type TransactionSigner as x, type TxDirection as y, type TxMetadata as z };
+/**
+ * Cetus Aggregator V3 SDK wrapper — the ONLY file that imports @cetusprotocol/aggregator-sdk.
+ * Documented CLAUDE.md exception: multi-DEX routing cannot be feasibly replaced by thin tx builders.
+ *
+ * [B5 v2 / @t2000/sdk@1.1.0 / 2026-04-30]
+ * Overlay fee config is now per-call instead of a module-level singleton. CLI / direct
+ * SDK callers (`T2000.swap()`) DON'T pass `overlayFee` → fee-free swap. Audric's
+ * prepare/route.ts ALWAYS passes `overlayFee = { rate: OVERLAY_FEE_RATE, receiver:
+ * T2000_OVERLAY_FEE_WALLET }` → fee charged. Structural inclusion (Audric's code can't
+ * forget to pass it because it IS the code), not a toggle that defaults to safe.
+ *
+ * Pre-1.1.0: a module-level `OVERLAY_FEE_RECEIVER` constant defaulted to a Move object
+ * ID. USDC sent there became OwnedObjects keyed to the object and was inaccessible.
+ * Fixed by making the receiver a regular wallet address (T2000_OVERLAY_FEE_WALLET) AND
+ * by removing the singleton pattern that hid the misconfig.
+ */
+
+interface OverlayFeeConfig {
+    /** Fee rate as a fraction (e.g. 0.001 = 0.1%). Pass 0 to disable. */
+    rate: number;
+    /** Wallet address that receives the overlay fee. */
+    receiver: string;
+}
+interface SwapRouteResult {
+    routerData: RouterDataV3;
+    amountIn: string;
+    amountOut: string;
+    byAmountIn: boolean;
+    priceImpact: number;
+    insufficientLiquidity: boolean;
+}
+/**
+ * Default Audric swap overlay fee — 0.1%. Exported for consumers that want to use
+ * the canonical Audric rate (the Audric prepare-route does this). Changing this
+ * rate requires a coordinated SDK + audric release.
+ */
+declare const OVERLAY_FEE_RATE = 0.001;
+/**
+ * Find the optimal swap route via Cetus Aggregator REST API.
+ *
+ * Pass `overlayFee` to charge an overlay fee on the output (Audric's pattern).
+ * Omit it for a fee-free swap (CLI / direct SDK pattern).
+ */
+declare function findSwapRoute(params: {
+    walletAddress: string;
+    from: string;
+    to: string;
+    amount: bigint;
+    byAmountIn: boolean;
+    overlayFee?: OverlayFeeConfig;
+}): Promise<SwapRouteResult | null>;
+/**
+ * Build a swap PTB from a route result. The caller must provide an input coin
+ * obtained by splitting/merging wallet coins.
+ *
+ * **Important:** Cetus's `routerSwap` reads the overlay-fee config from the
+ * AggregatorClient instance. The `overlayFee` param here MUST match the one
+ * passed to `findSwapRoute` for the same swap (otherwise you'll hit the cache
+ * boundary and get a different client with different overlay config).
+ */
+declare function buildSwapTx(params: {
+    walletAddress: string;
+    route: SwapRouteResult;
+    tx: Transaction;
+    inputCoin: TransactionObjectArgument;
+    slippage: number;
+    overlayFee?: OverlayFeeConfig;
+}): Promise<TransactionObjectArgument>;
+
+type SafeguardRule = 'locked' | 'maxPerTx' | 'maxDailySend';
+interface SafeguardErrorDetails {
+    attempted?: number;
+    limit?: number;
+    current?: number;
+}
+declare class SafeguardError extends T2000Error {
+    readonly rule: SafeguardRule;
+    readonly details: SafeguardErrorDetails;
+    constructor(rule: SafeguardRule, details: SafeguardErrorDetails, message?: string);
+    toJSON(): {
+        error: "SAFEGUARD_BLOCKED";
+        message: string;
+        retryable: boolean;
+        data: {
+            attempted?: number;
+            limit?: number;
+            current?: number;
+            rule: SafeguardRule;
+        };
+    };
+}
+
+interface SafeguardConfig {
+    locked: boolean;
+    maxPerTx: number;
+    maxDailySend: number;
+    dailyUsed: number;
+    dailyResetDate: string;
+    maxLeverage?: number;
+    maxPositionSize?: number;
+}
+interface TxMetadata {
+    operation: 'send' | 'save' | 'withdraw' | 'borrow' | 'repay' | 'pay';
+    amount?: number;
+}
+declare const OUTBOUND_OPS: Set<"save" | "borrow" | "withdraw" | "repay" | "send" | "pay">;
+declare const DEFAULT_SAFEGUARD_CONFIG: SafeguardConfig;
+
+export { WAL_TYPE as $, ALL_NAVI_ASSETS as A, BORROW_FEE_BPS as B, CLOCK_ID as C, DEFAULT_NETWORK as D, ETH_TYPE as E, type FeeOperation as F, GAS_RESERVE_MIN as G, type T2000ErrorData as H, IKA_TYPE as I, T2000_OVERLAY_FEE_WALLET as J, KNOWN_TARGETS as K, LABEL_PATTERNS as L, MANIFEST_TYPE as M, NAVX_TYPE as N, OUTBOUND_OPS as O, type ProtocolFeeInfo as P, TOKEN_MAP as Q, type TransactionSigner as R, SAVE_FEE_BPS as S, T2000Error as T, type TxDirection as U, type TxMetadata as V, USDC_DECIMALS as W, USDC_TYPE as X, USDE_TYPE as Y, USDSUI_TYPE as Z, USDT_TYPE as _, BPS_DENOMINATOR as a, WBTC_TYPE as a0, type ZkLoginProof as a1, ZkLoginSigner as a2, addFeeTransfer as a3, buildSwapTx as a4, calculateFee as a5, classifyAction as a6, classifyLabel as a7, classifyTransaction as a8, extractTransferDetails as a9, validateAddress as aA, CETUS_USDC_SUI_POOL as aB, OPERATION_ASSETS as aC, type Operation as aD, assertAllowedAsset as aE, isAllowedAsset as aF, normalizeCoinType as aG, queryHistory as aH, queryTransaction as aI, simulateTransaction as aJ, throwIfSimulationFailed as aK, extractTxCommands as aa, extractTxSender as ab, fallbackLabel as ac, findSwapRoute as ad, formatAssetAmount as ae, formatSui as af, formatUsd as ag, getDecimals as ah, getDecimalsForCoinType as ai, getTier as aj, isSupported as ak, isTier1 as al, isTier2 as am, mapMoveAbortCode as an, mapWalletError as ao, mistToSui as ap, parseSuiRpcTx as aq, rawToStable as ar, rawToUsdc as as, refineLendingLabel as at, resolveSymbol as au, resolveTokenType as av, stableToRaw as aw, suiToMist as ax, truncateAddress as ay, usdcToRaw as az, COIN_REGISTRY as b, type ClassifyBalanceChange as c, type ClassifyResult as d, type CoinMeta as e, DEFAULT_SAFEGUARD_CONFIG as f, type ExtractedTransfer as g, KeypairSigner as h, LOFI_TYPE as i, MIST_PER_SUI as j, OVERLAY_FEE_RATE as k, type OverlayFeeConfig as l, STABLE_ASSETS as m, SUI_DECIMALS as n, SUI_TYPE as o, SUPPORTED_ASSETS as p, type SafeguardConfig as q, SafeguardError as r, type SafeguardErrorDetails as s, type SafeguardRule as t, type SimulationResult as u, type StableAsset as v, type SuiRpcTxBlock as w, type SupportedAsset as x, type SwapRouteResult as y, type T2000ErrorCode as z };

package/dist/{token-registry-CoTPqCbS.d.ts → types-CWnyOY9f.d.ts}

@@ -2,6 +2,7 @@ import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
 import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
 import { T as TransactionRecord } from './types-jAD-e7Pq.js';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
+import { RouterDataV3 } from '@cetusprotocol/aggregator-sdk';
 
 /**
  * Abstract signing interface that decouples the SDK from any specific
@@ -153,6 +154,7 @@ declare function isAllowedAsset(op: Operation, asset: string): boolean;
  * Passing `undefined` (omitted) is always valid — defaults to USDC.
  */
 declare function assertAllowedAsset(op: Operation, asset: string | undefined): void;
+declare const T2000_OVERLAY_FEE_WALLET: string;
 declare const DEFAULT_NETWORK: "mainnet";
 declare const CETUS_USDC_SUI_POOL = "0x51e883ba7c0b566a26cbc8a94cd33eb0abd418a77cc1e60ad22fd9b1f29cd2ab";
 declare const GAS_RESERVE_MIN = 0.05;
@@ -381,59 +383,58 @@ interface SimulationResult {
 declare function simulateTransaction(client: SuiJsonRpcClient, tx: Transaction, sender: string): Promise<SimulationResult>;
 declare function throwIfSimulationFailed(sim: SimulationResult): void;
 
-type FeeOperation = 'save' | 'borrow';
+/**
+ * Protocol fee primitives — wallet-direct transfer model.
+ *
+ * [B5 v2 / @t2000/sdk@1.1.0 / 2026-04-30]
+ * Replaces the deprecated `t2000::treasury::collect_fee` Move call. Fees are now
+ * collected by splitting from the payment coin and transferring directly to the
+ * treasury wallet inside the same PTB. Atomic with the operation (PTB semantics);
+ * the wallet IS the ledger; the server-side indexer reads `balanceChanges` and
+ * writes a `ProtocolFeeLedger` row tagged with the operation classified from the
+ * tx's moveCall targets.
+ *
+ * The SDK / CLI never call this helper — they're fee-free by design (t2000 = infra
+ * brand, no opinion on fees). Audric's `prepare/route.ts` is the canonical caller.
+ *
+ * Pre-1.1.0 callers: `addCollectFeeToTx` and `reportFee` were removed in this
+ * release. Migration: replace `addCollectFeeToTx(tx, coin, op)` with
+ * `addFeeTransfer(tx, coin, FEE_BPS_FOR_OP, T2000_OVERLAY_FEE_WALLET)` BEFORE the
+ * NAVI deposit step (order matters — the deposit consumes the coin).
+ */
+
+type FeeOperation = 'save' | 'borrow' | 'swap';
 interface ProtocolFeeInfo {
     amount: number;
     asset: string;
     rate: number;
     rawAmount: bigint;
 }
+/**
+ * Compute the fee amount for a given operation against a USD-denominated input.
+ * Used pre-tx for receipt display + quote math. Does not modify any tx.
+ */
 declare function calculateFee(operation: FeeOperation, amount: number): ProtocolFeeInfo;
 /**
- * Add on-chain fee collection to an existing PTB via t2000::treasury::collect_fee().
- * The Move function splits the fee from the payment coin and stores it in the
- * Treasury's internal Balance<T>. Atomic — reverts with the operation if it fails.
+ * Split a fee from `paymentCoin` and transfer it to `receiver` inside the given PTB.
+ *
+ * **Order is load-bearing.** Call this BEFORE the protocol operation that consumes
+ * `paymentCoin` (e.g. NAVI deposit). `splitCoins` mutates the source coin in place,
+ * leaving the remainder for the protocol step. If you split AFTER the deposit,
+ * the deposit will have consumed the coin and the split will fail.
+ *
+ * Atomicity: `splitCoins` + `transferObjects` are PTB ops; if anything later in
+ * the PTB reverts, the fee transfer reverts too. Same atomicity guarantee as the
+ * deprecated `t2000::treasury::collect_fee` Move call.
+ *
+ * @param tx          Active PTB
+ * @param paymentCoin Coin to split the fee from (mutated in place)
+ * @param feeBps      Fee rate in basis points (e.g. `SAVE_FEE_BPS = 10n` = 0.1%)
+ * @param receiver    Treasury wallet address (typically `T2000_OVERLAY_FEE_WALLET`)
+ * @param amount      USD-denominated input amount (matches what was passed to the
+ *                    protocol operation; used to compute the raw fee amount)
  */
-declare function addCollectFeeToTx(tx: Transaction, paymentCoin: TransactionObjectArgument, operation: FeeOperation): void;
-
-type SafeguardRule = 'locked' | 'maxPerTx' | 'maxDailySend';
-interface SafeguardErrorDetails {
-    attempted?: number;
-    limit?: number;
-    current?: number;
-}
-declare class SafeguardError extends T2000Error {
-    readonly rule: SafeguardRule;
-    readonly details: SafeguardErrorDetails;
-    constructor(rule: SafeguardRule, details: SafeguardErrorDetails, message?: string);
-    toJSON(): {
-        error: "SAFEGUARD_BLOCKED";
-        message: string;
-        retryable: boolean;
-        data: {
-            attempted?: number;
-            limit?: number;
-            current?: number;
-            rule: SafeguardRule;
-        };
-    };
-}
-
-interface SafeguardConfig {
-    locked: boolean;
-    maxPerTx: number;
-    maxDailySend: number;
-    dailyUsed: number;
-    dailyResetDate: string;
-    maxLeverage?: number;
-    maxPositionSize?: number;
-}
-interface TxMetadata {
-    operation: 'send' | 'save' | 'withdraw' | 'borrow' | 'repay' | 'pay';
-    amount?: number;
-}
-declare const OUTBOUND_OPS: Set<"save" | "borrow" | "withdraw" | "repay" | "send" | "pay">;
-declare const DEFAULT_SAFEGUARD_CONFIG: SafeguardConfig;
+declare function addFeeTransfer(tx: Transaction, paymentCoin: TransactionObjectArgument, feeBps: bigint, receiver: string, amount: number): void;
 
 /**
  * Unified token registry — single source of truth for coin types, decimals, symbols, and tiers.
@@ -501,4 +502,112 @@ declare const IKA_TYPE: string;
 declare const LOFI_TYPE: string;
 declare const MANIFEST_TYPE: string;
 
-export { classifyAction as $, ALL_NAVI_ASSETS as A, BPS_DENOMINATOR as B, CLOCK_ID as C, DEFAULT_NETWORK as D, ETH_TYPE as E, type FeeOperation as F, GAS_RESERVE_MIN as G, USDC_TYPE as H, IKA_TYPE as I, USDE_TYPE as J, KNOWN_TARGETS as K, LABEL_PATTERNS as L, MANIFEST_TYPE as M, NAVX_TYPE as N, OUTBOUND_OPS as O, type ProtocolFeeInfo as P, USDSUI_TYPE as Q, USDT_TYPE as R, STABLE_ASSETS as S, T2000Error as T, USDC_DECIMALS as U, WBTC_TYPE as V, WAL_TYPE as W, ZkLoginSigner as X, addCollectFeeToTx as Y, type ZkLoginProof as Z, calculateFee as _, COIN_REGISTRY as a, classifyLabel as a0, classifyTransaction as a1, extractTransferDetails as a2, extractTxCommands as a3, extractTxSender as a4, fallbackLabel as a5, formatAssetAmount as a6, formatSui as a7, formatUsd as a8, getDecimals as a9, normalizeCoinType as aA, queryHistory as aB, queryTransaction as aC, simulateTransaction as aD, throwIfSimulationFailed as aE, getDecimalsForCoinType as aa, getTier as ab, isSupported as ac, isTier1 as ad, isTier2 as ae, mapMoveAbortCode as af, mapWalletError as ag, mistToSui as ah, parseSuiRpcTx as ai, rawToStable as aj, rawToUsdc as ak, refineLendingLabel as al, resolveSymbol as am, resolveTokenType as an, stableToRaw as ao, suiToMist as ap, truncateAddress as aq, usdcToRaw as ar, validateAddress as as, BORROW_FEE_BPS as at, CETUS_USDC_SUI_POOL as au, OPERATION_ASSETS as av, type Operation as aw, SAVE_FEE_BPS as ax, assertAllowedAsset as ay, isAllowedAsset as az, type ClassifyBalanceChange as b, type ClassifyResult as c, type CoinMeta as d, DEFAULT_SAFEGUARD_CONFIG as e, type ExtractedTransfer as f, KeypairSigner as g, LOFI_TYPE as h, MIST_PER_SUI as i, SUI_DECIMALS as j, SUI_TYPE as k, SUPPORTED_ASSETS as l, type SafeguardConfig as m, SafeguardError as n, type SafeguardErrorDetails as o, type SafeguardRule as p, type SimulationResult as q, type StableAsset as r, type SuiRpcTxBlock as s, type SupportedAsset as t, type T2000ErrorCode as u, type T2000ErrorData as v, TOKEN_MAP as w, type TransactionSigner as x, type TxDirection as y, type TxMetadata as z };
+/**
+ * Cetus Aggregator V3 SDK wrapper — the ONLY file that imports @cetusprotocol/aggregator-sdk.
+ * Documented CLAUDE.md exception: multi-DEX routing cannot be feasibly replaced by thin tx builders.
+ *
+ * [B5 v2 / @t2000/sdk@1.1.0 / 2026-04-30]
+ * Overlay fee config is now per-call instead of a module-level singleton. CLI / direct
+ * SDK callers (`T2000.swap()`) DON'T pass `overlayFee` → fee-free swap. Audric's
+ * prepare/route.ts ALWAYS passes `overlayFee = { rate: OVERLAY_FEE_RATE, receiver:
+ * T2000_OVERLAY_FEE_WALLET }` → fee charged. Structural inclusion (Audric's code can't
+ * forget to pass it because it IS the code), not a toggle that defaults to safe.
+ *
+ * Pre-1.1.0: a module-level `OVERLAY_FEE_RECEIVER` constant defaulted to a Move object
+ * ID. USDC sent there became OwnedObjects keyed to the object and was inaccessible.
+ * Fixed by making the receiver a regular wallet address (T2000_OVERLAY_FEE_WALLET) AND
+ * by removing the singleton pattern that hid the misconfig.
+ */
+
+interface OverlayFeeConfig {
+    /** Fee rate as a fraction (e.g. 0.001 = 0.1%). Pass 0 to disable. */
+    rate: number;
+    /** Wallet address that receives the overlay fee. */
+    receiver: string;
+}
+interface SwapRouteResult {
+    routerData: RouterDataV3;
+    amountIn: string;
+    amountOut: string;
+    byAmountIn: boolean;
+    priceImpact: number;
+    insufficientLiquidity: boolean;
+}
+/**
+ * Default Audric swap overlay fee — 0.1%. Exported for consumers that want to use
+ * the canonical Audric rate (the Audric prepare-route does this). Changing this
+ * rate requires a coordinated SDK + audric release.
+ */
+declare const OVERLAY_FEE_RATE = 0.001;
+/**
+ * Find the optimal swap route via Cetus Aggregator REST API.
+ *
+ * Pass `overlayFee` to charge an overlay fee on the output (Audric's pattern).
+ * Omit it for a fee-free swap (CLI / direct SDK pattern).
+ */
+declare function findSwapRoute(params: {
+    walletAddress: string;
+    from: string;
+    to: string;
+    amount: bigint;
+    byAmountIn: boolean;
+    overlayFee?: OverlayFeeConfig;
+}): Promise<SwapRouteResult | null>;
+/**
+ * Build a swap PTB from a route result. The caller must provide an input coin
+ * obtained by splitting/merging wallet coins.
+ *
+ * **Important:** Cetus's `routerSwap` reads the overlay-fee config from the
+ * AggregatorClient instance. The `overlayFee` param here MUST match the one
+ * passed to `findSwapRoute` for the same swap (otherwise you'll hit the cache
+ * boundary and get a different client with different overlay config).
+ */
+declare function buildSwapTx(params: {
+    walletAddress: string;
+    route: SwapRouteResult;
+    tx: Transaction;
+    inputCoin: TransactionObjectArgument;
+    slippage: number;
+    overlayFee?: OverlayFeeConfig;
+}): Promise<TransactionObjectArgument>;
+
+type SafeguardRule = 'locked' | 'maxPerTx' | 'maxDailySend';
+interface SafeguardErrorDetails {
+    attempted?: number;
+    limit?: number;
+    current?: number;
+}
+declare class SafeguardError extends T2000Error {
+    readonly rule: SafeguardRule;
+    readonly details: SafeguardErrorDetails;
+    constructor(rule: SafeguardRule, details: SafeguardErrorDetails, message?: string);
+    toJSON(): {
+        error: "SAFEGUARD_BLOCKED";
+        message: string;
+        retryable: boolean;
+        data: {
+            attempted?: number;
+            limit?: number;
+            current?: number;
+            rule: SafeguardRule;
+        };
+    };
+}
+
+interface SafeguardConfig {
+    locked: boolean;
+    maxPerTx: number;
+    maxDailySend: number;
+    dailyUsed: number;
+    dailyResetDate: string;
+    maxLeverage?: number;
+    maxPositionSize?: number;
+}
+interface TxMetadata {
+    operation: 'send' | 'save' | 'withdraw' | 'borrow' | 'repay' | 'pay';
+    amount?: number;
+}
+declare const OUTBOUND_OPS: Set<"save" | "borrow" | "withdraw" | "repay" | "send" | "pay">;
+declare const DEFAULT_SAFEGUARD_CONFIG: SafeguardConfig;
+
+export { WAL_TYPE as $, ALL_NAVI_ASSETS as A, BORROW_FEE_BPS as B, CLOCK_ID as C, DEFAULT_NETWORK as D, ETH_TYPE as E, type FeeOperation as F, GAS_RESERVE_MIN as G, type T2000ErrorData as H, IKA_TYPE as I, T2000_OVERLAY_FEE_WALLET as J, KNOWN_TARGETS as K, LABEL_PATTERNS as L, MANIFEST_TYPE as M, NAVX_TYPE as N, OUTBOUND_OPS as O, type ProtocolFeeInfo as P, TOKEN_MAP as Q, type TransactionSigner as R, SAVE_FEE_BPS as S, T2000Error as T, type TxDirection as U, type TxMetadata as V, USDC_DECIMALS as W, USDC_TYPE as X, USDE_TYPE as Y, USDSUI_TYPE as Z, USDT_TYPE as _, BPS_DENOMINATOR as a, WBTC_TYPE as a0, type ZkLoginProof as a1, ZkLoginSigner as a2, addFeeTransfer as a3, buildSwapTx as a4, calculateFee as a5, classifyAction as a6, classifyLabel as a7, classifyTransaction as a8, extractTransferDetails as a9, validateAddress as aA, CETUS_USDC_SUI_POOL as aB, OPERATION_ASSETS as aC, type Operation as aD, assertAllowedAsset as aE, isAllowedAsset as aF, normalizeCoinType as aG, queryHistory as aH, queryTransaction as aI, simulateTransaction as aJ, throwIfSimulationFailed as aK, extractTxCommands as aa, extractTxSender as ab, fallbackLabel as ac, findSwapRoute as ad, formatAssetAmount as ae, formatSui as af, formatUsd as ag, getDecimals as ah, getDecimalsForCoinType as ai, getTier as aj, isSupported as ak, isTier1 as al, isTier2 as am, mapMoveAbortCode as an, mapWalletError as ao, mistToSui as ap, parseSuiRpcTx as aq, rawToStable as ar, rawToUsdc as as, refineLendingLabel as at, resolveSymbol as au, resolveTokenType as av, stableToRaw as aw, suiToMist as ax, truncateAddress as ay, usdcToRaw as az, COIN_REGISTRY as b, type ClassifyBalanceChange as c, type ClassifyResult as d, type CoinMeta as e, DEFAULT_SAFEGUARD_CONFIG as f, type ExtractedTransfer as g, KeypairSigner as h, LOFI_TYPE as i, MIST_PER_SUI as j, OVERLAY_FEE_RATE as k, type OverlayFeeConfig as l, STABLE_ASSETS as m, SUI_DECIMALS as n, SUI_TYPE as o, SUPPORTED_ASSETS as p, type SafeguardConfig as q, SafeguardError as r, type SafeguardErrorDetails as s, type SafeguardRule as t, type SimulationResult as u, type StableAsset as v, type SuiRpcTxBlock as w, type SupportedAsset as x, type SwapRouteResult as y, type T2000ErrorCode as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t2000/sdk",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "TypeScript SDK for AI agent bank accounts on Sui — send, save, borrow, swap. NAVI lending + Cetus aggregator routing, sponsored gas, zkLogin compatible.",
   "type": "module",
   "main": "./dist/index.cjs",