@arkade-os/sdk 0.4.61 → 0.4.62

package/dist/contracts/handlers/index.cjs

@@ -1,38 +1,38 @@
 'use strict';
 
-var chunkSF5NKAUA_cjs = require('../../chunk-SF5NKAUA.cjs');
-require('../../chunk-FNCQJLR2.cjs');
+var chunkG53HASDV_cjs = require('../../chunk-G53HASDV.cjs');
+require('../../chunk-OH2XLTXE.cjs');
 require('../../chunk-5BLDMQED.cjs');
 
 
 
 Object.defineProperty(exports, "ArkadeContractHandler", {
   enumerable: true,
-  get: function () { return chunkSF5NKAUA_cjs.ArkadeContractHandler; }
+  get: function () { return chunkG53HASDV_cjs.ArkadeContractHandler; }
 });
 Object.defineProperty(exports, "BoardingContractHandler", {
   enumerable: true,
-  get: function () { return chunkSF5NKAUA_cjs.BoardingContractHandler; }
+  get: function () { return chunkG53HASDV_cjs.BoardingContractHandler; }
 });
 Object.defineProperty(exports, "DefaultContractHandler", {
   enumerable: true,
-  get: function () { return chunkSF5NKAUA_cjs.DefaultContractHandler; }
+  get: function () { return chunkG53HASDV_cjs.DefaultContractHandler; }
 });
 Object.defineProperty(exports, "DelegateContractHandler", {
   enumerable: true,
-  get: function () { return chunkSF5NKAUA_cjs.DelegateContractHandler; }
+  get: function () { return chunkG53HASDV_cjs.DelegateContractHandler; }
 });
 Object.defineProperty(exports, "VHTLCContractHandler", {
   enumerable: true,
-  get: function () { return chunkSF5NKAUA_cjs.VHTLCContractHandler; }
+  get: function () { return chunkG53HASDV_cjs.VHTLCContractHandler; }
 });
 Object.defineProperty(exports, "VHTLCV2ContractHandler", {
   enumerable: true,
-  get: function () { return chunkSF5NKAUA_cjs.VHTLCV2ContractHandler; }
+  get: function () { return chunkG53HASDV_cjs.VHTLCV2ContractHandler; }
 });
 Object.defineProperty(exports, "contractHandlers", {
   enumerable: true,
-  get: function () { return chunkSF5NKAUA_cjs.contractHandlers; }
+  get: function () { return chunkG53HASDV_cjs.contractHandlers; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/contracts/handlers/index.d.cts

@@ -1,7 +1,7 @@
-export { n as ArkadeContractHandler, B as BoardingContractHandler, o as BoardingContractParams, D as DefaultContractHandler, q as DefaultContractParams, t as DelegateContractHandler, u as DelegateContractParams, x as VHTLCContractHandler, y as VHTLCContractParams, z as VHTLCV2ContractHandler, E as VHTLCV2ContractParams, F as contractHandlers } from '../../index-Butfkm-K.cjs';
-import '../../index-BcRCHnzN.cjs';
+export { n as ArkadeContractHandler, B as BoardingContractHandler, o as BoardingContractParams, D as DefaultContractHandler, q as DefaultContractParams, t as DelegateContractHandler, u as DelegateContractParams, x as VHTLCContractHandler, y as VHTLCContractParams, z as VHTLCV2ContractHandler, E as VHTLCV2ContractParams, F as contractHandlers } from '../../index-Cz5_WaQP.cjs';
+import '../../index-CwBr7qzV.cjs';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer';
 import '@scure/btc-signer/psbt.js';
-import '../../delegate-C4Rl6h9l.cjs';
+import '../../delegate-CC1gcvuC.cjs';

package/dist/contracts/handlers/index.d.ts

@@ -1,7 +1,7 @@
-export { n as ArkadeContractHandler, B as BoardingContractHandler, o as BoardingContractParams, D as DefaultContractHandler, q as DefaultContractParams, t as DelegateContractHandler, u as DelegateContractParams, x as VHTLCContractHandler, y as VHTLCContractParams, z as VHTLCV2ContractHandler, E as VHTLCV2ContractParams, F as contractHandlers } from '../../index-C29VNcxC.js';
-import '../../index-BcRCHnzN.js';
+export { n as ArkadeContractHandler, B as BoardingContractHandler, o as BoardingContractParams, D as DefaultContractHandler, q as DefaultContractParams, t as DelegateContractHandler, u as DelegateContractParams, x as VHTLCContractHandler, y as VHTLCContractParams, z as VHTLCV2ContractHandler, E as VHTLCV2ContractParams, F as contractHandlers } from '../../index-C888wFEV.js';
+import '../../index-CwBr7qzV.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer';
 import '@scure/btc-signer/psbt.js';
-import '../../delegate-BySzD37I.js';
+import '../../delegate-BjYJJsml.js';

package/dist/contracts/handlers/index.js

@@ -1,5 +1,5 @@
-export { ArkadeContractHandler, BoardingContractHandler, DefaultContractHandler, DelegateContractHandler, VHTLCContractHandler, VHTLCV2ContractHandler, contractHandlers } from '../../chunk-6O5OLYTZ.js';
-import '../../chunk-PVY6DMN5.js';
+export { ArkadeContractHandler, BoardingContractHandler, DefaultContractHandler, DelegateContractHandler, VHTLCContractHandler, VHTLCV2ContractHandler, contractHandlers } from '../../chunk-L7S5KC5B.js';
+import '../../chunk-URT2RVGB.js';
 import '../../chunk-NSBPE2FW.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{delegate-BySzD37I.d.ts → delegate-BjYJJsml.d.ts}

@@ -1,5 +1,5 @@
 import { Bytes } from '@scure/btc-signer/utils.js';
-import { p as RelativeTimelock, V as VtxoScript, q as TapLeafScript } from './index-BcRCHnzN.js';
+import { q as RelativeTimelock, V as VtxoScript, r as TapLeafScript } from './index-CwBr7qzV.js';
 
 /**
  * DefaultVtxo is the default implementation of a VtxoScript.

package/dist/{delegate-C4Rl6h9l.d.cts → delegate-CC1gcvuC.d.cts}

@@ -1,5 +1,5 @@
 import { Bytes } from '@scure/btc-signer/utils.js';
-import { p as RelativeTimelock, V as VtxoScript, q as TapLeafScript } from './index-BcRCHnzN.cjs';
+import { q as RelativeTimelock, V as VtxoScript, r as TapLeafScript } from './index-CwBr7qzV.cjs';
 
 /**
  * DefaultVtxo is the default implementation of a VtxoScript.

package/dist/{index-C29VNcxC.d.ts → index-C888wFEV.d.ts}

@@ -1,5 +1,5 @@
-import { ba as ContractHandler, p as RelativeTimelock, bl as Discoverable, V as VtxoScript, q as TapLeafScript, cO as TapscriptDeriving } from './index-BcRCHnzN.js';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-BySzD37I.js';
+import { bb as ContractHandler, q as RelativeTimelock, bm as Discoverable, V as VtxoScript, r as TapLeafScript, cP as TapscriptDeriving } from './index-CwBr7qzV.js';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-BjYJJsml.js';
 import { Bytes } from '@scure/btc-signer/utils.js';
 
 /**

package/dist/{index-BcRCHnzN.d.cts → index-CwBr7qzV.d.cts}

@@ -5219,16 +5219,41 @@ interface WalletBalance {
         /** Combined boarding balance (`confirmed` + `unconfirmed`) */
         total: number;
     };
-    /** Spendable settled (finalized) balance. */
+    /** Settled (finalized) balance the wallet owns, including gated and intent-locked funds. */
     settled: number;
-    /** Spendable preconfirmed (unfinalized) balance. */
+    /** Preconfirmed (unfinalized) balance the wallet owns, on the same owned rule as {@link settled}. */
     preconfirmed: number;
     /**
-     * Immediately spendable offchain balance: the `settled + preconfirmed`
-     * rule applied only to VTXOs not locked by an in-flight (non-terminal)
-     * intent. Equals `settled + preconfirmed` when nothing is intent-locked.
+     * Immediately spendable offchain balance — what generic selection would
+     * pick, so nothing counted here can be refused by `send`:
+     * `settled + preconfirmed - gated - intentLocked`.
      */
     available: number;
+    /**
+     * Spendable-but-for-the-gate funds: VTXOs under a contract the
+     * generic-spending gate refuses — a VHTLC lockup, an unmarked `arkade`
+     * program, or a type whose handler this runtime never registered. Counted in
+     * `settled`/`preconfirmed` and `total`, never in `available`.
+     *
+     * Tested before {@link intentLocked}: the gate is a durable property of the
+     * contract while an intent lock clears on its own, so a VTXO that is both is
+     * reported here — it does not become available when the batch settles.
+     *
+     * Covers this bucket only: {@link recoverable} has the same owned-versus-
+     * obtainable split under a different predicate and is not counted here, so
+     * `total - gated` still carries a recoverable component.
+     */
+    gated: number;
+    /**
+     * Funds committed to an in-flight (non-terminal) intent, and not already
+     * counted in {@link gated}. Unlike `gated`, these return to `available` when
+     * the intent reaches a terminal state.
+     *
+     * Reported as zero where the wallet cannot answer the question — no intent
+     * repository, or a repository read that fails — so this under-reports into
+     * `available` rather than misattributing.
+     */
+    intentLocked: number;
     /**
      * Recoverable balance from subdust or expired (swept) virtual outputs —
      * recoverable in principle, so a lockup whose contract refuses a spend right
@@ -5250,9 +5275,9 @@ interface WalletBalance {
     assets: Asset[];
     /**
      * The subset of {@link assets} generic spending will accept, i.e. the asset
-     * analogue of {@link available}. Assets have no owned/spendable split of
-     * their own, so `assets - availableAssets` is what is held but not
-     * selectable — escrowed, intent-locked or awaiting recovery.
+     * analogue of {@link available}. `assets - availableAssets` is what is held
+     * but not selectable, for the {@link gated} and {@link intentLocked} causes
+     * plus recovery — assets have no per-cause split of their own.
      */
     availableAssets: Asset[];
 }
@@ -5320,6 +5345,31 @@ interface Recipient {
         type: number;
         payload: Uint8Array;
     }>;
+    /**
+     * The recipient contract's tapleaf set (`VtxoScript.encode` form), published
+     * on this output's `PSBT_OUT_TAP_TREE` so its spending paths are recoverable
+     * from the transaction alone — an address commits only to the output key.
+     *
+     * Refused unless it derives the recipient address's taproot key, and it must
+     * come from `VtxoScript.encode()`: leaf depths are ignored on read and the
+     * tree is rebuilt in arkd's canonical shape, so a tree from another encoder
+     * is refused even where it commits to the same address.
+     */
+    tapTree?: Bytes;
+}
+/** Object form of `IWallet.send`'s arguments; the variadic form has no slot for options. */
+interface SendParams {
+    /** One or more recipients — the variadic arguments of the other form. */
+    recipients: [Recipient, ...Recipient[]];
+    /**
+     * Spend exactly these virtual outputs instead of letting the wallet choose.
+     * Taken as given, like `settle({ inputs })`: nothing is added, so a shortfall
+     * is an error rather than a top-up. Use when a contract must be funded from
+     * coins outliving its timelock, which generic selection does not know about.
+     *
+     * @see IReadonlyWallet.getVtxos
+     */
+    selectedVtxos?: ExtendedVirtualCoin[];
 }
 /**
  * Known asset metadata fields.
@@ -5777,16 +5827,25 @@ interface IWallet extends IReadonlyWallet {
      */
     settle(params?: SettleParams, eventCallback?: (event: SettlementEvent) => void): Promise<string>;
     /**
-     * Send bitcoin and/or assets to one or more Arkade recipients.
+     * Send bitcoin and/or assets to one or more Arkade recipients, passed
+     * either as variadic `Recipient`s or as a single `SendParams` object —
+     * the latter also carries the inputs to spend.
      *
-     * @param recipients - One or more recipients
+     * @param args - Recipients, or a `SendParams` object
      * @returns Arkade transaction id
+     * @see SendParams
      * @example
      * ```typescript
      * await wallet.send({ address: 'ark1q...', amount: 1000 })
+     *
+     * // choosing the inputs as well as the outputs
+     * await wallet.send({
+     *     recipients: [{ address: 'ark1q...', amount: 1000 }],
+     *     selectedVtxos: mine,
+     * })
      * ```
      */
