@t2000/sdk 1.12.0 → 1.13.1

package/dist/index.d.cts

@@ -1,8 +1,8 @@
 import { EventEmitter } from 'eventemitter3';
 import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
-import { V as TxMetadata, q as SafeguardConfig, T as T2000Error, R as TransactionSigner, a1 as ZkLoginProof, x as SupportedAsset, l as OverlayFeeConfig, y as SwapRouteResult } from './types-DXM0Hixp.cjs';
-export { A as ALL_NAVI_ASSETS, B as BORROW_FEE_BPS, a as BPS_DENOMINATOR, aB as CETUS_USDC_SUI_POOL, 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, I as IKA_TYPE, K as KNOWN_TARGETS, h as KeypairSigner, L as LABEL_PATTERNS, i as LOFI_TYPE, M as MANIFEST_TYPE, j as MIST_PER_SUI, N as NAVX_TYPE, aC as OPERATION_ASSETS, O as OUTBOUND_OPS, k as OVERLAY_FEE_RATE, aD as Operation, P as ProtocolFeeInfo, S as SAVE_FEE_BPS, m as STABLE_ASSETS, n as SUI_DECIMALS, o as SUI_TYPE, p as SUPPORTED_ASSETS, r as SafeguardError, s as SafeguardErrorDetails, t as SafeguardRule, u as SimulationResult, v as StableAsset, w as SuiRpcTxBlock, z as T2000ErrorCode, H as T2000ErrorData, J as T2000_OVERLAY_FEE_WALLET, Q as TOKEN_MAP, U as TxDirection, W as USDC_DECIMALS, X as USDC_TYPE, Y as USDE_TYPE, Z as USDSUI_TYPE, _ as USDT_TYPE, $ as WAL_TYPE, a0 as WBTC_TYPE, a2 as ZkLoginSigner, a3 as addFeeTransfer, aE as addSwapToTx, aF as assertAllowedAsset, a4 as buildSwapTx, a5 as calculateFee, a6 as classifyAction, a7 as classifyLabel, a8 as classifyTransaction, a9 as extractTransferDetails, aa as extractTxCommands, ab as extractTxSender, ac as fallbackLabel, ad as findSwapRoute, ae as formatAssetAmount, af as formatSui, ag as formatUsd, aG as getCoinMeta, ah as getDecimals, ai as getDecimalsForCoinType, aj as getTier, aH as isAllowedAsset, aI as isInRegistry, ak as isSupported, al as isTier1, am as isTier2, an as mapMoveAbortCode, ao as mapWalletError, ap as mistToSui, aJ as normalizeAsset, aK as normalizeCoinType, aq as parseSuiRpcTx, aL as queryHistory, aM as queryTransaction, ar as rawToStable, as as rawToUsdc, at as refineLendingLabel, au as resolveSymbol, av as resolveTokenType, aN as simulateTransaction, aw as stableToRaw, ax as suiToMist, aO as throwIfSimulationFailed, ay as truncateAddress, az as usdcToRaw, aA as validateAddress } from './types-DXM0Hixp.cjs';
+import { V as TxMetadata, q as SafeguardConfig, T as T2000Error, R as TransactionSigner, a1 as ZkLoginProof, x as SupportedAsset, l as OverlayFeeConfig, y as SwapRouteResult } from './types-D03bON1v.cjs';
+export { A as ALL_NAVI_ASSETS, B as BORROW_FEE_BPS, a as BPS_DENOMINATOR, aB as CETUS_USDC_SUI_POOL, 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, I as IKA_TYPE, K as KNOWN_TARGETS, h as KeypairSigner, L as LABEL_PATTERNS, i as LOFI_TYPE, M as MANIFEST_TYPE, j as MIST_PER_SUI, N as NAVX_TYPE, aC as OPERATION_ASSETS, O as OUTBOUND_OPS, k as OVERLAY_FEE_RATE, aD as Operation, P as ProtocolFeeInfo, S as SAVE_FEE_BPS, m as STABLE_ASSETS, n as SUI_DECIMALS, o as SUI_TYPE, p as SUPPORTED_ASSETS, r as SafeguardError, s as SafeguardErrorDetails, t as SafeguardRule, u as SimulationResult, v as StableAsset, w as SuiRpcTxBlock, z as T2000ErrorCode, H as T2000ErrorData, J as T2000_OVERLAY_FEE_WALLET, Q as TOKEN_MAP, U as TxDirection, W as USDC_DECIMALS, X as USDC_TYPE, Y as USDE_TYPE, Z as USDSUI_TYPE, _ as USDT_TYPE, $ as WAL_TYPE, a0 as WBTC_TYPE, a2 as ZkLoginSigner, a3 as addFeeTransfer, aE as addSwapToTx, aF as assertAllowedAsset, a4 as buildSwapTx, a5 as calculateFee, a6 as classifyAction, a7 as classifyLabel, a8 as classifyTransaction, a9 as extractTransferDetails, aa as extractTxCommands, ab as extractTxSender, ac as fallbackLabel, ad as findSwapRoute, ae as formatAssetAmount, af as formatSui, ag as formatUsd, aG as getCoinMeta, ah as getDecimals, ai as getDecimalsForCoinType, aj as getTier, aH as isAllowedAsset, aI as isInRegistry, ak as isSupported, al as isTier1, am as isTier2, an as mapMoveAbortCode, ao as mapWalletError, ap as mistToSui, aJ as normalizeAsset, aK as normalizeCoinType, aq as parseSuiRpcTx, aL as queryHistory, aM as queryTransaction, ar as rawToStable, as as rawToUsdc, at as refineLendingLabel, au as resolveSymbol, av as resolveTokenType, aN as simulateTransaction, aw as stableToRaw, ax as suiToMist, aO as throwIfSimulationFailed, ay as truncateAddress, az as usdcToRaw, aA as validateAddress } from './types-D03bON1v.cjs';
 import { L as LendingAdapter, a as LendingRates, P as PendingReward$1 } from './descriptors-BnbL3xN8.cjs';
 export { A as AdapterCapability, b as AdapterPositions, c as AdapterTxResult, H as HealthInfo, d as ProtocolDescriptor, e as allDescriptors, n as naviDescriptor } from './descriptors-BnbL3xN8.cjs';
 import { i as T2000Options, P as PayOptions, c as PayResult, j as StakeVSuiResult, U as UnstakeVSuiResult, k as SwapResult, l as SwapQuoteResult, h as SendResult, B as BalanceResponse, T as TransactionRecord, D as DepositInfo, m as PaymentRequest, S as SaveResult, W as WithdrawResult, b as MaxWithdrawResult, a as BorrowResult, g as RepayResult, M as MaxBorrowResult, H as HealthFactorResult, d as PendingReward, C as ClaimRewardsResult, n as CompoundRewardsResult, f as PositionsResult, R as RatesResult, E as EarningsResult, F as FundStatusResult, o as FinancialSummary } from './types-jAD-e7Pq.cjs';
