@arkade-os/sdk 0.4.71 → 0.4.73

package/dist/{chunk-I7ZNWBBU.cjs → chunk-ZLDO4QDR.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkFM263GKH_cjs = require('./chunk-FM263GKH.cjs');
-var chunk5J5PDZRR_cjs = require('./chunk-5J5PDZRR.cjs');
+var chunkD5DLGVN4_cjs = require('./chunk-D5DLGVN4.cjs');
+var chunkKJ5E646Y_cjs = require('./chunk-KJ5E646Y.cjs');
 
 // src/providers/expoUtils.ts
 async function getExpoFetch(options) {
@@ -10,8 +10,8 @@ async function getExpoFetch(options) {
     console.debug("Using expo/fetch for streaming");
     const expoFetchWithHeader = (input, init) => {
       const headers = new Headers(init?.headers);
-      headers.set("X-Build-Version", chunk5J5PDZRR_cjs.buildVersion);
-      headers.set("X-SDK-VERSION", chunk5J5PDZRR_cjs.sdkVersion);
+      headers.set("X-Build-Version", chunkKJ5E646Y_cjs.buildVersion);
+      headers.set("X-SDK-VERSION", chunkKJ5E646Y_cjs.sdkVersion);
       return expoFetchModule.fetch(input, { ...init, headers });
     };
     return expoFetchWithHeader;
@@ -20,7 +20,7 @@ async function getExpoFetch(options) {
       "Using standard fetch instead of expo/fetch. Streaming may not be fully supported in some environments.",
       error
     );
-    return chunk5J5PDZRR_cjs.fetch;
+    return chunkKJ5E646Y_cjs.fetch;
   }
 }
 async function* sseStreamIterator(url, abortSignal, fetchFn, headers, parseData) {
@@ -33,6 +33,10 @@ async function* sseStreamIterator(url, abortSignal, fetchFn, headers, parseData)
         Accept: "text/event-stream",
         ...headers
       },
+      // Required, not just for cancellation: `getExpoFetch` falls back to
+      // the Ark `fetch` wrapper, which routes through `baseFetch` and so
+      // bounds any read that brings no signal of its own. Drop this and
+      // the stream is truncated at READ_TIMEOUT_MS.
       signal: fetchController.signal
     });
     if (!response.ok) {
@@ -77,8 +81,8 @@ async function* sseStreamIterator(url, abortSignal, fetchFn, headers, parseData)
 }
 
 // src/providers/expoArk.ts