-    send(...recipients: [Recipient, ...Recipient[]]): Promise<string>;
+    send(...args: [SendParams] | [Recipient, ...Recipient[]]): Promise<string>;
     /** Asset manager bound to this wallet instance. */
     assetManager: IAssetManager;
     /** @returns Delegation manager, when configured. */
@@ -5859,4 +5918,4 @@ interface IReadonlyWallet {
     clear(): Promise<void>;
 }
 
-export { type TreeSignatureEvent as $, type ArkTransaction as A, type VirtualTxRepository as B, type ContractRepository as C, type VirtualTx as D, type ExtendedCoin as E, type VtxoBranch as F, type GetVtxosFilter as G, ChainedTxType as H, type IWallet as I, type DescriptorProvider as J, type Network as K, CSVMultisigTapscript as L, type BatchStartedEvent as M, type NormalizedExtendedVirtualCoin as N, type Outpoint as O, type TreeSigningStartedEvent as P, TxTree as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotification as T, type TreeNoncesEvent as U, VtxoScript as V, type WalletRepository as W, type BatchFinalizationEvent as X, type BatchFinalizedEvent as Y, type BatchFailedEvent as Z, type TreeTxEvent as _, type Identity as a, type BaseWalletConfig as a$, type IReadonlyWallet as a0, type ReadonlyIdentity as a1, type OnchainProvider as a2, type DelegateProvider as a3, type ReadonlyWalletConfig as a4, type ExitCaptureMode as a5, type ExitDataSource as a6, type IReadonlyAssetManager as a7, type ContractSyncState as a8, type RecipientAddressContext as a9, type GetSpendablePathsOptions as aA, type GetAllSpendingPathsOptions as aB, type IssuanceParams as aC, type ReissuanceParams as aD, type BurnParams as aE, type RenewVtxosOptions as aF, type PathSelection as aG, type ContractEvent as aH, type AssetDetails as aI, type IssuanceResult as aJ, type DelegateInfo as aK, type MigrationGlobalSkipReason as aL, type MigrationLegSkipReason as aM, type SignerStatus as aN, type StorageConfig as aO, type IVtxoManager as aP, type ExplorerTransaction as aQ, type EncodedVtxoScript as aR, type Status as aS, type ChainTx as aT, type PathContext as aU, type ActivityIntent as aV, type ActivityResolver as aW, type ArkIntentState as aX, type ArkTapscript as aY, type AssetMetadata as aZ, BITCOIN_EMULATOR_PUBKEY as a_, type NetworkName as aa, type ArkInfo as ab, ArkAddress as ac, type ContractWithVtxos as ad, selectPendingRecoveryOutpoints as ae, type Coin as af, ContractManager as ag, type ContractManagerConfig as ah, type SettlementConfig as ai, VtxoManager as aj, type SignerSession as ak, type SignedIntent as al, Intent as am, type TimeHeight as an, type DescriptorSigningRequest as ao, Transaction as ap, type IntentFeeConfig as aq, type OffchainInput as ar, FeeAmount as as, type OnchainInput as at, type FeeOutput as au, type ContractWatcherConfig as av, type Asset as aw, type FeeInfo as ax, type CreateContractParams as ay, type GetContractsFilter as az, type WalletConfig as b, TapscriptType as b$, type BatchInfo as b0, type BatchSignableIdentity as b1, CLTVMultisigTapscript as b2, type CandidateDeps as b3, ChainTxType as b4, type CommitmentTx as b5, ConditionCSVMultisigTapscript as b6, ConditionMultisigTapscript as b7, type ContractBalance as b8, type ContractEventCallback as b9, IndexerTxType as bA, type KnownMetadata as bB, MUTINYNET_EMULATOR_PUBKEY as bC, type MigrateDeprecatedSignerOptions as bD, type MigrationLegReport as bE, type MigrationVtxoRef as bF, MultisigTapscript as bG, type Nonces as bH, type Output as bI, type PageResponse as bJ, type PaginationOptions as bK, PartialSig as bL, type ProviderClass as bM, REGTEST_EMULATOR_PUBKEY as bN, RestDelegateProvider as bO, RestDelegatorProvider as bP, type ScanContractsOptions as bQ, type ScanResult as bR, type ScheduledSession as bS, SettlementEventType as bT, type SignRequest as bU, type SignerClassification as bV, type SignerSet as bW, type SubscriptionEvent as bX, type SubscriptionHeartbeat as bY, type TapLeaves as bZ, TapTreeCoder as b_, type ContractHandler as ba, type ContractState as bb, type ContractVtxo as bc, ContractWatcher as bd, DelegateManagerImpl as be, type DelegateOptions as bf, DelegatorManagerImpl as bg, type DelegatorProvider as bh, type DeprecatedSignerMigrationReport as bi, type DeprecatedSignerReport as bj, DigestMismatchError as bk, type Discoverable as bl, type DiscoveredContract as bm, type DiscoveryDeps as bn, ESPLORA_URL as bo, EsploraProvider as bp, type EventSourceCapable as bq, type EventSourceFactory as br, type EventSourceLike as bs, EventSourceUnavailableError as bt, type ExitChainResolver as bu, type ExtendedContractVtxo as bv, type GroupMembership as bw, type HandlerError as bx, type IDelegatorManager as by, INTENT_TERMINAL_STATES as bz, type WalletBalance as c, type TreeNonces as c0, type TreePartialSigs as c1, type Tx as c2, type TxHistoryRecord as c3, type TxKey as c4, type TxTag as c5, type TxTreeNode as c6, TxType as c7, type VirtualStatus as c8, type Vtxo as c9, isPastExpiry as cA, isRecoverable as cB, isSigningIdentity as cC, isSpendable as cD, isSubdust as cE, isTerminalIntentState as cF, isVirtualCoin as cG, isVtxoExpiringSoon as cH, networks as cI, resolveEmulatorPubkey as cJ, resolveEventSource as cK, scriptFromTapLeafScript as cL, signerSetFromInfo as cM, toXOnlySignerHex as cN, type TapscriptDeriving as cO, type VtxoChain as ca, type VtxoType as cb, type WalletMode as cc, assetMintResolver as cd, boardingResolver as ce, canRecoverOnchain as cf, canSpendOffchain as cg, classifyAgainstSignerSet as ch, classifyContractSigner as ci, collabExitResolver as cj, configureEventSource as ck, createDefaultActivityRegistry as cl, createExitChainResolver as cm, decodeTapscript as cn, defaultEmulatorPubkey as co, getConfiguredEventSource as cp, getNetwork as cq, getRandomId as cr, getSequence as cs, hasCandidates as ct, hasTerminalSpend as cu, isBatchSignable as cv, isCooperativelyMigratable as cw, isDiscoverable as cx, isEventSourceUnavailableError as cy, isExpired as cz, ActivityRegistry as d, type Activity as e, type IContractManager as f, type IDelegateManager as g, type SettleParams as h, type SettlementEvent as i, type IAssetManager as j, RestArkProvider as k, RestIndexerProvider as l, type SubscriptionResponse as m, type ArkProvider as n, type IndexerProvider as o, type RelativeTimelock as p, type TapLeafScript as q, type VirtualCoin as r, type Contract as s, type ExtendedVirtualCoin as t, type VtxoRepositoryKey as u, type WalletState as v, type ContractFilter as w, type IntentRepository as x, type ArkIntent as y, type IntentFilter as z };
+export { type TreeTxEvent as $, type ArkTransaction as A, type IntentFilter as B, type ContractRepository as C, type VirtualTxRepository as D, type ExtendedCoin as E, type VirtualTx as F, type GetVtxosFilter as G, type VtxoBranch as H, type IWallet as I, ChainedTxType as J, type DescriptorProvider as K, type Network as L, CSVMultisigTapscript as M, type NormalizedExtendedVirtualCoin as N, type Outpoint as O, type BatchStartedEvent as P, type TreeSigningStartedEvent as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotification as T, TxTree as U, VtxoScript as V, type WalletRepository as W, type TreeNoncesEvent as X, type BatchFinalizationEvent as Y, type BatchFinalizedEvent as Z, type BatchFailedEvent as _, type Identity as a, BITCOIN_EMULATOR_PUBKEY as a$, type TreeSignatureEvent as a0, type IReadonlyWallet as a1, type ReadonlyIdentity as a2, type OnchainProvider as a3, type DelegateProvider as a4, type ReadonlyWalletConfig as a5, type ExitCaptureMode as a6, type ExitDataSource as a7, type IReadonlyAssetManager as a8, type ContractSyncState as a9, type GetContractsFilter as aA, type GetSpendablePathsOptions as aB, type GetAllSpendingPathsOptions as aC, type IssuanceParams as aD, type ReissuanceParams as aE, type BurnParams as aF, type RenewVtxosOptions as aG, type PathSelection as aH, type ContractEvent as aI, type AssetDetails as aJ, type IssuanceResult as aK, type DelegateInfo as aL, type MigrationGlobalSkipReason as aM, type MigrationLegSkipReason as aN, type SignerStatus as aO, type StorageConfig as aP, type IVtxoManager as aQ, type ExplorerTransaction as aR, type EncodedVtxoScript as aS, type Status as aT, type ChainTx as aU, type PathContext as aV, type ActivityIntent as aW, type ActivityResolver as aX, type ArkIntentState as aY, type ArkTapscript as aZ, type AssetMetadata as a_, type RecipientAddressContext as aa, type NetworkName as ab, type ArkInfo as ac, ArkAddress as ad, type ContractWithVtxos as ae, selectPendingRecoveryOutpoints as af, type Coin as ag, ContractManager as ah, type ContractManagerConfig as ai, type SettlementConfig as aj, VtxoManager as ak, type SignerSession as al, type SignedIntent as am, Intent as an, type TimeHeight as ao, type DescriptorSigningRequest as ap, Transaction as aq, type IntentFeeConfig as ar, type OffchainInput as as, FeeAmount as at, type OnchainInput as au, type FeeOutput as av, type ContractWatcherConfig as aw, type Asset as ax, type FeeInfo as ay, type CreateContractParams as az, type WalletConfig as b, TapTreeCoder as b$, type BaseWalletConfig as b0, type BatchInfo as b1, type BatchSignableIdentity as b2, CLTVMultisigTapscript as b3, type CandidateDeps as b4, ChainTxType as b5, type CommitmentTx as b6, ConditionCSVMultisigTapscript as b7, ConditionMultisigTapscript as b8, type ContractBalance as b9, INTENT_TERMINAL_STATES as bA, IndexerTxType as bB, type KnownMetadata as bC, MUTINYNET_EMULATOR_PUBKEY as bD, type MigrateDeprecatedSignerOptions as bE, type MigrationLegReport as bF, type MigrationVtxoRef as bG, MultisigTapscript as bH, type Nonces as bI, type Output as bJ, type PageResponse as bK, type PaginationOptions as bL, PartialSig as bM, type ProviderClass as bN, REGTEST_EMULATOR_PUBKEY as bO, RestDelegateProvider as bP, RestDelegatorProvider as bQ, type ScanContractsOptions as bR, type ScanResult as bS, type ScheduledSession as bT, SettlementEventType as bU, type SignRequest as bV, type SignerClassification as bW, type SignerSet as bX, type SubscriptionEvent as bY, type SubscriptionHeartbeat as bZ, type TapLeaves as b_, type ContractEventCallback as ba, type ContractHandler as bb, type ContractState as bc, type ContractVtxo as bd, ContractWatcher as be, DelegateManagerImpl as bf, type DelegateOptions as bg, DelegatorManagerImpl as bh, type DelegatorProvider as bi, type DeprecatedSignerMigrationReport as bj, type DeprecatedSignerReport as bk, DigestMismatchError as bl, type Discoverable as bm, type DiscoveredContract as bn, type DiscoveryDeps as bo, ESPLORA_URL as bp, EsploraProvider as bq, type EventSourceCapable as br, type EventSourceFactory as bs, type EventSourceLike as bt, EventSourceUnavailableError as bu, type ExitChainResolver as bv, type ExtendedContractVtxo as bw, type GroupMembership as bx, type HandlerError as by, type IDelegatorManager as bz, type WalletBalance as c, TapscriptType as c0, type TreeNonces as c1, type TreePartialSigs as c2, type Tx as c3, type TxHistoryRecord as c4, type TxKey as c5, type TxTag as c6, type TxTreeNode as c7, TxType as c8, type VirtualStatus as c9, isExpired as cA, isPastExpiry as cB, isRecoverable as cC, isSigningIdentity as cD, isSpendable as cE, isSubdust as cF, isTerminalIntentState as cG, isVirtualCoin as cH, isVtxoExpiringSoon as cI, networks as cJ, resolveEmulatorPubkey as cK, resolveEventSource as cL, scriptFromTapLeafScript as cM, signerSetFromInfo as cN, toXOnlySignerHex as cO, type TapscriptDeriving as cP, type Vtxo as ca, type VtxoChain as cb, type VtxoType as cc, type WalletMode as cd, assetMintResolver as ce, boardingResolver as cf, canRecoverOnchain as cg, canSpendOffchain as ch, classifyAgainstSignerSet as ci, classifyContractSigner as cj, collabExitResolver as ck, configureEventSource as cl, createDefaultActivityRegistry as cm, createExitChainResolver as cn, decodeTapscript as co, defaultEmulatorPubkey as cp, getConfiguredEventSource as cq, getNetwork as cr, getRandomId as cs, getSequence as ct, hasCandidates as cu, hasTerminalSpend as cv, isBatchSignable as cw, isCooperativelyMigratable as cx, isDiscoverable as cy, isEventSourceUnavailableError as cz, ActivityRegistry as d, type Activity as e, type IContractManager as f, type IDelegateManager as g, type SettleParams as h, type SettlementEvent as i, type SendParams as j, type IAssetManager as k, RestArkProvider as l, RestIndexerProvider as m, type SubscriptionResponse as n, type ArkProvider as o, type IndexerProvider as p, type RelativeTimelock as q, type TapLeafScript as r, type VirtualCoin as s, type Contract as t, type ExtendedVirtualCoin as u, type VtxoRepositoryKey as v, type WalletState as w, type ContractFilter as x, type IntentRepository as y, type ArkIntent as z };

