@t2000/sdk 2.13.1 → 2.14.0

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, _ as ZkLoginProof, v as SupportedAsset } from './types-BY6ovQGK.cjs';
-export { A as ALL_NAVI_ASSETS, B as BORROW_FEE_BPS, a as BPS_DENOMINATOR, ax 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, ay as OPERATION_ASSETS, O as OUTBOUND_OPS, az as Operation, P as ProtocolFeeInfo, S as SAVE_FEE_BPS, 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, 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, aA as assertAllowedAsset, a1 as calculateFee, a2 as classifyAction, a3 as classifyLabel, a4 as classifyTransaction, a5 as extractAllUserLegs, a6 as extractTransferDetails, a7 as extractTxCommands, a8 as extractTxSender, a9 as fallbackLabel, aa as formatAssetAmount, ab as formatSui, ac as formatUsd, aB as getCoinMeta, ad as getDecimals, ae as getDecimalsForCoinType, af as getTier, aC as isAllowedAsset, aD as isInRegistry, ag as isSupported, ah as isTier1, ai as isTier2, aj as mapMoveAbortCode, ak as mapWalletError, al as mistToSui, aE as normalizeAsset, aF as normalizeCoinType, am as parseSuiRpcTx, aG as queryHistory, aH as queryTransaction, an as rawToStable, ao as rawToUsdc, ap as refineLendingLabel, aq as resolveSymbol, ar as resolveTokenType, aI as simulateTransaction, as as stableToRaw, at as suiToMist, aJ as throwIfSimulationFailed, au as truncateAddress, av as usdcToRaw, aw as validateAddress } from './types-BY6ovQGK.cjs';
+import { Q as TxMetadata, o as SafeguardConfig, T as T2000Error, H as TransactionSigner, _ as ZkLoginProof, v as SupportedAsset } from './types-1WUNZK-9.cjs';
+export { A as ALL_NAVI_ASSETS, B as BORROW_FEE_BPS, a as BPS_DENOMINATOR, ax 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, ay as OPERATION_ASSETS, O as OUTBOUND_OPS, az as Operation, P as ProtocolFeeInfo, S as SAVE_FEE_BPS, 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, 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, aA as assertAllowedAsset, a1 as calculateFee, a2 as classifyAction, a3 as classifyLabel, a4 as classifyTransaction, a5 as extractAllUserLegs, a6 as extractTransferDetails, a7 as extractTxCommands, a8 as extractTxSender, a9 as fallbackLabel, aa as formatAssetAmount, ab as formatSui, ac as formatUsd, aB as getCoinMeta, ad as getDecimals, ae as getDecimalsForCoinType, af as getTier, aC as isAllowedAsset, aD as isInRegistry, ag as isSupported, ah as isTier1, ai as isTier2, aj as mapMoveAbortCode, ak as mapWalletError, al as mistToSui, aE as normalizeAsset, aF as normalizeCoinType, am as parseSuiRpcTx, aG as queryHistory, aH as queryTransaction, an as rawToStable, ao as rawToUsdc, ap as refineLendingLabel, aq as resolveSymbol, ar as resolveTokenType, aI as simulateTransaction, as as stableToRaw, at as suiToMist, aJ as throwIfSimulationFailed, au as truncateAddress, av as usdcToRaw, aw as validateAddress } from './types-1WUNZK-9.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 StakeVSuiResult, U as UnstakeVSuiResult, p as SwapResult, q as SwapQuoteResult, i as SendResult, B as BalanceResponse, k as TransactionRecord, D as DepositInfo, r 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, s as CompoundRewardsResult, g as PositionsResult, R as RatesResult, E as EarningsResult, F as FundStatusResult, c as OverlayFeeConfig, j as SwapRouteResult, t as FinancialSummary } from './types-epj9U13o.cjs';
-export { A as AssetRates, G as GasReserve, u as HFAlertLevel, O as OVERLAY_FEE_RATE, f as PositionEntry, v as SerializedCetusRoute, w as SerializedCetusRoutePath, x as SerializedRouterDataV3, T as TransactionLeg, y as addSwapToTx, l as buildSwapTx, z as deserializeCetusRoute, m as findSwapRoute, I as isCetusRouteFresh, J as serializeCetusRoute, K as verifyCetusRouteCoinMatch } from './types-epj9U13o.cjs';
+import { n as T2000Options, P as PayOptions, d as PayResult, o as StakeVSuiResult, U as UnstakeVSuiResult, p as SwapResult, q as SwapQuoteResult, i as SendResult, B as BalanceResponse, k as TransactionRecord, D as DepositInfo, r 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, s as CompoundRewardsResult, g as PositionsResult, R as RatesResult, E as EarningsResult, F as FundStatusResult, c as OverlayFeeConfig, j as SwapRouteResult, t as FinancialSummary } from './types-CFJrgLm2.cjs';
+export { A as AssetRates, G as GasReserve, u as HFAlertLevel, O as OVERLAY_FEE_RATE, f as PositionEntry, v as SerializedCetusRoute, w as SerializedCetusRoutePath, x as SerializedRouterDataV3, T as TransactionLeg, y as addSwapToTx, l as buildSwapTx, z as deserializeCetusRoute, m as findSwapRoute, I as isCetusRouteFresh, J as serializeCetusRoute, K as verifyCetusRouteCoinMatch } from './types-CFJrgLm2.cjs';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
 import { SuinsClient } from '@mysten/suins';
 export { NaviAdapter, ProtocolRegistry } from './adapters/index.cjs';
