@arkade-os/sdk 0.4.71 → 0.4.72

package/README.md

@@ -1396,6 +1396,35 @@ const swWallet = await ServiceWorkerWallet.setup({
 
 Raise it when the external issuer is expected to burn more than `N` consecutive addresses without any of them being paid — every index in such a run is a miss, and the funded one sits past the band. When that happens the funds are invisible until a `restore()` whose `gapLimit` is large enough to cross the run (`wallet.restore({ gapLimit: 200 })`); a default restore closes its gap window before reaching the funded index. Keep the value modest: the band adds up to `2N + 1` indices × the candidate matrix (typically 1-4 scripts each) to the wallet's subscription.
 
+#### Restoring plugin state
+
+`wallet.restore()` is the explicit imported-wallet recovery boundary. It first restores the
+wallet's own addresses, contracts, history, and balances, then runs every restore hook registered
+for that wallet instance. `Wallet` and `ServiceWorkerWallet` both follow this ordering, and
+concurrent calls coalesce until the hooks finish.
+
+```typescript
+import { registerWalletRestoreHook } from '@arkade-os/sdk'
+
+const unregister = registerWalletRestoreHook(wallet, {
+  id: 'my-plugin',
+  restore: async (restoredWallet) => {
+    await rebuildPluginState(await restoredWallet.getTransactionHistory())
+  },
+})
+
+await wallet.restore()
+```
+
+Registering the same `id` again replaces that hook without changing its position. A run uses a
+stable snapshot, attempts every hook in registration order, and throws an `AggregateError` after
+all failures have been collected. If core recovery fails, hooks do not run. The returned function
+removes only that exact registration and is safe to call more than once.
+
+Hooks do not run during `Wallet.create()`, `ServiceWorkerWallet.setup()`, or ordinary startup. A
+plugin should register before an application calls `restore()` and keep its normal incremental
+reconciliation for state that arrives later.
+
 For advanced use cases, you can access the ContractManager directly to register external contracts:
 
 ```typescript

package/dist/adapters/expo.cjs

@@ -1,19 +1,19 @@
 'use strict';
 
-var chunkI7ZNWBBU_cjs = require('../chunk-I7ZNWBBU.cjs');
-require('../chunk-FM263GKH.cjs');
-require('../chunk-5J5PDZRR.cjs');
+var chunk4BWZ437E_cjs = require('../chunk-4BWZ437E.cjs');
+require('../chunk-4C5PMGBB.cjs');
+require('../chunk-6FTHFJAN.cjs');
 require('../chunk-5BLDMQED.cjs');
 
 
 
 Object.defineProperty(exports, "ExpoArkProvider", {
   enumerable: true,
-  get: function () { return chunkI7ZNWBBU_cjs.ExpoArkProvider; }
+  get: function () { return chunk4BWZ437E_cjs.ExpoArkProvider; }
 });
 Object.defineProperty(exports, "ExpoIndexerProvider", {
   enumerable: true,
-  get: function () { return chunkI7ZNWBBU_cjs.ExpoIndexerProvider; }
+  get: function () { return chunk4BWZ437E_cjs.ExpoIndexerProvider; }
 });
 //# sourceMappingURL=expo.cjs.map
 //# sourceMappingURL=expo.cjs.map

package/dist/adapters/expo.d.cts

@@ -1,5 +1,5 @@
-import { n as RestArkProvider, k as SettlementEvent, T as TxNotificationEvent, o as RestIndexerProvider, p as SubscriptionResponse } from '../index-CyGnhCSS.cjs';
-export { q as ArkProvider, r as IndexerProvider } from '../index-CyGnhCSS.cjs';
+import { n as RestArkProvider, k as SettlementEvent, T as TxNotificationEvent, o as RestIndexerProvider, p as SubscriptionResponse } from '../index-Dg0-TvBQ.cjs';
+export { q as ArkProvider, r as IndexerProvider } from '../index-Dg0-TvBQ.cjs';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer';

package/dist/adapters/expo.d.ts

@@ -1,5 +1,5 @@
-import { n as RestArkProvider, k as SettlementEvent, T as TxNotificationEvent, o as RestIndexerProvider, p as SubscriptionResponse } from '../index-CyGnhCSS.js';
-export { q as ArkProvider, r as IndexerProvider } from '../index-CyGnhCSS.js';
+import { n as RestArkProvider, k as SettlementEvent, T as TxNotificationEvent, o as RestIndexerProvider, p as SubscriptionResponse } from '../index-Dg0-TvBQ.js';
+export { q as ArkProvider, r as IndexerProvider } from '../index-Dg0-TvBQ.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer';

package/dist/adapters/expo.js

@@ -1,6 +1,6 @@
-export { ExpoArkProvider, ExpoIndexerProvider } from '../chunk-SCSLCU66.js';
-import '../chunk-ZT3EM4CE.js';
-import '../chunk-2ZX4Z2IP.js';
+export { ExpoArkProvider, ExpoIndexerProvider } from '../chunk-S5PUFSXC.js';
+import '../chunk-IGER5FPC.js';
+import '../chunk-5GQFYVWP.js';
 import '../chunk-NSBPE2FW.js';
 //# sourceMappingURL=expo.js.map
 //# sourceMappingURL=expo.js.map

package/dist/adapters/indexedDB.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkMK5EPTTB_cjs = require('../chunk-MK5EPTTB.cjs');
-require('../chunk-FM263GKH.cjs');
-require('../chunk-P6EXRY5L.cjs');
-require('../chunk-5J5PDZRR.cjs');
+var chunkU5I3ITV7_cjs = require('../chunk-U5I3ITV7.cjs');
+require('../chunk-4C5PMGBB.cjs');
+require('../chunk-NPM5YZBC.cjs');
+require('../chunk-6FTHFJAN.cjs');
 require('../chunk-5BLDMQED.cjs');
 
 // src/storage/indexedDB.ts
@@ -11,7 +11,7 @@ var IndexedDBStorageAdapter = class {
   dbName;
   version;
   db = null;
-  constructor(dbName, version = chunkMK5EPTTB_cjs.DB_VERSION) {
+  constructor(dbName, version = chunkU5I3ITV7_cjs.DB_VERSION) {
     this.dbName = dbName;
     this.version = version;
   }

package/dist/adapters/indexedDB.js

@@ -1,7 +1,7 @@
-import { DB_VERSION } from '../chunk-E5JNYFOF.js';
-import '../chunk-ZT3EM4CE.js';
-import '../chunk-ALZ2CZ3T.js';
-import '../chunk-2ZX4Z2IP.js';
+import { DB_VERSION } from '../chunk-BHLYB44A.js';
+import '../chunk-IGER5FPC.js';
+import '../chunk-CB6QPAO5.js';
+import '../chunk-5GQFYVWP.js';
 import '../chunk-NSBPE2FW.js';
 
 // src/storage/indexedDB.ts

package/dist/{asyncStorageTaskQueue-CjKAUiuj.d.ts → asyncStorageTaskQueue-DhhNZc4v.d.ts}

@@ -1,4 +1,4 @@
-import { c as TaskQueue, b as TaskItem, d as TaskResult } from './taskRunner-l3zyfW_Q.js';
+import { a as TaskQueue, c as TaskItem, d as TaskResult } from './taskRunner-DrVz2QZs.js';
 
 /**
  * Minimal async key-value storage interface.
@@ -46,4 +46,4 @@ declare class AsyncStorageTaskQueue implements TaskQueue {
     private writeList;
 }
 
-export { type AsyncStorageLike as A, AsyncStorageTaskQueue as a };
+export { AsyncStorageTaskQueue as A, type AsyncStorageLike as a };

package/dist/{asyncStorageTaskQueue-DgXf4iuU.d.cts → asyncStorageTaskQueue-s5lUGWxu.d.cts}

@@ -1,4 +1,4 @@
-import { c as TaskQueue, b as TaskItem, d as TaskResult } from './taskRunner-CjmMH_rW.cjs';
+import { a as TaskQueue, c as TaskItem, d as TaskResult } from './taskRunner-BH_FxaNI.cjs';
 
 /**
  * Minimal async key-value storage interface.
@@ -46,4 +46,4 @@ declare class AsyncStorageTaskQueue implements TaskQueue {
     private writeList;
 }
 
-export { type AsyncStorageLike as A, AsyncStorageTaskQueue as a };
+export { AsyncStorageTaskQueue as A, type AsyncStorageLike as a };

package/dist/{chunk-I7ZNWBBU.cjs → chunk-4BWZ437E.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkFM263GKH_cjs = require('./chunk-FM263GKH.cjs');
-var chunk5J5PDZRR_cjs = require('./chunk-5J5PDZRR.cjs');
+var chunk4C5PMGBB_cjs = require('./chunk-4C5PMGBB.cjs');
+var chunk6FTHFJAN_cjs = require('./chunk-6FTHFJAN.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", chunk6FTHFJAN_cjs.buildVersion);
+      headers.set("X-SDK-VERSION", chunk6FTHFJAN_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 chunk6FTHFJAN_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 chunk6FTHFJAN_cjs.RestArkProvider {
+  constructor(serverUrl = chunk6FTHFJAN_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 (chunk6FTHFJAN_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 (chunk6FTHFJAN_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 chunk4C5PMGBB_cjs.RestIndexerProvider {
+  constructor(serverUrl = chunk6FTHFJAN_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(chunk6FTHFJAN_cjs.convertVtxo),
+                spentVtxos: (data.event.spentVtxos || []).map(chunk6FTHFJAN_cjs.convertVtxo),
+                sweptVtxos: (data.event.sweptVtxos || []).map(chunk6FTHFJAN_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 (chunk6FTHFJAN_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-4BWZ437E.cjs.map
+//# sourceMappingURL=chunk-4BWZ437E.cjs.map

package/dist/chunk-4BWZ437E.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-4BWZ437E.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/{chunk-FM263GKH.cjs → chunk-4C5PMGBB.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk5J5PDZRR_cjs = require('./chunk-5J5PDZRR.cjs');
+var chunk6FTHFJAN_cjs = require('./chunk-6FTHFJAN.cjs');
 var chunk5BLDMQED_cjs = require('./chunk-5BLDMQED.cjs');
 var base = require('@scure/base');
 var secp256k1_js = require('@noble/curves/secp256k1.js');
@@ -1420,10 +1420,10 @@ async function indexerFetch(input, init) {
     const lastAttempt = attempt >= maxAttempts;
     let res;
     try {
-      res = await chunk5J5PDZRR_cjs.rateGate.runHttp(input, () => chunk5J5PDZRR_cjs.baseFetch(input, init));
+      res = await chunk6FTHFJAN_cjs.rateGate.runHttp(input, () => chunk6FTHFJAN_cjs.baseFetch(input, init));
     } catch (err) {
-      const mapped = chunk5J5PDZRR_cjs.toProviderUnavailable(err, "indexer");
-      if (lastAttempt || !(mapped instanceof chunk5J5PDZRR_cjs.ProviderUnavailableError)) throw mapped;
+      const mapped = chunk6FTHFJAN_cjs.toProviderUnavailable(err, "indexer");
+      if (lastAttempt || !(mapped instanceof chunk6FTHFJAN_cjs.ProviderUnavailableError)) throw mapped;
       await sleep(retryDelayMs(attempt));
       continue;
     }
@@ -1435,7 +1435,7 @@ async function indexerFetch(input, init) {
       body = void 0;
     }
     try {
-      chunk5J5PDZRR_cjs.throwIfHttpUnavailable(res, "indexer", body);
+      chunk6FTHFJAN_cjs.throwIfHttpUnavailable(res, "indexer", body);
     } catch (err) {
       if (lastAttempt) throw err;
       await sleep(retryDelayMs(attempt));
@@ -1464,13 +1464,15 @@ var ChainTxType = /* @__PURE__ */ ((ChainTxType2) => {
   return ChainTxType2;
 })(ChainTxType || {});
 var RestIndexerProvider = class {
-  constructor(serverUrl = chunk5J5PDZRR_cjs.DEFAULT_ARKADE_SERVER_URL, options = {}) {
+  constructor(serverUrl = chunk6FTHFJAN_cjs.DEFAULT_ARKADE_SERVER_URL, options = {}) {
     this.serverUrl = serverUrl;
     this.eventSource = options.eventSource;
   }
   serverUrl;
   /** Overrides {@link configureEventSource} for this provider's subscription. */
   eventSource;
+  /** @see fetchVtxosJson */
+  inFlightVtxoReads = /* @__PURE__ */ new Map();
   async getVtxoTree(batchOutpoint, opts) {
     let url = `${this.serverUrl}/v1/indexer/batch/${batchOutpoint.txid}/${batchOutpoint.vout}/tree`;
     const params = new URLSearchParams();
@@ -1600,8 +1602,8 @@ var RestIndexerProvider = class {
       try {
         while (!abortSignal?.aborted) {
           try {
-            const currentIterator = chunk5J5PDZRR_cjs.eventSourceIterator(
-              chunk5J5PDZRR_cjs.resolveEventSource(override)(url)
+            const currentIterator = chunk6FTHFJAN_cjs.eventSourceIterator(
+              chunk6FTHFJAN_cjs.resolveEventSource(override)(url)
             );
             iterator = currentIterator;
             for await (const event of currentIterator) {
@@ -1612,9 +1614,9 @@ var RestIndexerProvider = class {
                   yield {
                     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(chunk6FTHFJAN_cjs.convertVtxo),
+                    spentVtxos: (data.event.spentVtxos || []).map(chunk6FTHFJAN_cjs.convertVtxo),
+                    sweptVtxos: (data.event.sweptVtxos || []).map(chunk6FTHFJAN_cjs.convertVtxo),
                     tx: data.event.tx,
                     checkpointTxs: data.event.checkpointTxs
                   };
@@ -1628,14 +1630,14 @@ var RestIndexerProvider = class {
             if (abortSignal?.aborted || error instanceof Error && error.name === "AbortError") {
               break;
             }
-            if (chunk5J5PDZRR_cjs.isFetchTimeoutError(error)) {
+            if (chunk6FTHFJAN_cjs.isFetchTimeoutError(error)) {
               console.debug("Timeout error ignored");
               continue;
             }
-            if (chunk5J5PDZRR_cjs.isEventSourceError(error)) {
+            if (chunk6FTHFJAN_cjs.isEventSourceError(error)) {
               throw error;
             }
-            if (chunk5J5PDZRR_cjs.isEventSourceUnavailableError(error)) throw error;
+            if (chunk6FTHFJAN_cjs.isEventSourceUnavailableError(error)) throw error;
             console.error("Subscription error:", error);
             throw error;
           } finally {
@@ -1777,19 +1779,43 @@ var RestIndexerProvider = class {
     if (params.toString()) {
       url += "?" + params.toString();
     }
-    const res = await indexerFetch(url);
-    if (!res.ok) {
-      throw new Error(`Failed to fetch vtxos: ${res.statusText}`);
-    }
-    const data = await res.json();
-    if (!Response.isVtxosResponse(data)) {
-      throw new Error("Invalid vtxos data received");
-    }
+    const data = await this.fetchVtxosJson(url);
     return {
-      vtxos: data.vtxos.map(chunk5J5PDZRR_cjs.convertVtxo),
+      vtxos: data.vtxos.map(chunk6FTHFJAN_cjs.convertVtxo),
       page: data.page
     };
   }
+  /**
+   * 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.
+   */
+  async fetchVtxosJson(url) {
+    const joined = this.inFlightVtxoReads.get(url);
+    if (joined) return joined;
+    const shared = (async () => {
+      const res = await indexerFetch(url);
+      if (!res.ok) {
+        throw new Error(`Failed to fetch vtxos: ${res.statusText}`);
+      }
+      const data = await res.json();
+      if (!Response.isVtxosResponse(data)) {
+        throw new Error("Invalid vtxos data received");
+      }
+      return data;
+    })();
+    this.inFlightVtxoReads.set(url, shared);
+    try {
+      return await shared;
+    } finally {
+      if (this.inFlightVtxoReads.get(url) === shared) this.inFlightVtxoReads.delete(url);
+    }
+  }
   async getAssetDetails(assetId) {
     const url = `${this.serverUrl}/v1/indexer/asset/${encodeURIComponent(assetId)}`;
     const res = await indexerFetch(url);
@@ -1969,5 +1995,5 @@ exports.Metadata = Metadata;
 exports.Packet = Packet;
 exports.RestIndexerProvider = RestIndexerProvider;
 exports.asset_exports = asset_exports;
-//# sourceMappingURL=chunk-FM263GKH.cjs.map
-//# sourceMappingURL=chunk-FM263GKH.cjs.map
+//# sourceMappingURL=chunk-4C5PMGBB.cjs.map
+//# sourceMappingURL=chunk-4C5PMGBB.cjs.map