@arkade-os/sdk 0.4.73 → 0.4.75

package/dist/index.d.cts

@@ -1,11 +1,11 @@
-import { a4 as ReadonlyIdentity, a as Identity, ar as DescriptorSigningRequest, as as Transaction, an as SignerSession, a2 as DescriptorProvider, at as IntentFeeConfig, au as OffchainInput, av as FeeAmount, aw as OnchainInput, ax as FeeOutput, B as IntentRepository, D as ArkIntent, F as IntentFilter, O as Outpoint, H as VirtualTxRepository, J as VirtualTx, K as VtxoBranch, W as WalletRepository, w as ExtendedVirtualCoin, x as VtxoRepositoryKey, E as ExtendedCoin, A as ArkTransaction, y as WalletState, v as Contract, C as ContractRepository, z as ContractFilter, I as IWallet, q as ArkProvider, al as SettlementConfig, ay as ContractWatcherConfig, az as Asset, R as Recipient, aA as FeeInfo, k as SettlementEvent, j as SettleParams, S as SendBitcoinParams, G as GetVtxosFilter, aB as CreateContractParams, aC as GetContractsFilter, u as VirtualCoin, aD as GetSpendablePathsOptions, aE as GetAllSpendingPathsOptions, g as GetNewAddressesOptions, aF as IssuanceParams, aG as ReissuanceParams, aH as BurnParams, aI as RenewVtxosOptions, c as WalletBalance, ab as ContractSyncState, ag as ContractWithVtxos, aJ as WatchedScript, aK as PathSelection, h as NewAddress, aL as ContractEvent, aM as AssetDetails, aN as IssuanceResult, aO as DelegateInfo, aP as MigrationGlobalSkipReason, aQ as MigrationLegSkipReason, aR as SignerStatus, a3 as IReadonlyWallet, d as ActivityRegistry, aa as IReadonlyAssetManager, aS as StorageConfig, e as Activity, N as NormalizedExtendedVirtualCoin, f as IContractManager, m as IAssetManager, l as SendParams, i as IDelegateManager, aT as IVtxoManager, a5 as OnchainProvider, M as Network, ad as NetworkName, ai as Coin, aU as ExplorerTransaction, ae as ArkInfo, ao as SignedIntent, ap as Intent, aV as TreeNonces, aW as TreePartialSigs, T as TxNotificationEvent, aX as PendingTx, t as TapLeafScript, aY as EncodedVtxoScript, P as CSVMultisigTapscript, s as RelativeTimelock, V as VtxoScript, aZ as Status, af as ArkAddress, a_ as ChainTx, r as IndexerProvider, X as TxTree, a$ as PathContext } from './index-Dg0-TvBQ.cjs';
-export { b0 as ActivityIntent, b1 as ActivityResolver, b2 as ArkIntentState, b3 as ArkTapscript, b4 as AssetMetadata, b5 as BITCOIN_EMULATOR_PUBKEY, b6 as BaseWalletConfig, $ as BatchFailedEvent, Z as BatchFinalizationEvent, _ as BatchFinalizedEvent, b7 as BatchInfo, b8 as BatchSignableIdentity, Q as BatchStartedEvent, b9 as CLTVMultisigTapscript, ba as CandidateDeps, bb as ChainTxType, L as ChainedTxType, bc as CommitmentTx, bd as ConditionCSVMultisigTapscript, be as ConditionMultisigTapscript, bf as ContractBalance, bg as ContractEventCallback, bh as ContractHandler, aj as ContractManager, ak as ContractManagerConfig, bi as ContractState, bj as ContractVtxo, bk as ContractVtxoEvent, bl as ContractWatcher, bm as DEFAULT_VTXO_PAGE_SIZE, bn as DelegateManagerImpl, bo as DelegateOptions, a6 as DelegateProvider, bp as DelegatorManagerImpl, bq as DelegatorProvider, br as DeprecatedSignerMigrationReport, bs as DeprecatedSignerReport, bt as DigestMismatchError, bu as Discoverable, bv as DiscoveredContract, bw as DiscoveryDeps, bx as ESPLORA_URL, by as EsploraProvider, bz as EventSourceCapable, bA as EventSourceFactory, bB as EventSourceLike, bC as EventSourceUnavailableError, a8 as ExitCaptureMode, bD as ExitChainResolver, a9 as ExitDataSource, bE as ExtendedContractVtxo, bF as GroupMembership, bG as HandlerError, bH as IDelegatorManager, bI as INTENT_TERMINAL_STATES, bJ as IndexerTxType, bK as IntentCoin, bL as KnownMetadata, bM as MUTINYNET_EMULATOR_PUBKEY, bN as MigrateDeprecatedSignerOptions, bO as MigrationLegReport, bP as MigrationVtxoRef, bQ as MultisigTapscript, bR as NewAddressType, bS as Nonces, bT as Output, bU as PageResponse, bV as PaginationOptions, bW as PartialSig, bX as PrevTxSource, bY as PrevTxUnavailableError, bZ as ProviderClass, b_ as REGTEST_EMULATOR_PUBKEY, b$ as RawTxSource, a7 as ReadonlyWalletConfig, n as RestArkProvider, c0 as RestDelegateProvider, c1 as RestDelegatorProvider, o as RestIndexerProvider, c2 as ScanContractsOptions, c3 as ScanResult, c4 as ScheduledSession, c5 as SettlementEventType, c6 as SignRequest, c7 as SignerClassification, c8 as SignerSet, c9 as SubscriptionEvent, ca as SubscriptionHeartbeat, p as SubscriptionResponse, cb as SweepTxNotification, cc as TapLeaves, cd as TapTreeCoder, ce as TapscriptType, aq as TimeHeight, Y as TreeNoncesEvent, a1 as TreeSignatureEvent, U as TreeSigningStartedEvent, a0 as TreeTxEvent, cf as Tx, cg as TxHistoryRecord, ch as TxKey, ci as TxNotification, cj as TxTag, ck as TxTreeNode, cl as TxType, cm as VirtualStatus, cn as Vtxo, co as VtxoChain, am as VtxoManager, cp as VtxoType, b as WalletConfig, cq as WalletMode, cr as WithPrevTx, cs as assertAllowedSighashTypes, ct as assetMintResolver, cu as attachPrevArkTxs, cv as attachPrevoutTxs, cw as boardingResolver, cx as canRecoverOnchain, cy as canSpendOffchain, cz as canSweepOnchain, cA as classifyAgainstSignerSet, cB as classifyContractSigner, cC as collabExitResolver, cD as configureEventSource, cE as createDefaultActivityRegistry, cF as createExitChainResolver, cG as decodeTapscript, cH as defaultEmulatorPubkey, cI as getConfiguredEventSource, cJ as getNetwork, cK as getRandomId, cL as getSequence, cM as hasCandidates, cN as hasTerminalSpend, cO as isBatchSignable, cP as isContractVtxoEvent, cQ as isCooperativelyMigratable, cR as isDiscoverable, cS as isEventSourceUnavailableError, cT as isExpired, cU as isPastExpiry, cV as isRecoverable, cW as isSigningIdentity, cX as isSpendable, cY as isSubdust, cZ as isTerminalIntentState, c_ as isVirtualCoin, c$ as isVtxoExpiringSoon, d0 as networks, d1 as resolveEmulatorPubkey, d2 as resolveEventSource, d3 as resolvePrevTxs, d4 as scriptFromTapLeafScript, d5 as signerSetFromInfo, d6 as toXOnlySignerHex, d7 as withPrevTxs } from './index-Dg0-TvBQ.cjs';
-import { W as Wallet, R as ReadonlyWallet, b as ReceiveRotatorFactory, c as ReceiveRotatorBootOpts, d as ReceiveRotatorBoot, P as ProviderConnectionState, H as HDWalletCapable, a as HDAllocationCapable, A as AddressAllocationCapable, B as BatchExpiryPolicy, e as Batch } from './hdWalletCapable-DA9bJ5eB.cjs';
-export { f as AbortError, g as ArkError, h as ArkErrorName, i as ArkadeCashClaimResult, j as ArkadeCashCreateError, k as ArkadeCashUnclaimedReason, l as ArkadeCashUnclaimedVtxo, m as BoardingUtxoGroup, C as CheckpointExitDelayPolicy, D as DEFAULT_MIN_BATCH_EXPIRY_SECONDS, n as DEFAULT_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, F as ForeignDescriptorError, I as IncomingFunds, M as MAX_USED_SIGNING_DESCRIPTORS_LOOK_AHEAD, o as MUTINYNET_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, p as ProviderKind, q as ProviderUnavailableError, r as REGTEST_MIN_BATCH_EXPIRY_SECONDS, s as REGTEST_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, S as SIGNET_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, t as ServerInfoSource, u as ServerResponseMismatchError, v as WaitForIncomingFundsOptions, w as WalletCannotAllocateAddressError, x as assertValidBatchExpiry, y as assertValidServerUnrollScript, z as defaultBatchExpiryPolicy, E as defaultCheckpointExitDelayPolicy, G as isAddressAllocationCapable, J as isArkError, K as isHDAllocationCapable, L as isHDWalletCapable, N as maybeArkError, O as resolveBatchExpiryPolicy, Q as resolveCheckpointExitDelayPolicy, T as resolveDescriptorSigner, U as selectVirtualCoins, V as signingDescriptorIndex, X as strictSigningDescriptorIndex, Y as waitForIncomingFunds } from './hdWalletCapable-DA9bJ5eB.cjs';
-import { P as Program, A as ArkadeParamValue, a as ArkadeProgramScript, b as ProgramKeys, c as ArkadeArgValue, C as CompiledProgramFunction, d as ArkadeFunction, I as InputRef, e as InputDef, f as ArkadeValueType, g as ArkadeArgType, h as ArkadeContractParams, i as ArkadeSegment, j as AsmToken, S as SUPPORTED_PROGRAM_VERSION, k as SignerRef, T as TapscriptSegment, W as WitnessRef, l as deserializeArkadeContractParams, p as parseArtifact, r as resolveAsm, s as serializeArkadeContractParams, m as stringifyArtifact, v as validateProgram, w as witnessRefToBytes } from './index-DSbDm0Io.cjs';
-export { n as ArkadeContractHandler, B as BoardingContractHandler, o as BoardingContractParams, D as DefaultContractHandler, q as DefaultContractParams, t as DelegateContractHandler, u as DelegateContractParams, V as VHTLC, x as VHTLCContractHandler, y as VHTLCContractParams, z as VHTLCV2ContractHandler, E as VHTLCV2ContractParams, F as contractHandlers } from './index-DSbDm0Io.cjs';
-import { D as DefaultVtxo } from './delegate-BJp8f6LT.cjs';
-export { a as DelegateVtxo } from './delegate-BJp8f6LT.cjs';
+import { a4 as ReadonlyIdentity, a as Identity, ar as DescriptorSigningRequest, as as Transaction, an as SignerSession, a2 as DescriptorProvider, at as IntentFeeConfig, au as OffchainInput, av as FeeAmount, aw as OnchainInput, ax as FeeOutput, B as IntentRepository, D as ArkIntent, F as IntentFilter, O as Outpoint, H as VirtualTxRepository, J as VirtualTx, K as VtxoBranch, W as WalletRepository, w as ExtendedVirtualCoin, x as VtxoRepositoryKey, E as ExtendedCoin, A as ArkTransaction, y as WalletState, v as Contract, C as ContractRepository, z as ContractFilter, I as IWallet, q as ArkProvider, al as SettlementConfig, ay as ContractWatcherConfig, az as Asset, R as Recipient, aA as FeeInfo, k as SettlementEvent, N as NormalizedExtendedVirtualCoin, j as SettleParams, S as SendBitcoinParams, G as GetVtxosFilter, aB as CreateContractParams, aC as GetContractsFilter, u as VirtualCoin, aD as GetSpendablePathsOptions, aE as GetAllSpendingPathsOptions, g as GetNewAddressesOptions, aF as IssuanceParams, aG as ReissuanceParams, aH as BurnParams, aI as RenewVtxosOptions, c as WalletBalance, ab as ContractSyncState, ag as ContractWithVtxos, aJ as WatchedScript, aK as PathSelection, h as NewAddress, aL as ContractEvent, aM as AssetDetails, aN as IssuanceResult, aO as DelegateInfo, aP as MigrationGlobalSkipReason, aQ as MigrationLegSkipReason, aR as SignerStatus, a3 as IReadonlyWallet, d as ActivityRegistry, aa as IReadonlyAssetManager, aS as StorageConfig, e as Activity, f as IContractManager, m as IAssetManager, l as SendParams, i as IDelegateManager, aT as IVtxoManager, a5 as OnchainProvider, M as Network, ad as NetworkName, ai as Coin, aU as ExplorerTransaction, ae as ArkInfo, ao as SignedIntent, ap as Intent, aV as TreeNonces, aW as TreePartialSigs, T as TxNotificationEvent, aX as PendingTx, t as TapLeafScript, aY as EncodedVtxoScript, P as CSVMultisigTapscript, s as RelativeTimelock, V as VtxoScript, aZ as Status, af as ArkAddress, a_ as ChainTx, r as IndexerProvider, X as TxTree, a$ as PathContext } from './index-TZBbMNqA.cjs';
+export { b0 as ActivityIntent, b1 as ActivityResolver, b2 as ArkIntentState, b3 as ArkTapscript, b4 as AssetMetadata, b5 as BITCOIN_EMULATOR_PUBKEY, b6 as BaseWalletConfig, $ as BatchFailedEvent, Z as BatchFinalizationEvent, _ as BatchFinalizedEvent, b7 as BatchInfo, b8 as BatchSignableIdentity, Q as BatchStartedEvent, b9 as CLTVMultisigTapscript, ba as CandidateDeps, bb as ChainTxType, L as ChainedTxType, bc as CommitmentTx, bd as ConditionCSVMultisigTapscript, be as ConditionMultisigTapscript, bf as ContractBalance, bg as ContractEventCallback, bh as ContractHandler, aj as ContractManager, ak as ContractManagerConfig, bi as ContractState, bj as ContractVtxo, bk as ContractVtxoEvent, bl as ContractWatcher, bm as DEFAULT_VTXO_PAGE_SIZE, bn as DelegateManagerImpl, bo as DelegateOptions, a6 as DelegateProvider, bp as DelegatorManagerImpl, bq as DelegatorProvider, br as DeprecatedSignerMigrationReport, bs as DeprecatedSignerReport, bt as DigestMismatchError, bu as Discoverable, bv as DiscoveredContract, bw as DiscoveryDeps, bx as ESPLORA_URL, by as EsploraProvider, bz as EventSourceCapable, bA as EventSourceFactory, bB as EventSourceLike, bC as EventSourceUnavailableError, a8 as ExitCaptureMode, bD as ExitChainResolver, a9 as ExitDataSource, bE as ExtendedContractVtxo, bF as GroupMembership, bG as HandlerError, bH as IDelegatorManager, bI as INTENT_TERMINAL_STATES, bJ as IndexerTxType, bK as IntentCoin, bL as KnownMetadata, bM as MUTINYNET_EMULATOR_PUBKEY, bN as MigrateDeprecatedSignerOptions, bO as MigrationLegReport, bP as MigrationVtxoRef, bQ as MultisigTapscript, bR as NewAddressType, bS as Nonces, bT as Output, bU as PageResponse, bV as PaginationOptions, bW as PartialSig, bX as PrevTxSource, bY as PrevTxUnavailableError, bZ as ProviderClass, b_ as REGTEST_EMULATOR_PUBKEY, b$ as RawTxSource, a7 as ReadonlyWalletConfig, n as RestArkProvider, c0 as RestDelegateProvider, c1 as RestDelegatorProvider, o as RestIndexerProvider, c2 as ScanContractsOptions, c3 as ScanResult, c4 as ScheduledSession, c5 as SettlementEventType, c6 as SignRequest, c7 as SignerClassification, c8 as SignerSet, c9 as SubscriptionEvent, ca as SubscriptionHeartbeat, p as SubscriptionResponse, cb as SweepTxNotification, cc as TapLeaves, cd as TapTreeCoder, ce as TapscriptType, aq as TimeHeight, Y as TreeNoncesEvent, a1 as TreeSignatureEvent, U as TreeSigningStartedEvent, a0 as TreeTxEvent, cf as Tx, cg as TxHistoryRecord, ch as TxKey, ci as TxNotification, cj as TxTag, ck as TxTreeNode, cl as TxType, cm as VirtualStatus, cn as Vtxo, co as VtxoChain, am as VtxoManager, cp as VtxoType, b as WalletConfig, cq as WalletMode, cr as WithPrevTx, cs as assertAllowedSighashTypes, ct as assetMintResolver, cu as attachPrevArkTxs, cv as attachPrevoutTxs, cw as boardingResolver, cx as canRecoverOnchain, cy as canSpendOffchain, cz as canSweepOnchain, cA as classifyAgainstSignerSet, cB as classifyContractSigner, cC as collabExitResolver, cD as configureEventSource, cE as createDefaultActivityRegistry, cF as createExitChainResolver, cG as decodeTapscript, cH as defaultEmulatorPubkey, cI as getConfiguredEventSource, cJ as getNetwork, cK as getRandomId, cL as getSequence, cM as hasCandidates, cN as hasTerminalSpend, cO as isBatchSignable, cP as isContractVtxoEvent, cQ as isCooperativelyMigratable, cR as isDiscoverable, cS as isEventSourceUnavailableError, cT as isExpired, cU as isPastExpiry, cV as isRecoverable, cW as isSigningIdentity, cX as isSpendable, cY as isSubdust, cZ as isTerminalIntentState, c_ as isVirtualCoin, c$ as isVtxoExpiringSoon, d0 as networks, d1 as resolveEmulatorPubkey, d2 as resolveEventSource, d3 as resolvePrevTxs, d4 as scriptFromTapLeafScript, d5 as signerSetFromInfo, d6 as toXOnlySignerHex, d7 as withPrevTxs } from './index-TZBbMNqA.cjs';
+import { W as Wallet, R as ReadonlyWallet, b as ReceiveRotatorFactory, c as ReceiveRotatorBootOpts, d as ReceiveRotatorBoot, P as ProviderConnectionState, H as HDWalletCapable, a as HDAllocationCapable, A as AddressAllocationCapable, B as BatchExpiryPolicy, e as Batch } from './hdWalletCapable-66hG5KQP.cjs';
+export { f as AbortError, g as ArkError, h as ArkErrorName, i as ArkadeCashClaimResult, j as ArkadeCashCreateError, k as ArkadeCashUnclaimedReason, l as ArkadeCashUnclaimedVtxo, m as BoardingUtxoGroup, C as CheckpointExitDelayPolicy, D as DEFAULT_MIN_BATCH_EXPIRY_SECONDS, n as DEFAULT_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, F as ForeignDescriptorError, I as IncomingFunds, M as MAX_USED_SIGNING_DESCRIPTORS_LOOK_AHEAD, o as MUTINYNET_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, p as ProviderKind, q as ProviderUnavailableError, r as REGTEST_MIN_BATCH_EXPIRY_SECONDS, s as REGTEST_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, S as SIGNET_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, t as ServerInfoSource, u as ServerResponseMismatchError, v as WaitForIncomingFundsOptions, w as WalletCannotAllocateAddressError, x as assertValidBatchExpiry, y as assertValidServerUnrollScript, z as defaultBatchExpiryPolicy, E as defaultCheckpointExitDelayPolicy, G as isAddressAllocationCapable, J as isArkError, K as isHDAllocationCapable, L as isHDWalletCapable, N as maybeArkError, O as resolveBatchExpiryPolicy, Q as resolveCheckpointExitDelayPolicy, T as resolveDescriptorSigner, U as selectVirtualCoins, V as signingDescriptorIndex, X as strictSigningDescriptorIndex, Y as waitForIncomingFunds } from './hdWalletCapable-66hG5KQP.cjs';
+import { P as Program, A as ArkadeParamValue, a as ArkadeProgramScript, b as ProgramKeys, c as ArkadeArgValue, C as CompiledProgramFunction, d as ArkadeFunction, I as InputRef, e as InputDef, f as ArkadeValueType, g as ArkadeArgType, h as ArkadeContractParams, i as ArkadeSegment, j as AsmToken, S as SUPPORTED_PROGRAM_VERSION, k as SignerRef, T as TapscriptSegment, W as WitnessRef, l as deserializeArkadeContractParams, p as parseArtifact, r as resolveAsm, s as serializeArkadeContractParams, m as stringifyArtifact, v as validateProgram, w as witnessRefToBytes } from './index-B2JSxDi1.cjs';
+export { n as ArkadeContractHandler, B as BoardingContractHandler, o as BoardingContractParams, D as DefaultContractHandler, q as DefaultContractParams, t as DelegateContractHandler, u as DelegateContractParams, V as VHTLC, x as VHTLCContractHandler, y as VHTLCContractParams, z as VHTLCV2ContractHandler, E as VHTLCV2ContractParams, F as contractHandlers } from './index-B2JSxDi1.cjs';
+import { D as DefaultVtxo } from './delegate-D0v8yT-a.cjs';
+export { a as DelegateVtxo } from './delegate-D0v8yT-a.cjs';
 import { Bytes, BTC_NETWORK } from '@scure/btc-signer/utils.js';
 import { P2TR } from '@scure/btc-signer/payment.js';
 import { Transaction as Transaction$1, OP, Script, ScriptType } from '@scure/btc-signer';