@@ -179,9 +179,6 @@ declare class T2000 extends EventEmitter<T2000Events> {
      * matching the caller's existing "insufficient balance" error path.
      */
     private _queryAssetBalance;
-    private _fetchCoins;
-    private _mergeCoinsInTx;
-    private _lastFundDigest;
     private _autoFundFromSavings;
     maxWithdraw(): Promise<MaxWithdrawResult>;
     borrow(params: {
@@ -267,27 +264,32 @@ declare function buildSendTx({ client, address, to, amount, asset, }: {
 declare function addSendToTx(tx: Transaction, coin: TransactionObjectArgument, recipient: string): void;
 
 /**
- * Wallet-side coin selection helpers — shared paginated coin lookup +
- * merge + split prelude used by every wallet-mode appender that needs
- * a `TransactionObjectArgument` reference to a specific amount of a
- * given coin type.
- *
- * Replaces three earlier inline implementations:
- * - `cetus-swap.ts:fetchAllCoinsForSwap` (deleted 2026-05-02 — addSwapToTx
- *   now calls `selectAndSplitCoin` directly so the merge cache is shared
- *   across every appender in a multi-write bundle)
- * - `volo.ts:fetchCoinsByType` (kept for backwards-compat, delegates
- *   here)
- * - audric host's `transactions/prepare/route.ts:fetchCoinsForSwap`
- *   (P2.2c retires this when migrating to `composeTx`)
- *
- * Single source of truth for the "fetch coins of type X owned by
- * address Y, paginated" pattern. P2.2b extracts this so `composeTx`'s
- * registry adapters can build a wallet-mode `TransactionObjectArgument`
- * uniformly across save / send / repay / etc. The 2026-05-02 P2.7 fix
- * adds a per-PTB merge cache so multi-write bundles that touch the same
- * coin type twice (swap+save, save+send, etc.) only emit `mergeCoins`
- * once — see `ptbMergeCache` JSDoc below.
+ * 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 {
@@ -295,13 +297,16 @@ interface CoinPage {
     totalBalance: bigint;
 }
 /**
- * Paginated coin lookup. Fetches every coin object of `coinType` owned
- * by `owner` (walks the cursor until `hasNextPage === false`). Returns
- * the list of object IDs + summed balance.
- *
- * Replaces inline `client.getCoins` calls that miss coins on the second
- * page when wallets accumulate many small coin objects (the bug class
- * that bit `buildSendTx` pre-P2.2 — captured for SPEC 12).
+ * 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 {
@@ -313,39 +318,30 @@ interface SelectAndSplitResult {
     swapAll: boolean;
 }
 /**
- * Wallet-mode coin selection prelude. Fetches every coin of `coinType`
- * owned by `owner`, merges them into a primary, and splits off the
- * requested `amount` (or returns the merged primary directly if the
- * request meets/exceeds the total balance — `swapAll` semantics).
+ * 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:
- * - No coins of `coinType` exist for `owner`
  * - `amount` is bigger than the total balance AND the caller did NOT
- *   opt into `swapAll: true` clipping
- *
- * Used by:
- * - `composeTx` registry adapters (save_deposit, send_transfer,
- *   repay_debt — non-SUI assets) for the wallet-mode prelude
- * - Layer 1 dual-mode appenders (`addSwapToTx`, `addStakeVSuiToTx`,
- *   `addUnstakeVSuiToTx`) when `inputCoin` is omitted
- *
- * @param tx — PTB to append `mergeCoins` + `splitCoins` commands to.
- * @param client — Sui RPC client for the paginated `getCoins` lookup.
- * @param owner — wallet address whose coins to fetch.
- * @param coinType — fully-qualified Sui coin type
- *   (`"0x...::usdc::USDC"`).
- * @param amount — raw amount to split out (in MIST / smallest unit).
- *   Pass `'all'` to consume the entire merged primary directly.
- * @param options.allowSwapAll — if true (default), `amount` >=
- *   totalBalance auto-clips to total (matches audric host's swap
- *   branch). If false, throws `INSUFFICIENT_BALANCE` when over.
+ *   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.
  *
  * @returns
- *   - `coin` — `TransactionObjectArgument` ready for downstream
- *     consumption (e.g. `addSaveToTx`, `tx.transferObjects`).
- *   - `effectiveAmount` — the raw amount the returned coin actually
- *     holds (handles swapAll clipping).
- *   - `swapAll` — true iff the entire merged primary was consumed.
+ *   - `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;
@@ -353,19 +349,15 @@ declare function selectAndSplitCoin(tx: Transaction, client: SuiJsonRpcClient, o
 /**
  * SUI-specific coin selection. Branches on sponsorship context:
  *
- * - **Sponsored (`sponsoredContext: true`)** — fetches SUI coins via
- *   `getCoins` and merges/splits, because `tx.gas` belongs to the
- *   Enoki sponsor (NOT the user) under sponsored flows. Same shape as
- *   `selectAndSplitCoin` for any other coin type.
- *
  * - **Self-funded (`sponsoredContext: false`)** — splits from `tx.gas`
  *   directly (the user's gas coin IS their SUI). More efficient — no
- *   getCoins RTT.
+ *   `getBalance` RTT.
  *
- * Captures the SUI-vs-other-asset divergence that lives inline in
- * `buildSendTx` today (`tx.splitCoins(tx.gas, ...)` vs paginated
- * lookup). composeTx's `send_transfer` adapter routes through this
- * helper to handle both.
+ * - **Sponsored (`sponsoredContext: true`)** — uses
+ *   `coinWithBalance({ type: SUI, useGasCoin: false })`, because `tx.gas`
+ *   belongs to the Enoki sponsor (NOT the user) under sponsored flows.
+ *   The resolver sources from the user's SUI coins / address balance,
+ *   not the sponsor's gas coin.
  */
 declare function selectSuiCoin(tx: Transaction, client: SuiJsonRpcClient, owner: string, amountMist: bigint, sponsoredContext: boolean): Promise<SelectAndSplitResult>;
 
@@ -1153,15 +1145,16 @@ declare function buildUnstakeVSuiTx(client: SuiJsonRpcClient, address: string, a
 /**
  * SPEC 7 § "Layer 1" Volo stake appender. Two modes.
  *
- * Wallet mode (`inputCoin` omitted): fetches SUI coins from the
- * sender's wallet (paginated), merges/splits to `amountMist`. Mirrors
+ * Wallet mode (`inputCoin` omitted): pre-flights via `getBalance` and
+ * sources SUI through `coinWithBalance({ type: SUI, useGasCoin: false })`,
+ * which resolves coin objects + address balance at build time. Mirrors
  * the audric host's `transactions/prepare/route.ts:524-545` volo-stake
  * branch — sponsored-flow safe (does NOT consume `tx.gas`, which
  * belongs to the Enoki sponsor in sponsored flows).
  *
  * For non-sponsored flows where the caller owns `tx.gas`, prefer
- * `buildStakeVSuiTx` directly (it splits from gas, which is more
- * efficient by avoiding the extra getCoins RTT).
+ * `buildStakeVSuiTx` directly (it splits from gas, which avoids one
+ * `getBalance` RTT).
  *
  * Chain mode (`inputCoin` provided): consumes the passed-in SUI coin
  * ref entirely. Used for chained flows like "swap USDC → SUI → stake".
@@ -1185,9 +1178,10 @@ declare function addStakeVSuiToTx(tx: Transaction, client: SuiJsonRpcClient, add
 /**
  * SPEC 7 § "Layer 1" Volo unstake appender. Two modes.
  *
- * Wallet mode (`inputCoin` omitted): fetches vSUI coins from the
- * sender's wallet (paginated), merges to a primary coin, splits to
- * `amountMist` (or consumes the entire merged primary if `'all'`).
+ * Wallet mode (`inputCoin` omitted): pre-flights via `getBalance` and
+ * sources vSUI through `coinWithBalance({ type: VSUI, balance })`,
+ * which resolves coin objects + address balance at build time. With
+ * `'all'`, the entire balance is consumed.
  *
  * Chain mode (`inputCoin` provided): consumes the passed-in vSUI coin
  * ref. With `amountMist = 'all'`, the entire input coin is unstaked.

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, _ as ZkLoginProof, v as SupportedAsset } from './types-WeZQDV54.js';
-export { A as ALL_NAVI_ASSETS, B as BORROW_FEE_BPS, a as BPS_DENOMINATOR, ax 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, ay as OPERATION_ASSETS, O as OUTBOUND_OPS, az as Operation, P as ProtocolFeeInfo, S as SAVE_FEE_BPS, 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, 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, aA as assertAllowedAsset, a1 as calculateFee, a2 as classifyAction, a3 as classifyLabel, a4 as classifyTransaction, a5 as extractAllUserLegs, a6 as extractTransferDetails, a7 as extractTxCommands, a8 as extractTxSender, a9 as fallbackLabel, aa as formatAssetAmount, ab as formatSui, ac as formatUsd, aB as getCoinMeta, ad as getDecimals, ae as getDecimalsForCoinType, af as getTier, aC as isAllowedAsset, aD as isInRegistry, ag as isSupported, ah as isTier1, ai as isTier2, aj as mapMoveAbortCode, ak as mapWalletError, al as mistToSui, aE as normalizeAsset, aF as normalizeCoinType, am as parseSuiRpcTx, aG as queryHistory, aH as queryTransaction, an as rawToStable, ao as rawToUsdc, ap as refineLendingLabel, aq as resolveSymbol, ar as resolveTokenType, aI as simulateTransaction, as as stableToRaw, at as suiToMist, aJ as throwIfSimulationFailed, au as truncateAddress, av as usdcToRaw, aw as validateAddress } from './types-WeZQDV54.js';
+import { Q as TxMetadata, o as SafeguardConfig, T as T2000Error, H as TransactionSigner, _ as ZkLoginProof, v as SupportedAsset } from './types-D65N3sBO.js';
+export { A as ALL_NAVI_ASSETS, B as BORROW_FEE_BPS, a as BPS_DENOMINATOR, ax 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, ay as OPERATION_ASSETS, O as OUTBOUND_OPS, az as Operation, P as ProtocolFeeInfo, S as SAVE_FEE_BPS, 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, 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, aA as assertAllowedAsset, a1 as calculateFee, a2 as classifyAction, a3 as classifyLabel, a4 as classifyTransaction, a5 as extractAllUserLegs, a6 as extractTransferDetails, a7 as extractTxCommands, a8 as extractTxSender, a9 as fallbackLabel, aa as formatAssetAmount, ab as formatSui, ac as formatUsd, aB as getCoinMeta, ad as getDecimals, ae as getDecimalsForCoinType, af as getTier, aC as isAllowedAsset, aD as isInRegistry, ag as isSupported, ah as isTier1, ai as isTier2, aj as mapMoveAbortCode, ak as mapWalletError, al as mistToSui, aE as normalizeAsset, aF as normalizeCoinType, am as parseSuiRpcTx, aG as queryHistory, aH as queryTransaction, an as rawToStable, ao as rawToUsdc, ap as refineLendingLabel, aq as resolveSymbol, ar as resolveTokenType, aI as simulateTransaction, as as stableToRaw, at as suiToMist, aJ as throwIfSimulationFailed, au as truncateAddress, av as usdcToRaw, aw as validateAddress } from './types-D65N3sBO.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 StakeVSuiResult, U as UnstakeVSuiResult, p as SwapResult, q as SwapQuoteResult, i as SendResult, B as BalanceResponse, k as TransactionRecord, D as DepositInfo, r 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, s as CompoundRewardsResult, g as PositionsResult, R as RatesResult, E as EarningsResult, F as FundStatusResult, c as OverlayFeeConfig, j as SwapRouteResult, t as FinancialSummary } from './types-epj9U13o.js';
-export { A as AssetRates, G as GasReserve, u as HFAlertLevel, O as OVERLAY_FEE_RATE, f as PositionEntry, v as SerializedCetusRoute, w as SerializedCetusRoutePath, x as SerializedRouterDataV3, T as TransactionLeg, y as addSwapToTx, l as buildSwapTx, z as deserializeCetusRoute, m as findSwapRoute, I as isCetusRouteFresh, J as serializeCetusRoute, K as verifyCetusRouteCoinMatch } from './types-epj9U13o.js';
+import { n as T2000Options, P as PayOptions, d as PayResult, o as StakeVSuiResult, U as UnstakeVSuiResult, p as SwapResult, q as SwapQuoteResult, i as SendResult, B as BalanceResponse, k as TransactionRecord, D as DepositInfo, r 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, s as CompoundRewardsResult, g as PositionsResult, R as RatesResult, E as EarningsResult, F as FundStatusResult, c as OverlayFeeConfig, j as SwapRouteResult, t as FinancialSummary } from './types-CFJrgLm2.js';
+export { A as AssetRates, G as GasReserve, u as HFAlertLevel, O as OVERLAY_FEE_RATE, f as PositionEntry, v as SerializedCetusRoute, w as SerializedCetusRoutePath, x as SerializedRouterDataV3, T as TransactionLeg, y as addSwapToTx, l as buildSwapTx, z as deserializeCetusRoute, m as findSwapRoute, I as isCetusRouteFresh, J as serializeCetusRoute, K as verifyCetusRouteCoinMatch } from './types-CFJrgLm2.js';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
 import { SuinsClient } from '@mysten/suins';
 export { NaviAdapter, ProtocolRegistry } from './adapters/index.js';
@@ -179,9 +179,6 @@ declare class T2000 extends EventEmitter<T2000Events> {
      * matching the caller's existing "insufficient balance" error path.
      */
     private _queryAssetBalance;
-    private _fetchCoins;
-    private _mergeCoinsInTx;
-    private _lastFundDigest;
     private _autoFundFromSavings;
     maxWithdraw(): Promise<MaxWithdrawResult>;
     borrow(params: {
@@ -267,27 +264,32 @@ declare function buildSendTx({ client, address, to, amount, asset, }: {
 declare function addSendToTx(tx: Transaction, coin: TransactionObjectArgument, recipient: string): void;
 
 /**
- * Wallet-side coin selection helpers — shared paginated coin lookup +
- * merge + split prelude used by every wallet-mode appender that needs
- * a `TransactionObjectArgument` reference to a specific amount of a
- * given coin type.
- *
- * Replaces three earlier inline implementations:
- * - `cetus-swap.ts:fetchAllCoinsForSwap` (deleted 2026-05-02 — addSwapToTx
- *   now calls `selectAndSplitCoin` directly so the merge cache is shared
- *   across every appender in a multi-write bundle)
- * - `volo.ts:fetchCoinsByType` (kept for backwards-compat, delegates
- *   here)
- * - audric host's `transactions/prepare/route.ts:fetchCoinsForSwap`
- *   (P2.2c retires this when migrating to `composeTx`)
- *
- * Single source of truth for the "fetch coins of type X owned by
- * address Y, paginated" pattern. P2.2b extracts this so `composeTx`'s
- * registry adapters can build a wallet-mode `TransactionObjectArgument`
- * uniformly across save / send / repay / etc. The 2026-05-02 P2.7 fix
- * adds a per-PTB merge cache so multi-write bundles that touch the same
- * coin type twice (swap+save, save+send, etc.) only emit `mergeCoins`
- * once — see `ptbMergeCache` JSDoc below.
+ * 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 {
@@ -295,13 +297,16 @@ interface CoinPage {
     totalBalance: bigint;
 }
 /**
- * Paginated coin lookup. Fetches every coin object of `coinType` owned
- * by `owner` (walks the cursor until `hasNextPage === false`). Returns
- * the list of object IDs + summed balance.
- *
- * Replaces inline `client.getCoins` calls that miss coins on the second
- * page when wallets accumulate many small coin objects (the bug class
- * that bit `buildSendTx` pre-P2.2 — captured for SPEC 12).
+ * 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 {
@@ -313,39 +318,30 @@ interface SelectAndSplitResult {
     swapAll: boolean;
 }
 /**
- * Wallet-mode coin selection prelude. Fetches every coin of `coinType`
- * owned by `owner`, merges them into a primary, and splits off the
- * requested `amount` (or returns the merged primary directly if the
- * request meets/exceeds the total balance — `swapAll` semantics).
+ * 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:
- * - No coins of `coinType` exist for `owner`
  * - `amount` is bigger than the total balance AND the caller did NOT
- *   opt into `swapAll: true` clipping
- *
- * Used by:
- * - `composeTx` registry adapters (save_deposit, send_transfer,
- *   repay_debt — non-SUI assets) for the wallet-mode prelude
- * - Layer 1 dual-mode appenders (`addSwapToTx`, `addStakeVSuiToTx`,
- *   `addUnstakeVSuiToTx`) when `inputCoin` is omitted
- *
- * @param tx — PTB to append `mergeCoins` + `splitCoins` commands to.
- * @param client — Sui RPC client for the paginated `getCoins` lookup.
- * @param owner — wallet address whose coins to fetch.
- * @param coinType — fully-qualified Sui coin type
- *   (`"0x...::usdc::USDC"`).
- * @param amount — raw amount to split out (in MIST / smallest unit).
- *   Pass `'all'` to consume the entire merged primary directly.
- * @param options.allowSwapAll — if true (default), `amount` >=
- *   totalBalance auto-clips to total (matches audric host's swap
- *   branch). If false, throws `INSUFFICIENT_BALANCE` when over.
+ *   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.
  *
  * @returns
- *   - `coin` — `TransactionObjectArgument` ready for downstream
- *     consumption (e.g. `addSaveToTx`, `tx.transferObjects`).
- *   - `effectiveAmount` — the raw amount the returned coin actually
- *     holds (handles swapAll clipping).
- *   - `swapAll` — true iff the entire merged primary was consumed.
+ *   - `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;
@@ -353,19 +349,15 @@ declare function selectAndSplitCoin(tx: Transaction, client: SuiJsonRpcClient, o
 /**
  * SUI-specific coin selection. Branches on sponsorship context:
  *
- * - **Sponsored (`sponsoredContext: true`)** — fetches SUI coins via
- *   `getCoins` and merges/splits, because `tx.gas` belongs to the
- *   Enoki sponsor (NOT the user) under sponsored flows. Same shape as
- *   `selectAndSplitCoin` for any other coin type.
- *
  * - **Self-funded (`sponsoredContext: false`)** — splits from `tx.gas`
  *   directly (the user's gas coin IS their SUI). More efficient — no
- *   getCoins RTT.
+ *   `getBalance` RTT.
  *
- * Captures the SUI-vs-other-asset divergence that lives inline in
- * `buildSendTx` today (`tx.splitCoins(tx.gas, ...)` vs paginated
- * lookup). composeTx's `send_transfer` adapter routes through this
- * helper to handle both.
+ * - **Sponsored (`sponsoredContext: true`)** — uses
+ *   `coinWithBalance({ type: SUI, useGasCoin: false })`, because `tx.gas`
+ *   belongs to the Enoki sponsor (NOT the user) under sponsored flows.
+ *   The resolver sources from the user's SUI coins / address balance,
+ *   not the sponsor's gas coin.
  */
 declare function selectSuiCoin(tx: Transaction, client: SuiJsonRpcClient, owner: string, amountMist: bigint, sponsoredContext: boolean): Promise<SelectAndSplitResult>;
 
@@ -1153,15 +1145,16 @@ declare function buildUnstakeVSuiTx(client: SuiJsonRpcClient, address: string, a
 /**
  * SPEC 7 § "Layer 1" Volo stake appender. Two modes.
  *
- * Wallet mode (`inputCoin` omitted): fetches SUI coins from the
- * sender's wallet (paginated), merges/splits to `amountMist`. Mirrors
+ * Wallet mode (`inputCoin` omitted): pre-flights via `getBalance` and
+ * sources SUI through `coinWithBalance({ type: SUI, useGasCoin: false })`,
+ * which resolves coin objects + address balance at build time. Mirrors
  * the audric host's `transactions/prepare/route.ts:524-545` volo-stake
  * branch — sponsored-flow safe (does NOT consume `tx.gas`, which
  * belongs to the Enoki sponsor in sponsored flows).
  *
  * For non-sponsored flows where the caller owns `tx.gas`, prefer
- * `buildStakeVSuiTx` directly (it splits from gas, which is more
- * efficient by avoiding the extra getCoins RTT).
+ * `buildStakeVSuiTx` directly (it splits from gas, which avoids one
+ * `getBalance` RTT).
  *
  * Chain mode (`inputCoin` provided): consumes the passed-in SUI coin
  * ref entirely. Used for chained flows like "swap USDC → SUI → stake".
@@ -1185,9 +1178,10 @@ declare function addStakeVSuiToTx(tx: Transaction, client: SuiJsonRpcClient, add
 /**
  * SPEC 7 § "Layer 1" Volo unstake appender. Two modes.
  *
- * Wallet mode (`inputCoin` omitted): fetches vSUI coins from the
- * sender's wallet (paginated), merges to a primary coin, splits to
- * `amountMist` (or consumes the entire merged primary if `'all'`).
+ * Wallet mode (`inputCoin` omitted): pre-flights via `getBalance` and
+ * sources vSUI through `coinWithBalance({ type: VSUI, balance })`,
+ * which resolves coin objects + address balance at build time. With
+ * `'all'`, the entire balance is consumed.
  *
  * Chain mode (`inputCoin` provided): consumes the passed-in vSUI coin
  * ref. With `amountMist = 'all'`, the entire input coin is unstaked.