package/dist/{index-BcRCHnzN.d.ts → index-CwBr7qzV.d.ts}

@@ -5219,16 +5219,41 @@ interface WalletBalance {
         /** Combined boarding balance (`confirmed` + `unconfirmed`) */
         total: number;
     };
-    /** Spendable settled (finalized) balance. */
+    /** Settled (finalized) balance the wallet owns, including gated and intent-locked funds. */
     settled: number;
-    /** Spendable preconfirmed (unfinalized) balance. */
+    /** Preconfirmed (unfinalized) balance the wallet owns, on the same owned rule as {@link settled}. */
     preconfirmed: number;
     /**
-     * Immediately spendable offchain balance: the `settled + preconfirmed`
-     * rule applied only to VTXOs not locked by an in-flight (non-terminal)
-     * intent. Equals `settled + preconfirmed` when nothing is intent-locked.
+     * Immediately spendable offchain balance — what generic selection would
+     * pick, so nothing counted here can be refused by `send`:
+     * `settled + preconfirmed - gated - intentLocked`.
      */
     available: number;
+    /**
+     * Spendable-but-for-the-gate funds: VTXOs under a contract the
+     * generic-spending gate refuses — a VHTLC lockup, an unmarked `arkade`
+     * program, or a type whose handler this runtime never registered. Counted in
+     * `settled`/`preconfirmed` and `total`, never in `available`.
+     *
+     * Tested before {@link intentLocked}: the gate is a durable property of the
+     * contract while an intent lock clears on its own, so a VTXO that is both is
+     * reported here — it does not become available when the batch settles.
+     *
+     * Covers this bucket only: {@link recoverable} has the same owned-versus-
+     * obtainable split under a different predicate and is not counted here, so
+     * `total - gated` still carries a recoverable component.
+     */
+    gated: number;
+    /**
+     * Funds committed to an in-flight (non-terminal) intent, and not already
+     * counted in {@link gated}. Unlike `gated`, these return to `available` when
+     * the intent reaches a terminal state.
+     *
+     * Reported as zero where the wallet cannot answer the question — no intent
+     * repository, or a repository read that fails — so this under-reports into
+     * `available` rather than misattributing.
+     */
+    intentLocked: number;
     /**
      * Recoverable balance from subdust or expired (swept) virtual outputs —
      * recoverable in principle, so a lockup whose contract refuses a spend right
@@ -5250,9 +5275,9 @@ interface WalletBalance {
     assets: Asset[];
     /**
      * The subset of {@link assets} generic spending will accept, i.e. the asset
-     * analogue of {@link available}. Assets have no owned/spendable split of
-     * their own, so `assets - availableAssets` is what is held but not
-     * selectable — escrowed, intent-locked or awaiting recovery.
+     * analogue of {@link available}. `assets - availableAssets` is what is held
+     * but not selectable, for the {@link gated} and {@link intentLocked} causes
+     * plus recovery — assets have no per-cause split of their own.
      */
     availableAssets: Asset[];
 }