@@ -2238,6 +2238,13 @@ declare class DustChangeError extends Error {
     readonly dustAmount: bigint;
     constructor(change: bigint, dustAmount: bigint);
 }
+/** Thrown when a collaborative exit's change VTXO is above the server's
+ *  per-output ceiling, which arkd answers with `AMOUNT_TOO_HIGH`. */
+declare class OversizedChangeError extends Error {
+    readonly change: bigint;
+    readonly maxAmount: bigint;
+    constructor(change: bigint, maxAmount: bigint);
+}
 /**
  * Ramps is a class wrapping `settle` method to provide a more convenient interface for onboarding and offboarding operations.
  *
@@ -2287,6 +2294,10 @@ declare class Ramps {
      * @param feeInfo - The fee info to deduct from the offboard amount.
      * @param amount - The amount to offboard. If not provided, the total amount of virtual outputs will be offboarded.
      * @param eventCallback - Optional callback that receives settlement events
+     * @param vtxos - Specific virtual outputs to spend, mirroring {@link onboard}'s
+     * `boardingUtxos`. Omitted, every spendable one is spent — merging the whole
+     * off-chain balance into a single change output. Taken as given like
+     * `settle({ inputs })`: an `amount` these cannot cover is an error, not a top-up.
      * @returns The Arkade transaction id created by settlement
      * @throws Error if no virtual outputs remain after fee deduction or the destination address cannot be decoded
      * @see IWallet.getSpendableVtxos
@@ -2298,7 +2309,24 @@ declare class Ramps {
      * await ramps.offboard('bc1q...', feeInfo);
      * ```
      */
