@arkade-os/sdk 0.4.74 → 0.4.76

package/dist/contracts/handlers/index.cjs

@@ -1,38 +1,38 @@
 'use strict';
 
-var chunkDXLVCFVK_cjs = require('../../chunk-DXLVCFVK.cjs');
-require('../../chunk-KMPNH7NS.cjs');
+var chunkCQNX4BTA_cjs = require('../../chunk-CQNX4BTA.cjs');
+require('../../chunk-P53OHGXY.cjs');
 require('../../chunk-5BLDMQED.cjs');
 
 
 
 Object.defineProperty(exports, "ArkadeContractHandler", {
   enumerable: true,
-  get: function () { return chunkDXLVCFVK_cjs.ArkadeContractHandler; }
+  get: function () { return chunkCQNX4BTA_cjs.ArkadeContractHandler; }
 });
 Object.defineProperty(exports, "BoardingContractHandler", {
   enumerable: true,
-  get: function () { return chunkDXLVCFVK_cjs.BoardingContractHandler; }
+  get: function () { return chunkCQNX4BTA_cjs.BoardingContractHandler; }
 });
 Object.defineProperty(exports, "DefaultContractHandler", {
   enumerable: true,
-  get: function () { return chunkDXLVCFVK_cjs.DefaultContractHandler; }
+  get: function () { return chunkCQNX4BTA_cjs.DefaultContractHandler; }
 });
 Object.defineProperty(exports, "DelegateContractHandler", {
   enumerable: true,
-  get: function () { return chunkDXLVCFVK_cjs.DelegateContractHandler; }
+  get: function () { return chunkCQNX4BTA_cjs.DelegateContractHandler; }
 });
 Object.defineProperty(exports, "VHTLCContractHandler", {
   enumerable: true,
-  get: function () { return chunkDXLVCFVK_cjs.VHTLCContractHandler; }
+  get: function () { return chunkCQNX4BTA_cjs.VHTLCContractHandler; }
 });
 Object.defineProperty(exports, "VHTLCV2ContractHandler", {
   enumerable: true,
-  get: function () { return chunkDXLVCFVK_cjs.VHTLCV2ContractHandler; }
+  get: function () { return chunkCQNX4BTA_cjs.VHTLCV2ContractHandler; }
 });
 Object.defineProperty(exports, "contractHandlers", {
   enumerable: true,
-  get: function () { return chunkDXLVCFVK_cjs.contractHandlers; }
+  get: function () { return chunkCQNX4BTA_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-BVqlZJwW.cjs';
-import '../../index-Bxz3cKPA.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-4NF3srcg.cjs';
+import '../../index-B_RYn9rg.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-6N0DKdnG.cjs';
+import '../../delegate-CR7msIXK.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-CKQQ1oOg.js';
-import '../../index-Bxz3cKPA.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-Dj2yOhQ2.js';
+import '../../index-B_RYn9rg.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-z6veQfLI.js';
+import '../../delegate-BAYpqkEx.js';

package/dist/contracts/handlers/index.js

@@ -1,5 +1,5 @@
-export { ArkadeContractHandler, BoardingContractHandler, DefaultContractHandler, DelegateContractHandler, VHTLCContractHandler, VHTLCV2ContractHandler, contractHandlers } from '../../chunk-LGB65ZCO.js';
-import '../../chunk-WJVOFYTQ.js';
+export { ArkadeContractHandler, BoardingContractHandler, DefaultContractHandler, DelegateContractHandler, VHTLCContractHandler, VHTLCV2ContractHandler, contractHandlers } from '../../chunk-7UJLIZQU.js';
+import '../../chunk-F6YOCYWU.js';
 import '../../chunk-NSBPE2FW.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{delegate-z6veQfLI.d.ts → delegate-BAYpqkEx.d.ts}

@@ -1,5 +1,5 @@
 import { Bytes } from '@scure/btc-signer/utils.js';
-import { s as RelativeTimelock, V as VtxoScript, t as TapLeafScript } from './index-Bxz3cKPA.js';
+import { s as RelativeTimelock, V as VtxoScript, t as TapLeafScript } from './index-B_RYn9rg.js';
 
 /**
  * DefaultVtxo is the default implementation of a VtxoScript.

package/dist/{delegate-6N0DKdnG.d.cts → delegate-CR7msIXK.d.cts}

@@ -1,5 +1,5 @@
 import { Bytes } from '@scure/btc-signer/utils.js';
-import { s as RelativeTimelock, V as VtxoScript, t as TapLeafScript } from './index-Bxz3cKPA.cjs';
+import { s as RelativeTimelock, V as VtxoScript, t as TapLeafScript } from './index-B_RYn9rg.cjs';
 
 /**
  * DefaultVtxo is the default implementation of a VtxoScript.

package/dist/{hdWalletCapable-Bncp-eF0.d.ts → hdWalletCapable-BSF29IjK.d.ts}

@@ -1,8 +1,8 @@
-import { s as RelativeTimelock, M as Network, P as CSVMultisigTapscript, Q as BatchStartedEvent, U as TreeSigningStartedEvent, X as TxTree, Y as TreeNoncesEvent, Z as BatchFinalizationEvent, _ as BatchFinalizedEvent, $ as BatchFailedEvent, a0 as TreeTxEvent, a1 as TreeSignatureEvent, k as SettlementEvent, b as WalletConfig, W as WalletRepository, C as ContractRepository, a2 as DescriptorProvider, f as IContractManager, a3 as IReadonlyWallet, a4 as ReadonlyIdentity, a5 as OnchainProvider, r as IndexerProvider, a6 as DelegateProvider, a7 as ReadonlyWalletConfig, B as IntentRepository, H as VirtualTxRepository, a8 as ExitCaptureMode, a9 as ExitDataSource, d as ActivityRegistry, aa as IReadonlyAssetManager, ab as ContractSyncState, ac as RecipientAddressContext, q as ArkProvider, ad as NetworkName, ae as ArkInfo, af as ArkAddress, c as WalletBalance, G as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, ag as ContractWithVtxos, ah as selectPendingRecoveryOutpoints, A as ArkTransaction, e as Activity, E as ExtendedCoin, ai as Coin, w as ExtendedVirtualCoin, aj as ContractManager, ak as ContractManagerConfig, I as IWallet, a as Identity, g as GetNewAddressesOptions, h as NewAddress, al as SettlementConfig, m as IAssetManager, am as VtxoManager, i as IDelegateManager, S as SendBitcoinParams, j as SettleParams, R as Recipient, an as SignerSession, ao as SignedIntent, ap as Intent, l as SendParams, aq as TimeHeight } from './index-Bxz3cKPA.js';
+import { s as RelativeTimelock, M as Network, P as CSVMultisigTapscript, Q as BatchStartedEvent, U as TreeSigningStartedEvent, X as TxTree, Y as TreeNoncesEvent, Z as BatchFinalizationEvent, _ as BatchFinalizedEvent, $ as BatchFailedEvent, a0 as TreeTxEvent, a1 as TreeSignatureEvent, k as SettlementEvent, b as WalletConfig, W as WalletRepository, C as ContractRepository, a2 as DescriptorProvider, f as IContractManager, a3 as IReadonlyWallet, a4 as ReadonlyIdentity, a5 as OnchainProvider, r as IndexerProvider, a6 as DelegateProvider, a7 as ReadonlyWalletConfig, B as IntentRepository, H as VirtualTxRepository, a8 as ExitCaptureMode, a9 as ExitDataSource, d as ActivityRegistry, aa as IReadonlyAssetManager, ab as ContractSyncState, ac as RecipientAddressContext, q as ArkProvider, ad as NetworkName, ae as ArkInfo, af as ArkAddress, c as WalletBalance, G as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, ag as ContractWithVtxos, ah as selectPendingRecoveryOutpoints, A as ArkTransaction, e as Activity, E as ExtendedCoin, ai as Coin, w as ExtendedVirtualCoin, aj as ContractManager, ak as ContractManagerConfig, I as IWallet, a as Identity, g as GetNewAddressesOptions, h as NewAddress, al as SettlementConfig, m as IAssetManager, am as VtxoManager, i as IDelegateManager, S as SendBitcoinParams, j as SettleParams, R as Recipient, an as SignerSession, ao as SignedIntent, ap as Intent, l as SendParams, aq as TimeHeight } from './index-B_RYn9rg.js';
 import { Transaction } from '@scure/btc-signer';
 import { TransactionOutput } from '@scure/btc-signer/psbt.js';
 import { Bytes } from '@scure/btc-signer/utils.js';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-z6veQfLI.js';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-BAYpqkEx.js';
 
 /** Wall-clock floor for `batchExpiry` outside regtest. */
 declare const DEFAULT_MIN_BATCH_EXPIRY_SECONDS = 86400n;
@@ -1759,15 +1759,7 @@ declare class Wallet extends ReadonlyWallet implements IWallet, HDWalletCapable,
      * fields already written by the event reducer (state-event ordering).
      */
     private persistIntentSnapshot;
-    /**
-     * @internal Sign an on-chain boarding exit / sweep transaction, routing
-     * each input to the correct key by its `witnessUtxo.script`: the identity
-     * for index-0 / static boarding, the per-index descriptor for a rotated
-     * boarding UTXO (plan §6-III.3). Used by
-     * {@link VtxoManager.sweepExpiredBoardingUtxos}; without it, the
-     * unilateral exit of a rotated boarding UTXO would be signed with the
-     * wrong (index-0) key and rejected.
-     */
+    signInputsByWitnessScript(tx: Transaction): Promise<Transaction>;
     signOnchainBoardingTx(tx: Transaction): Promise<Transaction>;
     safeRegisterIntent(intent: SignedIntent<Intent.RegisterMessage>, inputs: ExtendedCoin[]): Promise<string>;
     makeRegisterIntentSignature(coins: ExtendedCoin[], outputs: TransactionOutput[], onchainOutputsIndexes: number[], cosignerPubKeys: string[], validAt?: number): Promise<SignedIntent<Intent.RegisterMessage>>;

package/dist/{hdWalletCapable-DJT8E8sN.d.cts → hdWalletCapable-BbZxCUeZ.d.cts}

@@ -1,8 +1,8 @@
-import { s as RelativeTimelock, M as Network, P as CSVMultisigTapscript, Q as BatchStartedEvent, U as TreeSigningStartedEvent, X as TxTree, Y as TreeNoncesEvent, Z as BatchFinalizationEvent, _ as BatchFinalizedEvent, $ as BatchFailedEvent, a0 as TreeTxEvent, a1 as TreeSignatureEvent, k as SettlementEvent, b as WalletConfig, W as WalletRepository, C as ContractRepository, a2 as DescriptorProvider, f as IContractManager, a3 as IReadonlyWallet, a4 as ReadonlyIdentity, a5 as OnchainProvider, r as IndexerProvider, a6 as DelegateProvider, a7 as ReadonlyWalletConfig, B as IntentRepository, H as VirtualTxRepository, a8 as ExitCaptureMode, a9 as ExitDataSource, d as ActivityRegistry, aa as IReadonlyAssetManager, ab as ContractSyncState, ac as RecipientAddressContext, q as ArkProvider, ad as NetworkName, ae as ArkInfo, af as ArkAddress, c as WalletBalance, G as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, ag as ContractWithVtxos, ah as selectPendingRecoveryOutpoints, A as ArkTransaction, e as Activity, E as ExtendedCoin, ai as Coin, w as ExtendedVirtualCoin, aj as ContractManager, ak as ContractManagerConfig, I as IWallet, a as Identity, g as GetNewAddressesOptions, h as NewAddress, al as SettlementConfig, m as IAssetManager, am as VtxoManager, i as IDelegateManager, S as SendBitcoinParams, j as SettleParams, R as Recipient, an as SignerSession, ao as SignedIntent, ap as Intent, l as SendParams, aq as TimeHeight } from './index-Bxz3cKPA.cjs';
+import { s as RelativeTimelock, M as Network, P as CSVMultisigTapscript, Q as BatchStartedEvent, U as TreeSigningStartedEvent, X as TxTree, Y as TreeNoncesEvent, Z as BatchFinalizationEvent, _ as BatchFinalizedEvent, $ as BatchFailedEvent, a0 as TreeTxEvent, a1 as TreeSignatureEvent, k as SettlementEvent, b as WalletConfig, W as WalletRepository, C as ContractRepository, a2 as DescriptorProvider, f as IContractManager, a3 as IReadonlyWallet, a4 as ReadonlyIdentity, a5 as OnchainProvider, r as IndexerProvider, a6 as DelegateProvider, a7 as ReadonlyWalletConfig, B as IntentRepository, H as VirtualTxRepository, a8 as ExitCaptureMode, a9 as ExitDataSource, d as ActivityRegistry, aa as IReadonlyAssetManager, ab as ContractSyncState, ac as RecipientAddressContext, q as ArkProvider, ad as NetworkName, ae as ArkInfo, af as ArkAddress, c as WalletBalance, G as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, ag as ContractWithVtxos, ah as selectPendingRecoveryOutpoints, A as ArkTransaction, e as Activity, E as ExtendedCoin, ai as Coin, w as ExtendedVirtualCoin, aj as ContractManager, ak as ContractManagerConfig, I as IWallet, a as Identity, g as GetNewAddressesOptions, h as NewAddress, al as SettlementConfig, m as IAssetManager, am as VtxoManager, i as IDelegateManager, S as SendBitcoinParams, j as SettleParams, R as Recipient, an as SignerSession, ao as SignedIntent, ap as Intent, l as SendParams, aq as TimeHeight } from './index-B_RYn9rg.cjs';
 import { Transaction } from '@scure/btc-signer';
 import { TransactionOutput } from '@scure/btc-signer/psbt.js';
 import { Bytes } from '@scure/btc-signer/utils.js';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-6N0DKdnG.cjs';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-CR7msIXK.cjs';
 
 /** Wall-clock floor for `batchExpiry` outside regtest. */
 declare const DEFAULT_MIN_BATCH_EXPIRY_SECONDS = 86400n;
@@ -1759,15 +1759,7 @@ declare class Wallet extends ReadonlyWallet implements IWallet, HDWalletCapable,
      * fields already written by the event reducer (state-event ordering).
      */
     private persistIntentSnapshot;
-    /**
-     * @internal Sign an on-chain boarding exit / sweep transaction, routing
-     * each input to the correct key by its `witnessUtxo.script`: the identity
-     * for index-0 / static boarding, the per-index descriptor for a rotated
-     * boarding UTXO (plan §6-III.3). Used by
-     * {@link VtxoManager.sweepExpiredBoardingUtxos}; without it, the
-     * unilateral exit of a rotated boarding UTXO would be signed with the
-     * wrong (index-0) key and rejected.
-     */
+    signInputsByWitnessScript(tx: Transaction): Promise<Transaction>;
     signOnchainBoardingTx(tx: Transaction): Promise<Transaction>;
     safeRegisterIntent(intent: SignedIntent<Intent.RegisterMessage>, inputs: ExtendedCoin[]): Promise<string>;
     makeRegisterIntentSignature(coins: ExtendedCoin[], outputs: TransactionOutput[], onchainOutputsIndexes: number[], cosignerPubKeys: string[], validAt?: number): Promise<SignedIntent<Intent.RegisterMessage>>;

package/dist/{index-BVqlZJwW.d.cts → index-4NF3srcg.d.cts}

@@ -1,5 +1,5 @@
-import { bh as ContractHandler, s as RelativeTimelock, bu as Discoverable, V as VtxoScript, t as TapLeafScript, d8 as TapscriptDeriving } from './index-Bxz3cKPA.cjs';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-6N0DKdnG.cjs';
+import { bh as ContractHandler, s as RelativeTimelock, bu as Discoverable, V as VtxoScript, t as TapLeafScript, d8 as TapscriptDeriving } from './index-B_RYn9rg.cjs';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-CR7msIXK.cjs';
 import { Bytes } from '@scure/btc-signer/utils.js';
 
 /**

package/dist/{index-Bxz3cKPA.d.ts → index-B_RYn9rg.d.cts}

@@ -4060,6 +4060,8 @@ type CreateContractParams = Omit<Contract, "createdAt" | "state"> & {
 declare class ContractManager implements IContractManager {
     private config;
     private watcher;
+    /** Per-sync tapscript caches start empty; this outlives them. Consumers only ever see clones. */
+    private readonly tapscriptMemo;
     private initialized;
     private eventCallbacks;
     private stopWatcherFn?;
@@ -4107,6 +4109,15 @@ declare class ContractManager implements IContractManager {
     /** @see ContractManagerConfig.vtxoSyncMaxAgeMs — for factory-built managers. */
     setVtxoSyncMaxAge(maxAgeMs: number): void;
     private markSyncOnline;
+    /**
+     * Why a sync that just succeeded still has not covered everything it should
+     * have. Both reasons outlive the sync that failed to cover them, so neither
+     * is discharged by the next one succeeding — which is the point: a wallet
+     * that reported itself current while the look-ahead band sat behind the
+     * watermark, or while a contract could not be annotated, would be claiming
+     * coverage it never had. `getSyncState()` is the channel apps already watch.
+     */
+    private syncGapReason;
     /** Contracts a sync could not annotate, as `script → reason`. */
     private annotationFailures;
     private annotationDegradedReason;
@@ -4926,6 +4937,7 @@ interface DerivedContractTapscripts {
  * doesn't expose the legacy `forfeit()` method (e.g. program-compiled arkade
  * contracts, where the right leaf depends on the program) implement this so
  * the annotation pipeline stays type-agnostic.
+ * Must be pure in `(contract.type, contract.script, contract.params)`: `ContractManager` memoizes the result for its lifetime.
  */
 interface TapscriptDeriving<S extends VtxoScript = VtxoScript> {
     deriveTapscripts(script: S, contract: Contract): DerivedContractTapscripts;
@@ -5645,6 +5657,7 @@ interface WalletBalance {
      * Immediately spendable offchain balance — what generic selection would
      * pick, so nothing counted here can be refused by `send`:
      * `settled + preconfirmed - gated - intentLocked`.
+     * A dust carrier is reserved if any assets are held on outputs comprising this balance.
      */
     available: number;
     /**

package/dist/{index-Bxz3cKPA.d.cts → index-B_RYn9rg.d.ts}

@@ -4060,6 +4060,8 @@ type CreateContractParams = Omit<Contract, "createdAt" | "state"> & {
 declare class ContractManager implements IContractManager {
     private config;
     private watcher;
+    /** Per-sync tapscript caches start empty; this outlives them. Consumers only ever see clones. */
+    private readonly tapscriptMemo;
     private initialized;
     private eventCallbacks;
     private stopWatcherFn?;
@@ -4107,6 +4109,15 @@ declare class ContractManager implements IContractManager {
     /** @see ContractManagerConfig.vtxoSyncMaxAgeMs — for factory-built managers. */
     setVtxoSyncMaxAge(maxAgeMs: number): void;
     private markSyncOnline;
+    /**
+     * Why a sync that just succeeded still has not covered everything it should
+     * have. Both reasons outlive the sync that failed to cover them, so neither
+     * is discharged by the next one succeeding — which is the point: a wallet
+     * that reported itself current while the look-ahead band sat behind the
+     * watermark, or while a contract could not be annotated, would be claiming
+     * coverage it never had. `getSyncState()` is the channel apps already watch.
+     */
+    private syncGapReason;
     /** Contracts a sync could not annotate, as `script → reason`. */
     private annotationFailures;
     private annotationDegradedReason;
@@ -4926,6 +4937,7 @@ interface DerivedContractTapscripts {
  * doesn't expose the legacy `forfeit()` method (e.g. program-compiled arkade
  * contracts, where the right leaf depends on the program) implement this so
  * the annotation pipeline stays type-agnostic.
+ * Must be pure in `(contract.type, contract.script, contract.params)`: `ContractManager` memoizes the result for its lifetime.
  */
 interface TapscriptDeriving<S extends VtxoScript = VtxoScript> {
     deriveTapscripts(script: S, contract: Contract): DerivedContractTapscripts;
@@ -5645,6 +5657,7 @@ interface WalletBalance {
      * Immediately spendable offchain balance — what generic selection would
      * pick, so nothing counted here can be refused by `send`:
      * `settled + preconfirmed - gated - intentLocked`.
+     * A dust carrier is reserved if any assets are held on outputs comprising this balance.
      */
     available: number;
     /**

package/dist/{index-CKQQ1oOg.d.ts → index-Dj2yOhQ2.d.ts}

@@ -1,5 +1,5 @@
-import { bh as ContractHandler, s as RelativeTimelock, bu as Discoverable, V as VtxoScript, t as TapLeafScript, d8 as TapscriptDeriving } from './index-Bxz3cKPA.js';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-z6veQfLI.js';
+import { bh as ContractHandler, s as RelativeTimelock, bu as Discoverable, V as VtxoScript, t as TapLeafScript, d8 as TapscriptDeriving } from './index-B_RYn9rg.js';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-BAYpqkEx.js';
 import { Bytes } from '@scure/btc-signer/utils.js';
 
 /**