@arkade-os/sdk 0.4.33 → 0.4.34

package/dist/{chunk-HAVA4XB7.cjs → chunk-ZS3OZHC7.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk7K3ROJF6_cjs = require('./chunk-7K3ROJF6.cjs');
+var chunkXCHBQVMK_cjs = require('./chunk-XCHBQVMK.cjs');
 
 // src/worker/expo/taskRunner.ts
 async function runTasks(queue, processors, deps) {
@@ -32,7 +32,7 @@ async function runTasks(queue, processors, deps) {
     }
     const result = {
       ...partial,
-      id: chunk7K3ROJF6_cjs.getRandomId(),
+      id: chunkXCHBQVMK_cjs.getRandomId(),
       executedAt: Date.now()
     };
     await queue.pushResult(result);
@@ -44,7 +44,7 @@ async function runTasks(queue, processors, deps) {
 function createTaskDependencies(options) {
   return {
     ...options,
-    extendVtxo: (vtxo, contract) => chunk7K3ROJF6_cjs.extendVirtualCoinForContract(vtxo, contract)
+    extendVtxo: (vtxo, contract) => chunkXCHBQVMK_cjs.extendVirtualCoinForContract(vtxo, contract)
   };
 }
 
@@ -74,12 +74,12 @@ var contractPollProcessor = {
         hasMore = page ? vtxos.length === pageSize : false;
         pageIndex++;
       }
-      const filtered = chunk7K3ROJF6_cjs.warnAndFilterVtxosForScript(
+      const filtered = chunkXCHBQVMK_cjs.warnAndFilterVtxosForScript(
         allVtxos,
         contract.script,
         "contractPollProcessor"
       );
-      await chunk7K3ROJF6_cjs.saveVtxosForContract(walletRepository, contract, filtered);
+      await chunkXCHBQVMK_cjs.saveVtxosForContract(walletRepository, contract, filtered);
       vtxosSaved += filtered.length;
       contractsProcessed++;
     }
@@ -96,5 +96,5 @@ exports.CONTRACT_POLL_TASK_TYPE = CONTRACT_POLL_TASK_TYPE;
 exports.contractPollProcessor = contractPollProcessor;
 exports.createTaskDependencies = createTaskDependencies;
 exports.runTasks = runTasks;
-//# sourceMappingURL=chunk-HAVA4XB7.cjs.map
-//# sourceMappingURL=chunk-HAVA4XB7.cjs.map
+//# sourceMappingURL=chunk-ZS3OZHC7.cjs.map
+//# sourceMappingURL=chunk-ZS3OZHC7.cjs.map

package/dist/{chunk-HAVA4XB7.cjs.map → chunk-ZS3OZHC7.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/worker/expo/taskRunner.ts","../src/worker/expo/processors/contractPollProcessor.ts"],"names":["getRandomId","extendVirtualCoinForContract","warnAndFilterVtxosForScript","saveVtxosForContract"],"mappings":";;;;;AAkDA,eAAsB,QAAA,CAClB,KAAA,EACA,UAAA,EACA,IAAA,EACqB;AACrB,EAAA,MAAM,KAAA,GAAQ,MAAM,KAAA,CAAM,QAAA,EAAS;AACnC,EAAA,MAAM,YAAA,GAAe,IAAI,GAAA,CAAI,UAAA,CAAW,GAAA,CAAI,CAAC,CAAA,KAAM,CAAC,CAAA,CAAE,QAAA,EAAU,CAAC,CAAC,CAAC,CAAA;AACnE,EAAA,MAAM,UAAwB,EAAC;AAE/B,EAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACtB,IAAA,MAAM,SAAA,GAAY,YAAA,CAAa,GAAA,CAAI,IAAA,CAAK,IAAI,CAAA;AAE5C,IAAA,IAAI,OAAA;AAEJ,IAAA,IAAI,CAAC,SAAA,EAAW;AACZ,MAAA,OAAA,GAAU;AAAA,QACN,YAAY,IAAA,CAAK,EAAA;AAAA,QACjB,MAAM,IAAA,CAAK,IAAA;AAAA,QACX,MAAA,EAAQ;AAAA,OACZ;AAAA,IACJ,CAAA,MAAO;AACH,MAAA,IAAI;AACA,QAAA,OAAA,GAAU,MAAM,SAAA,CAAU,OAAA,CAAQ,IAAA,EAAM,IAAI,CAAA;AAAA,MAChD,SAAS,KAAA,EAAO;AACZ,QAAA,OAAA,GAAU;AAAA,UACN,YAAY,IAAA,CAAK,EAAA;AAAA,UACjB,MAAM,IAAA,CAAK,IAAA;AAAA,UACX,MAAA,EAAQ,QAAA;AAAA,UACR,IAAA,EAAM;AAAA,YACF,OAAO,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,OAAO,KAAK;AAAA;AAChE,SACJ;AAAA,MACJ;AAAA,IACJ;AAEA,IAAA,MAAM,MAAA,GAAqB;AAAA,MACvB,GAAG,OAAA;AAAA,MACH,IAAIA,6BAAA,EAAY;AAAA,MAChB,UAAA,EAAY,KAAK,GAAA;AAAI,KACzB;AAEA,IAAA,MAAM,KAAA,CAAM,WAAW,MAAM,CAAA;AAC7B,IAAA,MAAM,KAAA,CAAM,UAAA,CAAW,IAAA,CAAK,EAAE,CAAA;AAC9B,IAAA,OAAA,CAAQ,KAAK,MAAM,CAAA;AAAA,EACvB;AAEA,EAAA,OAAO,OAAA;AACX;AAqBO,SAAS,uBAAuB,OAAA,EAA0D;AAC7F,EAAA,OAAO;AAAA,IACH,GAAG,OAAA;AAAA,IACH,YAAY,CAAC,IAAA,EAAmB,QAAA,KAC5BC,8CAAA,CAA6B,MAAM,QAAQ;AAAA,GACnD;AACJ;;;ACpHO,IAAM,uBAAA,GAA0B;AAkBhC,IAAM,qBAAA,GAAuC;AAAA,EAChD,QAAA,EAAU,uBAAA;AAAA,EAEV,MAAM,OAAA,CACF,IAAA,EACA,IAAA,EAC8C;AAC9C,IAAA,MAAM,EAAE,kBAAA,EAAoB,gBAAA,EAAkB,eAAA,EAAiB,YAAW,GAAI,IAAA;AAE9E,IAAA,MAAM,SAAA,GAAY,MAAM,kBAAA,CAAmB,YAAA,EAAa;AACxD,IAAA,IAAI,kBAAA,GAAqB,CAAA;AACzB,IAAA,IAAI,UAAA,GAAa,CAAA;AAEjB,IAAA,KAAA,MAAW,YAAY,SAAA,EAAW;AAE9B,MAAA,MAAM,QAAA,GAAW,GAAA;AACjB,MAAA,IAAI,SAAA,GAAY,CAAA;AAChB,MAAA,IAAI,OAAA,GAAU,IAAA;AACd,MAAA,MAAM,WAAkC,EAAC;AAEzC,MAAA,OAAO,OAAA,EAAS;AACZ,QAAA,MAAM,EAAE,KAAA,EAAO,IAAA,EAAK,GAAI,MAAM,gBAAgB,QAAA,CAAS;AAAA,UACnD,OAAA,EAAS,CAAC,QAAA,CAAS,MAAM,CAAA;AAAA,UACzB,SAAA;AAAA,UACA;AAAA,SACH,CAAA;AAED,QAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACtB,UAAA,QAAA,CAAS,IAAA,CAAK,UAAA,CAAW,IAAA,EAAM,QAAQ,CAAC,CAAA;AAAA,QAC5C;AAEA,QAAA,OAAA,GAAU,IAAA,GAAO,KAAA,CAAM,MAAA,KAAW,QAAA,GAAW,KAAA;AAC7C,QAAA,SAAA,EAAA;AAAA,MACJ;AAKA,MAAA,MAAM,QAAA,GAAWC,6CAAA;AAAA,QACb,QAAA;AAAA,QACA,QAAA,CAAS,MAAA;AAAA,QACT;AAAA,OACJ;AACA,MAAA,MAAMC,sCAAA,CAAqB,gBAAA,EAAkB,QAAA,EAAU,QAAQ,CAAA;AAC/D,MAAA,UAAA,IAAc,QAAA,CAAS,MAAA;AACvB,MAAA,kBAAA,EAAA;AAAA,IACJ;AAEA,IAAA,OAAO;AAAA,MACH,YAAY,IAAA,CAAK,EAAA;AAAA,MACjB,IAAA,EAAM,uBAAA;AAAA,MACN,MAAA,EAAQ,SAAA;AAAA,MACR,IAAA,EAAM,EAAE,kBAAA,EAAoB,UAAA;AAAW,KAC3C;AAAA,EACJ;AACJ","file":"chunk-HAVA4XB7.cjs","sourcesContent":["import type { TaskItem, TaskResult, TaskQueue } from \"./taskQueue\";\nimport type { WalletRepository } from \"../../repositories/walletRepository\";\nimport type { ContractRepository } from \"../../repositories/contractRepository\";\nimport type { IndexerProvider } from \"../../providers/indexer\";\nimport type { ArkProvider } from \"../../providers/ark\";\nimport type { ExtendedVirtualCoin, VirtualCoin } from \"../../wallet\";\nimport type { Contract } from \"../../contracts/types\";\nimport { getRandomId, extendVirtualCoinForContract } from \"../../wallet/utils\";\n\n/**\n * Shared dependencies injected into every processor at runtime.\n *\n * `extendVtxo` requires the owning contract — processors must resolve each\n * vtxo's `script` to a known contract (via the contract repository) before\n * calling this. The strict signature prevents the footgun where a missing\n * contract silently falls back to the wallet's default tapscript.\n */\nexport interface TaskDependencies {\n    walletRepository: WalletRepository;\n    contractRepository: ContractRepository;\n    indexerProvider: IndexerProvider;\n    arkProvider: ArkProvider;\n    extendVtxo: (vtxo: VirtualCoin, contract: Contract) => ExtendedVirtualCoin;\n}\n\n/**\n * A stateless unit that handles one type of task item.\n *\n * Processors must not keep in-memory state across invocations —\n * all coordination lives in the @see TaskQueue and repositories.\n *\n * The `TDeps` parameter defaults to @see TaskDependencies but\n * can be overridden for domain-specific processors (e.g. swap processing).\n */\nexport interface TaskProcessor<TDeps = TaskDependencies> {\n    readonly taskType: string;\n    execute(item: TaskItem, deps: TDeps): Promise<Omit<TaskResult, \"id\" | \"executedAt\">>;\n}\n\n/**\n * Run all pending tasks from the queue through matching processors.\n *\n * For each task in the inbox:\n * 1. Find the processor whose `taskType` matches `task.type`.\n * 2. Execute it, producing a @see TaskResult.\n * 3. Push the result to the outbox and remove the task from the inbox.\n *\n * Tasks with no matching processor produce a `\"noop\"` result.\n * Processor errors produce a `\"failed\"` result with the error message.\n */\nexport async function runTasks<TDeps = TaskDependencies>(\n    queue: TaskQueue,\n    processors: TaskProcessor<TDeps>[],\n    deps: TDeps,\n): Promise<TaskResult[]> {\n    const tasks = await queue.getTasks();\n    const processorMap = new Map(processors.map((p) => [p.taskType, p]));\n    const results: TaskResult[] = [];\n\n    for (const task of tasks) {\n        const processor = processorMap.get(task.type);\n\n        let partial: Omit<TaskResult, \"id\" | \"executedAt\">;\n\n        if (!processor) {\n            partial = {\n                taskItemId: task.id,\n                type: task.type,\n                status: \"noop\",\n            };\n        } else {\n            try {\n                partial = await processor.execute(task, deps);\n            } catch (error) {\n                partial = {\n                    taskItemId: task.id,\n                    type: task.type,\n                    status: \"failed\",\n                    data: {\n                        error: error instanceof Error ? error.message : String(error),\n                    },\n                };\n            }\n        }\n\n        const result: TaskResult = {\n            ...partial,\n            id: getRandomId(),\n            executedAt: Date.now(),\n        };\n\n        await queue.pushResult(result);\n        await queue.removeTask(task.id);\n        results.push(result);\n    }\n\n    return results;\n}\n\n/**\n * Options for @see createTaskDependencies.\n */\nexport interface CreateTaskDependenciesOptions {\n    walletRepository: WalletRepository;\n    contractRepository: ContractRepository;\n    indexerProvider: IndexerProvider;\n    arkProvider: ArkProvider;\n}\n\n/**\n * Build the @see TaskDependencies needed by task processors\n * (e.g. `src/worker/expo/processors/contractPollProcessor.ts`)\n *\n * This is the same construction that `defineExpoBackgroundTask` does\n * internally, extracted so that consumers with custom schedulers\n * (e.g. bare React Native with `react-native-background-fetch`)\n * can build deps without depending on Expo.\n */\nexport function createTaskDependencies(options: CreateTaskDependenciesOptions): TaskDependencies {\n    return {\n        ...options,\n        extendVtxo: (vtxo: VirtualCoin, contract: Contract) =>\n            extendVirtualCoinForContract(vtxo, contract),\n    };\n}\n","import type { TaskItem, TaskResult } from \"../taskQueue\";\nimport type { TaskProcessor, TaskDependencies } from \"../taskRunner\";\nimport type { ExtendedVirtualCoin } from \"../../../wallet\";\nimport {\n    warnAndFilterVtxosForScript,\n    saveVtxosForContract,\n} from \"../../../contracts/vtxoOwnership\";\n\nexport const CONTRACT_POLL_TASK_TYPE = \"contract-poll\";\n\n/**\n * Polls the indexer for the latest VTXO state of every contract and\n * persists the results to the wallet repository.\n *\n * Replicates the polling subset of @see ContractManager.initialize:\n * 1. Load all contracts from the contract repository.\n * 2. Paginated fetch of every VTXO (including spent) from the indexer.\n * 3. Extend each VTXO with tapscript data.\n * 4. Save to the wallet repository.\n *\n * NOTE: the indexer query deliberately omits `spendableOnly`. Every\n * repository implements `saveVtxos` as an upsert with no batch delete,\n * so filtering to spendable-only would leave VTXOs that became spent\n * between polls marked as spendable forever. Fetching the full set lets\n * the upsert overwrite stale records with their latest state.\n */\nexport const contractPollProcessor: TaskProcessor = {\n    taskType: CONTRACT_POLL_TASK_TYPE,\n\n    async execute(\n        item: TaskItem,\n        deps: TaskDependencies,\n    ): Promise<Omit<TaskResult, \"id\" | \"executedAt\">> {\n        const { contractRepository, walletRepository, indexerProvider, extendVtxo } = deps;\n\n        const contracts = await contractRepository.getContracts();\n        let contractsProcessed = 0;\n        let vtxosSaved = 0;\n\n        for (const contract of contracts) {\n            // Paginated fetch of spendable virtual outputs\n            const pageSize = 100;\n            let pageIndex = 0;\n            let hasMore = true;\n            const allVtxos: ExtendedVirtualCoin[] = [];\n\n            while (hasMore) {\n                const { vtxos, page } = await indexerProvider.getVtxos({\n                    scripts: [contract.script],\n                    pageIndex,\n                    pageSize,\n                });\n\n                for (const vtxo of vtxos) {\n                    allVtxos.push(extendVtxo(vtxo, contract));\n                }\n\n                hasMore = page ? vtxos.length === pageSize : false;\n                pageIndex++;\n            }\n\n            // Skip wrong-script rows (legacy duplicates or indexer drift)\n            // before persisting; the loop must keep going for the remaining\n            // contracts even when one row is rejected.\n            const filtered = warnAndFilterVtxosForScript(\n                allVtxos,\n                contract.script,\n                \"contractPollProcessor\",\n            );\n            await saveVtxosForContract(walletRepository, contract, filtered);\n            vtxosSaved += filtered.length;\n            contractsProcessed++;\n        }\n\n        return {\n            taskItemId: item.id,\n            type: CONTRACT_POLL_TASK_TYPE,\n            status: \"success\",\n            data: { contractsProcessed, vtxosSaved },\n        };\n    },\n};\n"]}
+{"version":3,"sources":["../src/worker/expo/taskRunner.ts","../src/worker/expo/processors/contractPollProcessor.ts"],"names":["getRandomId","extendVirtualCoinForContract","warnAndFilterVtxosForScript","saveVtxosForContract"],"mappings":"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","file":"chunk-ZS3OZHC7.cjs","sourcesContent":["import type { TaskItem, TaskResult, TaskQueue } from \"./taskQueue\";\nimport type { WalletRepository } from \"../../repositories/walletRepository\";\nimport type { ContractRepository } from \"../../repositories/contractRepository\";\nimport type { IndexerProvider } from \"../../providers/indexer\";\nimport type { ArkProvider } from \"../../providers/ark\";\nimport type { ExtendedVirtualCoin, VirtualCoin } from \"../../wallet\";\nimport type { Contract } from \"../../contracts/types\";\nimport { getRandomId, extendVirtualCoinForContract } from \"../../wallet/utils\";\n\n/**\n * Shared dependencies injected into every processor at runtime.\n *\n * `extendVtxo` requires the owning contract — processors must resolve each\n * vtxo's `script` to a known contract (via the contract repository) before\n * calling this. The strict signature prevents the footgun where a missing\n * contract silently falls back to the wallet's default tapscript.\n */\nexport interface TaskDependencies {\n    walletRepository: WalletRepository;\n    contractRepository: ContractRepository;\n    indexerProvider: IndexerProvider;\n    arkProvider: ArkProvider;\n    extendVtxo: (vtxo: VirtualCoin, contract: Contract) => ExtendedVirtualCoin;\n}\n\n/**\n * A stateless unit that handles one type of task item.\n *\n * Processors must not keep in-memory state across invocations —\n * all coordination lives in the @see TaskQueue and repositories.\n *\n * The `TDeps` parameter defaults to @see TaskDependencies but\n * can be overridden for domain-specific processors (e.g. swap processing).\n */\nexport interface TaskProcessor<TDeps = TaskDependencies> {\n    readonly taskType: string;\n    execute(item: TaskItem, deps: TDeps): Promise<Omit<TaskResult, \"id\" | \"executedAt\">>;\n}\n\n/**\n * Run all pending tasks from the queue through matching processors.\n *\n * For each task in the inbox:\n * 1. Find the processor whose `taskType` matches `task.type`.\n * 2. Execute it, producing a @see TaskResult.\n * 3. Push the result to the outbox and remove the task from the inbox.\n *\n * Tasks with no matching processor produce a `\"noop\"` result.\n * Processor errors produce a `\"failed\"` result with the error message.\n */\nexport async function runTasks<TDeps = TaskDependencies>(\n    queue: TaskQueue,\n    processors: TaskProcessor<TDeps>[],\n    deps: TDeps,\n): Promise<TaskResult[]> {\n    const tasks = await queue.getTasks();\n    const processorMap = new Map(processors.map((p) => [p.taskType, p]));\n    const results: TaskResult[] = [];\n\n    for (const task of tasks) {\n        const processor = processorMap.get(task.type);\n\n        let partial: Omit<TaskResult, \"id\" | \"executedAt\">;\n\n        if (!processor) {\n            partial = {\n                taskItemId: task.id,\n                type: task.type,\n                status: \"noop\",\n            };\n        } else {\n            try {\n                partial = await processor.execute(task, deps);\n            } catch (error) {\n                partial = {\n                    taskItemId: task.id,\n                    type: task.type,\n                    status: \"failed\",\n                    data: {\n                        error: error instanceof Error ? error.message : String(error),\n                    },\n                };\n            }\n        }\n\n        const result: TaskResult = {\n            ...partial,\n            id: getRandomId(),\n            executedAt: Date.now(),\n        };\n\n        await queue.pushResult(result);\n        await queue.removeTask(task.id);\n        results.push(result);\n    }\n\n    return results;\n}\n\n/**\n * Options for @see createTaskDependencies.\n */\nexport interface CreateTaskDependenciesOptions {\n    walletRepository: WalletRepository;\n    contractRepository: ContractRepository;\n    indexerProvider: IndexerProvider;\n    arkProvider: ArkProvider;\n}\n\n/**\n * Build the @see TaskDependencies needed by task processors\n * (e.g. `src/worker/expo/processors/contractPollProcessor.ts`)\n *\n * This is the same construction that `defineExpoBackgroundTask` does\n * internally, extracted so that consumers with custom schedulers\n * (e.g. bare React Native with `react-native-background-fetch`)\n * can build deps without depending on Expo.\n */\nexport function createTaskDependencies(options: CreateTaskDependenciesOptions): TaskDependencies {\n    return {\n        ...options,\n        extendVtxo: (vtxo: VirtualCoin, contract: Contract) =>\n            extendVirtualCoinForContract(vtxo, contract),\n    };\n}\n","import type { TaskItem, TaskResult } from \"../taskQueue\";\nimport type { TaskProcessor, TaskDependencies } from \"../taskRunner\";\nimport type { ExtendedVirtualCoin } from \"../../../wallet\";\nimport {\n    warnAndFilterVtxosForScript,\n    saveVtxosForContract,\n} from \"../../../contracts/vtxoOwnership\";\n\nexport const CONTRACT_POLL_TASK_TYPE = \"contract-poll\";\n\n/**\n * Polls the indexer for the latest VTXO state of every contract and\n * persists the results to the wallet repository.\n *\n * Replicates the polling subset of @see ContractManager.initialize:\n * 1. Load all contracts from the contract repository.\n * 2. Paginated fetch of every VTXO (including spent) from the indexer.\n * 3. Extend each VTXO with tapscript data.\n * 4. Save to the wallet repository.\n *\n * NOTE: the indexer query deliberately omits `spendableOnly`. Every\n * repository implements `saveVtxos` as an upsert with no batch delete,\n * so filtering to spendable-only would leave VTXOs that became spent\n * between polls marked as spendable forever. Fetching the full set lets\n * the upsert overwrite stale records with their latest state.\n */\nexport const contractPollProcessor: TaskProcessor = {\n    taskType: CONTRACT_POLL_TASK_TYPE,\n\n    async execute(\n        item: TaskItem,\n        deps: TaskDependencies,\n    ): Promise<Omit<TaskResult, \"id\" | \"executedAt\">> {\n        const { contractRepository, walletRepository, indexerProvider, extendVtxo } = deps;\n\n        const contracts = await contractRepository.getContracts();\n        let contractsProcessed = 0;\n        let vtxosSaved = 0;\n\n        for (const contract of contracts) {\n            // Paginated fetch of spendable virtual outputs\n            const pageSize = 100;\n            let pageIndex = 0;\n            let hasMore = true;\n            const allVtxos: ExtendedVirtualCoin[] = [];\n\n            while (hasMore) {\n                const { vtxos, page } = await indexerProvider.getVtxos({\n                    scripts: [contract.script],\n                    pageIndex,\n                    pageSize,\n                });\n\n                for (const vtxo of vtxos) {\n                    allVtxos.push(extendVtxo(vtxo, contract));\n                }\n\n                hasMore = page ? vtxos.length === pageSize : false;\n                pageIndex++;\n            }\n\n            // Skip wrong-script rows (legacy duplicates or indexer drift)\n            // before persisting; the loop must keep going for the remaining\n            // contracts even when one row is rejected.\n            const filtered = warnAndFilterVtxosForScript(\n                allVtxos,\n                contract.script,\n                \"contractPollProcessor\",\n            );\n            await saveVtxosForContract(walletRepository, contract, filtered);\n            vtxosSaved += filtered.length;\n            contractsProcessed++;\n        }\n\n        return {\n            taskItemId: item.id,\n            type: CONTRACT_POLL_TASK_TYPE,\n            status: \"success\",\n            data: { contractsProcessed, vtxosSaved },\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-lNZ6qaO3.cjs';
+import '../../ark-Dsv5Jq4E.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-BaS5SCIW.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-FwXZveaX.js';
+import '../../ark-Dsv5Jq4E.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-Baz_hb83.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-BaS5SCIW.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-Dsv5Jq4E.cjs';
 
 /**
  * DefaultVtxo is the default implementation of a VtxoScript.

package/dist/{delegate-EXN2mfkb.d.ts → delegate-Baz_hb83.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-Dsv5Jq4E.js';
 
 /**
  * DefaultVtxo is the default implementation of a VtxoScript.

package/dist/{index-BG2ooYKO.d.ts → index-FwXZveaX.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, aN as ContractHandler, aW as Discoverable } from './ark-Dsv5Jq4E.js';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-Baz_hb83.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-lNZ6qaO3.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, aN as ContractHandler, aW as Discoverable } from './ark-Dsv5Jq4E.cjs';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-BaS5SCIW.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 };