@t2000/sdk 4.2.0 → 4.2.2

package/dist/index.d.cts

@@ -1,12 +1,12 @@
 import { EventEmitter } from 'eventemitter3';
 import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
-import { Q as TxMetadata, o as SafeguardConfig, T as T2000Error, H as TransactionSigner, v as SupportedAsset, _ as ZkLoginProof, ax as SendableAsset } from './types-CIclvR39.cjs';
-export { A as ALL_NAVI_ASSETS, B as BORROW_FEE_BPS, a as BPS_DENOMINATOR, ay as CETUS_USDC_SUI_POOL, C as CLOCK_ID, b as COIN_REGISTRY, c as ClassifyBalanceChange, d as ClassifyResult, e as CoinMeta, az as DEFAULT_GRPC_URL, D as DEFAULT_NETWORK, f as DEFAULT_SAFEGUARD_CONFIG, E as ETH_TYPE, g as ExtractedTransfer, F as FeeOperation, aA as GASLESS_MIN_STABLE_AMOUNT, aB as GASLESS_STABLE_TYPES, 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, aD as Operation, P as ProtocolFeeInfo, aE as SAVEABLE_ASSETS, S as SAVE_FEE_BPS, aF as SENDABLE_ASSETS, k as STABLE_ASSETS, l as SUI_DECIMALS, m as SUI_TYPE, n as SUPPORTED_ASSETS, p as SafeguardError, q as SafeguardErrorDetails, r as SafeguardRule, aG as SaveableAsset, s as SimulationResult, t as StableAsset, u as SuiRpcTxBlock, w as T2000ErrorCode, x as T2000ErrorData, y as T2000_OVERLAY_FEE_WALLET, z as TOKEN_MAP, J as TxDirection, U as USDC_DECIMALS, R as USDC_TYPE, V as USDE_TYPE, W as USDSUI_TYPE, X as USDT_TYPE, Y as WAL_TYPE, Z as WBTC_TYPE, $ as ZkLoginSigner, a0 as addFeeTransfer, aH as assertAllowedAsset, a1 as calculateFee, a2 as classifyAction, a3 as classifyLabel, a4 as classifyTransaction, aI as createSuiClient, a5 as extractAllUserLegs, a6 as extractTransferDetails, a7 as extractTxCommands, a8 as extractTxSender, a9 as fallbackLabel, aa as formatAssetAmount, ab as formatSui, ac as formatUsd, aJ as getCoinMeta, ad as getDecimals, ae as getDecimalsForCoinType, aK as getSuiClient, aL as getSuiGrpcClient, af as getTier, aM as isAllowedAsset, aN as isInRegistry, ag as isSupported, ah as isTier1, ai as isTier2, aj as mapMoveAbortCode, ak as mapWalletError, al as mistToSui, aO as normalizeAsset, aP as normalizeCoinType, am as parseSuiRpcTx, aQ as queryHistory, aR as queryTransaction, an as rawToStable, ao as rawToUsdc, ap as refineLendingLabel, aq as resolveSymbol, ar as resolveTokenType, aS as simulateTransaction, as as stableToRaw, at as suiToMist, aT as throwIfSimulationFailed, au as truncateAddress, av as usdcToRaw, aw as validateAddress } from './types-CIclvR39.cjs';
+import { Q as TxMetadata, o as SafeguardConfig, T as T2000Error, H as TransactionSigner, v as SupportedAsset, _ as ZkLoginProof, ax as SendableAsset } from './types-BjvEpkwT.cjs';
+export { A as ALL_NAVI_ASSETS, B as BORROW_FEE_BPS, a as BPS_DENOMINATOR, ay as CETUS_USDC_SUI_POOL, C as CLOCK_ID, b as COIN_REGISTRY, c as ClassifyBalanceChange, d as ClassifyResult, e as CoinMeta, az as DEFAULT_GRPC_URL, D as DEFAULT_NETWORK, f as DEFAULT_SAFEGUARD_CONFIG, E as ETH_TYPE, g as ExtractedTransfer, F as FeeOperation, aA as GASLESS_MIN_STABLE_AMOUNT, aB as GASLESS_STABLE_TYPES, 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, aD as Operation, P as ProtocolFeeInfo, aE as SAVEABLE_ASSETS, S as SAVE_FEE_BPS, aF as SENDABLE_ASSETS, k as STABLE_ASSETS, l as SUI_DECIMALS, m as SUI_TYPE, n as SUPPORTED_ASSETS, p as SafeguardError, q as SafeguardErrorDetails, r as SafeguardRule, aG as SaveableAsset, s as SimulationResult, t as StableAsset, u as SuiRpcTxBlock, w as T2000ErrorCode, x as T2000ErrorData, y as T2000_OVERLAY_FEE_WALLET, z as TOKEN_MAP, J as TxDirection, U as USDC_DECIMALS, R as USDC_TYPE, V as USDE_TYPE, W as USDSUI_TYPE, X as USDT_TYPE, Y as WAL_TYPE, Z as WBTC_TYPE, $ as ZkLoginSigner, a0 as addFeeTransfer, aH as assertAllowedAsset, a1 as calculateFee, a2 as classifyAction, a3 as classifyLabel, a4 as classifyTransaction, aI as createSuiClient, a5 as extractAllUserLegs, a6 as extractTransferDetails, a7 as extractTxCommands, a8 as extractTxSender, a9 as fallbackLabel, aa as formatAssetAmount, ab as formatSui, ac as formatUsd, aJ as getCoinMeta, ad as getDecimals, ae as getDecimalsForCoinType, aK as getSuiClient, aL as getSuiGrpcClient, af as getTier, aM as isAllowedAsset, aN as isInRegistry, ag as isSupported, ah as isTier1, ai as isTier2, aj as mapMoveAbortCode, ak as mapWalletError, al as mistToSui, aO as normalizeAsset, aP as normalizeCoinType, am as parseSuiRpcTx, aQ as queryHistory, aR as queryTransaction, an as rawToStable, ao as rawToUsdc, ap as refineLendingLabel, aq as resolveSymbol, ar as resolveTokenType, aS as simulateTransaction, as as stableToRaw, at as suiToMist, aT as throwIfSimulationFailed, au as truncateAddress, av as usdcToRaw, aw as validateAddress } from './types-BjvEpkwT.cjs';
 import { L as LendingAdapter, a as LendingRates, P as PendingReward$1 } from './descriptors-DqIb4AnV.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-DqIb4AnV.cjs';
