@arkade-os/sdk 0.4.76 → 0.4.77

package/dist/{chunk-MUBPGYUE.js → chunk-YKNTUOUG.js}

@@ -1,5 +1,5 @@
-import { RestIndexerProvider } from './chunk-54W6QBXL.js';
-import { RestArkProvider, DEFAULT_ARKADE_SERVER_URL, ARKADE_VERSION_HEADERS, isFetchTimeoutError, convertVtxo, baseFetch } from './chunk-F6YOCYWU.js';
+import { RestIndexerProvider } from './chunk-HKOFYHZP.js';
+import { RestArkProvider, DEFAULT_ARKADE_SERVER_URL, ARKADE_VERSION_HEADERS, isFetchTimeoutError, convertVtxo, baseFetch } from './chunk-52OA3UIC.js';
 
 // src/providers/expoUtils.ts
 async function getExpoFetch(options) {
@@ -188,5 +188,5 @@ var ExpoIndexerProvider = class extends RestIndexerProvider {
 };
 
 export { ExpoArkProvider, ExpoIndexerProvider };
-//# sourceMappingURL=chunk-MUBPGYUE.js.map
-//# sourceMappingURL=chunk-MUBPGYUE.js.map
+//# sourceMappingURL=chunk-YKNTUOUG.js.map
+//# sourceMappingURL=chunk-YKNTUOUG.js.map

package/dist/{chunk-MUBPGYUE.js.map → chunk-YKNTUOUG.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/providers/expoUtils.ts","../src/providers/expoArk.ts","../src/providers/expoIndexer.ts"],"names":[],"mappings":"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","file":"chunk-MUBPGYUE.js","sourcesContent":["import { baseFetch, fetch } from \"../utils/fetch\";\n\n/**\n * Dynamically imports expo/fetch, falling back to {@link baseFetch}.\n *\n * Adds no headers of its own: both Expo providers share this function but reach\n * different origins, so each passes its own per request.\n *\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        return expoFetchModule.fetch 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 baseFetch;\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            // `baseFetch`, which bounds any read that brings no signal of its\n            // own. Drop this and 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\";\nimport { ARKADE_VERSION_HEADERS } from \"../utils/fetch\";\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(\n                    url + queryParams,\n                    signal,\n                    expoFetch,\n                    ARKADE_VERSION_HEADERS,\n                    (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                );\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, ARKADE_VERSION_HEADERS, (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"]}
+{"version":3,"sources":["../src/providers/expoUtils.ts","../src/providers/expoArk.ts","../src/providers/expoIndexer.ts"],"names":[],"mappings":"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","file":"chunk-YKNTUOUG.js","sourcesContent":["import { baseFetch, fetch } from \"../utils/fetch\";\n\n/**\n * Dynamically imports expo/fetch, falling back to {@link baseFetch}.\n *\n * Adds no headers of its own: both Expo providers share this function but reach\n * different origins, so each passes its own per request.\n *\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        return expoFetchModule.fetch 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 baseFetch;\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            // `baseFetch`, which bounds any read that brings no signal of its\n            // own. Drop this and 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\";\nimport { ARKADE_VERSION_HEADERS } from \"../utils/fetch\";\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(\n                    url + queryParams,\n                    signal,\n                    expoFetch,\n                    ARKADE_VERSION_HEADERS,\n                    (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                );\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, ARKADE_VERSION_HEADERS, (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 chunkCQNX4BTA_cjs = require('../../chunk-CQNX4BTA.cjs');
-require('../../chunk-P53OHGXY.cjs');
+var chunkLUWSY2QO_cjs = require('../../chunk-LUWSY2QO.cjs');
+require('../../chunk-CJN4CUEU.cjs');
 require('../../chunk-5BLDMQED.cjs');
 
 
 
 Object.defineProperty(exports, "ArkadeContractHandler", {
   enumerable: true,
-  get: function () { return chunkCQNX4BTA_cjs.ArkadeContractHandler; }
+  get: function () { return chunkLUWSY2QO_cjs.ArkadeContractHandler; }
 });
 Object.defineProperty(exports, "BoardingContractHandler", {
   enumerable: true,
-  get: function () { return chunkCQNX4BTA_cjs.BoardingContractHandler; }
+  get: function () { return chunkLUWSY2QO_cjs.BoardingContractHandler; }
 });
 Object.defineProperty(exports, "DefaultContractHandler", {
   enumerable: true,
-  get: function () { return chunkCQNX4BTA_cjs.DefaultContractHandler; }
+  get: function () { return chunkLUWSY2QO_cjs.DefaultContractHandler; }
 });
 Object.defineProperty(exports, "DelegateContractHandler", {
   enumerable: true,
-  get: function () { return chunkCQNX4BTA_cjs.DelegateContractHandler; }
+  get: function () { return chunkLUWSY2QO_cjs.DelegateContractHandler; }
 });
 Object.defineProperty(exports, "VHTLCContractHandler", {
   enumerable: true,
-  get: function () { return chunkCQNX4BTA_cjs.VHTLCContractHandler; }
+  get: function () { return chunkLUWSY2QO_cjs.VHTLCContractHandler; }
 });
 Object.defineProperty(exports, "VHTLCV2ContractHandler", {
   enumerable: true,
-  get: function () { return chunkCQNX4BTA_cjs.VHTLCV2ContractHandler; }
+  get: function () { return chunkLUWSY2QO_cjs.VHTLCV2ContractHandler; }
 });
 Object.defineProperty(exports, "contractHandlers", {
   enumerable: true,
-  get: function () { return chunkCQNX4BTA_cjs.contractHandlers; }
+  get: function () { return chunkLUWSY2QO_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-4NF3srcg.cjs';
-import '../../index-B_RYn9rg.cjs';
+export { o as ArkadeContractHandler, B as BoardingContractHandler, q as BoardingContractParams, D as DefaultContractHandler, t as DefaultContractParams, u as DelegateContractHandler, x as DelegateContractParams, y as VHTLCContractHandler, z as VHTLCContractParams, E as VHTLCV2ContractHandler, F as VHTLCV2ContractParams, G as contractHandlers } from '../../index-BMY272ns.cjs';
+import '../../index-Ie_ak2zY.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-CR7msIXK.cjs';
+import '../../delegate-QPCGaD_z.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-Dj2yOhQ2.js';
-import '../../index-B_RYn9rg.js';
+export { o as ArkadeContractHandler, B as BoardingContractHandler, q as BoardingContractParams, D as DefaultContractHandler, t as DefaultContractParams, u as DelegateContractHandler, x as DelegateContractParams, y as VHTLCContractHandler, z as VHTLCContractParams, E as VHTLCV2ContractHandler, F as VHTLCV2ContractParams, G as contractHandlers } from '../../index-m-EM-e8D.js';
+import '../../index-Ie_ak2zY.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-BAYpqkEx.js';
+import '../../delegate-CjcysR7s.js';

package/dist/contracts/handlers/index.js

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

package/dist/{delegate-BAYpqkEx.d.ts → delegate-CjcysR7s.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-B_RYn9rg.js';
+import { t as RelativeTimelock, V as VtxoScript, u as TapLeafScript } from './index-Ie_ak2zY.js';
 
 /**
  * DefaultVtxo is the default implementation of a VtxoScript.

package/dist/{delegate-CR7msIXK.d.cts → delegate-QPCGaD_z.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-B_RYn9rg.cjs';
+import { t as RelativeTimelock, V as VtxoScript, u as TapLeafScript } from './index-Ie_ak2zY.cjs';
 
 /**
  * DefaultVtxo is the default implementation of a VtxoScript.

package/dist/{hdWalletCapable-BSF29IjK.d.ts → hdWalletCapable--pMncWbC.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-B_RYn9rg.js';
+import { t as RelativeTimelock, P as Network, Q as CSVMultisigTapscript, U as BatchStartedEvent, X as TreeSigningStartedEvent, Y as TxTree, Z as TreeNoncesEvent, _ as BatchFinalizationEvent, $ as BatchFinalizedEvent, a0 as BatchFailedEvent, a1 as TreeTxEvent, a2 as TreeSignatureEvent, l as SettlementEvent, b as WalletConfig, W as WalletRepository, C as ContractRepository, a3 as DescriptorProvider, g as IContractManager, a4 as IReadonlyWallet, a5 as ReadonlyIdentity, a6 as OnchainProvider, s as IndexerProvider, a7 as DelegateProvider, a8 as ReadonlyWalletConfig, D as IntentRepository, J as VirtualTxRepository, a9 as ExitCaptureMode, aa as ExitDataSource, e as ActivityRegistry, ab as IReadonlyAssetManager, ac as ContractSyncState, ad as RecipientAddressContext, r as ArkProvider, ae as NetworkName, af as ArkInfo, ag as ArkAddress, c as WalletBalance, G as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, d as GetSpendableVtxosFilter, ah as ContractWithVtxos, ai as selectPendingRecoveryOutpoints, A as ArkTransaction, f as Activity, E as ExtendedCoin, aj as Coin, x as ExtendedVirtualCoin, ak as ContractManager, al as ContractManagerConfig, I as IWallet, a as Identity, h as GetNewAddressesOptions, i as NewAddress, am as SettlementConfig, n as IAssetManager, an as VtxoManager, j as IDelegateManager, S as SendBitcoinParams, k as SettleParams, R as Recipient, ao as SignerSession, ap as SignedIntent, aq as Intent, m as SendParams, ar as TimeHeight } from './index-Ie_ak2zY.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-BAYpqkEx.js';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-CjcysR7s.js';
 
 /** Wall-clock floor for `batchExpiry` outside regtest. */
 declare const DEFAULT_MIN_BATCH_EXPIRY_SECONDS = 86400n;
@@ -973,7 +973,7 @@ declare class ReadonlyWallet implements IReadonlyWallet {
      */
     getVtxos(filter?: GetVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]>;
     /** @inheritdoc */
-    getSpendableVtxos(filter?: GetVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]>;
+    getSpendableVtxos(filter?: GetSpendableVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]>;
     /**
      * Debug-log any explicit input generic selection would have excluded, for
      * each of the three reasons it excludes on. Explicit-input APIs stay ungated
@@ -1008,7 +1008,9 @@ declare class ReadonlyWallet implements IReadonlyWallet {
      * otherwise the gate and the pending-recovery set answer about two different
      * points in time, and each read costs another sync.
      */
-    protected contractSnapshot(): Promise<ContractWithVtxos[]>;
+    protected contractSnapshot(filter?: GetSpendableVtxosFilter, options?: {
+        unspentOnly?: boolean;
+    }): Promise<ContractWithVtxos[]>;
     /**
      * The two exclusion sets the gate is made of, derived from one snapshot so
      * {@link getSpendableVtxos} and the balance answer about the same instant.

package/dist/{hdWalletCapable-BbZxCUeZ.d.cts → hdWalletCapable-Bp_p0WLj.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-B_RYn9rg.cjs';
+import { t as RelativeTimelock, P as Network, Q as CSVMultisigTapscript, U as BatchStartedEvent, X as TreeSigningStartedEvent, Y as TxTree, Z as TreeNoncesEvent, _ as BatchFinalizationEvent, $ as BatchFinalizedEvent, a0 as BatchFailedEvent, a1 as TreeTxEvent, a2 as TreeSignatureEvent, l as SettlementEvent, b as WalletConfig, W as WalletRepository, C as ContractRepository, a3 as DescriptorProvider, g as IContractManager, a4 as IReadonlyWallet, a5 as ReadonlyIdentity, a6 as OnchainProvider, s as IndexerProvider, a7 as DelegateProvider, a8 as ReadonlyWalletConfig, D as IntentRepository, J as VirtualTxRepository, a9 as ExitCaptureMode, aa as ExitDataSource, e as ActivityRegistry, ab as IReadonlyAssetManager, ac as ContractSyncState, ad as RecipientAddressContext, r as ArkProvider, ae as NetworkName, af as ArkInfo, ag as ArkAddress, c as WalletBalance, G as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, d as GetSpendableVtxosFilter, ah as ContractWithVtxos, ai as selectPendingRecoveryOutpoints, A as ArkTransaction, f as Activity, E as ExtendedCoin, aj as Coin, x as ExtendedVirtualCoin, ak as ContractManager, al as ContractManagerConfig, I as IWallet, a as Identity, h as GetNewAddressesOptions, i as NewAddress, am as SettlementConfig, n as IAssetManager, an as VtxoManager, j as IDelegateManager, S as SendBitcoinParams, k as SettleParams, R as Recipient, ao as SignerSession, ap as SignedIntent, aq as Intent, m as SendParams, ar as TimeHeight } from './index-Ie_ak2zY.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-CR7msIXK.cjs';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-QPCGaD_z.cjs';
 
 /** Wall-clock floor for `batchExpiry` outside regtest. */
 declare const DEFAULT_MIN_BATCH_EXPIRY_SECONDS = 86400n;
@@ -973,7 +973,7 @@ declare class ReadonlyWallet implements IReadonlyWallet {
      */
     getVtxos(filter?: GetVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]>;
     /** @inheritdoc */
-    getSpendableVtxos(filter?: GetVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]>;
+    getSpendableVtxos(filter?: GetSpendableVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]>;
     /**
      * Debug-log any explicit input generic selection would have excluded, for
      * each of the three reasons it excludes on. Explicit-input APIs stay ungated
@@ -1008,7 +1008,9 @@ declare class ReadonlyWallet implements IReadonlyWallet {
      * otherwise the gate and the pending-recovery set answer about two different
      * points in time, and each read costs another sync.
      */
-    protected contractSnapshot(): Promise<ContractWithVtxos[]>;
+    protected contractSnapshot(filter?: GetSpendableVtxosFilter, options?: {
+        unspentOnly?: boolean;
+    }): Promise<ContractWithVtxos[]>;
     /**
      * The two exclusion sets the gate is made of, derived from one snapshot so
      * {@link getSpendableVtxos} and the balance answer about the same instant.

package/dist/{index-4NF3srcg.d.cts → index-BMY272ns.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-B_RYn9rg.cjs';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-CR7msIXK.cjs';
+import { bi as ContractHandler, t as RelativeTimelock, bv as Discoverable, V as VtxoScript, u as TapLeafScript, da as TapscriptDeriving } from './index-Ie_ak2zY.cjs';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-QPCGaD_z.cjs';
 import { Bytes } from '@scure/btc-signer/utils.js';
 
 /**
@@ -654,14 +654,28 @@ interface InputDef {
  * {@link ArkadeArgValue}).
  */
 type InputRef = string | InputDef;
-/** Reference to a signer key: a `"$param"` reference or literal x-only bytes. */
-type SignerRef = string | Uint8Array;
+/** Constructor pubkey `$param` tweaked by `fn`'s covenant. */
+interface TweakedSigner {
+    tweak: string;
+    fn: string;
+}
+/** A `"$param"` reference, literal x-only bytes, or a {@link TweakedSigner}. */
+type SignerRef = string | Uint8Array | TweakedSigner;
 /** A witness-stack item: a function-input name, a `"$param"`, a literal number/bigint (minimal script-num), or raw bytes. */
 type WitnessRef = string | number | bigint | Uint8Array;
 /** Bitcoin Script segment of a spending path — enforced on-chain. */
 interface TapscriptSegment {
-    /** Required signers. The tweaked co-signer is appended automatically when the path has an `arkadeScript`. */
+    /**
+     * Required signers. A path with `arkadeScript` also appends the emulator
+     * co-signer, unless `emulator` is `null`.
+     */
     signers: SignerRef[];
+    /**
+     * Covenant named by `<EMULATOR_KEY:fn>`. `null` when this leaf belongs to a
+     * covenant but signs with a constructor-key tweak instead. Omitted on
+     * hand-written programs, which still append the co-signer.
+     */
+    emulator?: string | null;
     /**
      * Optional standard-opcode condition (e.g. a hashlock), encoded into a
      * ConditionMultisig leaf — or ConditionCSVMultisig when combined with `csv`.
@@ -798,15 +812,19 @@ declare class ArkadeProgramScript extends VtxoScript {
     functionByName(name: string): CompiledProgramFunction | undefined;
 }
 /**
- * Convert a compiler-style JSON artifact into a {@link Program}. Byte values are
+ * Convert a Program JSON artifact into a {@link Program}. Byte values are
  * encoded as `0x`-prefixed hex strings in `asm`/`witness`/`signers`; opcode names,
  * `$param` placeholders and numbers pass through unchanged.
+ *
+ * This is *not* the JSON `arkadec` writes. That artifact lists spend groups in
+ * an array and uses `<param>` placeholders and raw leaf assembly; pass it to
+ * {@link programFromArtifact} instead.
  */
 declare function parseArtifact(artifact: {
     version?: number;
     name?: string;
     params?: readonly InputRef[];
-    functions: Record<string, any>;
+    functions: unknown;
 }): Program;
 /**
  * Serialize a {@link Program} to compiler-artifact JSON — the inverse of
@@ -847,4 +865,4 @@ declare function deserializeArkadeContractParams(params: Record<string, string>)
  */
 declare const ArkadeContractHandler: ContractHandler<ArkadeContractParams, ArkadeProgramScript> & TapscriptDeriving<ArkadeProgramScript>;
 
-export { type ArkadeParamValue as A, BoardingContractHandler as B, type CompiledProgramFunction as C, DefaultContractHandler as D, type VHTLCV2ContractParams as E, contractHandlers as F, type InputRef as I, type Program as P, SUPPORTED_PROGRAM_VERSION as S, type TapscriptSegment as T, VHTLC as V, type WitnessRef as W, ArkadeProgramScript as a, type ProgramKeys as b, type ArkadeArgValue as c, type ArkadeFunction as d, type InputDef as e, type ArkadeValueType as f, type ArkadeArgType as g, type ArkadeContractParams as h, type ArkadeSegment as i, type AsmToken as j, type SignerRef as k, deserializeArkadeContractParams as l, stringifyArtifact as m, ArkadeContractHandler as n, type BoardingContractParams as o, parseArtifact as p, type DefaultContractParams as q, resolveAsm as r, serializeArkadeContractParams as s, DelegateContractHandler as t, type DelegateContractParams as u, validateProgram as v, witnessRefToBytes as w, VHTLCContractHandler as x, type VHTLCContractParams as y, VHTLCV2ContractHandler as z };
+export { type ArkadeParamValue as A, BoardingContractHandler as B, type CompiledProgramFunction as C, DefaultContractHandler as D, VHTLCV2ContractHandler as E, type VHTLCV2ContractParams as F, contractHandlers as G, type InputRef as I, type Program as P, SUPPORTED_PROGRAM_VERSION as S, type TapscriptSegment as T, VHTLC as V, type WitnessRef as W, ArkadeProgramScript as a, type ProgramKeys as b, type ArkadeArgValue as c, type ArkadeFunction as d, type InputDef as e, type ArkadeValueType as f, type ArkadeArgType as g, type ArkadeContractParams as h, type ArkadeSegment as i, type AsmToken as j, type SignerRef as k, type TweakedSigner as l, deserializeArkadeContractParams as m, stringifyArtifact as n, ArkadeContractHandler as o, parseArtifact as p, type BoardingContractParams as q, resolveAsm as r, serializeArkadeContractParams as s, type DefaultContractParams as t, DelegateContractHandler as u, validateProgram as v, witnessRefToBytes as w, type DelegateContractParams as x, VHTLCContractHandler as y, type VHTLCContractParams as z };

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

@@ -1948,7 +1948,9 @@ type NormalizedExtendedVirtualCoin = ExtendedVirtualCoin & NormalizedVirtualCoin
  * it was consumed. Mirrors NArk's `ArkVtxo.IsSpent()`. The location axis is {@link canSweepOnchain},
  * which the two capability predicates below subtract instead.
  */
-declare function hasTerminalSpend(vtxo: VirtualCoin): boolean;
+declare function isVtxoSpent(vtxo: VirtualCoin): boolean;
+/** @deprecated Use {@link isVtxoSpent}. */
+declare const hasTerminalSpend: typeof isVtxoSpent;
 /**
  * Whether a virtual output's batch expiry has passed. Pure expiry — swept is a separate fact, ORed
  * in explicitly by {@link canSpendOffchain} / {@link canRecoverOnchain}.
@@ -3005,6 +3007,10 @@ interface WalletRepository extends AsyncDisposable {
      * @optional SDK backends implement this; custom backends fall back to Tier 1.
      */
     getVtxosForScript?(script: string): Promise<ExtendedVirtualCoin[]>;
+    /** Fetch a script set without one read per contract; `unspentOnly` omits spent rows. */
+    getVtxosForScripts?(scripts: string[], options?: {
+        unspentOnly?: boolean;
+    }): Promise<ExtendedVirtualCoin[]>;
     /**
      * Save virtual outputs for a script.
      * @optional SDK backends implement this; custom backends fall back to Tier 1.
@@ -3644,8 +3650,14 @@ interface IContractManager extends Disposable {
      * List contracts and their current virtual outputs.
      *
      * If no filter is provided, returns all contracts with their virtual outputs.
+     * `unspentOnly` omits spent VTXOs from the repository result; it
+     * does not narrow the provider sync or change the full-history default.
      */
-    getContractsWithVtxos(filter?: GetContractsFilter): Promise<ContractWithVtxos[]>;
+    getContractsWithVtxos(filter?: GetContractsFilter, pageSize?: number, options?: {
+        maxSyncAgeMs?: number;
+        unspentOnly?: boolean;
+        requireSynced?: boolean;
+    }): Promise<ContractWithVtxos[]>;
     /**
      * Latest provider-sync health (online vs. degraded to repository data).
      * See {@link ContractSyncState}.
@@ -4317,7 +4329,11 @@ declare class ContractManager implements IContractManager {
      * ```
      */
     getContracts(filter?: GetContractsFilter): Promise<Contract[]>;
-    getContractsWithVtxos(filter?: GetContractsFilter, pageSize?: number): Promise<ContractWithVtxos[]>;
+    getContractsWithVtxos(filter?: GetContractsFilter, pageSize?: number, options?: {
+        maxSyncAgeMs?: number;
+        unspentOnly?: boolean;
+        requireSynced?: boolean;
+    }): Promise<ContractWithVtxos[]>;
     annotateVtxos(vtxos: VirtualCoin[], tapscripts?: ContractTapscriptCache): Promise<NormalizedExtendedVirtualCoin[]>;
     /** @inheritdoc */
     assertAnnotatable(vtxos: readonly {
@@ -5971,7 +5987,7 @@ interface Status {
  * @deprecated Use the canonical facts on {@link VirtualCoin} — `isSwept`, `isPreconfirmed`,
  * `isSpent`, `expiresAt`, `expiresAtHeight`, `commitmentTxIds`, `spentBy`, `settledBy` — and the
  * capability predicates {@link canSpendOffchain}, {@link canRecoverOnchain},
- * {@link hasTerminalSpend}, {@link isPastExpiry}. `state` collapses independent facts into one
+ * {@link isVtxoSpent}, {@link isPastExpiry}. `state` collapses independent facts into one
  * lossy label; this object is retained only as a backward-compatible projection.
  */
 interface VirtualStatus {
@@ -6031,7 +6047,7 @@ interface Coin extends Outpoint {
  * {@link IndexerProvider} and {@link WalletRepository} implementations may hand back coins without
  * them. The SDK normalizes every incoming coin, so coins it returns always carry the facts that are
  * determinable; do not read these fields off a coin the SDK has not returned to you — use
- * {@link canSpendOffchain} / {@link canRecoverOnchain} / {@link hasTerminalSpend} /
+ * {@link canSpendOffchain} / {@link canRecoverOnchain} / {@link isVtxoSpent} /
  * {@link isPastExpiry}, which normalize defensively.
  *
  * @see Coin
@@ -6211,6 +6227,16 @@ type GetVtxosFilter = {
      */
     withUnrolled?: boolean;
 };
+type GetSpendableVtxosFilter = GetVtxosFilter & {
+    /** Exclude contracts retained for history from this spendable read. */
+    watchedOnly?: boolean;
+    /** Query only contracts whose handler permits generic spending. */
+    genericallySpendableOnly?: boolean;
+    /** Maximum age of a successful sync reused by this read, in milliseconds. Default: 0. */
+    maxSyncAgeMs?: number;
+    /** Reject repository fallback when the selected contracts could not be synced. */
+    requireSynced?: boolean;
+};
 /**
  * Readonly asset manager interface for asset operations that do not require wallet identity.
  *
@@ -6362,10 +6388,10 @@ interface IReadonlyWallet {
      * Both exclusion sets are derived from one contract snapshot, so they cannot
      * disagree about which VTXOs exist.
      *
-     * @param filter - Same flags, same defaults, as {@link getVtxos}
-     * @see GetVtxosFilter
+     * @param filter - Same coin flags and defaults as {@link getVtxos}, with opt-in contract scopes
+     * @see GetSpendableVtxosFilter
      */
-    getSpendableVtxos(filter?: GetVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]>;
+    getSpendableVtxos(filter?: GetSpendableVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]>;
     /** @returns Onchain boarding inputs tracked by the wallet. */
     getBoardingUtxos(): Promise<ExtendedCoin[]>;
     /** @returns Wallet transaction history derived from boarding and Arkade activity. */
@@ -6390,4 +6416,4 @@ interface IReadonlyWallet {
     clear(): Promise<void>;
 }
 
-export { type BatchFailedEvent as $, type ArkTransaction as A, type IntentRepository as B, type ContractRepository as C, type ArkIntent as D, type ExtendedCoin as E, type IntentFilter as F, type GetVtxosFilter as G, type VirtualTxRepository as H, type IWallet as I, type VirtualTx as J, type VtxoBranch as K, ChainedTxType as L, type Network as M, type NormalizedExtendedVirtualCoin as N, type Outpoint as O, CSVMultisigTapscript as P, type BatchStartedEvent as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotificationEvent as T, type TreeSigningStartedEvent as U, VtxoScript as V, type WalletRepository as W, TxTree as X, type TreeNoncesEvent as Y, type BatchFinalizationEvent as Z, type BatchFinalizedEvent as _, type Identity as a, type PathContext as a$, type TreeTxEvent as a0, type TreeSignatureEvent as a1, type DescriptorProvider as a2, type IReadonlyWallet as a3, type ReadonlyIdentity as a4, type OnchainProvider as a5, type DelegateProvider as a6, type ReadonlyWalletConfig as a7, type ExitCaptureMode as a8, type ExitDataSource as a9, type FeeInfo as aA, type CreateContractParams as aB, type GetContractsFilter as aC, type GetSpendablePathsOptions as aD, type GetAllSpendingPathsOptions as aE, type IssuanceParams as aF, type ReissuanceParams as aG, type BurnParams as aH, type RenewVtxosOptions as aI, type WatchedScript as aJ, type PathSelection as aK, type ContractEvent as aL, type AssetDetails as aM, type IssuanceResult as aN, type DelegateInfo as aO, type MigrationGlobalSkipReason as aP, type MigrationLegSkipReason as aQ, type SignerStatus as aR, type StorageConfig as aS, type IVtxoManager as aT, type ExplorerTransaction as aU, type TreeNonces as aV, type TreePartialSigs as aW, type PendingTx as aX, type EncodedVtxoScript as aY, type Status as aZ, type ChainTx as a_, type IReadonlyAssetManager as aa, type ContractSyncState as ab, type RecipientAddressContext as ac, type NetworkName as ad, type ArkInfo as ae, ArkAddress as af, type ContractWithVtxos as ag, selectPendingRecoveryOutpoints as ah, type Coin as ai, ContractManager as aj, type ContractManagerConfig as ak, type SettlementConfig as al, VtxoManager as am, type SignerSession as an, type SignedIntent as ao, Intent as ap, type TimeHeight as aq, type DescriptorSigningRequest as ar, Transaction as as, type IntentFeeConfig as at, type OffchainInput as au, FeeAmount as av, type OnchainInput as aw, type FeeOutput as ax, type ContractWatcherConfig as ay, type Asset as az, type WalletConfig as b, type RawTxSource as b$, type ActivityIntent as b0, type ActivityResolver as b1, type ArkIntentState as b2, type ArkTapscript as b3, type AssetMetadata as b4, BITCOIN_EMULATOR_PUBKEY as b5, type BaseWalletConfig as b6, type BatchInfo as b7, type BatchSignableIdentity as b8, CLTVMultisigTapscript as b9, type EventSourceFactory as bA, type EventSourceLike as bB, EventSourceUnavailableError as bC, type ExitChainResolver as bD, type ExtendedContractVtxo as bE, type GroupMembership as bF, type HandlerError as bG, type IDelegatorManager as bH, INTENT_TERMINAL_STATES as bI, IndexerTxType as bJ, type IntentCoin as bK, type KnownMetadata as bL, MUTINYNET_EMULATOR_PUBKEY as bM, type MigrateDeprecatedSignerOptions as bN, type MigrationLegReport as bO, type MigrationVtxoRef as bP, MultisigTapscript as bQ, type NewAddressType as bR, type Nonces as bS, type Output as bT, type PageResponse as bU, type PaginationOptions as bV, PartialSig as bW, type PrevTxSource as bX, PrevTxUnavailableError as bY, type ProviderClass as bZ, REGTEST_EMULATOR_PUBKEY as b_, type CandidateDeps as ba, ChainTxType as bb, type CommitmentTx as bc, ConditionCSVMultisigTapscript as bd, ConditionMultisigTapscript as be, type ContractBalance as bf, type ContractEventCallback as bg, type ContractHandler as bh, type ContractState as bi, type ContractVtxo as bj, type ContractVtxoEvent as bk, ContractWatcher as bl, DEFAULT_VTXO_PAGE_SIZE as bm, DelegateManagerImpl as bn, type DelegateOptions as bo, DelegatorManagerImpl as bp, type DelegatorProvider as bq, type DeprecatedSignerMigrationReport as br, type DeprecatedSignerReport as bs, DigestMismatchError as bt, type Discoverable as bu, type DiscoveredContract as bv, type DiscoveryDeps as bw, ESPLORA_URL as bx, EsploraProvider as by, type EventSourceCapable as bz, type WalletBalance as c, isVtxoExpiringSoon as c$, RestDelegateProvider as c0, RestDelegatorProvider as c1, type ScanContractsOptions as c2, type ScanResult as c3, type ScheduledSession as c4, SettlementEventType as c5, type SignRequest as c6, type SignerClassification as c7, type SignerSet as c8, type SubscriptionEvent as c9, classifyAgainstSignerSet as cA, classifyContractSigner as cB, collabExitResolver as cC, configureEventSource as cD, createDefaultActivityRegistry as cE, createExitChainResolver as cF, decodeTapscript as cG, defaultEmulatorPubkey as cH, getConfiguredEventSource as cI, getNetwork as cJ, getRandomId as cK, getSequence as cL, hasCandidates as cM, hasTerminalSpend as cN, isBatchSignable as cO, isContractVtxoEvent as cP, isCooperativelyMigratable as cQ, isDiscoverable as cR, isEventSourceUnavailableError as cS, isExpired as cT, isPastExpiry as cU, isRecoverable as cV, isSigningIdentity as cW, isSpendable as cX, isSubdust as cY, isTerminalIntentState as cZ, isVirtualCoin as c_, type SubscriptionHeartbeat as ca, type SweepTxNotification as cb, type TapLeaves as cc, TapTreeCoder as cd, TapscriptType as ce, type Tx as cf, type TxHistoryRecord as cg, type TxKey as ch, type TxNotification as ci, type TxTag as cj, type TxTreeNode as ck, TxType as cl, type VirtualStatus as cm, type Vtxo as cn, type VtxoChain as co, type VtxoType as cp, type WalletMode as cq, type WithPrevTx as cr, assertAllowedSighashTypes as cs, assetMintResolver as ct, attachPrevArkTxs as cu, attachPrevoutTxs as cv, boardingResolver as cw, canRecoverOnchain as cx, canSpendOffchain as cy, canSweepOnchain as cz, ActivityRegistry as d, networks as d0, resolveEmulatorPubkey as d1, resolveEventSource as d2, resolvePrevTxs as d3, scriptFromTapLeafScript as d4, signerSetFromInfo as d5, toXOnlySignerHex as d6, withPrevTxs as d7, type TapscriptDeriving as d8, type Activity as e, type IContractManager as f, type GetNewAddressesOptions as g, type NewAddress as h, type IDelegateManager as i, type SettleParams as j, type SettlementEvent as k, type SendParams as l, type IAssetManager as m, RestArkProvider as n, RestIndexerProvider as o, type SubscriptionResponse as p, type ArkProvider as q, type IndexerProvider as r, type RelativeTimelock as s, type TapLeafScript as t, type VirtualCoin as u, type Contract as v, type ExtendedVirtualCoin as w, type VtxoRepositoryKey as x, type WalletState as y, type ContractFilter as z };
+export { type BatchFinalizedEvent as $, type ArkTransaction as A, type ContractFilter as B, type ContractRepository as C, type IntentRepository as D, type ExtendedCoin as E, type ArkIntent as F, type GetVtxosFilter as G, type IntentFilter as H, type IWallet as I, type VirtualTxRepository as J, type VirtualTx as K, type VtxoBranch as L, ChainedTxType as M, type NormalizedExtendedVirtualCoin as N, type Outpoint as O, type Network as P, CSVMultisigTapscript as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotificationEvent as T, type BatchStartedEvent as U, VtxoScript as V, type WalletRepository as W, type TreeSigningStartedEvent as X, TxTree as Y, type TreeNoncesEvent as Z, type BatchFinalizationEvent as _, type Identity as a, type ChainTx as a$, type BatchFailedEvent as a0, type TreeTxEvent as a1, type TreeSignatureEvent as a2, type DescriptorProvider as a3, type IReadonlyWallet as a4, type ReadonlyIdentity as a5, type OnchainProvider as a6, type DelegateProvider as a7, type ReadonlyWalletConfig as a8, type ExitCaptureMode as a9, type Asset as aA, type FeeInfo as aB, type CreateContractParams as aC, type GetContractsFilter as aD, type GetSpendablePathsOptions as aE, type GetAllSpendingPathsOptions as aF, type IssuanceParams as aG, type ReissuanceParams as aH, type BurnParams as aI, type RenewVtxosOptions as aJ, type WatchedScript as aK, type PathSelection as aL, type ContractEvent as aM, type AssetDetails as aN, type IssuanceResult as aO, type DelegateInfo as aP, type MigrationGlobalSkipReason as aQ, type MigrationLegSkipReason as aR, type SignerStatus as aS, type StorageConfig as aT, type IVtxoManager as aU, type ExplorerTransaction as aV, type TreeNonces as aW, type TreePartialSigs as aX, type PendingTx as aY, type EncodedVtxoScript as aZ, type Status as a_, type ExitDataSource as aa, type IReadonlyAssetManager as ab, type ContractSyncState as ac, type RecipientAddressContext as ad, type NetworkName as ae, type ArkInfo as af, ArkAddress as ag, type ContractWithVtxos as ah, selectPendingRecoveryOutpoints as ai, type Coin as aj, ContractManager as ak, type ContractManagerConfig as al, type SettlementConfig as am, VtxoManager as an, type SignerSession as ao, type SignedIntent as ap, Intent as aq, type TimeHeight as ar, type DescriptorSigningRequest as as, Transaction as at, type IntentFeeConfig as au, type OffchainInput as av, FeeAmount as aw, type OnchainInput as ax, type FeeOutput as ay, type ContractWatcherConfig as az, type WalletConfig as b, REGTEST_EMULATOR_PUBKEY as b$, type PathContext as b0, type ActivityIntent as b1, type ActivityResolver as b2, type ArkIntentState as b3, type ArkTapscript as b4, type AssetMetadata as b5, BITCOIN_EMULATOR_PUBKEY as b6, type BaseWalletConfig as b7, type BatchInfo as b8, type BatchSignableIdentity as b9, type EventSourceCapable as bA, type EventSourceFactory as bB, type EventSourceLike as bC, EventSourceUnavailableError as bD, type ExitChainResolver as bE, type ExtendedContractVtxo as bF, type GroupMembership as bG, type HandlerError as bH, type IDelegatorManager as bI, INTENT_TERMINAL_STATES as bJ, IndexerTxType as bK, type IntentCoin as bL, type KnownMetadata as bM, MUTINYNET_EMULATOR_PUBKEY as bN, type MigrateDeprecatedSignerOptions as bO, type MigrationLegReport as bP, type MigrationVtxoRef as bQ, MultisigTapscript as bR, type NewAddressType as bS, type Nonces as bT, type Output as bU, type PageResponse as bV, type PaginationOptions as bW, PartialSig as bX, type PrevTxSource as bY, PrevTxUnavailableError as bZ, type ProviderClass as b_, CLTVMultisigTapscript as ba, type CandidateDeps as bb, ChainTxType as bc, type CommitmentTx as bd, ConditionCSVMultisigTapscript as be, ConditionMultisigTapscript as bf, type ContractBalance as bg, type ContractEventCallback as bh, type ContractHandler as bi, type ContractState as bj, type ContractVtxo as bk, type ContractVtxoEvent as bl, ContractWatcher as bm, DEFAULT_VTXO_PAGE_SIZE as bn, DelegateManagerImpl as bo, type DelegateOptions as bp, DelegatorManagerImpl as bq, type DelegatorProvider as br, type DeprecatedSignerMigrationReport as bs, type DeprecatedSignerReport as bt, DigestMismatchError as bu, type Discoverable as bv, type DiscoveredContract as bw, type DiscoveryDeps as bx, ESPLORA_URL as by, EsploraProvider as bz, type WalletBalance as c, isVirtualCoin as c$, type RawTxSource as c0, RestDelegateProvider as c1, RestDelegatorProvider as c2, type ScanContractsOptions as c3, type ScanResult as c4, type ScheduledSession as c5, SettlementEventType as c6, type SignRequest as c7, type SignerClassification as c8, type SignerSet as c9, canSweepOnchain as cA, classifyAgainstSignerSet as cB, classifyContractSigner as cC, collabExitResolver as cD, configureEventSource as cE, createDefaultActivityRegistry as cF, createExitChainResolver as cG, decodeTapscript as cH, defaultEmulatorPubkey as cI, getConfiguredEventSource as cJ, getNetwork as cK, getRandomId as cL, getSequence as cM, hasCandidates as cN, hasTerminalSpend as cO, isBatchSignable as cP, isContractVtxoEvent as cQ, isCooperativelyMigratable as cR, isDiscoverable as cS, isEventSourceUnavailableError as cT, isExpired as cU, isPastExpiry as cV, isRecoverable as cW, isSigningIdentity as cX, isSpendable as cY, isSubdust as cZ, isTerminalIntentState as c_, type SubscriptionEvent as ca, type SubscriptionHeartbeat as cb, type SweepTxNotification as cc, type TapLeaves as cd, TapTreeCoder as ce, TapscriptType as cf, type Tx as cg, type TxHistoryRecord as ch, type TxKey as ci, type TxNotification as cj, type TxTag as ck, type TxTreeNode as cl, TxType as cm, type VirtualStatus as cn, type Vtxo as co, type VtxoChain as cp, type VtxoType as cq, type WalletMode as cr, type WithPrevTx as cs, assertAllowedSighashTypes as ct, assetMintResolver as cu, attachPrevArkTxs as cv, attachPrevoutTxs as cw, boardingResolver as cx, canRecoverOnchain as cy, canSpendOffchain as cz, type GetSpendableVtxosFilter as d, isVtxoExpiringSoon as d0, isVtxoSpent as d1, networks as d2, resolveEmulatorPubkey as d3, resolveEventSource as d4, resolvePrevTxs as d5, scriptFromTapLeafScript as d6, signerSetFromInfo as d7, toXOnlySignerHex as d8, withPrevTxs as d9, type TapscriptDeriving as da, ActivityRegistry as e, type Activity as f, type IContractManager as g, type GetNewAddressesOptions as h, type NewAddress as i, type IDelegateManager as j, type SettleParams as k, type SettlementEvent as l, type SendParams as m, type IAssetManager as n, RestArkProvider as o, RestIndexerProvider as p, type SubscriptionResponse as q, type ArkProvider as r, type IndexerProvider as s, type RelativeTimelock as t, type TapLeafScript as u, type VirtualCoin as v, type Contract as w, type ExtendedVirtualCoin as x, type VtxoRepositoryKey as y, type WalletState as z };