@arkade-os/sdk 0.4.33 → 0.4.35

package/dist/{chunk-L6ZETTX3.js → chunk-XQS2HW4Q.js}

@@ -1,12 +1,18 @@
-import { RestArkProvider, isFetchTimeoutError, RestIndexerProvider } from './chunk-E22HEKLN.js';
-import { DEFAULT_ARKADE_SERVER_URL } from './chunk-TU3LVAPX.js';
+import { RestArkProvider, isFetchTimeoutError, RestIndexerProvider, buildVersion, sdkVersion, fetch } from './chunk-3JR77WQ4.js';
+import { DEFAULT_ARKADE_SERVER_URL } from './chunk-OUVTG72A.js';
 
 // src/providers/expoUtils.ts
 async function getExpoFetch(options) {
   try {
     const expoFetchModule = await import('expo/fetch');
     console.debug("Using expo/fetch for streaming");
-    return expoFetchModule.fetch;
+    const expoFetchWithHeader = (input, init) => {
+      const headers = new Headers(init?.headers);
+      headers.set("X-Build-Version", buildVersion);
+      headers.set("X-SDK-VERSION", sdkVersion);
+      return expoFetchModule.fetch(input, { ...init, headers });
+    };
+    return expoFetchWithHeader;
   } catch (error) {
     console.warn(
       "Using standard fetch instead of expo/fetch. Streaming may not be fully supported in some environments.",
@@ -206,5 +212,5 @@ var ExpoIndexerProvider = class extends RestIndexerProvider {
 };
 
 export { ExpoArkProvider, ExpoIndexerProvider };
-//# sourceMappingURL=chunk-L6ZETTX3.js.map
-//# sourceMappingURL=chunk-L6ZETTX3.js.map
+//# sourceMappingURL=chunk-XQS2HW4Q.js.map
+//# sourceMappingURL=chunk-XQS2HW4Q.js.map

package/dist/chunk-XQS2HW4Q.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/providers/expoUtils.ts","../src/providers/expoArk.ts","../src/providers/expoIndexer.ts"],"names":[],"mappings":"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","file":"chunk-XQS2HW4Q.js","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            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, TxNotification, 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(signal: AbortSignal): AsyncIterableIterator<{\n        commitmentTx?: TxNotification;\n        arkTx?: TxNotification;\n    }> {\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, Vtxo } from \"./indexer\";\nimport { isFetchTimeoutError } from \"./ark\";\nimport { VirtualCoin } from \"../wallet\";\nimport { getExpoFetch, sseStreamIterator } from \"./expoUtils\";\nimport { DEFAULT_ARKADE_SERVER_URL } from \"../networks\";\n\n// Helper function to convert Vtxo to VirtualCoin (same as in indexer.ts)\nfunction convertVtxo(vtxo: Vtxo): VirtualCoin {\n    return {\n        txid: vtxo.outpoint.txid,\n        vout: vtxo.outpoint.vout,\n        value: Number(vtxo.amount),\n        status: {\n            confirmed: !vtxo.isSwept && !vtxo.isPreconfirmed,\n            isLeaf: !vtxo.isPreconfirmed,\n        },\n        virtualStatus: {\n            state: vtxo.isSwept ? \"swept\" : vtxo.isPreconfirmed ? \"preconfirmed\" : \"settled\",\n            commitmentTxIds: vtxo.commitmentTxids,\n            batchExpiry: vtxo.expiresAt ? Number(vtxo.expiresAt) * 1000 : undefined,\n        },\n        spentBy: vtxo.spentBy ?? \"\",\n        settledBy: vtxo.settledBy,\n        arkTxId: vtxo.arkTxid,\n        createdAt: new Date(Number(vtxo.createdAt) * 1000),\n        isUnrolled: vtxo.isUnrolled,\n        isSpent: vtxo.isSpent,\n        script: vtxo.script,\n        assets: vtxo.assets?.map((a) => ({\n            assetId: a.assetId,\n            amount: BigInt(a.amount),\n        })),\n    };\n}\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,30 +1,30 @@
 'use strict';
 
-var chunkGYSK5R57_cjs = require('../../chunk-GYSK5R57.cjs');
-require('../../chunk-WMIPYZSB.cjs');
+var chunkGUTKJMSF_cjs = require('../../chunk-GUTKJMSF.cjs');
+require('../../chunk-CMPJR3HS.cjs');
 require('../../chunk-5BLDMQED.cjs');
 
 
 
 Object.defineProperty(exports, "BoardingContractHandler", {
   enumerable: true,
-  get: function () { return chunkGYSK5R57_cjs.BoardingContractHandler; }
+  get: function () { return chunkGUTKJMSF_cjs.BoardingContractHandler; }
 });
 Object.defineProperty(exports, "DefaultContractHandler", {
   enumerable: true,
-  get: function () { return chunkGYSK5R57_cjs.DefaultContractHandler; }
+  get: function () { return chunkGUTKJMSF_cjs.DefaultContractHandler; }
 });
 Object.defineProperty(exports, "DelegateContractHandler", {
   enumerable: true,
-  get: function () { return chunkGYSK5R57_cjs.DelegateContractHandler; }
+  get: function () { return chunkGUTKJMSF_cjs.DelegateContractHandler; }
 });
 Object.defineProperty(exports, "VHTLCContractHandler", {
   enumerable: true,
-  get: function () { return chunkGYSK5R57_cjs.VHTLCContractHandler; }
+  get: function () { return chunkGUTKJMSF_cjs.VHTLCContractHandler; }
 });
 Object.defineProperty(exports, "contractHandlers", {
   enumerable: true,
-  get: function () { return chunkGYSK5R57_cjs.contractHandlers; }
+  get: function () { return chunkGUTKJMSF_cjs.contractHandlers; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/contracts/handlers/index.d.cts

@@ -1,7 +1,7 @@
-export { B as BoardingContractHandler, a as BoardingContractParams, D as DefaultContractHandler, b as DefaultContractParams, c as DelegateContractHandler, d as DelegateContractParams, e as VHTLCContractHandler, f as VHTLCContractParams, g as contractHandlers } from '../../index-DHjEeHEp.cjs';
-import '../../ark-DEsDMYGv.cjs';
+export { B as BoardingContractHandler, a as BoardingContractParams, D as DefaultContractHandler, b as DefaultContractParams, c as DelegateContractHandler, d as DelegateContractParams, e as VHTLCContractHandler, f as VHTLCContractParams, g as contractHandlers } from '../../index-jwQfHP6D.cjs';
+import '../../ark-D6sau_6-.cjs';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';
 import '@scure/btc-signer';
-import '../../delegate-BJeBNP5a.cjs';
+import '../../delegate-C-L6gSZx.cjs';

package/dist/contracts/handlers/index.d.ts

@@ -1,7 +1,7 @@
-export { B as BoardingContractHandler, a as BoardingContractParams, D as DefaultContractHandler, b as DefaultContractParams, c as DelegateContractHandler, d as DelegateContractParams, e as VHTLCContractHandler, f as VHTLCContractParams, g as contractHandlers } from '../../index-BG2ooYKO.js';
-import '../../ark-DEsDMYGv.js';
+export { B as BoardingContractHandler, a as BoardingContractParams, D as DefaultContractHandler, b as DefaultContractParams, c as DelegateContractHandler, d as DelegateContractParams, e as VHTLCContractHandler, f as VHTLCContractParams, g as contractHandlers } from '../../index-BETdjE_o.js';
+import '../../ark-D6sau_6-.js';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';
 import '@scure/btc-signer';
-import '../../delegate-EXN2mfkb.js';
+import '../../delegate-De5__fpZ.js';

package/dist/contracts/handlers/index.js

@@ -1,5 +1,5 @@
-export { BoardingContractHandler, DefaultContractHandler, DelegateContractHandler, VHTLCContractHandler, contractHandlers } from '../../chunk-AOJUURHM.js';
-import '../../chunk-TU3LVAPX.js';
+export { BoardingContractHandler, DefaultContractHandler, DelegateContractHandler, VHTLCContractHandler, contractHandlers } from '../../chunk-CUSABEUQ.js';
+import '../../chunk-OUVTG72A.js';
 import '../../chunk-NSBPE2FW.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{delegate-BJeBNP5a.d.cts → delegate-C-L6gSZx.d.cts}

@@ -1,5 +1,5 @@
 import { Bytes } from '@scure/btc-signer/utils.js';
-import { o as RelativeTimelock, V as VtxoScript, p as TapLeafScript } from './ark-DEsDMYGv.cjs';
+import { o as RelativeTimelock, V as VtxoScript, p as TapLeafScript } from './ark-D6sau_6-.cjs';
 
 /**
  * DefaultVtxo is the default implementation of a VtxoScript.

package/dist/{delegate-EXN2mfkb.d.ts → delegate-De5__fpZ.d.ts}

@@ -1,5 +1,5 @@
 import { Bytes } from '@scure/btc-signer/utils.js';
-import { o as RelativeTimelock, V as VtxoScript, p as TapLeafScript } from './ark-DEsDMYGv.js';
+import { o as RelativeTimelock, V as VtxoScript, p as TapLeafScript } from './ark-D6sau_6-.js';
 
 /**
  * DefaultVtxo is the default implementation of a VtxoScript.

package/dist/{index-BG2ooYKO.d.ts → index-BETdjE_o.d.ts}

@@ -1,5 +1,5 @@
-import { o as RelativeTimelock, V as VtxoScript, p as TapLeafScript, aN as ContractHandler, aW as Discoverable } from './ark-DEsDMYGv.js';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-EXN2mfkb.js';
+import { o as RelativeTimelock, V as VtxoScript, p as TapLeafScript, aQ as ContractHandler, b0 as Discoverable } from './ark-D6sau_6-.js';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-De5__fpZ.js';
 import { Bytes } from '@scure/btc-signer/utils.js';
 
 /** Virtual Hash Time Lock Contract (VHTLC) namespace. */
@@ -226,11 +226,14 @@ type BoardingContractParams = DefaultContractParams;
  * `timelockToSequence` / `sequenceToTimelock` helpers and BIP68 sequence
  * encoding as `default` / `delegate`.
  *
- * Unlike `default` / `delegate`, the boarding handler deliberately does
- * **not** implement {@link Discoverable.discoverAt}: branch/index
- * selection for HD wallets is owned by the wallet / address-provider
- * layer, which hands this handler an already-derived pubkey. As a result
- * `isDiscoverable(BoardingContractHandler)` is `false`.
+ * Like `default` / `delegate`, the boarding handler implements
+ * {@link Discoverable.discoverAt} so `wallet.restore()` can rediscover
+ * used boarding indices from authoritative on-chain data. It differs from
+ * the L2 handlers in its source of truth: boarding probes the **on-chain**
+ * UTXO set at its P2TR address (`OnchainProvider.getCoins`) rather than the
+ * Ark indexer, and builds its candidate from the boarding-exit CSV
+ * (`deps.boardingTimelock`). When boarding discovery is not plumbed (no
+ * `deps.boardingTimelock` / `deps.onchainNetwork`) `discoverAt` no-ops.
  *
  * Identity & the default/boarding collision: a contract's `script` (pkScript)
  * is its unique identity — a script owns exactly one repository row. `boarding`
@@ -239,15 +242,18 @@ type BoardingContractParams = DefaultContractParams;
  * server keeps boardingExitDelay strictly longer than unilateralExitDelay (equal
  * delays would expose the provider to a double-spend). Should those delays ever
  * coincide (a misconfigured/malicious server), the boarding script is
- * byte-identical to the default script and the wallet coalesces the single
- * shared row onto the `default` type ("default wins"; see `ensureWalletContract`)
- * rather than persisting a second row. Either way the funds are equally spendable
- * through the shared `DefaultVtxo.Script` paths. Consumers must NOT rely on
- * `contract.type === "boarding"` to identify the boarding purpose — resolve the
- * boarding script via `wallet.getBoardingAddress()` / `wallet.boardingTapscript`
- * (which never depend on the persisted contract's type) and match by script when
- * needed.
+ * byte-identical to the default script. `discoverAt` does NOT pre-coalesce that
+ * collision: it always emits `type: "boarding"`, and the single shared row is
+ * resolved FIRST-WINS at the persistence layer
+ * ({@link ContractManager.upsertContract}) — whichever purpose is persisted
+ * first keeps the row, and the scan deliberately probes boarding first
+ * (see docs/hd-wallets_onchain_rotation_collision_fix.md §5.1–5.2). Either way
+ * the funds are equally spendable through the shared `DefaultVtxo.Script` paths.
+ * Consumers must NOT rely on `contract.type === "boarding"` to identify the
+ * boarding purpose — resolve the boarding script via
+ * `wallet.getBoardingAddress()` / `wallet.boardingTapscript` (which never depend
+ * on the persisted contract's type) and match by script when needed.
  */
-declare const BoardingContractHandler: ContractHandler<BoardingContractParams, DefaultVtxo.Script>;
+declare const BoardingContractHandler: ContractHandler<BoardingContractParams, DefaultVtxo.Script> & Discoverable;
 
 export { BoardingContractHandler as B, DefaultContractHandler as D, VHTLC as V, type BoardingContractParams as a, type DefaultContractParams as b, DelegateContractHandler as c, type DelegateContractParams as d, VHTLCContractHandler as e, type VHTLCContractParams as f, contractHandlers as g };

package/dist/{index-DHjEeHEp.d.cts → index-jwQfHP6D.d.cts}

@@ -1,5 +1,5 @@
-import { o as RelativeTimelock, V as VtxoScript, p as TapLeafScript, aN as ContractHandler, aW as Discoverable } from './ark-DEsDMYGv.cjs';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-BJeBNP5a.cjs';
+import { o as RelativeTimelock, V as VtxoScript, p as TapLeafScript, aQ as ContractHandler, b0 as Discoverable } from './ark-D6sau_6-.cjs';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-C-L6gSZx.cjs';
 import { Bytes } from '@scure/btc-signer/utils.js';
 
 /** Virtual Hash Time Lock Contract (VHTLC) namespace. */
@@ -226,11 +226,14 @@ type BoardingContractParams = DefaultContractParams;
  * `timelockToSequence` / `sequenceToTimelock` helpers and BIP68 sequence
  * encoding as `default` / `delegate`.
  *
- * Unlike `default` / `delegate`, the boarding handler deliberately does
- * **not** implement {@link Discoverable.discoverAt}: branch/index
- * selection for HD wallets is owned by the wallet / address-provider
- * layer, which hands this handler an already-derived pubkey. As a result
- * `isDiscoverable(BoardingContractHandler)` is `false`.
+ * Like `default` / `delegate`, the boarding handler implements
+ * {@link Discoverable.discoverAt} so `wallet.restore()` can rediscover
+ * used boarding indices from authoritative on-chain data. It differs from
+ * the L2 handlers in its source of truth: boarding probes the **on-chain**
+ * UTXO set at its P2TR address (`OnchainProvider.getCoins`) rather than the
+ * Ark indexer, and builds its candidate from the boarding-exit CSV
+ * (`deps.boardingTimelock`). When boarding discovery is not plumbed (no
+ * `deps.boardingTimelock` / `deps.onchainNetwork`) `discoverAt` no-ops.
  *
  * Identity & the default/boarding collision: a contract's `script` (pkScript)
  * is its unique identity — a script owns exactly one repository row. `boarding`
@@ -239,15 +242,18 @@ type BoardingContractParams = DefaultContractParams;
  * server keeps boardingExitDelay strictly longer than unilateralExitDelay (equal
  * delays would expose the provider to a double-spend). Should those delays ever
  * coincide (a misconfigured/malicious server), the boarding script is
- * byte-identical to the default script and the wallet coalesces the single
- * shared row onto the `default` type ("default wins"; see `ensureWalletContract`)
- * rather than persisting a second row. Either way the funds are equally spendable
- * through the shared `DefaultVtxo.Script` paths. Consumers must NOT rely on
- * `contract.type === "boarding"` to identify the boarding purpose — resolve the
- * boarding script via `wallet.getBoardingAddress()` / `wallet.boardingTapscript`
- * (which never depend on the persisted contract's type) and match by script when
- * needed.
+ * byte-identical to the default script. `discoverAt` does NOT pre-coalesce that
+ * collision: it always emits `type: "boarding"`, and the single shared row is
+ * resolved FIRST-WINS at the persistence layer
+ * ({@link ContractManager.upsertContract}) — whichever purpose is persisted
+ * first keeps the row, and the scan deliberately probes boarding first
+ * (see docs/hd-wallets_onchain_rotation_collision_fix.md §5.1–5.2). Either way
+ * the funds are equally spendable through the shared `DefaultVtxo.Script` paths.
+ * Consumers must NOT rely on `contract.type === "boarding"` to identify the
+ * boarding purpose — resolve the boarding script via
+ * `wallet.getBoardingAddress()` / `wallet.boardingTapscript` (which never depend
+ * on the persisted contract's type) and match by script when needed.
  */
-declare const BoardingContractHandler: ContractHandler<BoardingContractParams, DefaultVtxo.Script>;
+declare const BoardingContractHandler: ContractHandler<BoardingContractParams, DefaultVtxo.Script> & Discoverable;
 
 export { BoardingContractHandler as B, DefaultContractHandler as D, VHTLC as V, type BoardingContractParams as a, type DefaultContractParams as b, DelegateContractHandler as c, type DelegateContractParams as d, VHTLCContractHandler as e, type VHTLCContractParams as f, contractHandlers as g };