-import { n as T2000Options, P as PayOptions, d as PayResult, o as SwapResult, p as SwapQuoteResult, i as SendResult, B as BalanceResponse, k as TransactionRecord, D as DepositInfo, q as PaymentRequest, S as SaveResult, W as WithdrawResult, b as MaxWithdrawResult, a as BorrowResult, h as RepayResult, M as MaxBorrowResult, H as HealthFactorResult, e as PendingReward, C as ClaimRewardsResult, r as CompoundRewardsResult, g as PositionsResult, R as RatesResult, E as EarningsResult, F as FundStatusResult, c as OverlayFeeConfig, j as SwapRouteResult, s as FinancialSummary } from './types-HJGbXJ37.cjs';
-export { A as AssetRates, G as GasReserve, t as HFAlertLevel, O as OVERLAY_FEE_RATE, f as PositionEntry, u as SerializedCetusRoute, v as SerializedCetusRoutePath, w as SerializedRouterDataV3, T as TransactionLeg, x as addSwapToTx, l as buildSwapTx, y as deserializeCetusRoute, m as findSwapRoute, z as isCetusRouteFresh, I as serializeCetusRoute, J as verifyCetusRouteCoinMatch } from './types-HJGbXJ37.cjs';
+import { n as T2000Options, P as PayOptions, d as PayResult, o as SwapResult, p as SwapQuoteResult, i as SendResult, B as BalanceResponse, k as TransactionRecord, D as DepositInfo, q as PaymentRequest, S as SaveResult, W as WithdrawResult, b as MaxWithdrawResult, a as BorrowResult, h as RepayResult, M as MaxBorrowResult, H as HealthFactorResult, e as PendingReward, C as ClaimRewardsResult, r as CompoundRewardsResult, g as PositionsResult, R as RatesResult, E as EarningsResult, F as FundStatusResult, c as OverlayFeeConfig, s as SponsoredCoinMergeCache, j as SwapRouteResult, t as FinancialSummary } from './types-Ch0zVUpC.cjs';
+export { A as AssetRates, u as CoinPage, G as GasReserve, v as HFAlertLevel, O as OVERLAY_FEE_RATE, f as PositionEntry, w as SelectAndSplitResult, x as SerializedCetusRoute, y as SerializedCetusRoutePath, z as SerializedRouterDataV3, T as TransactionLeg, I as addSwapToTx, l as buildSwapTx, J as deserializeCetusRoute, K as fetchAllCoins, m as findSwapRoute, L as isCetusRouteFresh, N as selectAndSplitCoin, Q as selectSuiCoin, U as serializeCetusRoute, V as verifyCetusRouteCoinMatch } from './types-Ch0zVUpC.cjs';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
 import { SuinsClient } from '@mysten/suins';
 export { NaviAdapter, ProtocolRegistry } from './adapters/index.cjs';
