@arkade-os/sdk 0.4.32 → 0.4.34

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

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkKQK4PP6L_cjs = require('./chunk-KQK4PP6L.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: chunkKQK4PP6L_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) => chunkKQK4PP6L_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 = chunkKQK4PP6L_cjs.warnAndFilterVtxosForScript(
+      const filtered = chunkXCHBQVMK_cjs.warnAndFilterVtxosForScript(
         allVtxos,
         contract.script,
         "contractPollProcessor"
       );
-      await chunkKQK4PP6L_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-I2UIKZM5.cjs.map
-//# sourceMappingURL=chunk-I2UIKZM5.cjs.map
+//# sourceMappingURL=chunk-ZS3OZHC7.cjs.map
+//# sourceMappingURL=chunk-ZS3OZHC7.cjs.map

package/dist/{chunk-I2UIKZM5.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":"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","file":"chunk-I2UIKZM5.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,26 +1,30 @@
 'use strict';
 
-var chunkIEO3XDKI_cjs = require('../../chunk-IEO3XDKI.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 chunkGUTKJMSF_cjs.BoardingContractHandler; }
+});
 Object.defineProperty(exports, "DefaultContractHandler", {
   enumerable: true,
-  get: function () { return chunkIEO3XDKI_cjs.DefaultContractHandler; }
+  get: function () { return chunkGUTKJMSF_cjs.DefaultContractHandler; }
 });
 Object.defineProperty(exports, "DelegateContractHandler", {
   enumerable: true,
-  get: function () { return chunkIEO3XDKI_cjs.DelegateContractHandler; }
+  get: function () { return chunkGUTKJMSF_cjs.DelegateContractHandler; }
 });
 Object.defineProperty(exports, "VHTLCContractHandler", {
   enumerable: true,
-  get: function () { return chunkIEO3XDKI_cjs.VHTLCContractHandler; }
+  get: function () { return chunkGUTKJMSF_cjs.VHTLCContractHandler; }
 });
 Object.defineProperty(exports, "contractHandlers", {
   enumerable: true,
-  get: function () { return chunkIEO3XDKI_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 { D as DefaultContractHandler, a as DefaultContractParams, b as DelegateContractHandler, c as DelegateContractParams, d as VHTLCContractHandler, e as VHTLCContractParams, f as contractHandlers } from '../../index-C-5Tw7VA.cjs';
-import '../../ark-ibLW4Hte.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-BvNTw44a.cjs';
+import '../../delegate-BaS5SCIW.cjs';

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

@@ -1,7 +1,7 @@
-export { D as DefaultContractHandler, a as DefaultContractParams, b as DelegateContractHandler, c as DelegateContractParams, d as VHTLCContractHandler, e as VHTLCContractParams, f as contractHandlers } from '../../index-BusKawmy.js';
-import '../../ark-ibLW4Hte.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-BXaR1RNG.js';
+import '../../delegate-Baz_hb83.js';

package/dist/contracts/handlers/index.js

@@ -1,5 +1,5 @@
-export { DefaultContractHandler, DelegateContractHandler, VHTLCContractHandler, contractHandlers } from '../../chunk-YA4G7RFB.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-BvNTw44a.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-ibLW4Hte.cjs';
+import { o as RelativeTimelock, V as VtxoScript, p as TapLeafScript } from './ark-Dsv5Jq4E.cjs';
 
 /**
  * DefaultVtxo is the default implementation of a VtxoScript.
@@ -15,7 +15,7 @@ declare namespace DefaultVtxo {
     interface Options {
         pubKey: Bytes;
         serverPubKey: Bytes;
-        csvTimelock?: RelativeTimelock;
+        csvTimelock: RelativeTimelock;
     }
     /**
      * DefaultVtxo.Script is the class letting to create the vtxo script.
@@ -24,6 +24,10 @@ declare namespace DefaultVtxo {
      * const vtxoScript = new DefaultVtxo.Script({
      *     pubKey: new Uint8Array(32),
      *     serverPubKey: new Uint8Array(32),
+     *     csvTimelock: {
+     *         value: 605184n,
+     *         type: "seconds"
+     *     }
      * });
      *
      * console.log("script pub key:", vtxoScript.pkScript)
@@ -61,6 +65,10 @@ declare namespace DelegateVtxo {
      *     pubKey: new Uint8Array(32),
      *     serverPubKey: new Uint8Array(32),
      *     delegatePubKey: new Uint8Array(32),
+     *     csvTimelock: {
+     *         value: 605184n,
+     *         type: "seconds"
+     *     }
      * });
      *
      * console.log("script pub key:", vtxoScript.pkScript)

package/dist/{delegate-BXaR1RNG.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-ibLW4Hte.js';
+import { o as RelativeTimelock, V as VtxoScript, p as TapLeafScript } from './ark-Dsv5Jq4E.js';
 
 /**
  * DefaultVtxo is the default implementation of a VtxoScript.
@@ -15,7 +15,7 @@ declare namespace DefaultVtxo {
     interface Options {
         pubKey: Bytes;
         serverPubKey: Bytes;
-        csvTimelock?: RelativeTimelock;
+        csvTimelock: RelativeTimelock;
     }
     /**
      * DefaultVtxo.Script is the class letting to create the vtxo script.
@@ -24,6 +24,10 @@ declare namespace DefaultVtxo {
      * const vtxoScript = new DefaultVtxo.Script({
      *     pubKey: new Uint8Array(32),
      *     serverPubKey: new Uint8Array(32),
+     *     csvTimelock: {
+     *         value: 605184n,
+     *         type: "seconds"
+     *     }
      * });
      *
      * console.log("script pub key:", vtxoScript.pkScript)
@@ -61,6 +65,10 @@ declare namespace DelegateVtxo {
      *     pubKey: new Uint8Array(32),
      *     serverPubKey: new Uint8Array(32),
      *     delegatePubKey: new Uint8Array(32),
+     *     csvTimelock: {
+     *         value: 605184n,
+     *         type: "seconds"
+     *     }
      * });
      *
      * console.log("script pub key:", vtxoScript.pkScript)

package/dist/{index-BusKawmy.d.ts → index-FwXZveaX.d.ts}

@@ -1,5 +1,5 @@
-import { o as RelativeTimelock, V as VtxoScript, p as TapLeafScript, aM as ContractHandler, aV as Discoverable } from './ark-ibLW4Hte.js';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-BXaR1RNG.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. */
@@ -196,4 +196,64 @@ interface VHTLCContractParams {
  */
 declare const VHTLCContractHandler: ContractHandler<VHTLCContractParams, VHTLC.Script>;
 
-export { DefaultContractHandler as D, VHTLC as V, type DefaultContractParams as a, DelegateContractHandler as b, type DelegateContractParams as c, VHTLCContractHandler as d, type VHTLCContractParams as e, contractHandlers as f };
+/**
+ * Typed parameters for boarding contracts.
+ *
+ * Boarding reuses the exact `default` contract parameter shape
+ * (`pubKey` / `serverPubKey` / `csvTimelock`) rather than inventing
+ * boarding-specific names — the boarding semantics come from the
+ * contract type and from populating `csvTimelock` with the server's
+ * boarding-exit delay (`ArkInfo.boardingExitDelay`) instead of the
+ * offchain unilateral-exit delay.
+ */
+type BoardingContractParams = DefaultContractParams;
+/**
+ * Handler for the boarding contract (registered type `boarding`).
+ *
+ * The boarding contract derives the on-chain Bitcoin address used to
+ * board funds onto Arkade. It shares the exact `DefaultVtxo.Script`
+ * shape with the `default` contract — a Taproot output co-owned by the
+ * wallet and the Ark server, with a CSV exit path back to the wallet —
+ * and therefore reuses the `default` handler's path logic (forfeit via
+ * server cooperation, exit after the boarding CSV).
+ *
+ * Boarding semantics come entirely from the contract type and from
+ * sourcing the CSV timelock from the server's boarding-exit delay
+ * (`ArkInfo.boardingExitDelay`), not from renamed parameters. The
+ * offchain `default` contract is built from `ArkInfo.unilateralExitDelay`
+ * instead, so the two share a script shape but differ in their CSV
+ * timelock value. Parameters round-trip through the same
+ * `timelockToSequence` / `sequenceToTimelock` helpers and BIP68 sequence
+ * encoding as `default` / `delegate`.
+ *
+ * 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`
+ * is a first-class type with its own row **when its script is distinct** from
+ * the wallet's `default` baseline — the real-world case, since a sound Ark
+ * 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. `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> & 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-C-5Tw7VA.d.cts → index-lNZ6qaO3.d.cts}

@@ -1,5 +1,5 @@
-import { o as RelativeTimelock, V as VtxoScript, p as TapLeafScript, aM as ContractHandler, aV as Discoverable } from './ark-ibLW4Hte.cjs';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-BvNTw44a.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. */
@@ -196,4 +196,64 @@ interface VHTLCContractParams {
  */
 declare const VHTLCContractHandler: ContractHandler<VHTLCContractParams, VHTLC.Script>;
 
-export { DefaultContractHandler as D, VHTLC as V, type DefaultContractParams as a, DelegateContractHandler as b, type DelegateContractParams as c, VHTLCContractHandler as d, type VHTLCContractParams as e, contractHandlers as f };
+/**
+ * Typed parameters for boarding contracts.
+ *
+ * Boarding reuses the exact `default` contract parameter shape
+ * (`pubKey` / `serverPubKey` / `csvTimelock`) rather than inventing
+ * boarding-specific names — the boarding semantics come from the
+ * contract type and from populating `csvTimelock` with the server's
+ * boarding-exit delay (`ArkInfo.boardingExitDelay`) instead of the
+ * offchain unilateral-exit delay.
+ */
+type BoardingContractParams = DefaultContractParams;
+/**
+ * Handler for the boarding contract (registered type `boarding`).
+ *
+ * The boarding contract derives the on-chain Bitcoin address used to
+ * board funds onto Arkade. It shares the exact `DefaultVtxo.Script`
+ * shape with the `default` contract — a Taproot output co-owned by the
+ * wallet and the Ark server, with a CSV exit path back to the wallet —
+ * and therefore reuses the `default` handler's path logic (forfeit via
+ * server cooperation, exit after the boarding CSV).
+ *
+ * Boarding semantics come entirely from the contract type and from
+ * sourcing the CSV timelock from the server's boarding-exit delay
+ * (`ArkInfo.boardingExitDelay`), not from renamed parameters. The
+ * offchain `default` contract is built from `ArkInfo.unilateralExitDelay`
+ * instead, so the two share a script shape but differ in their CSV
+ * timelock value. Parameters round-trip through the same
+ * `timelockToSequence` / `sequenceToTimelock` helpers and BIP68 sequence
+ * encoding as `default` / `delegate`.
+ *
+ * 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`
+ * is a first-class type with its own row **when its script is distinct** from
+ * the wallet's `default` baseline — the real-world case, since a sound Ark
+ * 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. `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> & 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 };