-    offboard(destinationAddress: string, feeInfo: FeeInfo, amount?: bigint, eventCallback?: (event: SettlementEvent) => void): ReturnType<IWallet["settle"]>;
+    offboard(destinationAddress: string, feeInfo: FeeInfo, amount?: bigint, eventCallback?: (event: SettlementEvent) => void, vtxos?: NormalizedExtendedVirtualCoin[]): ReturnType<IWallet["settle"]>;
+    /**
+     * Collaboratively exit with the DESTINATION paid exactly `amount`, pricing the
+     * fee on that output rather than on a grossed-up figure. {@link offboard} keeps
+     * the other anchor, which needs `g - fee(g) = amount` solved — impossible for
+     * a program charging the whole output.
+     */
+    offboardExact(params: {
+        destinationAddress: string;
+        feeInfo: FeeInfo;
+        /** Sats the destination receives, exactly. */
+        amount: bigint;
+        eventCallback?: (event: SettlementEvent) => void;
+        vtxos?: NormalizedExtendedVirtualCoin[];
+    }): ReturnType<IWallet["settle"]>;
+    /** Fund the change output: pay its own fee, then judge it against both
+     *  server-side bounds. `0n` in is `0n` out — no change output at all. */
+    private fundChange;
 }
 
 /**
@@ -2647,26 +2675,26 @@ type ResponseGetContractsWithVtxos = ResponseEnvelope & {
 type RequestWatchScript = RequestEnvelope & {
     type: "WATCH_SCRIPT";
     payload: {
-        script: string;
+        script: string | string[];
         label?: string;
     };
 };
 type ResponseWatchScript = ResponseEnvelope & {
     type: "SCRIPT_WATCHED";
     payload: {
-        script: string;
+        script: string | string[];
     };
 };
 type RequestUnwatchScript = RequestEnvelope & {
     type: "UNWATCH_SCRIPT";
     payload: {
-        script: string;
+        script: string | string[];
     };
 };
 type ResponseUnwatchScript = ResponseEnvelope & {
     type: "SCRIPT_UNWATCHED";
     payload: {
-        script: string;
+        script: string | string[];
     };
 };
 type RequestGetWatchedScripts = RequestEnvelope & {
@@ -5276,7 +5304,7 @@ declare class Extension {
 /**
  * Arkade Script Opcodes
  *
- * This module defines ONLY Arkade-specific opcodes (0xb3, 0xc3-0xf6).
+ * This module defines ONLY Arkade-specific opcodes (0xb3, 0xc3-0xf8).
  * Standard Bitcoin opcodes are imported from @scure/btc-signer.
  *
  * Reference: arkade-os/emulator v0.0.4 pkg/arkade/opcode.go
@@ -5307,6 +5335,8 @@ declare const ARKADE_OP: {
     readonly BIN2NUM: 216;
     readonly REVERSEBYTES: 217;
     readonly MODEXP: 218;
+    readonly PUSHEXPIRY: 219;
+    readonly CHECKTIME: 220;
     readonly ECADD: 224;
     readonly ECMUL: 225;
     readonly ECPAIRING: 226;
@@ -5330,6 +5360,8 @@ declare const ARKADE_OP: {
     readonly INSPECTPACKET: 244;
     readonly INSPECTINPUTPACKET: 245;
     readonly SIGHASH: 246;
+    readonly TUNNEL: 247;
+    readonly INSPECTINTENTMESSAGE: 248;
 };
 declare const ARKADE_OPCODES: number[];
 declare const ARKADE_OPCODE_NAMES: Record<number, string>;
@@ -5401,6 +5433,8 @@ declare const ARKADE_OPS: {
     readonly BIN2NUM: 216;
     readonly REVERSEBYTES: 217;
     readonly MODEXP: 218;
+    readonly PUSHEXPIRY: 219;
+    readonly CHECKTIME: 220;
     readonly ECADD: 224;
     readonly ECMUL: 225;
     readonly ECPAIRING: 226;
@@ -5424,6 +5458,8 @@ declare const ARKADE_OPS: {
     readonly INSPECTPACKET: 244;
     readonly INSPECTINPUTPACKET: 245;
     readonly SIGHASH: 246;
+    readonly TUNNEL: 247;
+    readonly INSPECTINTENTMESSAGE: 248;
     readonly OP_0: number;
     readonly PUSHDATA1: number;
     readonly PUSHDATA2: number;
@@ -5813,7 +5849,10 @@ interface ArkadeConnectOptions {
     indexer?: Pick<IndexerProvider, "getVtxos" | "getVirtualTxs">;
     /** Signer for paths that require a user signature; optional for watch-only. */
     identity?: Identity;
