@t2000/sdk 4.2.0 → 4.2.1

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-8CNP74n6.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-8CNP74n6.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-DUmk5ivZ.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-DUmk5ivZ.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,15 @@ interface AppenderContext {
      * the PTB build fails or the on-chain leg reverts.
      */
     isOutputConsumed?: boolean;
+    /**
+     * Per-PTB merge cache for sponsored SUI sourcing, shared across every
+     * appender in a single `composeTx` run. Lets multiple SUI-source swap
+     * legs in one bundle 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`). See `SponsoredCoinMergeCache` JSDoc.
+     */
+    suiMergeCache?: SponsoredCoinMergeCache;
 }
 /**
  * [SPEC 13 Phase 1] Appender return shape. Producers populate
@@ -1498,4 +1399,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-BTbqE8AE.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-BTbqE8AE.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-DUmk5ivZ.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-DUmk5ivZ.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,15 @@ interface AppenderContext {
      * the PTB build fails or the on-chain leg reverts.
      */
     isOutputConsumed?: boolean;
+    /**
+     * Per-PTB merge cache for sponsored SUI sourcing, shared across every
+     * appender in a single `composeTx` run. Lets multiple SUI-source swap
+     * legs in one bundle 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`). See `SponsoredCoinMergeCache` JSDoc.
+     */
+    suiMergeCache?: SponsoredCoinMergeCache;
 }
 /**
  * [SPEC 13 Phase 1] Appender return shape. Producers populate
@@ -1498,4 +1399,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

@@ -692,7 +692,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 +747,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,7 +978,8 @@ async function addSwapToTx(tx, client, address, input) {
       client,
       address,
       requestedRaw,
-      input.sponsoredContext ?? false
+      input.sponsoredContext ?? false,
+      input.suiMergeCache
     );
     inputCoin = result.coin;
     effectiveRaw = result.effectiveAmount;
@@ -8126,7 +8147,8 @@ var WRITE_APPENDER_REGISTRY = {
       providers,
       inputCoin: ctx.chainedCoin,
       precomputedRoute: input.precomputedRoute,
-      sponsoredContext: ctx.sponsoredContext
+      sponsoredContext: ctx.sponsoredContext,
+      suiMergeCache: ctx.suiMergeCache
     });
     if (!ctx.isOutputConsumed) {
       tx.transferObjects([result.coin], ctx.sender);
@@ -8229,7 +8251,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 so multi-leg
+    // sponsored bundles that source the same coin (e.g. two SUI swaps)
+    // merge that coin's objects exactly once.
+    suiMergeCache: /* @__PURE__ */ new Map()
   };
   const consumedSteps = /* @__PURE__ */ new Set();
   for (let i = 0; i < opts.steps.length; i++) {