@@ -497,114 +497,6 @@ declare function buildSendTx({ client, address, to, amount, asset, }: {
  */
 declare function addSendToTx(tx: Transaction, coin: TransactionObjectArgument, recipient: string): void;
 
-/**
- * Wallet-side coin selection helpers — single source of truth for the
- * "produce a `Coin<T>` argument holding `amount` raw units of `coinType`,
- * owned by `address`" pattern. Used by every wallet-mode appender that
- * needs a coin input (save, send, swap, repay, stake, etc.).
- *
- * **2026-05-22 — address-balance migration.** Sui mainnet's address-balance
- * feature ships funds account-style instead of as discrete `Coin<T>` objects.
- * After a payment via `0x2::balance::send_funds`, the leftover lands in the
- * sender's address balance with a synthetic "coin reservation" representing
- * the deposit. `client.getCoins()` correctly filters those reservations out
- * (they aren't real owned objects), so the old fetch+merge+split pattern
- * threw `INSUFFICIENT_BALANCE` for users whose stables had drifted into
- * address balance — even when `getBalance().totalBalance` showed plenty.
- *
- * The fix is structural: hand the work to `coinWithBalance({ type, balance })`
- * from `@mysten/sui/transactions`. Its build-time resolver inspects coins +
- * address balance together (`getBalance` + `listCoins`), then emits the
- * right shape — direct `redeem_funds` from address balance when AB ≥
- * required, or merge-and-split across coins + AB withdrawal when not. Multi
- * intents per coin type get batched into a single merge in one PTB, so the
- * old per-PTB merge cache is no longer needed.
- *
- * Pre-flight uses `client.getBalance().totalBalance` (sums coins + AB)
- * instead of summing the paginated `getCoins` page. That's the OTHER half
- * of the migration — the legacy path could see `0` from `getCoins` and
- * mistakenly throw before `coinWithBalance` ever ran.
- */
-
-interface CoinPage {
-    ids: string[];
-    totalBalance: bigint;
-}
-/**
- * Sum every coin of `coinType` owned by `owner`, INCLUDING address balance.
- * Returns the IDs of any discrete coin objects that exist (callers
- * occasionally need this for non-`coinWithBalance` paths, e.g. SUIns name
- * registration which expects raw object IDs).
- *
- * Pre-2026-05-22 this function paginated `client.getCoins` and summed
- * the page balances. That misses address-balance funds (the SDK filters
- * them out of `getCoins` for back-compat). The new implementation calls
- * `getBalance` for the canonical total and `getCoins` for the optional
- * ID list — both round-trips, but they happen in parallel.
- */
-declare function fetchAllCoins(client: SuiJsonRpcClient, owner: string, coinType: string): Promise<CoinPage>;
-interface SelectAndSplitResult {
-    /** TransactionObjectArgument for a coin holding `effectiveAmount` raw units. */
-    coin: TransactionObjectArgument;
-    /** Actual raw amount the returned coin holds. May be < requested if `swapAll` is true. */
-    effectiveAmount: bigint;
-    /** True iff the request consumed the entire wallet balance (no split needed). */
-    swapAll: boolean;
-}
-/**
- * Wallet-mode coin selection prelude. Pre-flights against
- * `getBalance().totalBalance` (coins + address balance combined), then
- * returns a `coinWithBalance({ type, balance })` argument that the
- * `@mysten/sui` resolver fulfills at build time.
- *
- * Throws `T2000Error` (`INSUFFICIENT_BALANCE`) when:
- * - `amount` is bigger than the total balance AND the caller did NOT
- *   opt into `swapAll: true` clipping.
- * - `amount === 'all'` AND total balance is zero.
- *
- * @param tx — PTB to register the `coinWithBalance` intent against.
- * @param client — Sui RPC client for the pre-flight `getBalance` lookup.
- * @param owner — wallet address whose coins to source from.
- * @param coinType — fully-qualified Sui coin type (e.g. `"0x...::usdc::USDC"`).
- * @param amount — raw amount to source (in MIST / smallest unit). Pass
- *   `'all'` to consume the entire balance.
- * @param options.allowSwapAll — if true (default), `amount` >= totalBalance
- *   auto-clips to total. If false, throws when the request would over-consume.
- * @param options.sponsoredContext — when true, source ONLY from discrete coin
- *   objects (never the address balance). See the long note below — this exists
- *   because Enoki's gas station can't yet deserialize a `TransactionData` that
- *   contains the address-balance `FundsWithdrawal` reservation that
- *   `coinWithBalance` emits. Self-funded callers leave this false: the fullnode
- *   handles `FundsWithdrawal` fine, so the address-balance path is preferred
- *   (it can reach funds that aren't held as coin objects).
- *
- * @returns
- *   - `coin` — `TransactionObjectArgument` ready for downstream consumption.
- *   - `effectiveAmount` — the raw amount the returned coin holds (handles
- *     swapAll clipping).
- *   - `swapAll` — true iff the entire balance was consumed.
- */
-declare function selectAndSplitCoin(tx: Transaction, client: SuiJsonRpcClient, owner: string, coinType: string, amount: bigint | 'all', options?: {
-    allowSwapAll?: boolean;
-    sponsoredContext?: boolean;
-}): Promise<SelectAndSplitResult>;
-/**
- * SUI-specific coin selection. Branches on sponsorship context:
- *
- * - **Self-funded (`sponsoredContext: false`)** — splits from `tx.gas`
- *   directly (the user's gas coin IS their SUI). More efficient — no
- *   `getBalance` RTT.
- *
- * - **Sponsored (`sponsoredContext: true`)** — sources from the user's
- *   discrete SUI coin objects (`selectCoinObjectsOnly`). This both (a) avoids
- *   `tx.gas`, which belongs to the Enoki sponsor — NOT the user — under
- *   sponsored flows (the original S.260 reason for `useGasCoin: false`), AND
- *   (b) avoids `coinWithBalance`'s address-balance `FundsWithdrawal`, which
- *   Enoki's gas station can't deserialize (issue #93). If the user's SUI is
- *   address-balance-only, it raises `ADDRESS_BALANCE_UNSPONSORABLE`.
- */
-declare function selectSuiCoin(tx: Transaction, client: SuiJsonRpcClient, owner: string, amountMist: bigint, sponsoredContext: boolean): Promise<SelectAndSplitResult>;
-
 /**
  * SPEC 7 v0.4 § Layer 0 — Canonical Write Architecture.
  *
@@ -981,6 +873,16 @@ interface AppenderContext {
      * the PTB build fails or the on-chain leg reverts.
      */
     isOutputConsumed?: boolean;
+    /**
+     * Per-PTB merge cache for sponsored coin-object sourcing, shared across
+     * every appender in a single `composeTx` run. Lets multiple legs that
+     * source the same coin type (two SUI swaps, swap USDC + save USDC, etc.)
+     * reuse a single merged primary coin instead of each re-fetching +
+     * re-merging the same coin objects (the second merge of which references
+     * already-consumed coins → Enoki dry-run `ArgumentWithoutValue`). Applies
+     * to ALL coin types, not just SUI. See `SponsoredCoinMergeCache` JSDoc.
+     */
+    coinMergeCache?: SponsoredCoinMergeCache;
 }
 /**
  * [SPEC 13 Phase 1] Appender return shape. Producers populate
@@ -1498,4 +1400,4 @@ declare function fullHandle(label: string): string;
  */
 declare function displayHandle(label: string): string;
 
-export { AUDRIC_PARENT_NAME, AUDRIC_PARENT_NFT_ID, type AppenderContext, BalanceResponse, type BorrowInput, BorrowResult, type BuildAddLeafParams, type BuildHarvestRewardsTxOptions, type BuildRevokeLeafParams, type ClaimRewardsInput, ClaimRewardsResult, type CoinPage, type ComposeTxFeeHookContext, type ComposeTxFeeHooks, type ComposeTxOptions, type ComposeTxResult, CompoundRewardsResult, ContactManager, DepositInfo, EarningsResult, FinancialSummary, type FinancialSummaryOptions, FundStatusResult, HF_CRITICAL_THRESHOLD, HF_WARN_THRESHOLD, type HarvestPlan, type HarvestSkippedLeg, type HarvestSwapLeg, HealthFactorResult, InvalidAddressError, type LabelValidationResult, LendingAdapter, LendingRates, MaxBorrowResult, MaxWithdrawResult, type NormalizedAddress, OverlayFeeConfig, PayOptions, PayResult, PaymentRequest, PendingReward, PositionsResult, RatesResult, type RepayDebtInput, RepayResult, SPONSORED_PYTH_DEPENDENT_PROVIDERS, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, SafeguardConfig, SafeguardEnforcer, type SaveDepositInput, SaveResult, type SelectAndSplitResult, SendResult, type SendTransferInput, SendableAsset, type StepPreview, SuinsNotRegisteredError, SuinsRpcError, SupportedAsset, type SwapExecuteInput, SwapQuoteResult, SwapResult, SwapRouteResult, T2000, T2000Error, T2000Options, TransactionRecord, TransactionSigner, TxMetadata, WRITE_APPENDER_REGISTRY, type WithdrawInput, WithdrawResult, type WriteStep, type WriteToolName, ZkLoginProof, addClaimRewardsToTx, addSendToTx, aggregateClaimableRewards, buildAddLeafTx, buildClaimRewardsTx, buildHarvestRewardsTx, buildRevokeLeafTx, buildSendTx, composeTx, deriveAllowedAddressesFromPtb, displayHandle, exportPrivateKey, fetchAllCoins, fullHandle, generateKeypair, getAddress, getFinancialSummary, getPendingRewards, getPendingRewardsByAddress, getRates, getSponsoredSwapProviders, getSwapQuote, keypairFromPrivateKey, loadKey, looksLikeSuiNs, normalizeAddressInput, resolveAddressToSuinsViaRpc, resolveSuinsViaRpc, saveBech32, saveKey, selectAndSplitCoin, selectSuiCoin, validateLabel, walletExists };
+export { AUDRIC_PARENT_NAME, AUDRIC_PARENT_NFT_ID, type AppenderContext, BalanceResponse, type BorrowInput, BorrowResult, type BuildAddLeafParams, type BuildHarvestRewardsTxOptions, type BuildRevokeLeafParams, type ClaimRewardsInput, ClaimRewardsResult, type ComposeTxFeeHookContext, type ComposeTxFeeHooks, type ComposeTxOptions, type ComposeTxResult, CompoundRewardsResult, ContactManager, DepositInfo, EarningsResult, FinancialSummary, type FinancialSummaryOptions, FundStatusResult, HF_CRITICAL_THRESHOLD, HF_WARN_THRESHOLD, type HarvestPlan, type HarvestSkippedLeg, type HarvestSwapLeg, HealthFactorResult, InvalidAddressError, type LabelValidationResult, LendingAdapter, LendingRates, MaxBorrowResult, MaxWithdrawResult, type NormalizedAddress, OverlayFeeConfig, PayOptions, PayResult, PaymentRequest, PendingReward, PositionsResult, RatesResult, type RepayDebtInput, RepayResult, SPONSORED_PYTH_DEPENDENT_PROVIDERS, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, SafeguardConfig, SafeguardEnforcer, type SaveDepositInput, SaveResult, SendResult, type SendTransferInput, SendableAsset, type StepPreview, SuinsNotRegisteredError, SuinsRpcError, SupportedAsset, type SwapExecuteInput, SwapQuoteResult, SwapResult, SwapRouteResult, T2000, T2000Error, T2000Options, TransactionRecord, TransactionSigner, TxMetadata, WRITE_APPENDER_REGISTRY, type WithdrawInput, WithdrawResult, type WriteStep, type WriteToolName, ZkLoginProof, addClaimRewardsToTx, addSendToTx, aggregateClaimableRewards, buildAddLeafTx, buildClaimRewardsTx, buildHarvestRewardsTx, buildRevokeLeafTx, buildSendTx, composeTx, deriveAllowedAddressesFromPtb, displayHandle, exportPrivateKey, fullHandle, generateKeypair, getAddress, getFinancialSummary, getPendingRewards, getPendingRewardsByAddress, getRates, getSponsoredSwapProviders, getSwapQuote, keypairFromPrivateKey, loadKey, looksLikeSuiNs, normalizeAddressInput, resolveAddressToSuinsViaRpc, resolveSuinsViaRpc, saveBech32, saveKey, validateLabel, walletExists };

package/dist/index.d.ts

@@ -1,12 +1,12 @@
 import { EventEmitter } from 'eventemitter3';
 import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
-import { Q as TxMetadata, o as SafeguardConfig, T as T2000Error, H as TransactionSigner, v as SupportedAsset, _ as ZkLoginProof, ax as SendableAsset } from './types-B63ogqZZ.js';
-export { A as ALL_NAVI_ASSETS, B as BORROW_FEE_BPS, a as BPS_DENOMINATOR, ay as CETUS_USDC_SUI_POOL, C as CLOCK_ID, b as COIN_REGISTRY, c as ClassifyBalanceChange, d as ClassifyResult, e as CoinMeta, az as DEFAULT_GRPC_URL, D as DEFAULT_NETWORK, f as DEFAULT_SAFEGUARD_CONFIG, E as ETH_TYPE, g as ExtractedTransfer, F as FeeOperation, aA as GASLESS_MIN_STABLE_AMOUNT, aB as GASLESS_STABLE_TYPES, 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, aD as Operation, P as ProtocolFeeInfo, aE as SAVEABLE_ASSETS, S as SAVE_FEE_BPS, aF as SENDABLE_ASSETS, k as STABLE_ASSETS, l as SUI_DECIMALS, m as SUI_TYPE, n as SUPPORTED_ASSETS, p as SafeguardError, q as SafeguardErrorDetails, r as SafeguardRule, aG as SaveableAsset, s as SimulationResult, t as StableAsset, u as SuiRpcTxBlock, w as T2000ErrorCode, x as T2000ErrorData, y as T2000_OVERLAY_FEE_WALLET, z as TOKEN_MAP, J as TxDirection, U as USDC_DECIMALS, R as USDC_TYPE, V as USDE_TYPE, W as USDSUI_TYPE, X as USDT_TYPE, Y as WAL_TYPE, Z as WBTC_TYPE, $ as ZkLoginSigner, a0 as addFeeTransfer, aH as assertAllowedAsset, a1 as calculateFee, a2 as classifyAction, a3 as classifyLabel, a4 as classifyTransaction, aI as createSuiClient, a5 as extractAllUserLegs, a6 as extractTransferDetails, a7 as extractTxCommands, a8 as extractTxSender, a9 as fallbackLabel, aa as formatAssetAmount, ab as formatSui, ac as formatUsd, aJ as getCoinMeta, ad as getDecimals, ae as getDecimalsForCoinType, aK as getSuiClient, aL as getSuiGrpcClient, af as getTier, aM as isAllowedAsset, aN as isInRegistry, ag as isSupported, ah as isTier1, ai as isTier2, aj as mapMoveAbortCode, ak as mapWalletError, al as mistToSui, aO as normalizeAsset, aP as normalizeCoinType, am as parseSuiRpcTx, aQ as queryHistory, aR as queryTransaction, an as rawToStable, ao as rawToUsdc, ap as refineLendingLabel, aq as resolveSymbol, ar as resolveTokenType, aS as simulateTransaction, as as stableToRaw, at as suiToMist, aT as throwIfSimulationFailed, au as truncateAddress, av as usdcToRaw, aw as validateAddress } from './types-B63ogqZZ.js';
+import { Q as TxMetadata, o as SafeguardConfig, T as T2000Error, H as TransactionSigner, v as SupportedAsset, _ as ZkLoginProof, ax as SendableAsset } from './types-CElCPOFA.js';
+export { A as ALL_NAVI_ASSETS, B as BORROW_FEE_BPS, a as BPS_DENOMINATOR, ay as CETUS_USDC_SUI_POOL, C as CLOCK_ID, b as COIN_REGISTRY, c as ClassifyBalanceChange, d as ClassifyResult, e as CoinMeta, az as DEFAULT_GRPC_URL, D as DEFAULT_NETWORK, f as DEFAULT_SAFEGUARD_CONFIG, E as ETH_TYPE, g as ExtractedTransfer, F as FeeOperation, aA as GASLESS_MIN_STABLE_AMOUNT, aB as GASLESS_STABLE_TYPES, 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, aD as Operation, P as ProtocolFeeInfo, aE as SAVEABLE_ASSETS, S as SAVE_FEE_BPS, aF as SENDABLE_ASSETS, k as STABLE_ASSETS, l as SUI_DECIMALS, m as SUI_TYPE, n as SUPPORTED_ASSETS, p as SafeguardError, q as SafeguardErrorDetails, r as SafeguardRule, aG as SaveableAsset, s as SimulationResult, t as StableAsset, u as SuiRpcTxBlock, w as T2000ErrorCode, x as T2000ErrorData, y as T2000_OVERLAY_FEE_WALLET, z as TOKEN_MAP, J as TxDirection, U as USDC_DECIMALS, R as USDC_TYPE, V as USDE_TYPE, W as USDSUI_TYPE, X as USDT_TYPE, Y as WAL_TYPE, Z as WBTC_TYPE, $ as ZkLoginSigner, a0 as addFeeTransfer, aH as assertAllowedAsset, a1 as calculateFee, a2 as classifyAction, a3 as classifyLabel, a4 as classifyTransaction, aI as createSuiClient, a5 as extractAllUserLegs, a6 as extractTransferDetails, a7 as extractTxCommands, a8 as extractTxSender, a9 as fallbackLabel, aa as formatAssetAmount, ab as formatSui, ac as formatUsd, aJ as getCoinMeta, ad as getDecimals, ae as getDecimalsForCoinType, aK as getSuiClient, aL as getSuiGrpcClient, af as getTier, aM as isAllowedAsset, aN as isInRegistry, ag as isSupported, ah as isTier1, ai as isTier2, aj as mapMoveAbortCode, ak as mapWalletError, al as mistToSui, aO as normalizeAsset, aP as normalizeCoinType, am as parseSuiRpcTx, aQ as queryHistory, aR as queryTransaction, an as rawToStable, ao as rawToUsdc, ap as refineLendingLabel, aq as resolveSymbol, ar as resolveTokenType, aS as simulateTransaction, as as stableToRaw, at as suiToMist, aT as throwIfSimulationFailed, au as truncateAddress, av as usdcToRaw, aw as validateAddress } from './types-CElCPOFA.js';
 import { L as LendingAdapter, a as LendingRates, P as PendingReward$1 } from './descriptors-DqIb4AnV.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-DqIb4AnV.js';
-import { n as T2000Options, P as PayOptions, d as PayResult, o as SwapResult, p as SwapQuoteResult, i as SendResult, B as BalanceResponse, k as TransactionRecord, D as DepositInfo, q as PaymentRequest, S as SaveResult, W as WithdrawResult, b as MaxWithdrawResult, a as BorrowResult, h as RepayResult, M as MaxBorrowResult, H as HealthFactorResult, e as PendingReward, C as ClaimRewardsResult, r as CompoundRewardsResult, g as PositionsResult, R as RatesResult, E as EarningsResult, F as FundStatusResult, c as OverlayFeeConfig, j as SwapRouteResult, s as FinancialSummary } from './types-HJGbXJ37.js';
-export { A as AssetRates, G as GasReserve, t as HFAlertLevel, O as OVERLAY_FEE_RATE, f as PositionEntry, u as SerializedCetusRoute, v as SerializedCetusRoutePath, w as SerializedRouterDataV3, T as TransactionLeg, x as addSwapToTx, l as buildSwapTx, y as deserializeCetusRoute, m as findSwapRoute, z as isCetusRouteFresh, I as serializeCetusRoute, J as verifyCetusRouteCoinMatch } from './types-HJGbXJ37.js';
+import { n as T2000Options, P as PayOptions, d as PayResult, o as SwapResult, p as SwapQuoteResult, i as SendResult, B as BalanceResponse, k as TransactionRecord, D as DepositInfo, q as PaymentRequest, S as SaveResult, W as WithdrawResult, b as MaxWithdrawResult, a as BorrowResult, h as RepayResult, M as MaxBorrowResult, H as HealthFactorResult, e as PendingReward, C as ClaimRewardsResult, r as CompoundRewardsResult, g as PositionsResult, R as RatesResult, E as EarningsResult, F as FundStatusResult, c as OverlayFeeConfig, s as SponsoredCoinMergeCache, j as SwapRouteResult, t as FinancialSummary } from './types-Ch0zVUpC.js';
+export { A as AssetRates, u as CoinPage, G as GasReserve, v as HFAlertLevel, O as OVERLAY_FEE_RATE, f as PositionEntry, w as SelectAndSplitResult, x as SerializedCetusRoute, y as SerializedCetusRoutePath, z as SerializedRouterDataV3, T as TransactionLeg, I as addSwapToTx, l as buildSwapTx, J as deserializeCetusRoute, K as fetchAllCoins, m as findSwapRoute, L as isCetusRouteFresh, N as selectAndSplitCoin, Q as selectSuiCoin, U as serializeCetusRoute, V as verifyCetusRouteCoinMatch } from './types-Ch0zVUpC.js';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
 import { SuinsClient } from '@mysten/suins';
 export { NaviAdapter, ProtocolRegistry } from './adapters/index.js';
@@ -497,114 +497,6 @@ declare function buildSendTx({ client, address, to, amount, asset, }: {
  */
 declare function addSendToTx(tx: Transaction, coin: TransactionObjectArgument, recipient: string): void;
 
-/**
- * Wallet-side coin selection helpers — single source of truth for the
- * "produce a `Coin<T>` argument holding `amount` raw units of `coinType`,
- * owned by `address`" pattern. Used by every wallet-mode appender that
- * needs a coin input (save, send, swap, repay, stake, etc.).
- *
- * **2026-05-22 — address-balance migration.** Sui mainnet's address-balance
- * feature ships funds account-style instead of as discrete `Coin<T>` objects.
- * After a payment via `0x2::balance::send_funds`, the leftover lands in the
- * sender's address balance with a synthetic "coin reservation" representing
- * the deposit. `client.getCoins()` correctly filters those reservations out
- * (they aren't real owned objects), so the old fetch+merge+split pattern
- * threw `INSUFFICIENT_BALANCE` for users whose stables had drifted into
- * address balance — even when `getBalance().totalBalance` showed plenty.
- *
- * The fix is structural: hand the work to `coinWithBalance({ type, balance })`
- * from `@mysten/sui/transactions`. Its build-time resolver inspects coins +
- * address balance together (`getBalance` + `listCoins`), then emits the
- * right shape — direct `redeem_funds` from address balance when AB ≥
- * required, or merge-and-split across coins + AB withdrawal when not. Multi
- * intents per coin type get batched into a single merge in one PTB, so the
- * old per-PTB merge cache is no longer needed.
- *
- * Pre-flight uses `client.getBalance().totalBalance` (sums coins + AB)
- * instead of summing the paginated `getCoins` page. That's the OTHER half
- * of the migration — the legacy path could see `0` from `getCoins` and
- * mistakenly throw before `coinWithBalance` ever ran.
- */
-
-interface CoinPage {
-    ids: string[];
-    totalBalance: bigint;
-}
-/**
- * Sum every coin of `coinType` owned by `owner`, INCLUDING address balance.
- * Returns the IDs of any discrete coin objects that exist (callers
- * occasionally need this for non-`coinWithBalance` paths, e.g. SUIns name
- * registration which expects raw object IDs).
- *
- * Pre-2026-05-22 this function paginated `client.getCoins` and summed
- * the page balances. That misses address-balance funds (the SDK filters
- * them out of `getCoins` for back-compat). The new implementation calls
- * `getBalance` for the canonical total and `getCoins` for the optional
- * ID list — both round-trips, but they happen in parallel.
- */
-declare function fetchAllCoins(client: SuiJsonRpcClient, owner: string, coinType: string): Promise<CoinPage>;
-interface SelectAndSplitResult {
-    /** TransactionObjectArgument for a coin holding `effectiveAmount` raw units. */
-    coin: TransactionObjectArgument;
-    /** Actual raw amount the returned coin holds. May be < requested if `swapAll` is true. */
-    effectiveAmount: bigint;
-    /** True iff the request consumed the entire wallet balance (no split needed). */
-    swapAll: boolean;
-}
-/**
- * Wallet-mode coin selection prelude. Pre-flights against
- * `getBalance().totalBalance` (coins + address balance combined), then
- * returns a `coinWithBalance({ type, balance })` argument that the
- * `@mysten/sui` resolver fulfills at build time.
- *
- * Throws `T2000Error` (`INSUFFICIENT_BALANCE`) when:
- * - `amount` is bigger than the total balance AND the caller did NOT
- *   opt into `swapAll: true` clipping.
- * - `amount === 'all'` AND total balance is zero.
- *
- * @param tx — PTB to register the `coinWithBalance` intent against.
- * @param client — Sui RPC client for the pre-flight `getBalance` lookup.
- * @param owner — wallet address whose coins to source from.
- * @param coinType — fully-qualified Sui coin type (e.g. `"0x...::usdc::USDC"`).
- * @param amount — raw amount to source (in MIST / smallest unit). Pass
- *   `'all'` to consume the entire balance.
- * @param options.allowSwapAll — if true (default), `amount` >= totalBalance
- *   auto-clips to total. If false, throws when the request would over-consume.
- * @param options.sponsoredContext — when true, source ONLY from discrete coin
- *   objects (never the address balance). See the long note below — this exists
- *   because Enoki's gas station can't yet deserialize a `TransactionData` that
- *   contains the address-balance `FundsWithdrawal` reservation that
- *   `coinWithBalance` emits. Self-funded callers leave this false: the fullnode
- *   handles `FundsWithdrawal` fine, so the address-balance path is preferred
- *   (it can reach funds that aren't held as coin objects).
- *
- * @returns
- *   - `coin` — `TransactionObjectArgument` ready for downstream consumption.
- *   - `effectiveAmount` — the raw amount the returned coin holds (handles
- *     swapAll clipping).
- *   - `swapAll` — true iff the entire balance was consumed.
- */
-declare function selectAndSplitCoin(tx: Transaction, client: SuiJsonRpcClient, owner: string, coinType: string, amount: bigint | 'all', options?: {
-    allowSwapAll?: boolean;
-    sponsoredContext?: boolean;
-}): Promise<SelectAndSplitResult>;
-/**
- * SUI-specific coin selection. Branches on sponsorship context:
- *
- * - **Self-funded (`sponsoredContext: false`)** — splits from `tx.gas`
- *   directly (the user's gas coin IS their SUI). More efficient — no
- *   `getBalance` RTT.
- *
- * - **Sponsored (`sponsoredContext: true`)** — sources from the user's
- *   discrete SUI coin objects (`selectCoinObjectsOnly`). This both (a) avoids
- *   `tx.gas`, which belongs to the Enoki sponsor — NOT the user — under
- *   sponsored flows (the original S.260 reason for `useGasCoin: false`), AND
- *   (b) avoids `coinWithBalance`'s address-balance `FundsWithdrawal`, which
- *   Enoki's gas station can't deserialize (issue #93). If the user's SUI is
- *   address-balance-only, it raises `ADDRESS_BALANCE_UNSPONSORABLE`.
- */
-declare function selectSuiCoin(tx: Transaction, client: SuiJsonRpcClient, owner: string, amountMist: bigint, sponsoredContext: boolean): Promise<SelectAndSplitResult>;
-
 /**
  * SPEC 7 v0.4 § Layer 0 — Canonical Write Architecture.
  *
@@ -981,6 +873,16 @@ interface AppenderContext {
      * the PTB build fails or the on-chain leg reverts.
      */
     isOutputConsumed?: boolean;
+    /**
+     * Per-PTB merge cache for sponsored coin-object sourcing, shared across
+     * every appender in a single `composeTx` run. Lets multiple legs that
+     * source the same coin type (two SUI swaps, swap USDC + save USDC, etc.)
+     * reuse a single merged primary coin instead of each re-fetching +
+     * re-merging the same coin objects (the second merge of which references
+     * already-consumed coins → Enoki dry-run `ArgumentWithoutValue`). Applies
+     * to ALL coin types, not just SUI. See `SponsoredCoinMergeCache` JSDoc.
+     */
+    coinMergeCache?: SponsoredCoinMergeCache;
 }
 /**
  * [SPEC 13 Phase 1] Appender return shape. Producers populate
@@ -1498,4 +1400,4 @@ declare function fullHandle(label: string): string;
  */
 declare function displayHandle(label: string): string;
 
-export { AUDRIC_PARENT_NAME, AUDRIC_PARENT_NFT_ID, type AppenderContext, BalanceResponse, type BorrowInput, BorrowResult, type BuildAddLeafParams, type BuildHarvestRewardsTxOptions, type BuildRevokeLeafParams, type ClaimRewardsInput, ClaimRewardsResult, type CoinPage, type ComposeTxFeeHookContext, type ComposeTxFeeHooks, type ComposeTxOptions, type ComposeTxResult, CompoundRewardsResult, ContactManager, DepositInfo, EarningsResult, FinancialSummary, type FinancialSummaryOptions, FundStatusResult, HF_CRITICAL_THRESHOLD, HF_WARN_THRESHOLD, type HarvestPlan, type HarvestSkippedLeg, type HarvestSwapLeg, HealthFactorResult, InvalidAddressError, type LabelValidationResult, LendingAdapter, LendingRates, MaxBorrowResult, MaxWithdrawResult, type NormalizedAddress, OverlayFeeConfig, PayOptions, PayResult, PaymentRequest, PendingReward, PositionsResult, RatesResult, type RepayDebtInput, RepayResult, SPONSORED_PYTH_DEPENDENT_PROVIDERS, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, SafeguardConfig, SafeguardEnforcer, type SaveDepositInput, SaveResult, type SelectAndSplitResult, SendResult, type SendTransferInput, SendableAsset, type StepPreview, SuinsNotRegisteredError, SuinsRpcError, SupportedAsset, type SwapExecuteInput, SwapQuoteResult, SwapResult, SwapRouteResult, T2000, T2000Error, T2000Options, TransactionRecord, TransactionSigner, TxMetadata, WRITE_APPENDER_REGISTRY, type WithdrawInput, WithdrawResult, type WriteStep, type WriteToolName, ZkLoginProof, addClaimRewardsToTx, addSendToTx, aggregateClaimableRewards, buildAddLeafTx, buildClaimRewardsTx, buildHarvestRewardsTx, buildRevokeLeafTx, buildSendTx, composeTx, deriveAllowedAddressesFromPtb, displayHandle, exportPrivateKey, fetchAllCoins, fullHandle, generateKeypair, getAddress, getFinancialSummary, getPendingRewards, getPendingRewardsByAddress, getRates, getSponsoredSwapProviders, getSwapQuote, keypairFromPrivateKey, loadKey, looksLikeSuiNs, normalizeAddressInput, resolveAddressToSuinsViaRpc, resolveSuinsViaRpc, saveBech32, saveKey, selectAndSplitCoin, selectSuiCoin, validateLabel, walletExists };
+export { AUDRIC_PARENT_NAME, AUDRIC_PARENT_NFT_ID, type AppenderContext, BalanceResponse, type BorrowInput, BorrowResult, type BuildAddLeafParams, type BuildHarvestRewardsTxOptions, type BuildRevokeLeafParams, type ClaimRewardsInput, ClaimRewardsResult, type ComposeTxFeeHookContext, type ComposeTxFeeHooks, type ComposeTxOptions, type ComposeTxResult, CompoundRewardsResult, ContactManager, DepositInfo, EarningsResult, FinancialSummary, type FinancialSummaryOptions, FundStatusResult, HF_CRITICAL_THRESHOLD, HF_WARN_THRESHOLD, type HarvestPlan, type HarvestSkippedLeg, type HarvestSwapLeg, HealthFactorResult, InvalidAddressError, type LabelValidationResult, LendingAdapter, LendingRates, MaxBorrowResult, MaxWithdrawResult, type NormalizedAddress, OverlayFeeConfig, PayOptions, PayResult, PaymentRequest, PendingReward, PositionsResult, RatesResult, type RepayDebtInput, RepayResult, SPONSORED_PYTH_DEPENDENT_PROVIDERS, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, SafeguardConfig, SafeguardEnforcer, type SaveDepositInput, SaveResult, SendResult, type SendTransferInput, SendableAsset, type StepPreview, SuinsNotRegisteredError, SuinsRpcError, SupportedAsset, type SwapExecuteInput, SwapQuoteResult, SwapResult, SwapRouteResult, T2000, T2000Error, T2000Options, TransactionRecord, TransactionSigner, TxMetadata, WRITE_APPENDER_REGISTRY, type WithdrawInput, WithdrawResult, type WriteStep, type WriteToolName, ZkLoginProof, addClaimRewardsToTx, addSendToTx, aggregateClaimableRewards, buildAddLeafTx, buildClaimRewardsTx, buildHarvestRewardsTx, buildRevokeLeafTx, buildSendTx, composeTx, deriveAllowedAddressesFromPtb, displayHandle, exportPrivateKey, fullHandle, generateKeypair, getAddress, getFinancialSummary, getPendingRewards, getPendingRewardsByAddress, getRates, getSponsoredSwapProviders, getSwapQuote, keypairFromPrivateKey, loadKey, looksLikeSuiNs, normalizeAddressInput, resolveAddressToSuinsViaRpc, resolveSuinsViaRpc, saveBech32, saveKey, validateLabel, walletExists };

package/dist/index.js

@@ -672,7 +672,15 @@ async function fetchAllCoins(client, owner, coinType) {
 }
 async function selectAndSplitCoin(tx, client, owner, coinType, amount, options = {}) {
   if (options.sponsoredContext) {
-    return selectCoinObjectsOnly(tx, client, owner, coinType, amount, options.allowSwapAll ?? true);
+    return selectCoinObjectsOnly(
+      tx,
+      client,
+      owner,
+      coinType,
+      amount,
+      options.allowSwapAll ?? true,
+      options.mergeCache
+    );
   }
   const balanceResp = await client.getBalance({ owner, coinType });
   const totalBalance = BigInt(balanceResp.totalBalance);
@@ -692,7 +700,23 @@ async function selectAndSplitCoin(tx, client, owner, coinType, amount, options =
   const coin = coinWithBalance({ type: coinType, balance: effectiveAmount })(tx);
   return { coin, effectiveAmount, swapAll };
 }
-async function selectCoinObjectsOnly(tx, client, owner, coinType, amount, allowSwapAll) {
+async function selectCoinObjectsOnly(tx, client, owner, coinType, amount, allowSwapAll, mergeCache) {
+  const cached = mergeCache?.get(coinType);
+  if (cached) {
+    const requested2 = amount === "all" ? cached.remaining : amount;
+    if (cached.remaining === 0n || requested2 > cached.remaining) {
+      throw new T2000Error(
+        "ADDRESS_BALANCE_UNSPONSORABLE",
+        `Not enough ${coinType} in coin objects to cover all legs of this sponsored bundle. The remaining funds are in your address balance, which sponsored transactions can't access yet.`,
+        { remaining: cached.remaining.toString(), requested: requested2.toString(), coinType }
+      );
+    }
+    const swapAll2 = amount === "all" || requested2 >= cached.remaining;
+    const effectiveAmount2 = swapAll2 ? cached.remaining : requested2;
+    const coin2 = swapAll2 ? cached.primary : tx.splitCoins(cached.primary, [effectiveAmount2])[0];
+    cached.remaining -= effectiveAmount2;
+    return { coin: coin2, effectiveAmount: effectiveAmount2, swapAll: swapAll2 };
+  }
   const objects = [];
   let coinObjectTotal = 0n;
   let cursor;
@@ -731,12 +755,16 @@ async function selectCoinObjectsOnly(tx, client, owner, coinType, amount, allowS
     );
   }
   const coin = swapAll ? primary : tx.splitCoins(primary, [effectiveAmount])[0];
+  mergeCache?.set(coinType, {
+    primary,
+    remaining: coinObjectTotal - effectiveAmount
+  });
   return { coin, effectiveAmount, swapAll };
 }
-async function selectSuiCoin(tx, client, owner, amountMist, sponsoredContext) {
+async function selectSuiCoin(tx, client, owner, amountMist, sponsoredContext, mergeCache) {
   if (sponsoredContext) {
     const { SUI_TYPE: SUI_TYPE2 } = await Promise.resolve().then(() => (init_token_registry(), token_registry_exports));
-    return selectCoinObjectsOnly(tx, client, owner, SUI_TYPE2, amountMist, false);
+    return selectCoinObjectsOnly(tx, client, owner, SUI_TYPE2, amountMist, false, mergeCache);
   }
   const [coin] = tx.splitCoins(tx.gas, [amountMist]);
   return { coin, effectiveAmount: amountMist, swapAll: false };
@@ -958,14 +986,16 @@ async function addSwapToTx(tx, client, address, input) {
       client,
       address,
       requestedRaw,
-      input.sponsoredContext ?? false
+      input.sponsoredContext ?? false,
+      input.coinMergeCache
     );
     inputCoin = result.coin;
     effectiveRaw = result.effectiveAmount;
   } else {
     const { selectAndSplitCoin: selectAndSplitCoin2 } = await Promise.resolve().then(() => (init_coinSelection(), coinSelection_exports));
     const result = await selectAndSplitCoin2(tx, client, address, fromType, requestedRaw, {
-      sponsoredContext: input.sponsoredContext ?? false
+      sponsoredContext: input.sponsoredContext ?? false,
+      mergeCache: input.coinMergeCache
     });
     inputCoin = result.coin;
     effectiveRaw = result.effectiveAmount;
@@ -7946,7 +7976,8 @@ var WRITE_APPENDER_REGISTRY = {
       effectiveAmount = rawAmount;
     } else {
       const r = await selectAndSplitCoin(tx, ctx.client, ctx.sender, assetInfo.type, rawAmount, {
-        sponsoredContext: ctx.sponsoredContext
+        sponsoredContext: ctx.sponsoredContext,
+        mergeCache: ctx.coinMergeCache
       });
       coin = r.coin;
       effectiveAmount = r.effectiveAmount;
@@ -8020,7 +8051,8 @@ var WRITE_APPENDER_REGISTRY = {
       effectiveAmount = rawAmount;
     } else {
       const r = await selectAndSplitCoin(tx, ctx.client, ctx.sender, assetInfo.type, rawAmount, {
-        sponsoredContext: ctx.sponsoredContext
+        sponsoredContext: ctx.sponsoredContext,
+        mergeCache: ctx.coinMergeCache
       });
       coin = r.coin;
       effectiveAmount = r.effectiveAmount;
@@ -8064,7 +8096,14 @@ var WRITE_APPENDER_REGISTRY = {
       };
     }
     if (asset === "SUI") {
-      const result = await selectSuiCoin(tx, ctx.client, ctx.sender, rawAmount, ctx.sponsoredContext);
+      const result = await selectSuiCoin(
+        tx,
+        ctx.client,
+        ctx.sender,
+        rawAmount,
+        ctx.sponsoredContext,
+        ctx.coinMergeCache
+      );
       addSendToTx(tx, result.coin, recipient);
       return {
         preview: {
@@ -8126,7 +8165,8 @@ var WRITE_APPENDER_REGISTRY = {
       providers,
       inputCoin: ctx.chainedCoin,
       precomputedRoute: input.precomputedRoute,
-      sponsoredContext: ctx.sponsoredContext
+      sponsoredContext: ctx.sponsoredContext,
+      coinMergeCache: ctx.coinMergeCache
     });
     if (!ctx.isOutputConsumed) {
       tx.transferObjects([result.coin], ctx.sender);
@@ -8229,7 +8269,11 @@ async function composeTx(opts) {
     sender: opts.sender,
     sponsoredContext: opts.sponsoredContext ?? false,
     overlayFee: opts.overlayFee,
-    feeHooks: opts.feeHooks
+    feeHooks: opts.feeHooks,
+    // One cache per compose run — shared across all legs (any coin type)
+    // so multi-leg sponsored bundles that source the same coin (two SUI
+    // swaps, swap USDC + save USDC, ...) merge that coin's objects once.
+    coinMergeCache: /* @__PURE__ */ new Map()
   };
   const consumedSteps = /* @__PURE__ */ new Set();
   for (let i = 0; i < opts.steps.length; i++) {