@@ -482,10 +482,23 @@ interface VoloUnstakeInput {
  * Discriminated union mapping `toolName` → `input`. Used to type
  * `WriteStep` so consumers get autocomplete + compile-time validation
  * that the input matches the tool.
+ *
+ * **[SPEC 13 Phase 1] `inputCoinFromStep`** — consumer steps may
+ * reference an earlier step's output coin handle by index. When set,
+ * `composeTx`'s orchestration loop threads the producer's
+ * `outputCoin` into this step's appender as the `inputCoin` arg,
+ * bypassing the wallet pre-fetch path. The producer's terminal
+ * `tx.transferObjects([coin], sender)` is suppressed automatically so
+ * the same handle isn't double-consumed.
+ *
+ * Producer-only tools (`withdraw`, `borrow`, `claim_rewards`) don't
+ * accept the field — they have no input coin slot. Consumer +
+ * dual-mode tools all accept it.
  */
 type WriteStep = {
     toolName: 'save_deposit';
     input: SaveDepositInput;
+    inputCoinFromStep?: number;
 } | {
     toolName: 'withdraw';
     input: WithdrawInput;
@@ -495,21 +508,26 @@ type WriteStep = {
 } | {
     toolName: 'repay_debt';
     input: RepayDebtInput;
+    inputCoinFromStep?: number;
 } | {
     toolName: 'send_transfer';
     input: SendTransferInput;
+    inputCoinFromStep?: number;
 } | {
     toolName: 'swap_execute';
     input: SwapExecuteInput;
+    inputCoinFromStep?: number;
 } | {
     toolName: 'claim_rewards';
     input: ClaimRewardsInput;
 } | {
     toolName: 'volo_stake';
     input: VoloStakeInput;
+    inputCoinFromStep?: number;
 } | {
     toolName: 'volo_unstake';
     input: VoloUnstakeInput;
+    inputCoinFromStep?: number;
 };
 interface ComposeTxOptions {
     sender: string;
@@ -647,8 +665,8 @@ interface ComposeTxResult {
 }
 /**
  * Per-appender context passed into every registry entry. Carries the
- * RPC client, sender, sponsorship flag, and optional per-call overlay
- * fee config (Cetus swaps).
+ * RPC client, sender, sponsorship flag, optional per-call overlay
+ * fee config (Cetus swaps), and SPEC 13 Phase 1 chain-mode fields.
  */
 interface AppenderContext {
     client: SuiJsonRpcClient;
@@ -656,8 +674,46 @@ interface AppenderContext {
     sponsoredContext: boolean;
     overlayFee?: OverlayFeeConfig;
     feeHooks?: ComposeTxFeeHooks;
+    /**
+     * [SPEC 13 Phase 1] When set, the consumer appender consumes this
+     * coin handle directly instead of pre-fetching from the wallet via
+     * `selectAndSplitCoin` / `selectSuiCoin`. Provided by the
+     * orchestration loop when the step has `inputCoinFromStep` set; the
+     * loop looks up `priorOutputs[step.inputCoinFromStep]` and threads
+     * it through here.
+     *
+     * In chain mode, the consumer consumes the handle IN FULL — the
+     * `input.amount` field is treated as informational (used for preview
+     * math). This matches Cetus's `routerSwap`, NAVI's `deposit`/`repay`,
+     * and the Sui `transferObjects` semantics: each takes a coin object
+     * and consumes its entire balance.
+     */
+    chainedCoin?: TransactionObjectArgument;
+    /**
+     * [SPEC 13 Phase 1] True when this step's output coin will be
+     * consumed by a downstream step (some later step has
+     * `inputCoinFromStep === currentStepIndex`). Producer appenders MUST
+     * skip their terminal `tx.transferObjects([coin], ctx.sender)` call
+     * when this is true — otherwise the same `TransactionObjectArgument`
+     * gets used twice (once by the consumer, once by the transfer) and
+     * the PTB build fails or the on-chain leg reverts.
+     */
+    isOutputConsumed?: boolean;
+}
+/**
+ * [SPEC 13 Phase 1] Appender return shape. Producers populate
+ * `outputCoin` so the orchestration loop can thread it into a
+ * downstream consumer's `chainedCoin`. Terminal consumers
+ * (`save_deposit`, `repay_debt`, `send_transfer`) omit it.
+ *
+ * `swap_execute`, `volo_stake`, and `volo_unstake` are dual-mode —
+ * they accept `chainedCoin` AND populate `outputCoin`.
+ */
+interface AppenderResult<TPreview extends StepPreview> {
+    preview: TPreview;
+    outputCoin?: TransactionObjectArgument;
 }
-type AppenderFn<TInput, TPreview extends StepPreview> = (tx: Transaction, input: TInput, ctx: AppenderContext) => Promise<TPreview>;
+type AppenderFn<TInput, TPreview extends StepPreview> = (tx: Transaction, input: TInput, ctx: AppenderContext) => Promise<AppenderResult<TPreview>>;
 /**
  * The typed registry. Each entry is a wallet-mode dispatcher that takes
  * (tx, input, ctx) and returns a per-step preview. Compile-time check

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import { EventEmitter } from 'eventemitter3';
 import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
-import { V as TxMetadata, q as SafeguardConfig, T as T2000Error, R as TransactionSigner, a1 as ZkLoginProof, x as SupportedAsset, l as OverlayFeeConfig, y as SwapRouteResult } from './types-BuwFyb-U.js';
-export { A as ALL_NAVI_ASSETS, B as BORROW_FEE_BPS, a as BPS_DENOMINATOR, aB as CETUS_USDC_SUI_POOL, 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, I as IKA_TYPE, K as KNOWN_TARGETS, h as KeypairSigner, L as LABEL_PATTERNS, i as LOFI_TYPE, M as MANIFEST_TYPE, j as MIST_PER_SUI, N as NAVX_TYPE, aC as OPERATION_ASSETS, O as OUTBOUND_OPS, k as OVERLAY_FEE_RATE, aD as Operation, P as ProtocolFeeInfo, S as SAVE_FEE_BPS, m as STABLE_ASSETS, n as SUI_DECIMALS, o as SUI_TYPE, p as SUPPORTED_ASSETS, r as SafeguardError, s as SafeguardErrorDetails, t as SafeguardRule, u as SimulationResult, v as StableAsset, w as SuiRpcTxBlock, z as T2000ErrorCode, H as T2000ErrorData, J as T2000_OVERLAY_FEE_WALLET, Q as TOKEN_MAP, U as TxDirection, W as USDC_DECIMALS, X as USDC_TYPE, Y as USDE_TYPE, Z as USDSUI_TYPE, _ as USDT_TYPE, $ as WAL_TYPE, a0 as WBTC_TYPE, a2 as ZkLoginSigner, a3 as addFeeTransfer, aE as addSwapToTx, aF as assertAllowedAsset, a4 as buildSwapTx, a5 as calculateFee, a6 as classifyAction, a7 as classifyLabel, a8 as classifyTransaction, a9 as extractTransferDetails, aa as extractTxCommands, ab as extractTxSender, ac as fallbackLabel, ad as findSwapRoute, ae as formatAssetAmount, af as formatSui, ag as formatUsd, aG as getCoinMeta, ah as getDecimals, ai as getDecimalsForCoinType, aj as getTier, aH as isAllowedAsset, aI as isInRegistry, ak as isSupported, al as isTier1, am as isTier2, an as mapMoveAbortCode, ao as mapWalletError, ap as mistToSui, aJ as normalizeAsset, aK as normalizeCoinType, aq as parseSuiRpcTx, aL as queryHistory, aM as queryTransaction, ar as rawToStable, as as rawToUsdc, at as refineLendingLabel, au as resolveSymbol, av as resolveTokenType, aN as simulateTransaction, aw as stableToRaw, ax as suiToMist, aO as throwIfSimulationFailed, ay as truncateAddress, az as usdcToRaw, aA as validateAddress } from './types-BuwFyb-U.js';
+import { V as TxMetadata, q as SafeguardConfig, T as T2000Error, R as TransactionSigner, a1 as ZkLoginProof, x as SupportedAsset, l as OverlayFeeConfig, y as SwapRouteResult } from './types-DCb8Xt_q.js';
+export { A as ALL_NAVI_ASSETS, B as BORROW_FEE_BPS, a as BPS_DENOMINATOR, aB as CETUS_USDC_SUI_POOL, 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, I as IKA_TYPE, K as KNOWN_TARGETS, h as KeypairSigner, L as LABEL_PATTERNS, i as LOFI_TYPE, M as MANIFEST_TYPE, j as MIST_PER_SUI, N as NAVX_TYPE, aC as OPERATION_ASSETS, O as OUTBOUND_OPS, k as OVERLAY_FEE_RATE, aD as Operation, P as ProtocolFeeInfo, S as SAVE_FEE_BPS, m as STABLE_ASSETS, n as SUI_DECIMALS, o as SUI_TYPE, p as SUPPORTED_ASSETS, r as SafeguardError, s as SafeguardErrorDetails, t as SafeguardRule, u as SimulationResult, v as StableAsset, w as SuiRpcTxBlock, z as T2000ErrorCode, H as T2000ErrorData, J as T2000_OVERLAY_FEE_WALLET, Q as TOKEN_MAP, U as TxDirection, W as USDC_DECIMALS, X as USDC_TYPE, Y as USDE_TYPE, Z as USDSUI_TYPE, _ as USDT_TYPE, $ as WAL_TYPE, a0 as WBTC_TYPE, a2 as ZkLoginSigner, a3 as addFeeTransfer, aE as addSwapToTx, aF as assertAllowedAsset, a4 as buildSwapTx, a5 as calculateFee, a6 as classifyAction, a7 as classifyLabel, a8 as classifyTransaction, a9 as extractTransferDetails, aa as extractTxCommands, ab as extractTxSender, ac as fallbackLabel, ad as findSwapRoute, ae as formatAssetAmount, af as formatSui, ag as formatUsd, aG as getCoinMeta, ah as getDecimals, ai as getDecimalsForCoinType, aj as getTier, aH as isAllowedAsset, aI as isInRegistry, ak as isSupported, al as isTier1, am as isTier2, an as mapMoveAbortCode, ao as mapWalletError, ap as mistToSui, aJ as normalizeAsset, aK as normalizeCoinType, aq as parseSuiRpcTx, aL as queryHistory, aM as queryTransaction, ar as rawToStable, as as rawToUsdc, at as refineLendingLabel, au as resolveSymbol, av as resolveTokenType, aN as simulateTransaction, aw as stableToRaw, ax as suiToMist, aO as throwIfSimulationFailed, ay as truncateAddress, az as usdcToRaw, aA as validateAddress } from './types-DCb8Xt_q.js';
 import { L as LendingAdapter, a as LendingRates, P as PendingReward$1 } from './descriptors-BnbL3xN8.js';
 export { A as AdapterCapability, b as AdapterPositions, c as AdapterTxResult, H as HealthInfo, d as ProtocolDescriptor, e as allDescriptors, n as naviDescriptor } from './descriptors-BnbL3xN8.js';
 import { i as T2000Options, P as PayOptions, c as PayResult, j as StakeVSuiResult, U as UnstakeVSuiResult, k as SwapResult, l as SwapQuoteResult, h as SendResult, B as BalanceResponse, T as TransactionRecord, D as DepositInfo, m as PaymentRequest, S as SaveResult, W as WithdrawResult, b as MaxWithdrawResult, a as BorrowResult, g as RepayResult, M as MaxBorrowResult, H as HealthFactorResult, d as PendingReward, C as ClaimRewardsResult, n as CompoundRewardsResult, f as PositionsResult, R as RatesResult, E as EarningsResult, F as FundStatusResult, o as FinancialSummary } from './types-jAD-e7Pq.js';
@@ -482,10 +482,23 @@ interface VoloUnstakeInput {
  * Discriminated union mapping `toolName` → `input`. Used to type
  * `WriteStep` so consumers get autocomplete + compile-time validation
  * that the input matches the tool.
+ *
+ * **[SPEC 13 Phase 1] `inputCoinFromStep`** — consumer steps may
+ * reference an earlier step's output coin handle by index. When set,
+ * `composeTx`'s orchestration loop threads the producer's
+ * `outputCoin` into this step's appender as the `inputCoin` arg,
+ * bypassing the wallet pre-fetch path. The producer's terminal
+ * `tx.transferObjects([coin], sender)` is suppressed automatically so
+ * the same handle isn't double-consumed.
+ *
+ * Producer-only tools (`withdraw`, `borrow`, `claim_rewards`) don't
+ * accept the field — they have no input coin slot. Consumer +
+ * dual-mode tools all accept it.
  */
 type WriteStep = {
     toolName: 'save_deposit';
     input: SaveDepositInput;
+    inputCoinFromStep?: number;
 } | {
     toolName: 'withdraw';
     input: WithdrawInput;
@@ -495,21 +508,26 @@ type WriteStep = {
 } | {
     toolName: 'repay_debt';
     input: RepayDebtInput;
+    inputCoinFromStep?: number;
 } | {
     toolName: 'send_transfer';
     input: SendTransferInput;
+    inputCoinFromStep?: number;
 } | {
     toolName: 'swap_execute';
     input: SwapExecuteInput;
+    inputCoinFromStep?: number;
 } | {
     toolName: 'claim_rewards';
     input: ClaimRewardsInput;
 } | {
     toolName: 'volo_stake';
     input: VoloStakeInput;
+    inputCoinFromStep?: number;
 } | {
     toolName: 'volo_unstake';
     input: VoloUnstakeInput;
+    inputCoinFromStep?: number;
 };
 interface ComposeTxOptions {
     sender: string;
@@ -647,8 +665,8 @@ interface ComposeTxResult {
 }
 /**
  * Per-appender context passed into every registry entry. Carries the
- * RPC client, sender, sponsorship flag, and optional per-call overlay
- * fee config (Cetus swaps).
+ * RPC client, sender, sponsorship flag, optional per-call overlay
+ * fee config (Cetus swaps), and SPEC 13 Phase 1 chain-mode fields.
  */
 interface AppenderContext {
     client: SuiJsonRpcClient;
@@ -656,8 +674,46 @@ interface AppenderContext {
     sponsoredContext: boolean;
     overlayFee?: OverlayFeeConfig;
     feeHooks?: ComposeTxFeeHooks;
+    /**
+     * [SPEC 13 Phase 1] When set, the consumer appender consumes this
+     * coin handle directly instead of pre-fetching from the wallet via
+     * `selectAndSplitCoin` / `selectSuiCoin`. Provided by the
+     * orchestration loop when the step has `inputCoinFromStep` set; the
+     * loop looks up `priorOutputs[step.inputCoinFromStep]` and threads
+     * it through here.
+     *
+     * In chain mode, the consumer consumes the handle IN FULL — the
+     * `input.amount` field is treated as informational (used for preview
+     * math). This matches Cetus's `routerSwap`, NAVI's `deposit`/`repay`,
+     * and the Sui `transferObjects` semantics: each takes a coin object
+     * and consumes its entire balance.
+     */
+    chainedCoin?: TransactionObjectArgument;
+    /**
+     * [SPEC 13 Phase 1] True when this step's output coin will be
+     * consumed by a downstream step (some later step has
+     * `inputCoinFromStep === currentStepIndex`). Producer appenders MUST
+     * skip their terminal `tx.transferObjects([coin], ctx.sender)` call
+     * when this is true — otherwise the same `TransactionObjectArgument`
+     * gets used twice (once by the consumer, once by the transfer) and
+     * the PTB build fails or the on-chain leg reverts.
+     */
+    isOutputConsumed?: boolean;
+}
+/**
+ * [SPEC 13 Phase 1] Appender return shape. Producers populate
+ * `outputCoin` so the orchestration loop can thread it into a
+ * downstream consumer's `chainedCoin`. Terminal consumers
+ * (`save_deposit`, `repay_debt`, `send_transfer`) omit it.
+ *
+ * `swap_execute`, `volo_stake`, and `volo_unstake` are dual-mode —
+ * they accept `chainedCoin` AND populate `outputCoin`.
+ */
+interface AppenderResult<TPreview extends StepPreview> {
+    preview: TPreview;
+    outputCoin?: TransactionObjectArgument;
 }
-type AppenderFn<TInput, TPreview extends StepPreview> = (tx: Transaction, input: TInput, ctx: AppenderContext) => Promise<TPreview>;
+type AppenderFn<TInput, TPreview extends StepPreview> = (tx: Transaction, input: TInput, ctx: AppenderContext) => Promise<AppenderResult<TPreview>>;
 /**
  * The typed registry. Each entry is a wallet-mode dispatcher that takes
  * (tx, input, ctx) and returns a per-step preview. Compile-time check

package/dist/index.js

@@ -7480,21 +7480,26 @@ var WRITE_APPENDER_REGISTRY = {
       throw new T2000Error("INVALID_AMOUNT", "Save amount must be greater than zero");
     }
     const rawAmount = BigInt(Math.floor(input.amount * 10 ** assetInfo.decimals));
-    const { coin, effectiveAmount } = await selectAndSplitCoin(
-      tx,
-      ctx.client,
-      ctx.sender,
-      assetInfo.type,
-      rawAmount
-    );
+    let coin;
+    let effectiveAmount;
+    if (ctx.chainedCoin) {
+      coin = ctx.chainedCoin;
+      effectiveAmount = rawAmount;
+    } else {
+      const r = await selectAndSplitCoin(tx, ctx.client, ctx.sender, assetInfo.type, rawAmount);
+      coin = r.coin;
+      effectiveAmount = r.effectiveAmount;
+    }
     if (ctx.feeHooks?.save_deposit) {
       await ctx.feeHooks.save_deposit({ tx, coin, input, sender: ctx.sender });
     }
     await addSaveToTx(tx, ctx.client, ctx.sender, coin, { asset });
     return {
-      toolName: "save_deposit",
-      effectiveAmount: Number(effectiveAmount) / 10 ** assetInfo.decimals,
-      asset
+      preview: {
+        toolName: "save_deposit",
+        effectiveAmount: Number(effectiveAmount) / 10 ** assetInfo.decimals,
+        asset
+      }
     };
   },
   withdraw: async (tx, input, ctx) => {
@@ -7509,8 +7514,13 @@ var WRITE_APPENDER_REGISTRY = {
       input.amount,
       { asset, skipPythUpdate: ctx.sponsoredContext }
     );
-    tx.transferObjects([coin], ctx.sender);
-    return { toolName: "withdraw", effectiveAmount, asset };
+    if (!ctx.isOutputConsumed) {
+      tx.transferObjects([coin], ctx.sender);
+    }
+    return {
+      preview: { toolName: "withdraw", effectiveAmount, asset },
+      outputCoin: coin
+    };
   },
   borrow: async (tx, input, ctx) => {
     const asset = resolveSaveableAsset(input.asset);
@@ -7527,8 +7537,13 @@ var WRITE_APPENDER_REGISTRY = {
     if (ctx.feeHooks?.borrow) {
       await ctx.feeHooks.borrow({ tx, coin, input, sender: ctx.sender });
     }
-    tx.transferObjects([coin], ctx.sender);
-    return { toolName: "borrow", effectiveAmount: input.amount, asset };
+    if (!ctx.isOutputConsumed) {
+      tx.transferObjects([coin], ctx.sender);
+    }
+    return {
+      preview: { toolName: "borrow", effectiveAmount: input.amount, asset },
+      outputCoin: coin
+    };
   },
   repay_debt: async (tx, input, ctx) => {
     const asset = resolveSaveableAsset(input.asset);
@@ -7537,21 +7552,26 @@ var WRITE_APPENDER_REGISTRY = {
       throw new T2000Error("INVALID_AMOUNT", "Repay amount must be greater than zero");
     }
     const rawAmount = BigInt(Math.floor(input.amount * 10 ** assetInfo.decimals));
-    const { coin, effectiveAmount } = await selectAndSplitCoin(
-      tx,
-      ctx.client,
-      ctx.sender,
-      assetInfo.type,
-      rawAmount
-    );
+    let coin;
+    let effectiveAmount;
+    if (ctx.chainedCoin) {
+      coin = ctx.chainedCoin;
+      effectiveAmount = rawAmount;
+    } else {
+      const r = await selectAndSplitCoin(tx, ctx.client, ctx.sender, assetInfo.type, rawAmount);
+      coin = r.coin;
+      effectiveAmount = r.effectiveAmount;
+    }
     await addRepayToTx(tx, ctx.client, ctx.sender, coin, {
       asset,
       skipOracle: ctx.sponsoredContext
     });
     return {
-      toolName: "repay_debt",
-      effectiveAmount: Number(effectiveAmount) / 10 ** assetInfo.decimals,
-      asset
+      preview: {
+        toolName: "repay_debt",
+        effectiveAmount: Number(effectiveAmount) / 10 ** assetInfo.decimals,
+        asset
+      }
     };
   },
   send_transfer: async (tx, input, ctx) => {
@@ -7567,7 +7587,10 @@ var WRITE_APPENDER_REGISTRY = {
     const rawAmount = BigInt(Math.floor(input.amount * 10 ** assetInfo.decimals));
     let coin;
     let effectiveRaw;
-    if (asset === "SUI") {
+    if (ctx.chainedCoin) {
+      coin = ctx.chainedCoin;
+      effectiveRaw = rawAmount;
+    } else if (asset === "SUI") {
       const result = await selectSuiCoin(tx, ctx.client, ctx.sender, rawAmount, ctx.sponsoredContext);
       coin = result.coin;
       effectiveRaw = result.effectiveAmount;
@@ -7578,10 +7601,12 @@ var WRITE_APPENDER_REGISTRY = {
     }
     addSendToTx(tx, coin, recipient);
     return {
-      toolName: "send_transfer",
-      effectiveAmount: Number(effectiveRaw) / 10 ** assetInfo.decimals,
-      recipient,
-      asset
+      preview: {
+        toolName: "send_transfer",
+        effectiveAmount: Number(effectiveRaw) / 10 ** assetInfo.decimals,
+        recipient,
+        asset
+      }
     };
   },
   swap_execute: async (tx, input, ctx) => {
@@ -7601,37 +7626,59 @@ var WRITE_APPENDER_REGISTRY = {
       slippage: input.slippage,
       byAmountIn: input.byAmountIn,
       overlayFee: ctx.overlayFee,
-      providers
+      providers,
+      inputCoin: ctx.chainedCoin
     });
-    tx.transferObjects([result.coin], ctx.sender);
+    if (!ctx.isOutputConsumed) {
+      tx.transferObjects([result.coin], ctx.sender);
+    }
     return {
-      toolName: "swap_execute",
-      effectiveAmountIn: result.effectiveAmountIn,
-      expectedAmountOut: result.expectedAmountOut,
-      route: result.route
+      preview: {
+        toolName: "swap_execute",
+        effectiveAmountIn: result.effectiveAmountIn,
+        expectedAmountOut: result.expectedAmountOut,
+        route: result.route
+      },
+      outputCoin: result.coin
     };
   },
   claim_rewards: async (tx, _input, ctx) => {
     const rewards = await addClaimRewardsToTx(tx, ctx.client, ctx.sender);
-    return { toolName: "claim_rewards", rewards };
+    return { preview: { toolName: "claim_rewards", rewards } };
   },
   volo_stake: async (tx, input, ctx) => {
     if (input.amountSui <= 0) {
       throw new T2000Error("INVALID_AMOUNT", "Stake amount must be greater than zero");
     }
     const amountMist = BigInt(Math.floor(input.amountSui * 1e9));
-    const result = await addStakeVSuiToTx(tx, ctx.client, ctx.sender, { amountMist });
-    tx.transferObjects([result.coin], ctx.sender);
-    return { toolName: "volo_stake", effectiveAmountMist: result.effectiveAmountMist };
+    const result = await addStakeVSuiToTx(tx, ctx.client, ctx.sender, {
+      amountMist,
+      inputCoin: ctx.chainedCoin
+    });
+    if (!ctx.isOutputConsumed) {
+      tx.transferObjects([result.coin], ctx.sender);
+    }
+    return {
+      preview: { toolName: "volo_stake", effectiveAmountMist: result.effectiveAmountMist },
+      outputCoin: result.coin
+    };
   },
   volo_unstake: async (tx, input, ctx) => {
     const amountMist = input.amountVSui === "all" ? "all" : BigInt(Math.floor(input.amountVSui * 1e9));
     if (amountMist !== "all" && amountMist <= 0n) {
       throw new T2000Error("INVALID_AMOUNT", "Unstake amount must be greater than zero");
     }
-    const result = await addUnstakeVSuiToTx(tx, ctx.client, ctx.sender, { amountMist });
-    tx.transferObjects([result.coin], ctx.sender);
-    return { toolName: "volo_unstake", effectiveAmountMist: result.effectiveAmountMist };
+    const result = await addUnstakeVSuiToTx(tx, ctx.client, ctx.sender, {
+      amountMist,
+      inputCoin: ctx.chainedCoin
+    });
+    if (!ctx.isOutputConsumed) {
+      tx.transferObjects([result.coin], ctx.sender);
+    }
+    return {
+      preview: { toolName: "volo_unstake", effectiveAmountMist: result.effectiveAmountMist },
+      outputCoin: result.coin
+    };
   }
 };
 function deriveAllowedAddressesFromPtb(tx) {
@@ -7670,15 +7717,38 @@ function base64ToBytes(b64) {
 async function composeTx(opts) {
   const tx = new Transaction();
   tx.setSender(opts.sender);
-  const ctx = {
+  const baseCtx = {
     client: opts.client,
     sender: opts.sender,
     sponsoredContext: opts.sponsoredContext ?? false,
     overlayFee: opts.overlayFee,
     feeHooks: opts.feeHooks
   };
+  const consumedSteps = /* @__PURE__ */ new Set();
+  for (let i = 0; i < opts.steps.length; i++) {
+    const step = opts.steps[i];
+    const stepWithChain = step;
+    const idx = stepWithChain.inputCoinFromStep;
+    if (idx === void 0) continue;
+    if (!Number.isInteger(idx) || idx < 0 || idx >= i) {
+      throw new T2000Error(
+        "CHAIN_MODE_INVALID",
+        `Step ${i} (${step.toolName}) has inputCoinFromStep=${idx}, which must be a non-negative integer < ${i} (forward-only references).`
+      );
+    }
+    const producer = opts.steps[idx];
+    if (producer.toolName === "save_deposit" || producer.toolName === "repay_debt" || producer.toolName === "send_transfer" || producer.toolName === "claim_rewards") {
+      throw new T2000Error(
+        "CHAIN_MODE_INVALID",
+        `Step ${i} (${step.toolName}) references step ${idx} (${producer.toolName}) as producer, but '${producer.toolName}' is a terminal consumer that does not produce a chainable coin handle. Allowed producers: withdraw, borrow, swap_execute, volo_stake, volo_unstake.`
+      );
+    }
+    consumedSteps.add(idx);
+  }
+  const priorOutputs = [];
   const previews = [];
-  for (const step of opts.steps) {
+  for (let i = 0; i < opts.steps.length; i++) {
+    const step = opts.steps[i];
     const appender = WRITE_APPENDER_REGISTRY[step.toolName];
     if (!appender) {
       throw new T2000Error(
@@ -7686,8 +7756,26 @@ async function composeTx(opts) {
         `No fragment appender registered for tool '${step.toolName}'. Allowed: ${Object.keys(WRITE_APPENDER_REGISTRY).join(", ")}`
       );
     }
-    const preview = await appender(tx, step.input, ctx);
-    previews.push(preview);
+    const stepWithChain = step;
+    let chainedCoin;
+    if (stepWithChain.inputCoinFromStep !== void 0) {
+      const upstream = priorOutputs[stepWithChain.inputCoinFromStep];
+      if (!upstream) {
+        throw new T2000Error(
+          "CHAIN_MODE_INVALID",
+          `Step ${i} (${step.toolName}) expected a coin handle from step ${stepWithChain.inputCoinFromStep}, but the producer did not return one.`
+        );
+      }
+      chainedCoin = upstream;
+    }
+    const stepCtx = {
+      ...baseCtx,
+      chainedCoin,
+      isOutputConsumed: consumedSteps.has(i)
+    };
+    const result = await appender(tx, step.input, stepCtx);
+    priorOutputs.push(result.outputCoin ?? null);
+    previews.push(result.preview);
   }
   const txKindBytes = await tx.build({ client: opts.client, onlyTransactionKind: true });
   const derivedAllowedAddresses = deriveAllowedAddressesFromPtb(tx);