@@ -5320,6 +5345,31 @@ interface Recipient {
         type: number;
         payload: Uint8Array;
     }>;
+    /**
+     * The recipient contract's tapleaf set (`VtxoScript.encode` form), published
+     * on this output's `PSBT_OUT_TAP_TREE` so its spending paths are recoverable
+     * from the transaction alone — an address commits only to the output key.
+     *
+     * Refused unless it derives the recipient address's taproot key, and it must
+     * come from `VtxoScript.encode()`: leaf depths are ignored on read and the
+     * tree is rebuilt in arkd's canonical shape, so a tree from another encoder
+     * is refused even where it commits to the same address.
+     */
+    tapTree?: Bytes;
+}
+/** Object form of `IWallet.send`'s arguments; the variadic form has no slot for options. */
+interface SendParams {
+    /** One or more recipients — the variadic arguments of the other form. */
+    recipients: [Recipient, ...Recipient[]];
+    /**
+     * Spend exactly these virtual outputs instead of letting the wallet choose.
+     * Taken as given, like `settle({ inputs })`: nothing is added, so a shortfall
+     * is an error rather than a top-up. Use when a contract must be funded from
+     * coins outliving its timelock, which generic selection does not know about.
+     *
+     * @see IReadonlyWallet.getVtxos
+     */
+    selectedVtxos?: ExtendedVirtualCoin[];
 }
 /**
  * Known asset metadata fields.
@@ -5777,16 +5827,25 @@ interface IWallet extends IReadonlyWallet {
      */
     settle(params?: SettleParams, eventCallback?: (event: SettlementEvent) => void): Promise<string>;
     /**
-     * Send bitcoin and/or assets to one or more Arkade recipients.
+     * Send bitcoin and/or assets to one or more Arkade recipients, passed
+     * either as variadic `Recipient`s or as a single `SendParams` object —
+     * the latter also carries the inputs to spend.
      *
-     * @param recipients - One or more recipients
+     * @param args - Recipients, or a `SendParams` object
      * @returns Arkade transaction id
+     * @see SendParams
      * @example
      * ```typescript
      * await wallet.send({ address: 'ark1q...', amount: 1000 })
+     *
+     * // choosing the inputs as well as the outputs
+     * await wallet.send({
+     *     recipients: [{ address: 'ark1q...', amount: 1000 }],
+     *     selectedVtxos: mine,
+     * })
      * ```
      */