-    /** Network for address derivation; defaults to the SDK default. */
+    /**
+     * Network for address derivation. Defaults to the network the server
+     * reports on `getInfo` — or the SDK default when the server names none.
+     */
     network?: Network;
     /**
      * Co-sign with this emulator key (33-byte compressed hex) instead of the
@@ -6168,9 +6207,10 @@ interface PaymentHandle {
  *
  * `fee` is a pre-send estimate wherever the true cost is only fixed later: the
  * swap rails quote from Boltz's advertised pricing and are superseded by the
- * amount Boltz returns at swap creation, and the collaborative exit does not
- * include the per-input intent fees, which depend on the VTXO selection made at
- * settlement. Treat it as a display and ranking figure, not a guarantee.
+ * amount Boltz returns at swap creation, and the collaborative exit omits the
+ * per-input intent fees whenever the request left the VTXO selection to
+ * settlement — naming {@link PaymentRequest.selectedVtxos} fixes them, and they
+ * are priced in. Treat it as a display and ranking figure, not a guarantee.
  */
 interface RouteQuote {
     railId: string;
@@ -6243,6 +6283,17 @@ interface PaymentRequest {
      *  Additive: an asset transfer also moves sats, so a 500 USDX request
      *  legitimately has both. A rail that cannot deliver assets must REFUSE. */
     assets?: Asset[];
+    /**
+     * Spend exactly these virtual outputs, with the meaning
+     * {@link SendParams.selectedVtxos} already gives it: taken as given, so a
+     * shortfall is an error rather than a top-up, and ungated like
+     * `settle({ inputs })`. Normalized, i.e. what `getSpendableVtxos()` returns.
+     *
+     * Only the rails spending the wallet's own coins can honour it (`ark`,
+     * `ark-asset`, `onchain`). A rail funding its payment through a counterparty
+     * picks its own inputs, so it must REFUSE rather than ignore the selection.
+     */
+    selectedVtxos?: NormalizedExtendedVirtualCoin[];
 }
 /** A payment rail — registered by id, mirrors the ActivityRegistry resolver shape. */
 interface PaymentRail {
@@ -6275,10 +6326,11 @@ declare const isLightningInvoice: (raw: string) => boolean;
 /**
  * True for an LNURL or a Lightning address (`user@host`).
  *
- * TODO(lnurl): no rail consumes this yet — LNURL / Lightning-address routing is
- * planned future work. The predicate is exported ahead of the rail so consumers
- * can classify these targets today; until the rail lands, `route()` throws
- * "no rail for" on them. Keep the export (do not flag as unused).
+ * No rail here consumes it, and that is the layering rather than a gap:
+ * routing an LNURL needs an LNURL client, so the rails ship from
+ * `@arkade-os/lnurl-client/arkade` (`lnurlRails`) and are registered by the
+ * app, as the solver rails from `@arkade-os/swap` are. With none registered,
+ * `route()` throws "no rail for" on these targets.
  */
 declare const isLnurl: (raw: string) => boolean;
 /** True for a bech32 (segwit) or base58 (legacy) Bitcoin address, any network —
@@ -6315,6 +6367,11 @@ declare function assetsOf(req: PaymentRequest): Asset[];
 /** For a BTC-only rail: refusing is what leaves the router free to rank an
  *  asset-capable one, instead of paying the carrier and dropping the asset. */
 declare function assertNoAssets(railId: string, req: PaymentRequest): void;
+/** The inputs a request names. An EMPTY array is still a selection, covering nothing. */
+declare function selectionOf(req: PaymentRequest): NormalizedExtendedVirtualCoin[] | undefined;
+/** For a rail whose counterparty funds the spend: ignoring a named input set
+ *  would spend coins the caller had promised elsewhere, so refuse instead. */
+declare function assertNoSelection(railId: string, req: PaymentRequest): void;
 /** Exactly one: `Wallet.send` takes a list because one output can carry
  *  several, but a routed PAYMENT is one thing being paid. */
 declare function resolveAssetAmount(railId: string, req: PaymentRequest): Asset;
@@ -6393,12 +6450,15 @@ declare const walletFeeSource: (wallet: Wallet) => () => Promise<FeeInfo>;
  * and offboards VTXOs to the address via {@link Ramps.offboard}, which owns
  * fee-aware coin selection, dust-safe change, and settlement.
  *
- * `offboard` deducts its fee from the amount it is handed, so the rail grosses
- * the amount up first: the recipient receives exactly `quote.amount`, matching
- * the receiver-exact semantics of every other rail (see {@link RouteQuote}).
- * `quote.total` is the offboard amount; the per-input intent fees `offboard`
- * shaves off the selected VTXOs are additional and depend on the selection, so
- * they are not part of the quote.
+ * The exit fee is priced on the DESTINATION output — the one arkd charges for —
+ * and met from the balance, so the recipient receives exactly `quote.amount`
+ * (see {@link RouteQuote}). {@link Ramps.offboardExact} carries that; the
+ * gross-up this rail used to do could only approximate it.
+ *
+ * A request naming `selectedVtxos` offboards exactly those — so the exit need not
+ * sweep the whole off-chain balance into one change output — and only then does
+ * the quote carry the per-input intent fees: unselected, the coins are chosen
+ * later at settlement and there is nothing here to price.
  *
  * An explicit amount is mandatory. To sweep the full balance, call
  * `Ramps.offboard(address, feeInfo)` directly — the router has no amountless path.
@@ -6709,4 +6769,4 @@ declare class AssetManager extends ReadonlyAssetManager implements IAssetManager
     burn(params: BurnParams): Promise<string>;
 }
 
-export { ARKADE_MAGIC, ARKADE_SALTED_PREIMAGE_TAG, ARKADE_SWAP_PREIMAGE_TAG, ASSET_CARRIER_SATS, Activity, ActivityRegistry, AddressAllocationCapable, AmbiguousRouteError, type AnchorBumper, ArkAddress, ArkInfo, ArkIntent, ArkNote, ArkProvider, type ArkPsbtFieldCoder, ArkPsbtFieldKey, ArkPsbtFieldKeyType, ArkTransaction, type ArkTxInput, type ArkadeBatchInput, ArkadeCash, ArkadeContractParams, type ArkadeExtendedCoin, type ArkadeExtendedVirtualCoin, Asset, AssetDetails, AssetManager, BIP21, BIP21Error, type BIP21Params, type BIP21ParseResult, BIP322, BLOCKED_UPGRADE_TIMEOUT_MS, Batch, BatchExpiryPolicy, BurnParams, CSVMultisigTapscript, CachingArkProvider, ChainTx, Coin, ConditionWitness, ConnectionDisposedError, type ConnectorTreeNode, Contract, ContractEvent, ContractRepository, ContractRepositoryImpl, ContractSyncState, ContractWatcherConfig, ContractWithVtxos, CosignerPublicKey, CreateContractParams, DEFAULT_MESSAGE_TIMEOUTS, DatabaseUpgradeBlockedError, DefaultVtxo, DelegateInfo, DelegateNotConfiguredError, DelegatorNotConfiguredError, DescriptorIdentity, type DescriptorIdentityOptions, type DescriptorOptions, type DescriptorSigner, DescriptorSigningProviderMissingError, type DeterministicSigner, DustChangeError, ELECTRUM_TCP_HOST, ELECTRUM_WS_URL, type BlockHeader as ElectrumBlockHeader, ElectrumOnchainProvider, type TransactionHistory as ElectrumTransactionHistory, type Unspent as ElectrumUnspent, type EmulatorEntry, type EmulatorInfo, EmulatorPacket, type EmulatorProvider, EncodedVtxoScript, Estimator, type ExcludableVtxo, type ExecutorEvent, type ExecutorOptions, type ExitDelay, type ExitFeeWallet, type ExitMode, type ExitOptions, type ExitPackage, type ExitQuote, type ExitStep, type ExitTotals, type ExitVtxoInfo, ExplorerTransaction, ExtendedCoin, ExtendedVirtualCoin, Extension, ExtensionNotFoundError, type ExtensionPacket, FeeAmount, FeeInfo, FeeOutput, FetchError, GetNewAddressesOptions, GetVtxosFilter, HDAllocationCapable, HDDescriptorProvider, type HDDeterministicSignCapable, HDWalletCapable, IAssetManager, IContractManager, IDelegateManager, IReadonlyAssetManager, IReadonlyWallet, IVtxoManager, IWallet, Identity, InMemoryContractRepository, InMemoryIntentRepository, InMemoryVirtualTxRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBIntentRepository, IndexedDBVirtualTxRepository, IndexedDBWalletRepository, IndexerProvider, Intent, IntentFeeConfig, IntentFilter, IntentRepository, IssuanceParams, IssuanceResult, MESSAGE_BUS_INITIALIZING, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, type ManagedConnection, MessageBus, MessageBusInitializingError, MessageBusNotInitializedError, type MessageHandler, type MessageTimeouts, MigrationGlobalSkipReason, MigrationLegSkipReason, type MigrationStatus, MissingSigningDescriptorError, MnemonicIdentity, type MnemonicOptions, Network, NetworkName, type NetworkOptions, NewAddress, OffchainInput, type OffchainTx, type OnExitObserved, OnchainInput, OnchainProvider, OnchainWallet, Outpoint, P2A, type ParsedArkContract, PathContext, PathSelection, type PaymentHandle, type PaymentOption, type PaymentRail, type PaymentRequest, PaymentRouter, type PaymentStatus, PrevArkTxField, PrevoutTxField, ProviderConnectionState, type ProvisionedClaimSecret, type ProvisionedKey, READ_TIMEOUT_MS, Ramps, ReadonlyAssetManager, ReadonlyDescriptorIdentity, ReadonlyIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, Recipient, ReissuanceParams, RelativeTimelock, RenewVtxosOptions, type RequestEnvelope, type ResponseEnvelope, RestEmulatorProvider, type RouteQuote, type RouteResult, type RouterContext, type RouterPreferences, SeedIdentity, type SeedIdentityOptions, SendBitcoinParams, SendParams, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, type ServiceWorkerWalletMode, SettleParams, SettlementConfig, SettlementEvent, SignedIntent, SignerSession, SignerStatus, SingleKey, Status, StorageConfig, TapLeafScript, Transaction, TreeNonces, TreePartialSigs, TxNotificationEvent, TxTree, TxWeightEstimator, UnannotatableInputError, UnilateralExit, UnknownPacket, Unroll, type VSize, type VerifyServerSignatures, VirtualCoin, VirtualTx, VirtualTxRepository, VtxoBranch, type VtxoExclusion, VtxoScript, VtxoTaprootTree, VtxoTreeExpiry, Wallet, WalletBalance, WalletCannotSignError, WalletMessageHandler, WalletNotInitializedError, WalletRepository, WalletRepositoryImpl, type WalletRestoreHook, WatchedScript, WsElectrumChainSource, adoptContractDescriptor, arkAssetRail, arkRail, arkTarget, index as arkade, assembleBtcdTaprootTree, assertFinalCommitmentMatchesValidated, assertNoAssets, assertSendableAmount, assertSubmittedArkTxid, index$1 as asset, assetsOf, awaitTransaction, btcTarget, buildForfeitTx, buildOffchainTx, buildPreimageMessage, buildSaltedPreimageMessage, buildVersion, claimWithPreimageIdentity, closeDatabase, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, contractPreimage, contractSigner, createAssetPacket, createDefaultPaymentRouter, createManagedConnection, decodeArkContract, deleteByIndex, deriveDescriptorLeafCompressedPubKey, deriveDescriptorLeafPubKey, deserializeExitPackage, encodeArkContract, exitObserverFor, gateExclusion, gatedContracts, getAllByIndexValues, getArkPsbtFields, getMigrationStatus, hasBoardingTxExpired, identityDescriptor, invoiceTarget, isArkContract, isBtcAddress, isCltvSatisfied, isContractGenericallySpendable, isCsvSpendable, isDeterministicSigner, isHDDeterministicSignCapable, isLightningInvoice, isLnurl, isMessageBusInitializingError, isMessageBusNotInitializedError, isPerArtifactDescriptor, isRetryableProviderError, isValidArkAddress, logExcludedVtxos, makeHandle, matchServerCheckpoints, migrateWalletRepository, normalizeToDescriptor, notifyExitObserved, onchainRail, openDatabase, outpointExclusion, outpointReasons, parseHDDescriptor, promisifyRequest, provisionClaimSecret, provisionRefundKey, registerWalletRestoreHook, requiresMigration, resolveAssetAmount, resolveSendAmount, rollbackMigration, sdkVersion, selectCoinsWithAsset, sequenceToTimelock, serializeExitPackage, setArkPsbtField, setupServiceWorker, signAndSubmitOffchainTx, timelockToSequence, toXOnly, tryResolveSendAmount, validateBatchRecipients, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures, walletFeeSource };
+export { ARKADE_MAGIC, ARKADE_SALTED_PREIMAGE_TAG, ARKADE_SWAP_PREIMAGE_TAG, ASSET_CARRIER_SATS, Activity, ActivityRegistry, AddressAllocationCapable, AmbiguousRouteError, type AnchorBumper, ArkAddress, ArkInfo, ArkIntent, ArkNote, ArkProvider, type ArkPsbtFieldCoder, ArkPsbtFieldKey, ArkPsbtFieldKeyType, ArkTransaction, type ArkTxInput, type ArkadeBatchInput, ArkadeCash, ArkadeContractParams, type ArkadeExtendedCoin, type ArkadeExtendedVirtualCoin, Asset, AssetDetails, AssetManager, BIP21, BIP21Error, type BIP21Params, type BIP21ParseResult, BIP322, BLOCKED_UPGRADE_TIMEOUT_MS, Batch, BatchExpiryPolicy, BurnParams, CSVMultisigTapscript, CachingArkProvider, ChainTx, Coin, ConditionWitness, ConnectionDisposedError, type ConnectorTreeNode, Contract, ContractEvent, ContractRepository, ContractRepositoryImpl, ContractSyncState, ContractWatcherConfig, ContractWithVtxos, CosignerPublicKey, CreateContractParams, DEFAULT_MESSAGE_TIMEOUTS, DatabaseUpgradeBlockedError, DefaultVtxo, DelegateInfo, DelegateNotConfiguredError, DelegatorNotConfiguredError, DescriptorIdentity, type DescriptorIdentityOptions, type DescriptorOptions, type DescriptorSigner, DescriptorSigningProviderMissingError, type DeterministicSigner, DustChangeError, ELECTRUM_TCP_HOST, ELECTRUM_WS_URL, type BlockHeader as ElectrumBlockHeader, ElectrumOnchainProvider, type TransactionHistory as ElectrumTransactionHistory, type Unspent as ElectrumUnspent, type EmulatorEntry, type EmulatorInfo, EmulatorPacket, type EmulatorProvider, EncodedVtxoScript, Estimator, type ExcludableVtxo, type ExecutorEvent, type ExecutorOptions, type ExitDelay, type ExitFeeWallet, type ExitMode, type ExitOptions, type ExitPackage, type ExitQuote, type ExitStep, type ExitTotals, type ExitVtxoInfo, ExplorerTransaction, ExtendedCoin, ExtendedVirtualCoin, Extension, ExtensionNotFoundError, type ExtensionPacket, FeeAmount, FeeInfo, FeeOutput, FetchError, GetNewAddressesOptions, GetVtxosFilter, HDAllocationCapable, HDDescriptorProvider, type HDDeterministicSignCapable, HDWalletCapable, IAssetManager, IContractManager, IDelegateManager, IReadonlyAssetManager, IReadonlyWallet, IVtxoManager, IWallet, Identity, InMemoryContractRepository, InMemoryIntentRepository, InMemoryVirtualTxRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBIntentRepository, IndexedDBVirtualTxRepository, IndexedDBWalletRepository, IndexerProvider, Intent, IntentFeeConfig, IntentFilter, IntentRepository, IssuanceParams, IssuanceResult, MESSAGE_BUS_INITIALIZING, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, type ManagedConnection, MessageBus, MessageBusInitializingError, MessageBusNotInitializedError, type MessageHandler, type MessageTimeouts, MigrationGlobalSkipReason, MigrationLegSkipReason, type MigrationStatus, MissingSigningDescriptorError, MnemonicIdentity, type MnemonicOptions, Network, NetworkName, type NetworkOptions, NewAddress, NormalizedExtendedVirtualCoin, OffchainInput, type OffchainTx, type OnExitObserved, OnchainInput, OnchainProvider, OnchainWallet, Outpoint, OversizedChangeError, P2A, type ParsedArkContract, PathContext, PathSelection, type PaymentHandle, type PaymentOption, type PaymentRail, type PaymentRequest, PaymentRouter, type PaymentStatus, PrevArkTxField, PrevoutTxField, ProviderConnectionState, type ProvisionedClaimSecret, type ProvisionedKey, READ_TIMEOUT_MS, Ramps, ReadonlyAssetManager, ReadonlyDescriptorIdentity, ReadonlyIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, Recipient, ReissuanceParams, RelativeTimelock, RenewVtxosOptions, type RequestEnvelope, type ResponseEnvelope, RestEmulatorProvider, type RouteQuote, type RouteResult, type RouterContext, type RouterPreferences, SeedIdentity, type SeedIdentityOptions, SendBitcoinParams, SendParams, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, type ServiceWorkerWalletMode, SettleParams, SettlementConfig, SettlementEvent, SignedIntent, SignerSession, SignerStatus, SingleKey, Status, StorageConfig, TapLeafScript, Transaction, TreeNonces, TreePartialSigs, TxNotificationEvent, TxTree, TxWeightEstimator, UnannotatableInputError, UnilateralExit, UnknownPacket, Unroll, type VSize, type VerifyServerSignatures, VirtualCoin, VirtualTx, VirtualTxRepository, VtxoBranch, type VtxoExclusion, VtxoScript, VtxoTaprootTree, VtxoTreeExpiry, Wallet, WalletBalance, WalletCannotSignError, WalletMessageHandler, WalletNotInitializedError, WalletRepository, WalletRepositoryImpl, type WalletRestoreHook, WatchedScript, WsElectrumChainSource, adoptContractDescriptor, arkAssetRail, arkRail, arkTarget, index as arkade, assembleBtcdTaprootTree, assertFinalCommitmentMatchesValidated, assertNoAssets, assertNoSelection, assertSendableAmount, assertSubmittedArkTxid, index$1 as asset, assetsOf, awaitTransaction, btcTarget, buildForfeitTx, buildOffchainTx, buildPreimageMessage, buildSaltedPreimageMessage, buildVersion, claimWithPreimageIdentity, closeDatabase, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, contractPreimage, contractSigner, createAssetPacket, createDefaultPaymentRouter, createManagedConnection, decodeArkContract, deleteByIndex, deriveDescriptorLeafCompressedPubKey, deriveDescriptorLeafPubKey, deserializeExitPackage, encodeArkContract, exitObserverFor, gateExclusion, gatedContracts, getAllByIndexValues, getArkPsbtFields, getMigrationStatus, hasBoardingTxExpired, identityDescriptor, invoiceTarget, isArkContract, isBtcAddress, isCltvSatisfied, isContractGenericallySpendable, isCsvSpendable, isDeterministicSigner, isHDDeterministicSignCapable, isLightningInvoice, isLnurl, isMessageBusInitializingError, isMessageBusNotInitializedError, isPerArtifactDescriptor, isRetryableProviderError, isValidArkAddress, logExcludedVtxos, makeHandle, matchServerCheckpoints, migrateWalletRepository, normalizeToDescriptor, notifyExitObserved, onchainRail, openDatabase, outpointExclusion, outpointReasons, parseHDDescriptor, promisifyRequest, provisionClaimSecret, provisionRefundKey, registerWalletRestoreHook, requiresMigration, resolveAssetAmount, resolveSendAmount, rollbackMigration, sdkVersion, selectCoinsWithAsset, selectionOf, sequenceToTimelock, serializeExitPackage, setArkPsbtField, setupServiceWorker, signAndSubmitOffchainTx, timelockToSequence, toXOnly, tryResolveSendAmount, validateBatchRecipients, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures, walletFeeSource };

package/dist/index.d.ts

@@ -1,11 +1,11 @@
-import { a4 as ReadonlyIdentity, a as Identity, ar as DescriptorSigningRequest, as as Transaction, an as SignerSession, a2 as DescriptorProvider, at as IntentFeeConfig, au as OffchainInput, av as FeeAmount, aw as OnchainInput, ax as FeeOutput, B as IntentRepository, D as ArkIntent, F as IntentFilter, O as Outpoint, H as VirtualTxRepository, J as VirtualTx, K as VtxoBranch, W as WalletRepository, w as ExtendedVirtualCoin, x as VtxoRepositoryKey, E as ExtendedCoin, A as ArkTransaction, y as WalletState, v as Contract, C as ContractRepository, z as ContractFilter, I as IWallet, q as ArkProvider, al as SettlementConfig, ay as ContractWatcherConfig, az as Asset, R as Recipient, aA as FeeInfo, k as SettlementEvent, j as SettleParams, S as SendBitcoinParams, G as GetVtxosFilter, aB as CreateContractParams, aC as GetContractsFilter, u as VirtualCoin, aD as GetSpendablePathsOptions, aE as GetAllSpendingPathsOptions, g as GetNewAddressesOptions, aF as IssuanceParams, aG as ReissuanceParams, aH as BurnParams, aI as RenewVtxosOptions, c as WalletBalance, ab as ContractSyncState, ag as ContractWithVtxos, aJ as WatchedScript, aK as PathSelection, h as NewAddress, aL as ContractEvent, aM as AssetDetails, aN as IssuanceResult, aO as DelegateInfo, aP as MigrationGlobalSkipReason, aQ as MigrationLegSkipReason, aR as SignerStatus, a3 as IReadonlyWallet, d as ActivityRegistry, aa as IReadonlyAssetManager, aS as StorageConfig, e as Activity, N as NormalizedExtendedVirtualCoin, f as IContractManager, m as IAssetManager, l as SendParams, i as IDelegateManager, aT as IVtxoManager, a5 as OnchainProvider, M as Network, ad as NetworkName, ai as Coin, aU as ExplorerTransaction, ae as ArkInfo, ao as SignedIntent, ap as Intent, aV as TreeNonces, aW as TreePartialSigs, T as TxNotificationEvent, aX as PendingTx, t as TapLeafScript, aY as EncodedVtxoScript, P as CSVMultisigTapscript, s as RelativeTimelock, V as VtxoScript, aZ as Status, af as ArkAddress, a_ as ChainTx, r as IndexerProvider, X as TxTree, a$ as PathContext } from './index-Dg0-TvBQ.js';
-export { b0 as ActivityIntent, b1 as ActivityResolver, b2 as ArkIntentState, b3 as ArkTapscript, b4 as AssetMetadata, b5 as BITCOIN_EMULATOR_PUBKEY, b6 as BaseWalletConfig, $ as BatchFailedEvent, Z as BatchFinalizationEvent, _ as BatchFinalizedEvent, b7 as BatchInfo, b8 as BatchSignableIdentity, Q as BatchStartedEvent, b9 as CLTVMultisigTapscript, ba as CandidateDeps, bb as ChainTxType, L as ChainedTxType, bc as CommitmentTx, bd as ConditionCSVMultisigTapscript, be as ConditionMultisigTapscript, bf as ContractBalance, bg as ContractEventCallback, bh as ContractHandler, aj as ContractManager, ak as ContractManagerConfig, bi as ContractState, bj as ContractVtxo, bk as ContractVtxoEvent, bl as ContractWatcher, bm as DEFAULT_VTXO_PAGE_SIZE, bn as DelegateManagerImpl, bo as DelegateOptions, a6 as DelegateProvider, bp as DelegatorManagerImpl, bq as DelegatorProvider, br as DeprecatedSignerMigrationReport, bs as DeprecatedSignerReport, bt as DigestMismatchError, bu as Discoverable, bv as DiscoveredContract, bw as DiscoveryDeps, bx as ESPLORA_URL, by as EsploraProvider, bz as EventSourceCapable, bA as EventSourceFactory, bB as EventSourceLike, bC as EventSourceUnavailableError, a8 as ExitCaptureMode, bD as ExitChainResolver, a9 as ExitDataSource, bE as ExtendedContractVtxo, bF as GroupMembership, bG as HandlerError, bH as IDelegatorManager, bI as INTENT_TERMINAL_STATES, bJ as IndexerTxType, bK as IntentCoin, bL as KnownMetadata, bM as MUTINYNET_EMULATOR_PUBKEY, bN as MigrateDeprecatedSignerOptions, bO as MigrationLegReport, bP as MigrationVtxoRef, bQ as MultisigTapscript, bR as NewAddressType, bS as Nonces, bT as Output, bU as PageResponse, bV as PaginationOptions, bW as PartialSig, bX as PrevTxSource, bY as PrevTxUnavailableError, bZ as ProviderClass, b_ as REGTEST_EMULATOR_PUBKEY, b$ as RawTxSource, a7 as ReadonlyWalletConfig, n as RestArkProvider, c0 as RestDelegateProvider, c1 as RestDelegatorProvider, o as RestIndexerProvider, c2 as ScanContractsOptions, c3 as ScanResult, c4 as ScheduledSession, c5 as SettlementEventType, c6 as SignRequest, c7 as SignerClassification, c8 as SignerSet, c9 as SubscriptionEvent, ca as SubscriptionHeartbeat, p as SubscriptionResponse, cb as SweepTxNotification, cc as TapLeaves, cd as TapTreeCoder, ce as TapscriptType, aq as TimeHeight, Y as TreeNoncesEvent, a1 as TreeSignatureEvent, U as TreeSigningStartedEvent, a0 as TreeTxEvent, cf as Tx, cg as TxHistoryRecord, ch as TxKey, ci as TxNotification, cj as TxTag, ck as TxTreeNode, cl as TxType, cm as VirtualStatus, cn as Vtxo, co as VtxoChain, am as VtxoManager, cp as VtxoType, b as WalletConfig, cq as WalletMode, cr as WithPrevTx, cs as assertAllowedSighashTypes, ct as assetMintResolver, cu as attachPrevArkTxs, cv as attachPrevoutTxs, cw as boardingResolver, cx as canRecoverOnchain, cy as canSpendOffchain, cz as canSweepOnchain, cA as classifyAgainstSignerSet, cB as classifyContractSigner, cC as collabExitResolver, cD as configureEventSource, cE as createDefaultActivityRegistry, cF as createExitChainResolver, cG as decodeTapscript, cH as defaultEmulatorPubkey, cI as getConfiguredEventSource, cJ as getNetwork, cK as getRandomId, cL as getSequence, cM as hasCandidates, cN as hasTerminalSpend, cO as isBatchSignable, cP as isContractVtxoEvent, cQ as isCooperativelyMigratable, cR as isDiscoverable, cS as isEventSourceUnavailableError, cT as isExpired, cU as isPastExpiry, cV as isRecoverable, cW as isSigningIdentity, cX as isSpendable, cY as isSubdust, cZ as isTerminalIntentState, c_ as isVirtualCoin, c$ as isVtxoExpiringSoon, d0 as networks, d1 as resolveEmulatorPubkey, d2 as resolveEventSource, d3 as resolvePrevTxs, d4 as scriptFromTapLeafScript, d5 as signerSetFromInfo, d6 as toXOnlySignerHex, d7 as withPrevTxs } from './index-Dg0-TvBQ.js';
-import { W as Wallet, R as ReadonlyWallet, b as ReceiveRotatorFactory, c as ReceiveRotatorBootOpts, d as ReceiveRotatorBoot, P as ProviderConnectionState, H as HDWalletCapable, a as HDAllocationCapable, A as AddressAllocationCapable, B as BatchExpiryPolicy, e as Batch } from './hdWalletCapable-DABgAD-T.js';
-export { f as AbortError, g as ArkError, h as ArkErrorName, i as ArkadeCashClaimResult, j as ArkadeCashCreateError, k as ArkadeCashUnclaimedReason, l as ArkadeCashUnclaimedVtxo, m as BoardingUtxoGroup, C as CheckpointExitDelayPolicy, D as DEFAULT_MIN_BATCH_EXPIRY_SECONDS, n as DEFAULT_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, F as ForeignDescriptorError, I as IncomingFunds, M as MAX_USED_SIGNING_DESCRIPTORS_LOOK_AHEAD, o as MUTINYNET_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, p as ProviderKind, q as ProviderUnavailableError, r as REGTEST_MIN_BATCH_EXPIRY_SECONDS, s as REGTEST_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, S as SIGNET_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, t as ServerInfoSource, u as ServerResponseMismatchError, v as WaitForIncomingFundsOptions, w as WalletCannotAllocateAddressError, x as assertValidBatchExpiry, y as assertValidServerUnrollScript, z as defaultBatchExpiryPolicy, E as defaultCheckpointExitDelayPolicy, G as isAddressAllocationCapable, J as isArkError, K as isHDAllocationCapable, L as isHDWalletCapable, N as maybeArkError, O as resolveBatchExpiryPolicy, Q as resolveCheckpointExitDelayPolicy, T as resolveDescriptorSigner, U as selectVirtualCoins, V as signingDescriptorIndex, X as strictSigningDescriptorIndex, Y as waitForIncomingFunds } from './hdWalletCapable-DABgAD-T.js';
-import { P as Program, A as ArkadeParamValue, a as ArkadeProgramScript, b as ProgramKeys, c as ArkadeArgValue, C as CompiledProgramFunction, d as ArkadeFunction, I as InputRef, e as InputDef, f as ArkadeValueType, g as ArkadeArgType, h as ArkadeContractParams, i as ArkadeSegment, j as AsmToken, S as SUPPORTED_PROGRAM_VERSION, k as SignerRef, T as TapscriptSegment, W as WitnessRef, l as deserializeArkadeContractParams, p as parseArtifact, r as resolveAsm, s as serializeArkadeContractParams, m as stringifyArtifact, v as validateProgram, w as witnessRefToBytes } from './index-B8xrELXY.js';
-export { n as ArkadeContractHandler, B as BoardingContractHandler, o as BoardingContractParams, D as DefaultContractHandler, q as DefaultContractParams, t as DelegateContractHandler, u as DelegateContractParams, V as VHTLC, x as VHTLCContractHandler, y as VHTLCContractParams, z as VHTLCV2ContractHandler, E as VHTLCV2ContractParams, F as contractHandlers } from './index-B8xrELXY.js';
-import { D as DefaultVtxo } from './delegate-Ckz_TWzM.js';
-export { a as DelegateVtxo } from './delegate-Ckz_TWzM.js';
+import { a4 as ReadonlyIdentity, a as Identity, ar as DescriptorSigningRequest, as as Transaction, an as SignerSession, a2 as DescriptorProvider, at as IntentFeeConfig, au as OffchainInput, av as FeeAmount, aw as OnchainInput, ax as FeeOutput, B as IntentRepository, D as ArkIntent, F as IntentFilter, O as Outpoint, H as VirtualTxRepository, J as VirtualTx, K as VtxoBranch, W as WalletRepository, w as ExtendedVirtualCoin, x as VtxoRepositoryKey, E as ExtendedCoin, A as ArkTransaction, y as WalletState, v as Contract, C as ContractRepository, z as ContractFilter, I as IWallet, q as ArkProvider, al as SettlementConfig, ay as ContractWatcherConfig, az as Asset, R as Recipient, aA as FeeInfo, k as SettlementEvent, N as NormalizedExtendedVirtualCoin, j as SettleParams, S as SendBitcoinParams, G as GetVtxosFilter, aB as CreateContractParams, aC as GetContractsFilter, u as VirtualCoin, aD as GetSpendablePathsOptions, aE as GetAllSpendingPathsOptions, g as GetNewAddressesOptions, aF as IssuanceParams, aG as ReissuanceParams, aH as BurnParams, aI as RenewVtxosOptions, c as WalletBalance, ab as ContractSyncState, ag as ContractWithVtxos, aJ as WatchedScript, aK as PathSelection, h as NewAddress, aL as ContractEvent, aM as AssetDetails, aN as IssuanceResult, aO as DelegateInfo, aP as MigrationGlobalSkipReason, aQ as MigrationLegSkipReason, aR as SignerStatus, a3 as IReadonlyWallet, d as ActivityRegistry, aa as IReadonlyAssetManager, aS as StorageConfig, e as Activity, f as IContractManager, m as IAssetManager, l as SendParams, i as IDelegateManager, aT as IVtxoManager, a5 as OnchainProvider, M as Network, ad as NetworkName, ai as Coin, aU as ExplorerTransaction, ae as ArkInfo, ao as SignedIntent, ap as Intent, aV as TreeNonces, aW as TreePartialSigs, T as TxNotificationEvent, aX as PendingTx, t as TapLeafScript, aY as EncodedVtxoScript, P as CSVMultisigTapscript, s as RelativeTimelock, V as VtxoScript, aZ as Status, af as ArkAddress, a_ as ChainTx, r as IndexerProvider, X as TxTree, a$ as PathContext } from './index-TZBbMNqA.js';
+export { b0 as ActivityIntent, b1 as ActivityResolver, b2 as ArkIntentState, b3 as ArkTapscript, b4 as AssetMetadata, b5 as BITCOIN_EMULATOR_PUBKEY, b6 as BaseWalletConfig, $ as BatchFailedEvent, Z as BatchFinalizationEvent, _ as BatchFinalizedEvent, b7 as BatchInfo, b8 as BatchSignableIdentity, Q as BatchStartedEvent, b9 as CLTVMultisigTapscript, ba as CandidateDeps, bb as ChainTxType, L as ChainedTxType, bc as CommitmentTx, bd as ConditionCSVMultisigTapscript, be as ConditionMultisigTapscript, bf as ContractBalance, bg as ContractEventCallback, bh as ContractHandler, aj as ContractManager, ak as ContractManagerConfig, bi as ContractState, bj as ContractVtxo, bk as ContractVtxoEvent, bl as ContractWatcher, bm as DEFAULT_VTXO_PAGE_SIZE, bn as DelegateManagerImpl, bo as DelegateOptions, a6 as DelegateProvider, bp as DelegatorManagerImpl, bq as DelegatorProvider, br as DeprecatedSignerMigrationReport, bs as DeprecatedSignerReport, bt as DigestMismatchError, bu as Discoverable, bv as DiscoveredContract, bw as DiscoveryDeps, bx as ESPLORA_URL, by as EsploraProvider, bz as EventSourceCapable, bA as EventSourceFactory, bB as EventSourceLike, bC as EventSourceUnavailableError, a8 as ExitCaptureMode, bD as ExitChainResolver, a9 as ExitDataSource, bE as ExtendedContractVtxo, bF as GroupMembership, bG as HandlerError, bH as IDelegatorManager, bI as INTENT_TERMINAL_STATES, bJ as IndexerTxType, bK as IntentCoin, bL as KnownMetadata, bM as MUTINYNET_EMULATOR_PUBKEY, bN as MigrateDeprecatedSignerOptions, bO as MigrationLegReport, bP as MigrationVtxoRef, bQ as MultisigTapscript, bR as NewAddressType, bS as Nonces, bT as Output, bU as PageResponse, bV as PaginationOptions, bW as PartialSig, bX as PrevTxSource, bY as PrevTxUnavailableError, bZ as ProviderClass, b_ as REGTEST_EMULATOR_PUBKEY, b$ as RawTxSource, a7 as ReadonlyWalletConfig, n as RestArkProvider, c0 as RestDelegateProvider, c1 as RestDelegatorProvider, o as RestIndexerProvider, c2 as ScanContractsOptions, c3 as ScanResult, c4 as ScheduledSession, c5 as SettlementEventType, c6 as SignRequest, c7 as SignerClassification, c8 as SignerSet, c9 as SubscriptionEvent, ca as SubscriptionHeartbeat, p as SubscriptionResponse, cb as SweepTxNotification, cc as TapLeaves, cd as TapTreeCoder, ce as TapscriptType, aq as TimeHeight, Y as TreeNoncesEvent, a1 as TreeSignatureEvent, U as TreeSigningStartedEvent, a0 as TreeTxEvent, cf as Tx, cg as TxHistoryRecord, ch as TxKey, ci as TxNotification, cj as TxTag, ck as TxTreeNode, cl as TxType, cm as VirtualStatus, cn as Vtxo, co as VtxoChain, am as VtxoManager, cp as VtxoType, b as WalletConfig, cq as WalletMode, cr as WithPrevTx, cs as assertAllowedSighashTypes, ct as assetMintResolver, cu as attachPrevArkTxs, cv as attachPrevoutTxs, cw as boardingResolver, cx as canRecoverOnchain, cy as canSpendOffchain, cz as canSweepOnchain, cA as classifyAgainstSignerSet, cB as classifyContractSigner, cC as collabExitResolver, cD as configureEventSource, cE as createDefaultActivityRegistry, cF as createExitChainResolver, cG as decodeTapscript, cH as defaultEmulatorPubkey, cI as getConfiguredEventSource, cJ as getNetwork, cK as getRandomId, cL as getSequence, cM as hasCandidates, cN as hasTerminalSpend, cO as isBatchSignable, cP as isContractVtxoEvent, cQ as isCooperativelyMigratable, cR as isDiscoverable, cS as isEventSourceUnavailableError, cT as isExpired, cU as isPastExpiry, cV as isRecoverable, cW as isSigningIdentity, cX as isSpendable, cY as isSubdust, cZ as isTerminalIntentState, c_ as isVirtualCoin, c$ as isVtxoExpiringSoon, d0 as networks, d1 as resolveEmulatorPubkey, d2 as resolveEventSource, d3 as resolvePrevTxs, d4 as scriptFromTapLeafScript, d5 as signerSetFromInfo, d6 as toXOnlySignerHex, d7 as withPrevTxs } from './index-TZBbMNqA.js';
+import { W as Wallet, R as ReadonlyWallet, b as ReceiveRotatorFactory, c as ReceiveRotatorBootOpts, d as ReceiveRotatorBoot, P as ProviderConnectionState, H as HDWalletCapable, a as HDAllocationCapable, A as AddressAllocationCapable, B as BatchExpiryPolicy, e as Batch } from './hdWalletCapable-DHCNbAgl.js';
+export { f as AbortError, g as ArkError, h as ArkErrorName, i as ArkadeCashClaimResult, j as ArkadeCashCreateError, k as ArkadeCashUnclaimedReason, l as ArkadeCashUnclaimedVtxo, m as BoardingUtxoGroup, C as CheckpointExitDelayPolicy, D as DEFAULT_MIN_BATCH_EXPIRY_SECONDS, n as DEFAULT_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, F as ForeignDescriptorError, I as IncomingFunds, M as MAX_USED_SIGNING_DESCRIPTORS_LOOK_AHEAD, o as MUTINYNET_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, p as ProviderKind, q as ProviderUnavailableError, r as REGTEST_MIN_BATCH_EXPIRY_SECONDS, s as REGTEST_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, S as SIGNET_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, t as ServerInfoSource, u as ServerResponseMismatchError, v as WaitForIncomingFundsOptions, w as WalletCannotAllocateAddressError, x as assertValidBatchExpiry, y as assertValidServerUnrollScript, z as defaultBatchExpiryPolicy, E as defaultCheckpointExitDelayPolicy, G as isAddressAllocationCapable, J as isArkError, K as isHDAllocationCapable, L as isHDWalletCapable, N as maybeArkError, O as resolveBatchExpiryPolicy, Q as resolveCheckpointExitDelayPolicy, T as resolveDescriptorSigner, U as selectVirtualCoins, V as signingDescriptorIndex, X as strictSigningDescriptorIndex, Y as waitForIncomingFunds } from './hdWalletCapable-DHCNbAgl.js';
+import { P as Program, A as ArkadeParamValue, a as ArkadeProgramScript, b as ProgramKeys, c as ArkadeArgValue, C as CompiledProgramFunction, d as ArkadeFunction, I as InputRef, e as InputDef, f as ArkadeValueType, g as ArkadeArgType, h as ArkadeContractParams, i as ArkadeSegment, j as AsmToken, S as SUPPORTED_PROGRAM_VERSION, k as SignerRef, T as TapscriptSegment, W as WitnessRef, l as deserializeArkadeContractParams, p as parseArtifact, r as resolveAsm, s as serializeArkadeContractParams, m as stringifyArtifact, v as validateProgram, w as witnessRefToBytes } from './index-vUeTpifq.js';
+export { n as ArkadeContractHandler, B as BoardingContractHandler, o as BoardingContractParams, D as DefaultContractHandler, q as DefaultContractParams, t as DelegateContractHandler, u as DelegateContractParams, V as VHTLC, x as VHTLCContractHandler, y as VHTLCContractParams, z as VHTLCV2ContractHandler, E as VHTLCV2ContractParams, F as contractHandlers } from './index-vUeTpifq.js';
+import { D as DefaultVtxo } from './delegate-D_sW61rj.js';
+export { a as DelegateVtxo } from './delegate-D_sW61rj.js';
 import { Bytes, BTC_NETWORK } from '@scure/btc-signer/utils.js';
 import { P2TR } from '@scure/btc-signer/payment.js';
 import { Transaction as Transaction$1, OP, Script, ScriptType } from '@scure/btc-signer';
@@ -2238,6 +2238,13 @@ declare class DustChangeError extends Error {
     readonly dustAmount: bigint;
     constructor(change: bigint, dustAmount: bigint);
 }
+/** Thrown when a collaborative exit's change VTXO is above the server's
+ *  per-output ceiling, which arkd answers with `AMOUNT_TOO_HIGH`. */
+declare class OversizedChangeError extends Error {
+    readonly change: bigint;
+    readonly maxAmount: bigint;
+    constructor(change: bigint, maxAmount: bigint);
+}
 /**
  * Ramps is a class wrapping `settle` method to provide a more convenient interface for onboarding and offboarding operations.
  *
@@ -2287,6 +2294,10 @@ declare class Ramps {
      * @param feeInfo - The fee info to deduct from the offboard amount.
      * @param amount - The amount to offboard. If not provided, the total amount of virtual outputs will be offboarded.
      * @param eventCallback - Optional callback that receives settlement events
+     * @param vtxos - Specific virtual outputs to spend, mirroring {@link onboard}'s
+     * `boardingUtxos`. Omitted, every spendable one is spent — merging the whole
+     * off-chain balance into a single change output. Taken as given like
+     * `settle({ inputs })`: an `amount` these cannot cover is an error, not a top-up.
      * @returns The Arkade transaction id created by settlement
      * @throws Error if no virtual outputs remain after fee deduction or the destination address cannot be decoded
      * @see IWallet.getSpendableVtxos
@@ -2298,7 +2309,24 @@ declare class Ramps {
      * await ramps.offboard('bc1q...', feeInfo);
      * ```
      */
-    offboard(destinationAddress: string, feeInfo: FeeInfo, amount?: bigint, eventCallback?: (event: SettlementEvent) => void): ReturnType<IWallet["settle"]>;
+    offboard(destinationAddress: string, feeInfo: FeeInfo, amount?: bigint, eventCallback?: (event: SettlementEvent) => void, vtxos?: NormalizedExtendedVirtualCoin[]): ReturnType<IWallet["settle"]>;
+    /**
+     * Collaboratively exit with the DESTINATION paid exactly `amount`, pricing the
+     * fee on that output rather than on a grossed-up figure. {@link offboard} keeps
+     * the other anchor, which needs `g - fee(g) = amount` solved — impossible for
+     * a program charging the whole output.
+     */
+    offboardExact(params: {
+        destinationAddress: string;
+        feeInfo: FeeInfo;
+        /** Sats the destination receives, exactly. */
+        amount: bigint;
+        eventCallback?: (event: SettlementEvent) => void;
+        vtxos?: NormalizedExtendedVirtualCoin[];
+    }): ReturnType<IWallet["settle"]>;
+    /** Fund the change output: pay its own fee, then judge it against both
+     *  server-side bounds. `0n` in is `0n` out — no change output at all. */
+    private fundChange;
 }
 
 /**
@@ -2647,26 +2675,26 @@ type ResponseGetContractsWithVtxos = ResponseEnvelope & {
 type RequestWatchScript = RequestEnvelope & {
     type: "WATCH_SCRIPT";
     payload: {
-        script: string;
+        script: string | string[];
         label?: string;
     };
 };
 type ResponseWatchScript = ResponseEnvelope & {
     type: "SCRIPT_WATCHED";
     payload: {
-        script: string;
+        script: string | string[];
     };
 };
 type RequestUnwatchScript = RequestEnvelope & {
     type: "UNWATCH_SCRIPT";
     payload: {
-        script: string;
+        script: string | string[];
     };
 };
 type ResponseUnwatchScript = ResponseEnvelope & {
     type: "SCRIPT_UNWATCHED";
     payload: {
-        script: string;
+        script: string | string[];
     };
 };
 type RequestGetWatchedScripts = RequestEnvelope & {
@@ -5276,7 +5304,7 @@ declare class Extension {
 /**
  * Arkade Script Opcodes
  *
- * This module defines ONLY Arkade-specific opcodes (0xb3, 0xc3-0xf6).
+ * This module defines ONLY Arkade-specific opcodes (0xb3, 0xc3-0xf8).
  * Standard Bitcoin opcodes are imported from @scure/btc-signer.
  *
  * Reference: arkade-os/emulator v0.0.4 pkg/arkade/opcode.go
@@ -5307,6 +5335,8 @@ declare const ARKADE_OP: {
     readonly BIN2NUM: 216;
     readonly REVERSEBYTES: 217;
     readonly MODEXP: 218;
+    readonly PUSHEXPIRY: 219;
+    readonly CHECKTIME: 220;
     readonly ECADD: 224;
     readonly ECMUL: 225;
     readonly ECPAIRING: 226;
@@ -5330,6 +5360,8 @@ declare const ARKADE_OP: {
     readonly INSPECTPACKET: 244;
     readonly INSPECTINPUTPACKET: 245;
     readonly SIGHASH: 246;
+    readonly TUNNEL: 247;
+    readonly INSPECTINTENTMESSAGE: 248;
 };
 declare const ARKADE_OPCODES: number[];
 declare const ARKADE_OPCODE_NAMES: Record<number, string>;
@@ -5401,6 +5433,8 @@ declare const ARKADE_OPS: {
     readonly BIN2NUM: 216;
     readonly REVERSEBYTES: 217;
     readonly MODEXP: 218;
+    readonly PUSHEXPIRY: 219;
+    readonly CHECKTIME: 220;
     readonly ECADD: 224;
     readonly ECMUL: 225;
     readonly ECPAIRING: 226;
@@ -5424,6 +5458,8 @@ declare const ARKADE_OPS: {
     readonly INSPECTPACKET: 244;
     readonly INSPECTINPUTPACKET: 245;
     readonly SIGHASH: 246;
+    readonly TUNNEL: 247;
+    readonly INSPECTINTENTMESSAGE: 248;
     readonly OP_0: number;
     readonly PUSHDATA1: number;
     readonly PUSHDATA2: number;
@@ -5813,7 +5849,10 @@ interface ArkadeConnectOptions {
     indexer?: Pick<IndexerProvider, "getVtxos" | "getVirtualTxs">;
     /** Signer for paths that require a user signature; optional for watch-only. */
     identity?: Identity;
