@arkade-os/sdk 0.4.71 → 0.4.72

package/dist/contracts/handlers/index.cjs

@@ -1,38 +1,38 @@
 'use strict';
 
-var chunkP6EXRY5L_cjs = require('../../chunk-P6EXRY5L.cjs');
-require('../../chunk-5J5PDZRR.cjs');
+var chunkNPM5YZBC_cjs = require('../../chunk-NPM5YZBC.cjs');
+require('../../chunk-6FTHFJAN.cjs');
 require('../../chunk-5BLDMQED.cjs');
 
 
 
 Object.defineProperty(exports, "ArkadeContractHandler", {
   enumerable: true,
-  get: function () { return chunkP6EXRY5L_cjs.ArkadeContractHandler; }
+  get: function () { return chunkNPM5YZBC_cjs.ArkadeContractHandler; }
 });
 Object.defineProperty(exports, "BoardingContractHandler", {
   enumerable: true,
-  get: function () { return chunkP6EXRY5L_cjs.BoardingContractHandler; }
+  get: function () { return chunkNPM5YZBC_cjs.BoardingContractHandler; }
 });
 Object.defineProperty(exports, "DefaultContractHandler", {
   enumerable: true,
-  get: function () { return chunkP6EXRY5L_cjs.DefaultContractHandler; }
+  get: function () { return chunkNPM5YZBC_cjs.DefaultContractHandler; }
 });
 Object.defineProperty(exports, "DelegateContractHandler", {
   enumerable: true,
-  get: function () { return chunkP6EXRY5L_cjs.DelegateContractHandler; }
+  get: function () { return chunkNPM5YZBC_cjs.DelegateContractHandler; }
 });
 Object.defineProperty(exports, "VHTLCContractHandler", {
   enumerable: true,
-  get: function () { return chunkP6EXRY5L_cjs.VHTLCContractHandler; }
+  get: function () { return chunkNPM5YZBC_cjs.VHTLCContractHandler; }
 });
 Object.defineProperty(exports, "VHTLCV2ContractHandler", {
   enumerable: true,
-  get: function () { return chunkP6EXRY5L_cjs.VHTLCV2ContractHandler; }
+  get: function () { return chunkNPM5YZBC_cjs.VHTLCV2ContractHandler; }
 });
 Object.defineProperty(exports, "contractHandlers", {
   enumerable: true,
-  get: function () { return chunkP6EXRY5L_cjs.contractHandlers; }
+  get: function () { return chunkNPM5YZBC_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-BE1uFXrV.cjs';
-import '../../index-CyGnhCSS.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-DSbDm0Io.cjs';
+import '../../index-Dg0-TvBQ.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-D-gEEqrP.cjs';
+import '../../delegate-BJp8f6LT.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-Boppyqav.js';
-import '../../index-CyGnhCSS.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-B8xrELXY.js';
+import '../../index-Dg0-TvBQ.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-CKJdsC99.js';
+import '../../delegate-Ckz_TWzM.js';

package/dist/contracts/handlers/index.js

@@ -1,5 +1,5 @@
-export { ArkadeContractHandler, BoardingContractHandler, DefaultContractHandler, DelegateContractHandler, VHTLCContractHandler, VHTLCV2ContractHandler, contractHandlers } from '../../chunk-ALZ2CZ3T.js';
-import '../../chunk-2ZX4Z2IP.js';
+export { ArkadeContractHandler, BoardingContractHandler, DefaultContractHandler, DelegateContractHandler, VHTLCContractHandler, VHTLCV2ContractHandler, contractHandlers } from '../../chunk-CB6QPAO5.js';
+import '../../chunk-5GQFYVWP.js';
 import '../../chunk-NSBPE2FW.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{delegate-D-gEEqrP.d.cts → delegate-BJp8f6LT.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-CyGnhCSS.cjs';
+import { s as RelativeTimelock, V as VtxoScript, t as TapLeafScript } from './index-Dg0-TvBQ.cjs';
 
 /**
  * DefaultVtxo is the default implementation of a VtxoScript.

package/dist/{delegate-CKJdsC99.d.ts → delegate-Ckz_TWzM.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-CyGnhCSS.js';
+import { s as RelativeTimelock, V as VtxoScript, t as TapLeafScript } from './index-Dg0-TvBQ.js';
 
 /**
  * DefaultVtxo is the default implementation of a VtxoScript.

package/dist/{hdWalletCapable-CwLPmWct.d.cts → hdWalletCapable-DA9bJ5eB.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-CyGnhCSS.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-Dg0-TvBQ.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-D-gEEqrP.cjs';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-BJp8f6LT.cjs';
 
 /** Wall-clock floor for `batchExpiry` outside regtest. */
 declare const DEFAULT_MIN_BATCH_EXPIRY_SECONDS = 86400n;

package/dist/{hdWalletCapable-BJ4pvkai.d.ts → hdWalletCapable-DABgAD-T.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-CyGnhCSS.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-Dg0-TvBQ.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-CKJdsC99.js';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-Ckz_TWzM.js';
 
 /** Wall-clock floor for `batchExpiry` outside regtest. */
 declare const DEFAULT_MIN_BATCH_EXPIRY_SECONDS = 86400n;

package/dist/{index-Boppyqav.d.ts → index-B8xrELXY.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-CyGnhCSS.js';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-CKJdsC99.js';
+import { bh as ContractHandler, s as RelativeTimelock, bu as Discoverable, V as VtxoScript, t as TapLeafScript, d8 as TapscriptDeriving } from './index-Dg0-TvBQ.js';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-Ckz_TWzM.js';
 import { Bytes } from '@scure/btc-signer/utils.js';
 
 /**

package/dist/{index-BE1uFXrV.d.cts → index-DSbDm0Io.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-CyGnhCSS.cjs';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-D-gEEqrP.cjs';
+import { bh as ContractHandler, s as RelativeTimelock, bu as Discoverable, V as VtxoScript, t as TapLeafScript, d8 as TapscriptDeriving } from './index-Dg0-TvBQ.cjs';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-BJp8f6LT.cjs';
 import { Bytes } from '@scure/btc-signer/utils.js';
 
 /**

package/dist/{index-CyGnhCSS.d.ts → index-Dg0-TvBQ.d.cts}

@@ -566,6 +566,8 @@ declare class RestIndexerProvider implements IndexerProvider {
     serverUrl: string;
     /** Overrides {@link configureEventSource} for this provider's subscription. */
     protected readonly eventSource?: EventSourceFactory;
+    /** @see fetchVtxosJson */
+    private readonly inFlightVtxoReads;
     constructor(serverUrl?: string, options?: EventSourceCapable);
     getVtxoTree(batchOutpoint: Outpoint, opts?: PaginationOptions): Promise<{
         vtxoTree: Tx[];
@@ -603,6 +605,17 @@ declare class RestIndexerProvider implements IndexerProvider {
      * politeness through the rate gate, so don't add a redundant sleep.
      */
     private fetchVtxosPage;
+    /**
+     * The wire read behind {@link fetchVtxosPage}, with an identical read
+     * already in flight served from that one request instead of repeated.
+     *
+     * Two callers can want the same page at the same instant without either
+     * being redundant, so there is no single call site to remove: a send that
+     * leaves change makes the indexer emit `vtxo_spent` and `vtxo_received` for
+     * the wallet's own contract milliseconds apart, and `handleContractEvent`
+     * delta-syncs that contract on both arms.
+     */
+    private fetchVtxosJson;
     getAssetDetails(assetId: string): Promise<AssetDetails>;
     subscribeForScripts(scripts: string[], subscriptionId?: string): Promise<string>;
     unsubscribeForScripts(subscriptionId: string, scripts?: string[]): Promise<void>;
@@ -3611,6 +3624,12 @@ interface IContractManager extends Disposable {
      * The contract script is used as the unique identifier.
      */
     createContract(params: CreateContractParams): Promise<Contract>;
+    /**
+     * {@link createContract} for a set, one indexer round trip instead of N.
+     * Optional so adding it breaks no implementer of this public interface
+     * (`serviceWorker/wallet.ts` proxies each method over wire): fall back.
+     */
+    createContracts?(paramsList: CreateContractParams[]): Promise<Contract[]>;
     /**
      * List contracts with optional filters.
      *
@@ -3941,6 +3960,14 @@ interface ContractManagerConfig {
         height: number;
         time: number;
     } | undefined>;
+    /**
+     * How stale {@link ContractManager.getContractsWithVtxos} may let its
+     * opportunistic sync be before repeating it. `0` (default) repeats it every
+     * call. A send syncs, selects, then submits, so its coins are already one
+     * submit latency stale; this widens that bound by this value, and is
+     * therefore a budget rather than a free saving.
+     */
+    vtxoSyncMaxAgeMs?: number;
 }
 /**
  * Wallet-injected surface backing the HD look-ahead window. Kept as a
@@ -4034,6 +4061,7 @@ declare class ContractManager implements IContractManager {
     private syncDegradedReason?;
     /** Epoch-ms of the last successful provider sync, if any. */
     private lastSyncedAt?;
+    private syncedAtByScript;
     /** Last chain tip read, with the epoch-ms it was read at. @see currentChainTip */
     private chainTipCache?;
     /** In-flight chain tip read, so concurrent cache misses share one. */
@@ -4070,6 +4098,8 @@ declare class ContractManager implements IContractManager {
      * sync. Purely a freshness signal — not a source of truth for wallet data.
      */
     getSyncState(): ContractSyncState;
+    /** @see ContractManagerConfig.vtxoSyncMaxAgeMs — for factory-built managers. */
+    setVtxoSyncMaxAge(maxAgeMs: number): void;
     private markSyncOnline;
     /** Contracts a sync could not annotate, as `script → reason`. */
     private annotationFailures;
@@ -4179,6 +4209,13 @@ declare class ContractManager implements IContractManager {
      * @returns The created contract
      */
     createContract(params: CreateContractParams): Promise<Contract>;
+    /**
+     * `createContract`'s step order, fetch batched: persist all, hydrate once,
+     * then watch. Hydrating first keeps it equivalent — the watcher seeds from
+     * the repository, so an unhydrated row reads as all-new. A part-way failure
+     * still watches what it wrote; a retry reports those rows as existing.
+     */
+    createContracts(paramsList: CreateContractParams[]): Promise<Contract[]>;
     /**
      * Lightweight variant of {@link createContract} for batch discovery
      * paths (currently: {@link scanContracts}). Validates, dedupes, persists,
@@ -4406,6 +4443,7 @@ declare class ContractManager implements IContractManager {
      * other contracts still need to pick up.
      */
     private syncContracts;
+    private syncedWithin;
     /**
      * Demote every `awaiting-funds` contract in `contracts` that has been
      * funded — the automatic half of {@link ContractWatchState}.
@@ -6047,13 +6085,23 @@ interface TxKey {
     /** Arkade transaction id, when applicable. */
     arkTxid: string;
 }
-/** The categories the history builder itself assigns. */
-type BuiltinTxTag = "offchain" | "boarding" | "exit" | "batch";
+/**
+ * The categories the history builder itself assigns.
+ *
+ * Four of them name the mechanism that moved the coin. `"gated"` names the
+ * counterparty instead: an offchain row facing a contract row of this wallet's
+ * that generic spending is closed on — a swap covenant, a lockup — which is the
+ * same money {@link WalletBalance.gated} reports. History reads such a contract
+ * as an external party, so the movement is a real send or receive rather than
+ * change, and the tag is what lets a consumer tell "into my own escrow" from
+ * "to a stranger" instead of the movement arriving unattributed.
+ */
+type BuiltinTxTag = "offchain" | "boarding" | "exit" | "batch" | "gated";
 /**
  * The category the history builder assigns to a transaction. The `(string & {})`
  * arm keeps the union open — apps and resolvers can introduce their own
  * categories without a breaking change — while preserving editor autocomplete
- * for the built-in four.
+ * for the built-in ones.
  */
 type TxTag = BuiltinTxTag | (string & {});
 /**

package/dist/{index-CyGnhCSS.d.cts → index-Dg0-TvBQ.d.ts}

@@ -566,6 +566,8 @@ declare class RestIndexerProvider implements IndexerProvider {
     serverUrl: string;
     /** Overrides {@link configureEventSource} for this provider's subscription. */
     protected readonly eventSource?: EventSourceFactory;
+    /** @see fetchVtxosJson */
+    private readonly inFlightVtxoReads;
     constructor(serverUrl?: string, options?: EventSourceCapable);
     getVtxoTree(batchOutpoint: Outpoint, opts?: PaginationOptions): Promise<{
         vtxoTree: Tx[];
@@ -603,6 +605,17 @@ declare class RestIndexerProvider implements IndexerProvider {
      * politeness through the rate gate, so don't add a redundant sleep.
      */
     private fetchVtxosPage;
+    /**
+     * The wire read behind {@link fetchVtxosPage}, with an identical read
+     * already in flight served from that one request instead of repeated.
+     *
+     * Two callers can want the same page at the same instant without either
+     * being redundant, so there is no single call site to remove: a send that
+     * leaves change makes the indexer emit `vtxo_spent` and `vtxo_received` for
+     * the wallet's own contract milliseconds apart, and `handleContractEvent`
+     * delta-syncs that contract on both arms.
+     */
+    private fetchVtxosJson;
     getAssetDetails(assetId: string): Promise<AssetDetails>;
     subscribeForScripts(scripts: string[], subscriptionId?: string): Promise<string>;
     unsubscribeForScripts(subscriptionId: string, scripts?: string[]): Promise<void>;
@@ -3611,6 +3624,12 @@ interface IContractManager extends Disposable {
      * The contract script is used as the unique identifier.
      */
     createContract(params: CreateContractParams): Promise<Contract>;
+    /**
+     * {@link createContract} for a set, one indexer round trip instead of N.
+     * Optional so adding it breaks no implementer of this public interface
+     * (`serviceWorker/wallet.ts` proxies each method over wire): fall back.
+     */
+    createContracts?(paramsList: CreateContractParams[]): Promise<Contract[]>;
     /**
      * List contracts with optional filters.
      *
@@ -3941,6 +3960,14 @@ interface ContractManagerConfig {
         height: number;
         time: number;
     } | undefined>;
+    /**
+     * How stale {@link ContractManager.getContractsWithVtxos} may let its
+     * opportunistic sync be before repeating it. `0` (default) repeats it every
+     * call. A send syncs, selects, then submits, so its coins are already one
+     * submit latency stale; this widens that bound by this value, and is
+     * therefore a budget rather than a free saving.
+     */
+    vtxoSyncMaxAgeMs?: number;
 }
 /**
  * Wallet-injected surface backing the HD look-ahead window. Kept as a
@@ -4034,6 +4061,7 @@ declare class ContractManager implements IContractManager {
     private syncDegradedReason?;
     /** Epoch-ms of the last successful provider sync, if any. */
     private lastSyncedAt?;
+    private syncedAtByScript;
     /** Last chain tip read, with the epoch-ms it was read at. @see currentChainTip */
     private chainTipCache?;
     /** In-flight chain tip read, so concurrent cache misses share one. */
@@ -4070,6 +4098,8 @@ declare class ContractManager implements IContractManager {
      * sync. Purely a freshness signal — not a source of truth for wallet data.
      */
     getSyncState(): ContractSyncState;
+    /** @see ContractManagerConfig.vtxoSyncMaxAgeMs — for factory-built managers. */
+    setVtxoSyncMaxAge(maxAgeMs: number): void;
     private markSyncOnline;
     /** Contracts a sync could not annotate, as `script → reason`. */
     private annotationFailures;
@@ -4179,6 +4209,13 @@ declare class ContractManager implements IContractManager {
      * @returns The created contract
      */
     createContract(params: CreateContractParams): Promise<Contract>;
+    /**
+     * `createContract`'s step order, fetch batched: persist all, hydrate once,
+     * then watch. Hydrating first keeps it equivalent — the watcher seeds from
+     * the repository, so an unhydrated row reads as all-new. A part-way failure
+     * still watches what it wrote; a retry reports those rows as existing.
+     */
+    createContracts(paramsList: CreateContractParams[]): Promise<Contract[]>;
     /**
      * Lightweight variant of {@link createContract} for batch discovery
      * paths (currently: {@link scanContracts}). Validates, dedupes, persists,
@@ -4406,6 +4443,7 @@ declare class ContractManager implements IContractManager {
      * other contracts still need to pick up.
      */
     private syncContracts;
+    private syncedWithin;
     /**
      * Demote every `awaiting-funds` contract in `contracts` that has been
      * funded — the automatic half of {@link ContractWatchState}.
@@ -6047,13 +6085,23 @@ interface TxKey {
     /** Arkade transaction id, when applicable. */
     arkTxid: string;
 }
-/** The categories the history builder itself assigns. */
-type BuiltinTxTag = "offchain" | "boarding" | "exit" | "batch";
+/**
+ * The categories the history builder itself assigns.
+ *
+ * Four of them name the mechanism that moved the coin. `"gated"` names the
+ * counterparty instead: an offchain row facing a contract row of this wallet's
+ * that generic spending is closed on — a swap covenant, a lockup — which is the
+ * same money {@link WalletBalance.gated} reports. History reads such a contract
+ * as an external party, so the movement is a real send or receive rather than
+ * change, and the tag is what lets a consumer tell "into my own escrow" from
+ * "to a stranger" instead of the movement arriving unattributed.
+ */
+type BuiltinTxTag = "offchain" | "boarding" | "exit" | "batch" | "gated";
 /**
  * The category the history builder assigns to a transaction. The `(string & {})`
  * arm keeps the union open — apps and resolvers can introduce their own
  * categories without a breaking change — while preserving editor autocomplete
- * for the built-in four.
+ * for the built-in ones.
  */
 type TxTag = BuiltinTxTag | (string & {});
 /**