-    send(...recipients: [Recipient, ...Recipient[]]): Promise<string>;
+    send(...args: [SendParams] | [Recipient, ...Recipient[]]): Promise<string>;
     /** Asset manager bound to this wallet instance. */
     assetManager: IAssetManager;
     /** @returns Delegation manager, when configured. */
@@ -5859,4 +5918,4 @@ interface IReadonlyWallet {
     clear(): Promise<void>;
 }
 
-export { type TreeSignatureEvent as $, type ArkTransaction as A, type VirtualTxRepository as B, type ContractRepository as C, type VirtualTx as D, type ExtendedCoin as E, type VtxoBranch as F, type GetVtxosFilter as G, ChainedTxType as H, type IWallet as I, type DescriptorProvider as J, type Network as K, CSVMultisigTapscript as L, type BatchStartedEvent as M, type NormalizedExtendedVirtualCoin as N, type Outpoint as O, type TreeSigningStartedEvent as P, TxTree as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotification as T, type TreeNoncesEvent as U, VtxoScript as V, type WalletRepository as W, type BatchFinalizationEvent as X, type BatchFinalizedEvent as Y, type BatchFailedEvent as Z, type TreeTxEvent as _, type Identity as a, type BaseWalletConfig as a$, type IReadonlyWallet as a0, type ReadonlyIdentity as a1, type OnchainProvider as a2, type DelegateProvider as a3, type ReadonlyWalletConfig as a4, type ExitCaptureMode as a5, type ExitDataSource as a6, type IReadonlyAssetManager as a7, type ContractSyncState as a8, type RecipientAddressContext as a9, type GetSpendablePathsOptions as aA, type GetAllSpendingPathsOptions as aB, type IssuanceParams as aC, type ReissuanceParams as aD, type BurnParams as aE, type RenewVtxosOptions as aF, type PathSelection as aG, type ContractEvent as aH, type AssetDetails as aI, type IssuanceResult as aJ, type DelegateInfo as aK, type MigrationGlobalSkipReason as aL, type MigrationLegSkipReason as aM, type SignerStatus as aN, type StorageConfig as aO, type IVtxoManager as aP, type ExplorerTransaction as aQ, type EncodedVtxoScript as aR, type Status as aS, type ChainTx as aT, type PathContext as aU, type ActivityIntent as aV, type ActivityResolver as aW, type ArkIntentState as aX, type ArkTapscript as aY, type AssetMetadata as aZ, BITCOIN_EMULATOR_PUBKEY as a_, type NetworkName as aa, type ArkInfo as ab, ArkAddress as ac, type ContractWithVtxos as ad, selectPendingRecoveryOutpoints as ae, type Coin as af, ContractManager as ag, type ContractManagerConfig as ah, type SettlementConfig as ai, VtxoManager as aj, type SignerSession as ak, type SignedIntent as al, Intent as am, type TimeHeight as an, type DescriptorSigningRequest as ao, Transaction as ap, type IntentFeeConfig as aq, type OffchainInput as ar, FeeAmount as as, type OnchainInput as at, type FeeOutput as au, type ContractWatcherConfig as av, type Asset as aw, type FeeInfo as ax, type CreateContractParams as ay, type GetContractsFilter as az, type WalletConfig as b, TapscriptType as b$, type BatchInfo as b0, type BatchSignableIdentity as b1, CLTVMultisigTapscript as b2, type CandidateDeps as b3, ChainTxType as b4, type CommitmentTx as b5, ConditionCSVMultisigTapscript as b6, ConditionMultisigTapscript as b7, type ContractBalance as b8, type ContractEventCallback as b9, IndexerTxType as bA, type KnownMetadata as bB, MUTINYNET_EMULATOR_PUBKEY as bC, type MigrateDeprecatedSignerOptions as bD, type MigrationLegReport as bE, type MigrationVtxoRef as bF, MultisigTapscript as bG, type Nonces as bH, type Output as bI, type PageResponse as bJ, type PaginationOptions as bK, PartialSig as bL, type ProviderClass as bM, REGTEST_EMULATOR_PUBKEY as bN, RestDelegateProvider as bO, RestDelegatorProvider as bP, type ScanContractsOptions as bQ, type ScanResult as bR, type ScheduledSession as bS, SettlementEventType as bT, type SignRequest as bU, type SignerClassification as bV, type SignerSet as bW, type SubscriptionEvent as bX, type SubscriptionHeartbeat as bY, type TapLeaves as bZ, TapTreeCoder as b_, type ContractHandler as ba, type ContractState as bb, type ContractVtxo as bc, ContractWatcher as bd, DelegateManagerImpl as be, type DelegateOptions as bf, DelegatorManagerImpl as bg, type DelegatorProvider as bh, type DeprecatedSignerMigrationReport as bi, type DeprecatedSignerReport as bj, DigestMismatchError as bk, type Discoverable as bl, type DiscoveredContract as bm, type DiscoveryDeps as bn, ESPLORA_URL as bo, EsploraProvider as bp, type EventSourceCapable as bq, type EventSourceFactory as br, type EventSourceLike as bs, EventSourceUnavailableError as bt, type ExitChainResolver as bu, type ExtendedContractVtxo as bv, type GroupMembership as bw, type HandlerError as bx, type IDelegatorManager as by, INTENT_TERMINAL_STATES as bz, type WalletBalance as c, type TreeNonces as c0, type TreePartialSigs as c1, type Tx as c2, type TxHistoryRecord as c3, type TxKey as c4, type TxTag as c5, type TxTreeNode as c6, TxType as c7, type VirtualStatus as c8, type Vtxo as c9, isPastExpiry as cA, isRecoverable as cB, isSigningIdentity as cC, isSpendable as cD, isSubdust as cE, isTerminalIntentState as cF, isVirtualCoin as cG, isVtxoExpiringSoon as cH, networks as cI, resolveEmulatorPubkey as cJ, resolveEventSource as cK, scriptFromTapLeafScript as cL, signerSetFromInfo as cM, toXOnlySignerHex as cN, type TapscriptDeriving as cO, type VtxoChain as ca, type VtxoType as cb, type WalletMode as cc, assetMintResolver as cd, boardingResolver as ce, canRecoverOnchain as cf, canSpendOffchain as cg, classifyAgainstSignerSet as ch, classifyContractSigner as ci, collabExitResolver as cj, configureEventSource as ck, createDefaultActivityRegistry as cl, createExitChainResolver as cm, decodeTapscript as cn, defaultEmulatorPubkey as co, getConfiguredEventSource as cp, getNetwork as cq, getRandomId as cr, getSequence as cs, hasCandidates as ct, hasTerminalSpend as cu, isBatchSignable as cv, isCooperativelyMigratable as cw, isDiscoverable as cx, isEventSourceUnavailableError as cy, isExpired as cz, ActivityRegistry as d, type Activity as e, type IContractManager as f, type IDelegateManager as g, type SettleParams as h, type SettlementEvent as i, type IAssetManager as j, RestArkProvider as k, RestIndexerProvider as l, type SubscriptionResponse as m, type ArkProvider as n, type IndexerProvider as o, type RelativeTimelock as p, type TapLeafScript as q, type VirtualCoin as r, type Contract as s, type ExtendedVirtualCoin as t, type VtxoRepositoryKey as u, type WalletState as v, type ContractFilter as w, type IntentRepository as x, type ArkIntent as y, type IntentFilter as z };
+export { type TreeTxEvent as $, type ArkTransaction as A, type IntentFilter as B, type ContractRepository as C, type VirtualTxRepository as D, type ExtendedCoin as E, type VirtualTx as F, type GetVtxosFilter as G, type VtxoBranch as H, type IWallet as I, ChainedTxType as J, type DescriptorProvider as K, type Network as L, CSVMultisigTapscript as M, type NormalizedExtendedVirtualCoin as N, type Outpoint as O, type BatchStartedEvent as P, type TreeSigningStartedEvent as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotification as T, TxTree as U, VtxoScript as V, type WalletRepository as W, type TreeNoncesEvent as X, type BatchFinalizationEvent as Y, type BatchFinalizedEvent as Z, type BatchFailedEvent as _, type Identity as a, BITCOIN_EMULATOR_PUBKEY as a$, type TreeSignatureEvent as a0, type IReadonlyWallet as a1, type ReadonlyIdentity as a2, type OnchainProvider as a3, type DelegateProvider as a4, type ReadonlyWalletConfig as a5, type ExitCaptureMode as a6, type ExitDataSource as a7, type IReadonlyAssetManager as a8, type ContractSyncState as a9, type GetContractsFilter as aA, type GetSpendablePathsOptions as aB, type GetAllSpendingPathsOptions as aC, type IssuanceParams as aD, type ReissuanceParams as aE, type BurnParams as aF, type RenewVtxosOptions as aG, type PathSelection as aH, type ContractEvent as aI, type AssetDetails as aJ, type IssuanceResult as aK, type DelegateInfo as aL, type MigrationGlobalSkipReason as aM, type MigrationLegSkipReason as aN, type SignerStatus as aO, type StorageConfig as aP, type IVtxoManager as aQ, type ExplorerTransaction as aR, type EncodedVtxoScript as aS, type Status as aT, type ChainTx as aU, type PathContext as aV, type ActivityIntent as aW, type ActivityResolver as aX, type ArkIntentState as aY, type ArkTapscript as aZ, type AssetMetadata as a_, type RecipientAddressContext as aa, type NetworkName as ab, type ArkInfo as ac, ArkAddress as ad, type ContractWithVtxos as ae, selectPendingRecoveryOutpoints as af, type Coin as ag, ContractManager as ah, type ContractManagerConfig as ai, type SettlementConfig as aj, VtxoManager as ak, type SignerSession as al, type SignedIntent as am, Intent as an, type TimeHeight as ao, type DescriptorSigningRequest as ap, Transaction as aq, type IntentFeeConfig as ar, type OffchainInput as as, FeeAmount as at, type OnchainInput as au, type FeeOutput as av, type ContractWatcherConfig as aw, type Asset as ax, type FeeInfo as ay, type CreateContractParams as az, type WalletConfig as b, TapTreeCoder as b$, type BaseWalletConfig as b0, type BatchInfo as b1, type BatchSignableIdentity as b2, CLTVMultisigTapscript as b3, type CandidateDeps as b4, ChainTxType as b5, type CommitmentTx as b6, ConditionCSVMultisigTapscript as b7, ConditionMultisigTapscript as b8, type ContractBalance as b9, INTENT_TERMINAL_STATES as bA, IndexerTxType as bB, type KnownMetadata as bC, MUTINYNET_EMULATOR_PUBKEY as bD, type MigrateDeprecatedSignerOptions as bE, type MigrationLegReport as bF, type MigrationVtxoRef as bG, MultisigTapscript as bH, type Nonces as bI, type Output as bJ, type PageResponse as bK, type PaginationOptions as bL, PartialSig as bM, type ProviderClass as bN, REGTEST_EMULATOR_PUBKEY as bO, RestDelegateProvider as bP, RestDelegatorProvider as bQ, type ScanContractsOptions as bR, type ScanResult as bS, type ScheduledSession as bT, SettlementEventType as bU, type SignRequest as bV, type SignerClassification as bW, type SignerSet as bX, type SubscriptionEvent as bY, type SubscriptionHeartbeat as bZ, type TapLeaves as b_, type ContractEventCallback as ba, type ContractHandler as bb, type ContractState as bc, type ContractVtxo as bd, ContractWatcher as be, DelegateManagerImpl as bf, type DelegateOptions as bg, DelegatorManagerImpl as bh, type DelegatorProvider as bi, type DeprecatedSignerMigrationReport as bj, type DeprecatedSignerReport as bk, DigestMismatchError as bl, type Discoverable as bm, type DiscoveredContract as bn, type DiscoveryDeps as bo, ESPLORA_URL as bp, EsploraProvider as bq, type EventSourceCapable as br, type EventSourceFactory as bs, type EventSourceLike as bt, EventSourceUnavailableError as bu, type ExitChainResolver as bv, type ExtendedContractVtxo as bw, type GroupMembership as bx, type HandlerError as by, type IDelegatorManager as bz, type WalletBalance as c, TapscriptType as c0, type TreeNonces as c1, type TreePartialSigs as c2, type Tx as c3, type TxHistoryRecord as c4, type TxKey as c5, type TxTag as c6, type TxTreeNode as c7, TxType as c8, type VirtualStatus as c9, isExpired as cA, isPastExpiry as cB, isRecoverable as cC, isSigningIdentity as cD, isSpendable as cE, isSubdust as cF, isTerminalIntentState as cG, isVirtualCoin as cH, isVtxoExpiringSoon as cI, networks as cJ, resolveEmulatorPubkey as cK, resolveEventSource as cL, scriptFromTapLeafScript as cM, signerSetFromInfo as cN, toXOnlySignerHex as cO, type TapscriptDeriving as cP, type Vtxo as ca, type VtxoChain as cb, type VtxoType as cc, type WalletMode as cd, assetMintResolver as ce, boardingResolver as cf, canRecoverOnchain as cg, canSpendOffchain as ch, classifyAgainstSignerSet as ci, classifyContractSigner as cj, collabExitResolver as ck, configureEventSource as cl, createDefaultActivityRegistry as cm, createExitChainResolver as cn, decodeTapscript as co, defaultEmulatorPubkey as cp, getConfiguredEventSource as cq, getNetwork as cr, getRandomId as cs, getSequence as ct, hasCandidates as cu, hasTerminalSpend as cv, isBatchSignable as cw, isCooperativelyMigratable as cx, isDiscoverable as cy, isEventSourceUnavailableError as cz, ActivityRegistry as d, type Activity as e, type IContractManager as f, type IDelegateManager as g, type SettleParams as h, type SettlementEvent as i, type SendParams as j, type IAssetManager as k, RestArkProvider as l, RestIndexerProvider as m, type SubscriptionResponse as n, type ArkProvider as o, type IndexerProvider as p, type RelativeTimelock as q, type TapLeafScript as r, type VirtualCoin as s, type Contract as t, type ExtendedVirtualCoin as u, type VtxoRepositoryKey as v, type WalletState as w, type ContractFilter as x, type IntentRepository as y, type ArkIntent as z };

package/dist/{index-Butfkm-K.d.cts → index-Cz5_WaQP.d.cts}

@@ -1,5 +1,5 @@
-import { ba as ContractHandler, p as RelativeTimelock, bl as Discoverable, V as VtxoScript, q as TapLeafScript, cO as TapscriptDeriving } from './index-BcRCHnzN.cjs';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-C4Rl6h9l.cjs';
+import { bb as ContractHandler, q as RelativeTimelock, bm as Discoverable, V as VtxoScript, r as TapLeafScript, cP as TapscriptDeriving } from './index-CwBr7qzV.cjs';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-CC1gcvuC.cjs';
 import { Bytes } from '@scure/btc-signer/utils.js';
 
 /**