-    /** Network for address derivation; defaults to the SDK default. */
+    /**
+     * Network for address derivation. Defaults to the network the server
+     * reports on `getInfo` — or the SDK default when the server names none.
+     */
     network?: Network;
     /**
      * Co-sign with this emulator key (33-byte compressed hex) instead of the
@@ -6168,9 +6207,10 @@ interface PaymentHandle {
  *
  * `fee` is a pre-send estimate wherever the true cost is only fixed later: the
  * swap rails quote from Boltz's advertised pricing and are superseded by the
- * amount Boltz returns at swap creation, and the collaborative exit does not
- * include the per-input intent fees, which depend on the VTXO selection made at
- * settlement. Treat it as a display and ranking figure, not a guarantee.
+ * amount Boltz returns at swap creation, and the collaborative exit omits the
+ * per-input intent fees whenever the request left the VTXO selection to
+ * settlement — naming {@link PaymentRequest.selectedVtxos} fixes them, and they
+ * are priced in. Treat it as a display and ranking figure, not a guarantee.
  */
 interface RouteQuote {
     railId: string;
@@ -6243,6 +6283,17 @@ interface PaymentRequest {
      *  Additive: an asset transfer also moves sats, so a 500 USDX request
      *  legitimately has both. A rail that cannot deliver assets must REFUSE. */
     assets?: Asset[];
+    /**
+     * Spend exactly these virtual outputs, with the meaning
+     * {@link SendParams.selectedVtxos} already gives it: taken as given, so a
+     * shortfall is an error rather than a top-up, and ungated like
+     * `settle({ inputs })`. Normalized, i.e. what `getSpendableVtxos()` returns.
+     *
+     * Only the rails spending the wallet's own coins can honour it (`ark`,
+     * `ark-asset`, `onchain`). A rail funding its payment through a counterparty
+     * picks its own inputs, so it must REFUSE rather than ignore the selection.
+     */
+    selectedVtxos?: NormalizedExtendedVirtualCoin[];
 }
 /** A payment rail — registered by id, mirrors the ActivityRegistry resolver shape. */
 interface PaymentRail {
@@ -6275,10 +6326,11 @@ declare const isLightningInvoice: (raw: string) => boolean;
 /**
  * True for an LNURL or a Lightning address (`user@host`).
  *
- * TODO(lnurl): no rail consumes this yet — LNURL / Lightning-address routing is
- * planned future work. The predicate is exported ahead of the rail so consumers
- * can classify these targets today; until the rail lands, `route()` throws
- * "no rail for" on them. Keep the export (do not flag as unused).
+ * No rail here consumes it, and that is the layering rather than a gap:
+ * routing an LNURL needs an LNURL client, so the rails ship from
+ * `@arkade-os/lnurl-client/arkade` (`lnurlRails`) and are registered by the
+ * app, as the solver rails from `@arkade-os/swap` are. With none registered,
+ * `route()` throws "no rail for" on these targets.
  */
 declare const isLnurl: (raw: string) => boolean;
 /** True for a bech32 (segwit) or base58 (legacy) Bitcoin address, any network —
@@ -6315,6 +6367,11 @@ declare function assetsOf(req: PaymentRequest): Asset[];
 /** For a BTC-only rail: refusing is what leaves the router free to rank an
  *  asset-capable one, instead of paying the carrier and dropping the asset. */
 declare function assertNoAssets(railId: string, req: PaymentRequest): void;
+/** The inputs a request names. An EMPTY array is still a selection, covering nothing. */
+declare function selectionOf(req: PaymentRequest): NormalizedExtendedVirtualCoin[] | undefined;
+/** For a rail whose counterparty funds the spend: ignoring a named input set
+ *  would spend coins the caller had promised elsewhere, so refuse instead. */
+declare function assertNoSelection(railId: string, req: PaymentRequest): void;
 /** Exactly one: `Wallet.send` takes a list because one output can carry
  *  several, but a routed PAYMENT is one thing being paid. */
 declare function resolveAssetAmount(railId: string, req: PaymentRequest): Asset;
@@ -6393,12 +6450,15 @@ declare const walletFeeSource: (wallet: Wallet) => () => Promise<FeeInfo>;
  * and offboards VTXOs to the address via {@link Ramps.offboard}, which owns
  * fee-aware coin selection, dust-safe change, and settlement.
  *
- * `offboard` deducts its fee from the amount it is handed, so the rail grosses
- * the amount up first: the recipient receives exactly `quote.amount`, matching
- * the receiver-exact semantics of every other rail (see {@link RouteQuote}).
- * `quote.total` is the offboard amount; the per-input intent fees `offboard`
- * shaves off the selected VTXOs are additional and depend on the selection, so
- * they are not part of the quote.
+ * The exit fee is priced on the DESTINATION output — the one arkd charges for —
+ * and met from the balance, so the recipient receives exactly `quote.amount`
+ * (see {@link RouteQuote}). {@link Ramps.offboardExact} carries that; the
+ * gross-up this rail used to do could only approximate it.
+ *
+ * A request naming `selectedVtxos` offboards exactly those — so the exit need not
+ * sweep the whole off-chain balance into one change output — and only then does
+ * the quote carry the per-input intent fees: unselected, the coins are chosen
+ * later at settlement and there is nothing here to price.
  *
  * An explicit amount is mandatory. To sweep the full balance, call
  * `Ramps.offboard(address, feeInfo)` directly — the router has no amountless path.
@@ -6709,4 +6769,4 @@ declare class AssetManager extends ReadonlyAssetManager implements IAssetManager
     burn(params: BurnParams): Promise<string>;
 }
 
-export { ARKADE_MAGIC, ARKADE_SALTED_PREIMAGE_TAG, ARKADE_SWAP_PREIMAGE_TAG, ASSET_CARRIER_SATS, Activity, ActivityRegistry, AddressAllocationCapable, AmbiguousRouteError, type AnchorBumper, ArkAddress, ArkInfo, ArkIntent, ArkNote, ArkProvider, type ArkPsbtFieldCoder, ArkPsbtFieldKey, ArkPsbtFieldKeyType, ArkTransaction, type ArkTxInput, type ArkadeBatchInput, ArkadeCash, ArkadeContractParams, type ArkadeExtendedCoin, type ArkadeExtendedVirtualCoin, Asset, AssetDetails, AssetManager, BIP21, BIP21Error, type BIP21Params, type BIP21ParseResult, BIP322, BLOCKED_UPGRADE_TIMEOUT_MS, Batch, BatchExpiryPolicy, BurnParams, CSVMultisigTapscript, CachingArkProvider, ChainTx, Coin, ConditionWitness, ConnectionDisposedError, type ConnectorTreeNode, Contract, ContractEvent, ContractRepository, ContractRepositoryImpl, ContractSyncState, ContractWatcherConfig, ContractWithVtxos, CosignerPublicKey, CreateContractParams, DEFAULT_MESSAGE_TIMEOUTS, DatabaseUpgradeBlockedError, DefaultVtxo, DelegateInfo, DelegateNotConfiguredError, DelegatorNotConfiguredError, DescriptorIdentity, type DescriptorIdentityOptions, type DescriptorOptions, type DescriptorSigner, DescriptorSigningProviderMissingError, type DeterministicSigner, DustChangeError, ELECTRUM_TCP_HOST, ELECTRUM_WS_URL, type BlockHeader as ElectrumBlockHeader, ElectrumOnchainProvider, type TransactionHistory as ElectrumTransactionHistory, type Unspent as ElectrumUnspent, type EmulatorEntry, type EmulatorInfo, EmulatorPacket, type EmulatorProvider, EncodedVtxoScript, Estimator, type ExcludableVtxo, type ExecutorEvent, type ExecutorOptions, type ExitDelay, type ExitFeeWallet, type ExitMode, type ExitOptions, type ExitPackage, type ExitQuote, type ExitStep, type ExitTotals, type ExitVtxoInfo, ExplorerTransaction, ExtendedCoin, ExtendedVirtualCoin, Extension, ExtensionNotFoundError, type ExtensionPacket, FeeAmount, FeeInfo, FeeOutput, FetchError, GetNewAddressesOptions, GetVtxosFilter, HDAllocationCapable, HDDescriptorProvider, type HDDeterministicSignCapable, HDWalletCapable, IAssetManager, IContractManager, IDelegateManager, IReadonlyAssetManager, IReadonlyWallet, IVtxoManager, IWallet, Identity, InMemoryContractRepository, InMemoryIntentRepository, InMemoryVirtualTxRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBIntentRepository, IndexedDBVirtualTxRepository, IndexedDBWalletRepository, IndexerProvider, Intent, IntentFeeConfig, IntentFilter, IntentRepository, IssuanceParams, IssuanceResult, MESSAGE_BUS_INITIALIZING, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, type ManagedConnection, MessageBus, MessageBusInitializingError, MessageBusNotInitializedError, type MessageHandler, type MessageTimeouts, MigrationGlobalSkipReason, MigrationLegSkipReason, type MigrationStatus, MissingSigningDescriptorError, MnemonicIdentity, type MnemonicOptions, Network, NetworkName, type NetworkOptions, NewAddress, OffchainInput, type OffchainTx, type OnExitObserved, OnchainInput, OnchainProvider, OnchainWallet, Outpoint, P2A, type ParsedArkContract, PathContext, PathSelection, type PaymentHandle, type PaymentOption, type PaymentRail, type PaymentRequest, PaymentRouter, type PaymentStatus, PrevArkTxField, PrevoutTxField, ProviderConnectionState, type ProvisionedClaimSecret, type ProvisionedKey, READ_TIMEOUT_MS, Ramps, ReadonlyAssetManager, ReadonlyDescriptorIdentity, ReadonlyIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, Recipient, ReissuanceParams, RelativeTimelock, RenewVtxosOptions, type RequestEnvelope, type ResponseEnvelope, RestEmulatorProvider, type RouteQuote, type RouteResult, type RouterContext, type RouterPreferences, SeedIdentity, type SeedIdentityOptions, SendBitcoinParams, SendParams, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, type ServiceWorkerWalletMode, SettleParams, SettlementConfig, SettlementEvent, SignedIntent, SignerSession, SignerStatus, SingleKey, Status, StorageConfig, TapLeafScript, Transaction, TreeNonces, TreePartialSigs, TxNotificationEvent, TxTree, TxWeightEstimator, UnannotatableInputError, UnilateralExit, UnknownPacket, Unroll, type VSize, type VerifyServerSignatures, VirtualCoin, VirtualTx, VirtualTxRepository, VtxoBranch, type VtxoExclusion, VtxoScript, VtxoTaprootTree, VtxoTreeExpiry, Wallet, WalletBalance, WalletCannotSignError, WalletMessageHandler, WalletNotInitializedError, WalletRepository, WalletRepositoryImpl, type WalletRestoreHook, WatchedScript, WsElectrumChainSource, adoptContractDescriptor, arkAssetRail, arkRail, arkTarget, index as arkade, assembleBtcdTaprootTree, assertFinalCommitmentMatchesValidated, assertNoAssets, assertSendableAmount, assertSubmittedArkTxid, index$1 as asset, assetsOf, awaitTransaction, btcTarget, buildForfeitTx, buildOffchainTx, buildPreimageMessage, buildSaltedPreimageMessage, buildVersion, claimWithPreimageIdentity, closeDatabase, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, contractPreimage, contractSigner, createAssetPacket, createDefaultPaymentRouter, createManagedConnection, decodeArkContract, deleteByIndex, deriveDescriptorLeafCompressedPubKey, deriveDescriptorLeafPubKey, deserializeExitPackage, encodeArkContract, exitObserverFor, gateExclusion, gatedContracts, getAllByIndexValues, getArkPsbtFields, getMigrationStatus, hasBoardingTxExpired, identityDescriptor, invoiceTarget, isArkContract, isBtcAddress, isCltvSatisfied, isContractGenericallySpendable, isCsvSpendable, isDeterministicSigner, isHDDeterministicSignCapable, isLightningInvoice, isLnurl, isMessageBusInitializingError, isMessageBusNotInitializedError, isPerArtifactDescriptor, isRetryableProviderError, isValidArkAddress, logExcludedVtxos, makeHandle, matchServerCheckpoints, migrateWalletRepository, normalizeToDescriptor, notifyExitObserved, onchainRail, openDatabase, outpointExclusion, outpointReasons, parseHDDescriptor, promisifyRequest, provisionClaimSecret, provisionRefundKey, registerWalletRestoreHook, requiresMigration, resolveAssetAmount, resolveSendAmount, rollbackMigration, sdkVersion, selectCoinsWithAsset, sequenceToTimelock, serializeExitPackage, setArkPsbtField, setupServiceWorker, signAndSubmitOffchainTx, timelockToSequence, toXOnly, tryResolveSendAmount, validateBatchRecipients, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures, walletFeeSource };
+export { ARKADE_MAGIC, ARKADE_SALTED_PREIMAGE_TAG, ARKADE_SWAP_PREIMAGE_TAG, ASSET_CARRIER_SATS, Activity, ActivityRegistry, AddressAllocationCapable, AmbiguousRouteError, type AnchorBumper, ArkAddress, ArkInfo, ArkIntent, ArkNote, ArkProvider, type ArkPsbtFieldCoder, ArkPsbtFieldKey, ArkPsbtFieldKeyType, ArkTransaction, type ArkTxInput, type ArkadeBatchInput, ArkadeCash, ArkadeContractParams, type ArkadeExtendedCoin, type ArkadeExtendedVirtualCoin, Asset, AssetDetails, AssetManager, BIP21, BIP21Error, type BIP21Params, type BIP21ParseResult, BIP322, BLOCKED_UPGRADE_TIMEOUT_MS, Batch, BatchExpiryPolicy, BurnParams, CSVMultisigTapscript, CachingArkProvider, ChainTx, Coin, ConditionWitness, ConnectionDisposedError, type ConnectorTreeNode, Contract, ContractEvent, ContractRepository, ContractRepositoryImpl, ContractSyncState, ContractWatcherConfig, ContractWithVtxos, CosignerPublicKey, CreateContractParams, DEFAULT_MESSAGE_TIMEOUTS, DatabaseUpgradeBlockedError, DefaultVtxo, DelegateInfo, DelegateNotConfiguredError, DelegatorNotConfiguredError, DescriptorIdentity, type DescriptorIdentityOptions, type DescriptorOptions, type DescriptorSigner, DescriptorSigningProviderMissingError, type DeterministicSigner, DustChangeError, ELECTRUM_TCP_HOST, ELECTRUM_WS_URL, type BlockHeader as ElectrumBlockHeader, ElectrumOnchainProvider, type TransactionHistory as ElectrumTransactionHistory, type Unspent as ElectrumUnspent, type EmulatorEntry, type EmulatorInfo, EmulatorPacket, type EmulatorProvider, EncodedVtxoScript, Estimator, type ExcludableVtxo, type ExecutorEvent, type ExecutorOptions, type ExitDelay, type ExitFeeWallet, type ExitMode, type ExitOptions, type ExitPackage, type ExitQuote, type ExitStep, type ExitTotals, type ExitVtxoInfo, ExplorerTransaction, ExtendedCoin, ExtendedVirtualCoin, Extension, ExtensionNotFoundError, type ExtensionPacket, FeeAmount, FeeInfo, FeeOutput, FetchError, GetNewAddressesOptions, GetVtxosFilter, HDAllocationCapable, HDDescriptorProvider, type HDDeterministicSignCapable, HDWalletCapable, IAssetManager, IContractManager, IDelegateManager, IReadonlyAssetManager, IReadonlyWallet, IVtxoManager, IWallet, Identity, InMemoryContractRepository, InMemoryIntentRepository, InMemoryVirtualTxRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBIntentRepository, IndexedDBVirtualTxRepository, IndexedDBWalletRepository, IndexerProvider, Intent, IntentFeeConfig, IntentFilter, IntentRepository, IssuanceParams, IssuanceResult, MESSAGE_BUS_INITIALIZING, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, type ManagedConnection, MessageBus, MessageBusInitializingError, MessageBusNotInitializedError, type MessageHandler, type MessageTimeouts, MigrationGlobalSkipReason, MigrationLegSkipReason, type MigrationStatus, MissingSigningDescriptorError, MnemonicIdentity, type MnemonicOptions, Network, NetworkName, type NetworkOptions, NewAddress, NormalizedExtendedVirtualCoin, OffchainInput, type OffchainTx, type OnExitObserved, OnchainInput, OnchainProvider, OnchainWallet, Outpoint, OversizedChangeError, P2A, type ParsedArkContract, PathContext, PathSelection, type PaymentHandle, type PaymentOption, type PaymentRail, type PaymentRequest, PaymentRouter, type PaymentStatus, PrevArkTxField, PrevoutTxField, ProviderConnectionState, type ProvisionedClaimSecret, type ProvisionedKey, READ_TIMEOUT_MS, Ramps, ReadonlyAssetManager, ReadonlyDescriptorIdentity, ReadonlyIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, Recipient, ReissuanceParams, RelativeTimelock, RenewVtxosOptions, type RequestEnvelope, type ResponseEnvelope, RestEmulatorProvider, type RouteQuote, type RouteResult, type RouterContext, type RouterPreferences, SeedIdentity, type SeedIdentityOptions, SendBitcoinParams, SendParams, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, type ServiceWorkerWalletMode, SettleParams, SettlementConfig, SettlementEvent, SignedIntent, SignerSession, SignerStatus, SingleKey, Status, StorageConfig, TapLeafScript, Transaction, TreeNonces, TreePartialSigs, TxNotificationEvent, TxTree, TxWeightEstimator, UnannotatableInputError, UnilateralExit, UnknownPacket, Unroll, type VSize, type VerifyServerSignatures, VirtualCoin, VirtualTx, VirtualTxRepository, VtxoBranch, type VtxoExclusion, VtxoScript, VtxoTaprootTree, VtxoTreeExpiry, Wallet, WalletBalance, WalletCannotSignError, WalletMessageHandler, WalletNotInitializedError, WalletRepository, WalletRepositoryImpl, type WalletRestoreHook, WatchedScript, WsElectrumChainSource, adoptContractDescriptor, arkAssetRail, arkRail, arkTarget, index as arkade, assembleBtcdTaprootTree, assertFinalCommitmentMatchesValidated, assertNoAssets, assertNoSelection, assertSendableAmount, assertSubmittedArkTxid, index$1 as asset, assetsOf, awaitTransaction, btcTarget, buildForfeitTx, buildOffchainTx, buildPreimageMessage, buildSaltedPreimageMessage, buildVersion, claimWithPreimageIdentity, closeDatabase, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, contractPreimage, contractSigner, createAssetPacket, createDefaultPaymentRouter, createManagedConnection, decodeArkContract, deleteByIndex, deriveDescriptorLeafCompressedPubKey, deriveDescriptorLeafPubKey, deserializeExitPackage, encodeArkContract, exitObserverFor, gateExclusion, gatedContracts, getAllByIndexValues, getArkPsbtFields, getMigrationStatus, hasBoardingTxExpired, identityDescriptor, invoiceTarget, isArkContract, isBtcAddress, isCltvSatisfied, isContractGenericallySpendable, isCsvSpendable, isDeterministicSigner, isHDDeterministicSignCapable, isLightningInvoice, isLnurl, isMessageBusInitializingError, isMessageBusNotInitializedError, isPerArtifactDescriptor, isRetryableProviderError, isValidArkAddress, logExcludedVtxos, makeHandle, matchServerCheckpoints, migrateWalletRepository, normalizeToDescriptor, notifyExitObserved, onchainRail, openDatabase, outpointExclusion, outpointReasons, parseHDDescriptor, promisifyRequest, provisionClaimSecret, provisionRefundKey, registerWalletRestoreHook, requiresMigration, resolveAssetAmount, resolveSendAmount, rollbackMigration, sdkVersion, selectCoinsWithAsset, selectionOf, sequenceToTimelock, serializeExitPackage, setArkPsbtField, setupServiceWorker, signAndSubmitOffchainTx, timelockToSequence, toXOnly, tryResolveSendAmount, validateBatchRecipients, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures, walletFeeSource };