-var ExpoArkProvider = class extends chunk5J5PDZRR_cjs.RestArkProvider {
-  constructor(serverUrl = chunk5J5PDZRR_cjs.DEFAULT_ARKADE_SERVER_URL) {
+var ExpoArkProvider = class extends chunkKJ5E646Y_cjs.RestArkProvider {
+  constructor(serverUrl = chunkKJ5E646Y_cjs.DEFAULT_ARKADE_SERVER_URL) {
     super(serverUrl);
   }
   async *getEventStream(signal, topics) {
@@ -98,7 +102,7 @@ var ExpoArkProvider = class extends chunk5J5PDZRR_cjs.RestArkProvider {
         if (error instanceof Error && error.name === "AbortError") {
           break;
         }
-        if (chunk5J5PDZRR_cjs.isFetchTimeoutError(error)) {
+        if (chunkKJ5E646Y_cjs.isFetchTimeoutError(error)) {
           console.debug("Timeout error ignored");
           continue;
         }
@@ -119,7 +123,7 @@ var ExpoArkProvider = class extends chunk5J5PDZRR_cjs.RestArkProvider {
         if (error instanceof Error && error.name === "AbortError") {
           break;
         }
-        if (chunk5J5PDZRR_cjs.isFetchTimeoutError(error)) {
+        if (chunkKJ5E646Y_cjs.isFetchTimeoutError(error)) {
           console.debug("Timeout error ignored");
           continue;
         }
@@ -131,8 +135,8 @@ var ExpoArkProvider = class extends chunk5J5PDZRR_cjs.RestArkProvider {
 };
 
 // src/providers/expoIndexer.ts
-var ExpoIndexerProvider = class extends chunkFM263GKH_cjs.RestIndexerProvider {
-  constructor(serverUrl = chunk5J5PDZRR_cjs.DEFAULT_ARKADE_SERVER_URL) {
+var ExpoIndexerProvider = class extends chunkD5DLGVN4_cjs.RestIndexerProvider {
+  constructor(serverUrl = chunkKJ5E646Y_cjs.DEFAULT_ARKADE_SERVER_URL) {
     super(serverUrl);
   }
   async *getSubscription(subscriptionId, abortSignal) {
@@ -161,9 +165,9 @@ var ExpoIndexerProvider = class extends chunkFM263GKH_cjs.RestIndexerProvider {
               return {
                 txid: data.event.txid,
                 scripts: data.event.scripts || [],
-                newVtxos: (data.event.newVtxos || []).map(chunk5J5PDZRR_cjs.convertVtxo),
-                spentVtxos: (data.event.spentVtxos || []).map(chunk5J5PDZRR_cjs.convertVtxo),
-                sweptVtxos: (data.event.sweptVtxos || []).map(chunk5J5PDZRR_cjs.convertVtxo),
+                newVtxos: (data.event.newVtxos || []).map(chunkKJ5E646Y_cjs.convertVtxo),
+                spentVtxos: (data.event.spentVtxos || []).map(chunkKJ5E646Y_cjs.convertVtxo),
+                sweptVtxos: (data.event.sweptVtxos || []).map(chunkKJ5E646Y_cjs.convertVtxo),
                 tx: data.event.tx,
                 checkpointTxs: data.event.checkpointTxs
               };
@@ -175,7 +179,7 @@ var ExpoIndexerProvider = class extends chunkFM263GKH_cjs.RestIndexerProvider {
         if (error instanceof Error && error.name === "AbortError") {
           break;
         }
-        if (chunk5J5PDZRR_cjs.isFetchTimeoutError(error)) {
+        if (chunkKJ5E646Y_cjs.isFetchTimeoutError(error)) {
           console.debug("Timeout error ignored");
           continue;
         }
@@ -188,5 +192,5 @@ var ExpoIndexerProvider = class extends chunkFM263GKH_cjs.RestIndexerProvider {
 
 exports.ExpoArkProvider = ExpoArkProvider;
 exports.ExpoIndexerProvider = ExpoIndexerProvider;
-//# sourceMappingURL=chunk-I7ZNWBBU.cjs.map
-//# sourceMappingURL=chunk-I7ZNWBBU.cjs.map
+//# sourceMappingURL=chunk-ZLDO4QDR.cjs.map
+//# sourceMappingURL=chunk-ZLDO4QDR.cjs.map

package/dist/chunk-ZLDO4QDR.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/providers/expoUtils.ts","../src/providers/expoArk.ts","../src/providers/expoIndexer.ts"],"names":["buildVersion","sdkVersion","fetch","RestArkProvider","DEFAULT_ARKADE_SERVER_URL","isFetchTimeoutError","RestIndexerProvider","convertVtxo"],"mappings":"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","file":"chunk-ZLDO4QDR.cjs","sourcesContent":["import { fetch, buildVersion, sdkVersion } from \"../utils/fetch\";\n\n/**\n * Dynamically imports expo/fetch with fallback to standard fetch.\n * @returns A fetch function suitable for SSE streaming\n */\nexport async function getExpoFetch(options?: { requireExpo?: boolean }): Promise<typeof fetch> {\n    const requireExpo = options?.requireExpo ?? false;\n\n    try {\n        const expoFetchModule = await import(\"expo/fetch\");\n        console.debug(\"Using expo/fetch for streaming\");\n        const expoFetchWithHeader = (input: RequestInfo, init?: RequestInit) => {\n            const headers = new Headers(init?.headers);\n            headers.set(\"X-Build-Version\", buildVersion);\n            headers.set(\"X-SDK-VERSION\", sdkVersion);\n            return expoFetchModule.fetch(input, { ...init, headers });\n        };\n        return expoFetchWithHeader as unknown as typeof fetch;\n    } catch (error) {\n        if (requireExpo) {\n            throw new Error(\n                \"expo/fetch is unavailable in this environment. \" +\n                    \"Please ensure expo/fetch is installed and properly configured.\",\n            );\n        }\n\n        console.warn(\n            \"Using standard fetch instead of expo/fetch. \" +\n                \"Streaming may not be fully supported in some environments.\",\n            error,\n        );\n        return fetch;\n    }\n}\n\n/**\n * Generic SSE stream processor using fetch API with ReadableStream.\n * Handles SSE format parsing, buffer management, and abort signals.\n *\n * @param url - The SSE endpoint URL\n * @param abortSignal - Signal to abort the stream\n * @param fetchFn - Fetch function to use (defaults to standard fetch)\n * @param headers - Additional headers to send\n * @param parseData - Function to parse and yield data from SSE events\n */\nexport async function* sseStreamIterator<T>(\n    url: string,\n    abortSignal: AbortSignal,\n    fetchFn: typeof fetch,\n    headers: Record<string, string>,\n    parseData: (data: any) => T | null,\n): AsyncGenerator<T, void, unknown> {\n    const fetchController = new AbortController();\n    const cleanup = () => fetchController.abort();\n    abortSignal?.addEventListener(\"abort\", cleanup, { once: true });\n\n    try {\n        const response = await fetchFn(url, {\n            headers: {\n                Accept: \"text/event-stream\",\n                ...headers,\n            },\n            // Required, not just for cancellation: `getExpoFetch` falls back to\n            // the Ark `fetch` wrapper, which routes through `baseFetch` and so\n            // bounds any read that brings no signal of its own. Drop this and\n            // the stream is truncated at READ_TIMEOUT_MS.\n            signal: fetchController.signal,\n        });\n\n        if (!response.ok) {\n            throw new Error(`Unexpected status ${response.status} when fetching SSE stream`);\n        }\n\n        if (!response.body) {\n            throw new Error(\"Response body is null\");\n        }\n\n        const reader = response.body.getReader();\n        const decoder = new TextDecoder();\n        let buffer = \"\";\n\n        while (!abortSignal?.aborted) {\n            const { done, value } = await reader.read();\n            if (done) {\n                break;\n            }\n\n            buffer += decoder.decode(value, { stream: true });\n            const lines = buffer.split(\"\\n\");\n\n            for (let i = 0; i < lines.length - 1; i++) {\n                const line = lines[i].trim();\n                if (!line) continue;\n\n                if (line.startsWith(\"data:\")) {\n                    const jsonStr = line.substring(5).trim();\n                    if (!jsonStr) continue;\n\n                    try {\n                        const data = JSON.parse(jsonStr);\n                        const parsed = parseData(data);\n                        if (parsed !== null) {\n                            yield parsed;\n                        }\n                    } catch (parseError) {\n                        console.error(\"Failed to parse SSE data:\", parseError);\n                        throw parseError;\n                    }\n                }\n            }\n\n            buffer = lines[lines.length - 1];\n        }\n    } finally {\n        abortSignal?.removeEventListener(\"abort\", cleanup);\n    }\n}\n","import { DEFAULT_ARKADE_SERVER_URL } from \"../networks\";\nimport { RestArkProvider, SettlementEvent, TxNotificationEvent, isFetchTimeoutError } from \"./ark\";\nimport { getExpoFetch, sseStreamIterator } from \"./expoUtils\";\n\n/**\n * Expo-compatible Arkade provider implementation using expo/fetch for SSE support.\n * This provider works specifically in React Native/Expo environments where\n * standard EventSource is not available but expo/fetch provides SSE capabilities.\n *\n * @example\n * ```typescript\n * import { ExpoArkProvider } from '@arkade-os/sdk/providers/expo';\n *\n * const provider = new ExpoArkProvider('https://arkade.computer');\n * const info = await provider.getInfo();\n * ```\n */\nexport class ExpoArkProvider extends RestArkProvider {\n    constructor(serverUrl: string = DEFAULT_ARKADE_SERVER_URL) {\n        super(serverUrl);\n    }\n\n    override async *getEventStream(\n        signal: AbortSignal,\n        topics: string[],\n    ): AsyncIterableIterator<SettlementEvent> {\n        const expoFetch = await getExpoFetch();\n        const url = `${this.serverUrl}/v1/batch/events`;\n        const queryParams =\n            topics.length > 0\n                ? `?${topics.map((topic) => `topics=${encodeURIComponent(topic)}`).join(\"&\")}`\n                : \"\";\n\n        while (!signal?.aborted) {\n            try {\n                yield* sseStreamIterator(url + queryParams, signal, expoFetch, {}, (data) => {\n                    // Handle different response structures\n                    // v8 mesh API might wrap in {result: ...} or send directly\n                    const eventData = data.result || data;\n\n                    // Skip heartbeat messages\n                    if (eventData.heartbeat !== undefined) {\n                        return null;\n                    }\n\n                    return this.parseSettlementEvent(eventData);\n                });\n            } catch (error) {\n                if (error instanceof Error && error.name === \"AbortError\") {\n                    break;\n                }\n\n                // ignore timeout errors, they're expected when the server is not sending anything for 5 min\n                // these timeouts are set by expo/fetch function\n                if (isFetchTimeoutError(error)) {\n                    console.debug(\"Timeout error ignored\");\n                    continue;\n                }\n\n                console.error(\"Event stream error:\", error);\n                throw error;\n            }\n        }\n    }\n\n    override async *getTransactionsStream(\n        signal: AbortSignal,\n    ): AsyncIterableIterator<TxNotificationEvent> {\n        const expoFetch = await getExpoFetch();\n        const url = `${this.serverUrl}/v1/txs`;\n\n        while (!signal?.aborted) {\n            try {\n                yield* sseStreamIterator(url, signal, expoFetch, {}, (data) => {\n                    return this.parseTransactionNotification(data.result);\n                });\n            } catch (error) {\n                if (error instanceof Error && error.name === \"AbortError\") {\n                    break;\n                }\n\n                // ignore timeout errors, they're expected when the server is not sending anything for 5 min\n                // these timeouts are set by expo/fetch function\n                if (isFetchTimeoutError(error)) {\n                    console.debug(\"Timeout error ignored\");\n                    continue;\n                }\n\n                console.error(\"Transaction stream error:\", error);\n                throw error;\n            }\n        }\n    }\n}\n","import { RestIndexerProvider, SubscriptionResponse } from \"./indexer\";\nimport { isFetchTimeoutError } from \"./ark\";\nimport { convertVtxo } from \"../wallet/vtxo\";\nimport { getExpoFetch, sseStreamIterator } from \"./expoUtils\";\nimport { DEFAULT_ARKADE_SERVER_URL } from \"../networks\";\n\n/**\n * Expo-compatible Indexer provider implementation using expo/fetch for streaming support.\n * This provider works specifically in React Native/Expo environments where\n * standard fetch streaming may not work properly but expo/fetch provides streaming capabilities.\n *\n * @example\n * ```typescript\n * import { ExpoIndexerProvider } from '@arkade-os/sdk/adapters/expo';\n *\n * const provider = new ExpoIndexerProvider('https://indexer.example.com');\n * const vtxos = await provider.getVtxos({ scripts: ['script1'] });\n * ```\n */\nexport class ExpoIndexerProvider extends RestIndexerProvider {\n    constructor(serverUrl: string = DEFAULT_ARKADE_SERVER_URL) {\n        super(serverUrl);\n    }\n\n    override async *getSubscription(\n        subscriptionId: string,\n        abortSignal: AbortSignal,\n    ): AsyncIterableIterator<SubscriptionResponse> {\n        // Detect if we're running in React Native/Expo environment\n        const isReactNative =\n            typeof navigator !== \"undefined\" && navigator.product === \"ReactNative\";\n\n        const expoFetch = await getExpoFetch().catch((error) => {\n            // In React Native/Expo, expo/fetch is required for proper streaming support\n            if (isReactNative) {\n                throw new Error(\n                    \"expo/fetch is unavailable in React Native environment. \" +\n                        \"Please ensure expo/fetch is installed and properly configured. \" +\n                        \"Streaming support may not work with standard fetch in React Native.\",\n                );\n            }\n            throw error;\n        });\n\n        const url = `${this.serverUrl}/v1/indexer/script/subscription/${subscriptionId}`;\n\n        while (!abortSignal.aborted) {\n            try {\n                yield* sseStreamIterator(\n                    url,\n                    abortSignal,\n                    expoFetch,\n                    { \"Content-Type\": \"application/json\" },\n                    (data): SubscriptionResponse | null => {\n                        // Handle new v8 proto format with heartbeat or event\n                        if (data.heartbeat !== undefined) {\n                            // Skip heartbeat messages\n                            return null;\n                        }\n                        // Process event messages\n                        if (data.event) {\n                            return {\n                                txid: data.event.txid,\n                                scripts: data.event.scripts || [],\n                                newVtxos: (data.event.newVtxos || []).map(convertVtxo),\n                                spentVtxos: (data.event.spentVtxos || []).map(convertVtxo),\n                                sweptVtxos: (data.event.sweptVtxos || []).map(convertVtxo),\n                                tx: data.event.tx,\n                                checkpointTxs: data.event.checkpointTxs,\n                            };\n                        }\n                        return null;\n                    },\n                );\n            } catch (error) {\n                if (error instanceof Error && error.name === \"AbortError\") {\n                    break;\n                }\n\n                // ignore timeout errors, they're expected when the server is not sending anything for 5 min\n                // these timeouts are set by expo/fetch function\n                if (isFetchTimeoutError(error)) {\n                    console.debug(\"Timeout error ignored\");\n                    continue;\n                }\n\n                console.error(\"Subscription error:\", error);\n                throw error;\n            }\n        }\n    }\n}\n"]}

package/dist/contracts/handlers/index.cjs

@@ -1,38 +1,38 @@
 'use strict';
 
-var chunkP6EXRY5L_cjs = require('../../chunk-P6EXRY5L.cjs');
-require('../../chunk-5J5PDZRR.cjs');
+var chunk2D7F5IU3_cjs = require('../../chunk-2D7F5IU3.cjs');
+require('../../chunk-KJ5E646Y.cjs');
 require('../../chunk-5BLDMQED.cjs');
 
 
 
 Object.defineProperty(exports, "ArkadeContractHandler", {
   enumerable: true,
-  get: function () { return chunkP6EXRY5L_cjs.ArkadeContractHandler; }
+  get: function () { return chunk2D7F5IU3_cjs.ArkadeContractHandler; }
 });
 Object.defineProperty(exports, "BoardingContractHandler", {
   enumerable: true,
-  get: function () { return chunkP6EXRY5L_cjs.BoardingContractHandler; }
+  get: function () { return chunk2D7F5IU3_cjs.BoardingContractHandler; }
 });
 Object.defineProperty(exports, "DefaultContractHandler", {
   enumerable: true,
-  get: function () { return chunkP6EXRY5L_cjs.DefaultContractHandler; }
+  get: function () { return chunk2D7F5IU3_cjs.DefaultContractHandler; }
 });
 Object.defineProperty(exports, "DelegateContractHandler", {
   enumerable: true,
-  get: function () { return chunkP6EXRY5L_cjs.DelegateContractHandler; }
+  get: function () { return chunk2D7F5IU3_cjs.DelegateContractHandler; }
 });
 Object.defineProperty(exports, "VHTLCContractHandler", {
   enumerable: true,
-  get: function () { return chunkP6EXRY5L_cjs.VHTLCContractHandler; }
+  get: function () { return chunk2D7F5IU3_cjs.VHTLCContractHandler; }
 });
 Object.defineProperty(exports, "VHTLCV2ContractHandler", {
   enumerable: true,
-  get: function () { return chunkP6EXRY5L_cjs.VHTLCV2ContractHandler; }
+  get: function () { return chunk2D7F5IU3_cjs.VHTLCV2ContractHandler; }
 });
 Object.defineProperty(exports, "contractHandlers", {
   enumerable: true,
-  get: function () { return chunkP6EXRY5L_cjs.contractHandlers; }
+  get: function () { return chunk2D7F5IU3_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-G5RPUZJE.js';
+import '../../chunk-OV4GLPZI.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 & {});
 /**