@satora/escrow 0.0.1-alpha.0

package/dist/2-of-2/ark-contract.d.ts

@@ -0,0 +1,29 @@
+import { type Contract, type ContractState, type CreateContractParams, type Network } from "@arkade-os/sdk";
+import { type EscrowScriptOptions } from "./escrow-script.js";
+/** Optional descriptive fields carried alongside a registered contract. */
+export interface EscrowContractMeta {
+    label?: string;
+    state?: ContractState;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Build {@link CreateContractParams} for a 2-of-2 escrow: derives the pkScript
+ * and funding address from the escrow parameters, ready to hand to
+ * `ContractManager.createContract`.
+ */
+export declare function escrowCreateContractParams(options: EscrowScriptOptions, network: Network, meta?: EscrowContractMeta): CreateContractParams;
+/**
+ * Encode a 2-of-2 escrow as a NArk-compatible `arkcontract=` string for the
+ * server→client handoff. Carries the escrow parameters only — the receiver
+ * re-derives the script and address via {@link decodeEscrowArkContract}.
+ */
+export declare function encodeEscrowArkContract(options: EscrowScriptOptions): string;
+/**
+ * Decode an escrow `arkcontract=` string into a full {@link Contract},
+ * re-deriving the pkScript and funding address from the embedded parameters.
+ *
+ * Registers the escrow handler if needed, so the caller does not have to.
+ * `aspPubKey` is the ASP x-only key the funding address is built from.
+ */
+export declare function decodeEscrowArkContract(encoded: string, aspPubKey: Uint8Array, network: Network, meta?: EscrowContractMeta): Contract;
+//# sourceMappingURL=ark-contract.d.ts.map

package/dist/2-of-2/ark-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ark-contract.d.ts","sourceRoot":"","sources":["../../src/2-of-2/ark-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,oBAAoB,EAGzB,KAAK,OAAO,EACb,MAAM,gBAAgB,CAAC;AAOxB,OAAO,EAAE,KAAK,mBAAmB,EAAoB,MAAM,oBAAoB,CAAC;AAEhF,2EAA2E;AAC3E,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,OAAO,EAChB,IAAI,GAAE,kBAAuB,GAC5B,oBAAoB,CAWtB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAM5E;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,OAAO,EAChB,IAAI,GAAE,kBAAuB,GAC5B,QAAQ,CAOV"}

package/dist/2-of-2/ark-contract.js

@@ -0,0 +1,49 @@
+import { contractFromArkContractWithAddress, encodeArkContract, } from "@arkade-os/sdk";
+import { hex } from "@scure/base";
+import { ESCROW_2OF2_CONTRACT_TYPE, EscrowContractHandler, registerEscrowContractHandler, } from "./contract-handler.js";
+import { EscrowVtxoScript } from "./escrow-script.js";
+/**
+ * Build {@link CreateContractParams} for a 2-of-2 escrow: derives the pkScript
+ * and funding address from the escrow parameters, ready to hand to
+ * `ContractManager.createContract`.
+ */
+export function escrowCreateContractParams(options, network, meta = {}) {
+    const script = new EscrowVtxoScript(options);
+    return {
+        label: meta.label,
+        type: ESCROW_2OF2_CONTRACT_TYPE,
+        params: EscrowContractHandler.serializeParams(options),
+        script: hex.encode(script.pkScript),
+        address: script.arkAddress(network),
+        state: meta.state,
+        metadata: meta.metadata,
+    };
+}
+/**
+ * Encode a 2-of-2 escrow as a NArk-compatible `arkcontract=` string for the
+ * server→client handoff. Carries the escrow parameters only — the receiver
+ * re-derives the script and address via {@link decodeEscrowArkContract}.
+ */
+export function encodeEscrowArkContract(options) {
+    // `encodeArkContract` reads only `type` and `params`.
+    return encodeArkContract({
+        type: ESCROW_2OF2_CONTRACT_TYPE,
+        params: EscrowContractHandler.serializeParams(options),
+    });
+}
+/**
+ * Decode an escrow `arkcontract=` string into a full {@link Contract},
+ * re-deriving the pkScript and funding address from the embedded parameters.
+ *
+ * Registers the escrow handler if needed, so the caller does not have to.
+ * `aspPubKey` is the ASP x-only key the funding address is built from.
+ */
+export function decodeEscrowArkContract(encoded, aspPubKey, network, meta = {}) {
+    registerEscrowContractHandler();
+    return contractFromArkContractWithAddress(encoded, aspPubKey, network.hrp, {
+        label: meta.label,
+        state: meta.state,
+        metadata: meta.metadata,
+    });
+}
+//# sourceMappingURL=ark-contract.js.map

package/dist/2-of-2/ark-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ark-contract.js","sourceRoot":"","sources":["../../src/2-of-2/ark-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,kCAAkC,EAClC,iBAAiB,GAElB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,6BAA6B,GAC9B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAA4B,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAShF;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAA4B,EAC5B,OAAgB,EAChB,OAA2B,EAAE;IAE7B,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC7C,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,yBAAyB;QAC/B,MAAM,EAAE,qBAAqB,CAAC,eAAe,CAAC,OAAO,CAAC;QACtD,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;QACnC,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC;QACnC,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAA4B;IAClE,sDAAsD;IACtD,OAAO,iBAAiB,CAAC;QACvB,IAAI,EAAE,yBAAyB;QAC/B,MAAM,EAAE,qBAAqB,CAAC,eAAe,CAAC,OAAO,CAAC;KAC3C,CAAC,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAe,EACf,SAAqB,EACrB,OAAgB,EAChB,OAA2B,EAAE;IAE7B,6BAA6B,EAAE,CAAC;IAChC,OAAO,kCAAkC,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,GAAG,EAAE;QACzE,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC,CAAC;AACL,CAAC"}

package/dist/2-of-2/contract-handler.d.ts

@@ -0,0 +1,26 @@
+import { type ContractHandler } from "@arkade-os/sdk";
+import { type EscrowScriptOptions, EscrowVtxoScript } from "./escrow-script.js";
+/** Contract type identifier for the cooperative 2-of-2 escrow. */
+export declare const ESCROW_2OF2_CONTRACT_TYPE = "escrow-2of2";
+/** Role a wallet can play in a 2-of-2 escrow contract. */
+export type EscrowRole = "seller" | "arbiter";
+/**
+ * ContractHandler for the cooperative 2-of-2 escrow ({@link EscrowVtxoScript}).
+ *
+ * Spending paths:
+ *  - cooperative (leaf A): 3-of-3 [seller, arbiter, asp]. Available whenever
+ *    the server cooperates. Returned for ANY role — the witness is completed
+ *    by the multi-party signing choreography (see `signEscrowArkTx`), not by a
+ *    single wallet. This mirrors how the SDK's VHTLC handler returns its
+ *    multi-party `refund`/`claim` leaves.
+ *  - escape (leaf B): arbiter-only, after the CSV. The seller has no
+ *    unilateral path by design, so `selectPath` returns null for the seller
+ *    once collaboration is unavailable.
+ */
+export declare const EscrowContractHandler: ContractHandler<EscrowScriptOptions, EscrowVtxoScript>;
+/**
+ * Register {@link EscrowContractHandler} in the SDK's global handler registry.
+ * Idempotent: a no-op if a handler for the type is already registered.
+ */
+export declare function registerEscrowContractHandler(): void;
+//# sourceMappingURL=contract-handler.d.ts.map

package/dist/2-of-2/contract-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-handler.d.ts","sourceRoot":"","sources":["../../src/2-of-2/contract-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EAMrB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,KAAK,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEhF,kEAAkE;AAClE,eAAO,MAAM,yBAAyB,gBAAgB,CAAC;AAEvD,0DAA0D;AAC1D,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAiE9C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,EAAE,eAAe,CACjD,mBAAmB,EACnB,gBAAgB,CA8DjB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,6BAA6B,IAAI,IAAI,CAIpD"}

package/dist/2-of-2/contract-handler.js

@@ -0,0 +1,140 @@
+import { contractHandlers, sequenceToTimelock, timelockToSequence, } from "@arkade-os/sdk";
+import { hex } from "@scure/base";
+import { EscrowVtxoScript } from "./escrow-script.js";
+/** Contract type identifier for the cooperative 2-of-2 escrow. */
+export const ESCROW_2OF2_CONTRACT_TYPE = "escrow-2of2";
+/**
+ * Resolve the wallet's role by matching its x-only pubkey (hex) against the
+ * contract's seller/arbiter params. An explicit `context.role` wins.
+ *
+ * The buyer holds no key in the script, so it is never a role here.
+ */
+function resolveEscrowRole(contract, context) {
+    if (context.role === "seller" || context.role === "arbiter") {
+        return context.role;
+    }
+    const walletKey = context.walletPubKey?.toLowerCase();
+    if (!walletKey)
+        return undefined;
+    if (walletKey === contract.params.sellerPubKey?.toLowerCase()) {
+        return "seller";
+    }
+    if (walletKey === contract.params.arbiterPubKey?.toLowerCase()) {
+        return "arbiter";
+    }
+    return undefined;
+}
+/**
+ * CSV maturity check for the escape leaf: is the relative (BIP-68) timelock
+ * satisfied for the vtxo under evaluation?
+ *
+ * TODO: drop this local copy and import the SDK's `isCsvSpendable` once
+ * https://github.com/arkade-os/ts-sdk/pull/541 lands and ships in a release —
+ * that PR exports this exact helper. Until then we mirror it here.
+ */
+function isCsvSpendable(context, sequence) {
+    if (sequence === undefined)
+        return true;
+    if (!context.vtxo)
+        return false;
+    const timelock = sequenceToTimelock(sequence);
+    if (timelock.type === "blocks") {
+        if (context.blockHeight === undefined ||
+            context.vtxo.status.block_height === undefined) {
+            return false;
+        }
+        return (context.blockHeight - context.vtxo.status.block_height >=
+            Number(timelock.value));
+    }
+    const blockTime = context.vtxo.status.block_time;
+    if (blockTime === undefined)
+        return false;
+    return context.currentTime / 1000 - blockTime >= Number(timelock.value);
+}
+/** nSequence (BIP-68) for the escape leaf, as stored in the contract params. */
+function escapeSequence(contract) {
+    return contract.params.exitTimelock
+        ? Number(contract.params.exitTimelock)
+        : undefined;
+}
+/**
+ * ContractHandler for the cooperative 2-of-2 escrow ({@link EscrowVtxoScript}).
+ *
+ * Spending paths:
+ *  - cooperative (leaf A): 3-of-3 [seller, arbiter, asp]. Available whenever
+ *    the server cooperates. Returned for ANY role — the witness is completed
+ *    by the multi-party signing choreography (see `signEscrowArkTx`), not by a
+ *    single wallet. This mirrors how the SDK's VHTLC handler returns its
+ *    multi-party `refund`/`claim` leaves.
+ *  - escape (leaf B): arbiter-only, after the CSV. The seller has no
+ *    unilateral path by design, so `selectPath` returns null for the seller
+ *    once collaboration is unavailable.
+ */
+export const EscrowContractHandler = {
+    type: ESCROW_2OF2_CONTRACT_TYPE,
+    createScript(params) {
+        return new EscrowVtxoScript(this.deserializeParams(params));
+    },
+    serializeParams(params) {
+        return {
+            sellerPubKey: hex.encode(params.sellerPubKey),
+            arbiterPubKey: hex.encode(params.arbiterPubKey),
+            aspPubKey: hex.encode(params.aspPubKey),
+            exitTimelock: timelockToSequence(params.exitTimelock).toString(),
+        };
+    },
+    deserializeParams(params) {
+        return {
+            sellerPubKey: hex.decode(params.sellerPubKey),
+            arbiterPubKey: hex.decode(params.arbiterPubKey),
+            aspPubKey: hex.decode(params.aspPubKey),
+            exitTimelock: sequenceToTimelock(Number(params.exitTimelock)),
+        };
+    },
+    selectPath(script, contract, context) {
+        if (context.collaborative) {
+            return { leaf: script.cooperativeLeaf() };
+        }
+        // Unilateral: only the arbiter, only after the CSV elapses.
+        if (resolveEscrowRole(contract, context) !== "arbiter")
+            return null;
+        const sequence = escapeSequence(contract);
+        if (!isCsvSpendable(context, sequence))
+            return null;
+        return { leaf: script.escapeLeaf(), sequence };
+    },
+    getAllSpendingPaths(script, contract, context) {
+        const paths = [{ leaf: script.cooperativeLeaf() }];
+        // The escape leaf only exists for the arbiter (CSV checked at tx time).
+        if (resolveEscrowRole(contract, context) === "arbiter") {
+            paths.push({
+                leaf: script.escapeLeaf(),
+                sequence: escapeSequence(contract),
+            });
+        }
+        return paths;
+    },
+    getSpendablePaths(script, contract, context) {
+        const paths = [];
+        if (context.collaborative) {
+            paths.push({ leaf: script.cooperativeLeaf() });
+        }
+        if (resolveEscrowRole(contract, context) === "arbiter") {
+            const sequence = escapeSequence(contract);
+            if (isCsvSpendable(context, sequence)) {
+                paths.push({ leaf: script.escapeLeaf(), sequence });
+            }
+        }
+        return paths;
+    },
+};
+/**
+ * Register {@link EscrowContractHandler} in the SDK's global handler registry.
+ * Idempotent: a no-op if a handler for the type is already registered.
+ */
+export function registerEscrowContractHandler() {
+    if (!contractHandlers.has(ESCROW_2OF2_CONTRACT_TYPE)) {
+        contractHandlers.register(EscrowContractHandler);
+    }
+}
+//# sourceMappingURL=contract-handler.js.map

package/dist/2-of-2/contract-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-handler.js","sourceRoot":"","sources":["../../src/2-of-2/contract-handler.ts"],"names":[],"mappings":"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"}

package/dist/2-of-2/escrow-script.d.ts

@@ -0,0 +1,57 @@
+import { type Network, type RelativeTimelock, VtxoScript } from "@arkade-os/sdk";
+export interface EscrowScriptOptions {
+    /** x-only Schnorr pubkey, 32 bytes. The funding party (seller). */
+    sellerPubKey: Uint8Array;
+    /** x-only Schnorr pubkey, 32 bytes. The escrow arbiter / cosigner. */
+    arbiterPubKey: Uint8Array;
+    /** x-only Schnorr pubkey, 32 bytes. Arkade ASP's signer key. */
+    aspPubKey: Uint8Array;
+    /**
+     * CSV timelock for the arbiter-only unilateral escape leaf — the
+     * ASP-mandated unilateral-exit closure. Must be ≥ the ASP's
+     * `unilateralExitDelay` (~2 days on mutinynet, ~30 days on
+     * mainnet) or `submitTx` rejects the script with
+     * INVALID_VTXO_SCRIPT "exit delay is too short".
+     */
+    exitTimelock: RelativeTimelock;
+}
+/**
+ * Two-leaf VtxoScript for a cooperative 2-of-2 escrow on Ark.
+ *
+ *   A — cooperative release     : 3-of-3 [seller, arbiter, asp] (no CSV)
+ *   B — arbiter unilateral exit : [arbiter] alone after a long CSV
+ *
+ * The two policy parties are the seller and the arbiter; both must sign
+ * the cooperative release. The Arkade ASP is added to leaf A as required
+ * by Ark's round/forfeit semantics — the ASP must cosign every
+ * cooperative VTXO spend — so at the script level leaf A is 3-of-3 even
+ * though only two parties hold policy.
+ *
+ * The seller has NO unilateral exit. Seller safety relies on a
+ * pre-signed cooperative refund ark-tx (created at funding time, held by
+ * the arbiter). After the CSV elapses, only the arbiter can sweep.
+ */
+export declare class EscrowVtxoScript extends VtxoScript {
+    readonly options: EscrowScriptOptions;
+    constructor(options: EscrowScriptOptions);
+    /** The cooperative-release tapleaf (3-of-3). Index 0. */
+    cooperativeLeaf(): import("@arkade-os/sdk").TapLeafScript;
+    /** The arbiter-only unilateral exit tapleaf (long CSV). Index 1. */
+    escapeLeaf(): import("@arkade-os/sdk").TapLeafScript;
+    /**
+     * SDK-conformant alias for {@link cooperativeLeaf}.
+     *
+     * The Arkade wallet/contract machinery (`deriveContractTapscripts`) expects
+     * every contract VtxoScript to expose `forfeit()` as its collaborative
+     * forfeit/intent leaf. For this escrow that is the cooperative 3-of-3 leaf.
+     */
+    forfeit(): import("@arkade-os/sdk").TapLeafScript;
+    /**
+     * SDK-conformant alias for {@link escapeLeaf}, matching the `DefaultVtxo`
+     * `exit()` convention for the unilateral (CSV) leaf.
+     */
+    exit(): import("@arkade-os/sdk").TapLeafScript;
+    /** Encoded Ark address (bech32m) for funding this escrow. */
+    arkAddress(network: Network): string;
+}
+//# sourceMappingURL=escrow-script.d.ts.map

package/dist/2-of-2/escrow-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escrow-script.d.ts","sourceRoot":"","sources":["../../src/2-of-2/escrow-script.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,gBAAgB,EACrB,UAAU,EACX,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,YAAY,EAAE,UAAU,CAAC;IACzB,sEAAsE;IACtE,aAAa,EAAE,UAAU,CAAC;IAC1B,gEAAgE;IAChE,SAAS,EAAE,UAAU,CAAC;IACtB;;;;;;OAMG;IACH,YAAY,EAAE,gBAAgB,CAAC;CAChC;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;gBAE1B,OAAO,EAAE,mBAAmB;IAexC,yDAAyD;IACzD,eAAe;IAIf,oEAAoE;IACpE,UAAU;IAIV;;;;;;OAMG;IACH,OAAO;IAIP;;;OAGG;IACH,IAAI;IAIJ,6DAA6D;IAC7D,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;CAGrC"}

package/dist/2-of-2/escrow-script.js

@@ -0,0 +1,61 @@
+import { CSVMultisigTapscript, MultisigTapscript, VtxoScript, } from "@arkade-os/sdk";
+/**
+ * Two-leaf VtxoScript for a cooperative 2-of-2 escrow on Ark.
+ *
+ *   A — cooperative release     : 3-of-3 [seller, arbiter, asp] (no CSV)
+ *   B — arbiter unilateral exit : [arbiter] alone after a long CSV
+ *
+ * The two policy parties are the seller and the arbiter; both must sign
+ * the cooperative release. The Arkade ASP is added to leaf A as required
+ * by Ark's round/forfeit semantics — the ASP must cosign every
+ * cooperative VTXO spend — so at the script level leaf A is 3-of-3 even
+ * though only two parties hold policy.
+ *
+ * The seller has NO unilateral exit. Seller safety relies on a
+ * pre-signed cooperative refund ark-tx (created at funding time, held by
+ * the arbiter). After the CSV elapses, only the arbiter can sweep.
+ */
+export class EscrowVtxoScript extends VtxoScript {
+    options;
+    constructor(options) {
+        const cooperativeLeaf = MultisigTapscript.encode({
+            pubkeys: [options.sellerPubKey, options.arbiterPubKey, options.aspPubKey],
+        });
+        const escapeLeaf = CSVMultisigTapscript.encode({
+            pubkeys: [options.arbiterPubKey],
+            timelock: options.exitTimelock,
+        });
+        super([cooperativeLeaf.script, escapeLeaf.script]);
+        this.options = options;
+    }
+    /** The cooperative-release tapleaf (3-of-3). Index 0. */
+    cooperativeLeaf() {
+        return this.leaves[0];
+    }
+    /** The arbiter-only unilateral exit tapleaf (long CSV). Index 1. */
+    escapeLeaf() {
+        return this.leaves[1];
+    }
+    /**
+     * SDK-conformant alias for {@link cooperativeLeaf}.
+     *
+     * The Arkade wallet/contract machinery (`deriveContractTapscripts`) expects
+     * every contract VtxoScript to expose `forfeit()` as its collaborative
+     * forfeit/intent leaf. For this escrow that is the cooperative 3-of-3 leaf.
+     */
+    forfeit() {
+        return this.cooperativeLeaf();
+    }
+    /**
+     * SDK-conformant alias for {@link escapeLeaf}, matching the `DefaultVtxo`
+     * `exit()` convention for the unilateral (CSV) leaf.
+     */
+    exit() {
+        return this.escapeLeaf();
+    }
+    /** Encoded Ark address (bech32m) for funding this escrow. */
+    arkAddress(network) {
+        return this.address(network.hrp, this.options.aspPubKey).encode();
+    }
+}
+//# sourceMappingURL=escrow-script.js.map

package/dist/2-of-2/escrow-script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escrow-script.js","sourceRoot":"","sources":["../../src/2-of-2/escrow-script.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EAGjB,UAAU,GACX,MAAM,gBAAgB,CAAC;AAmBxB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,gBAAiB,SAAQ,UAAU;IACrC,OAAO,CAAsB;IAEtC,YAAY,OAA4B;QACtC,MAAM,eAAe,GAAG,iBAAiB,CAAC,MAAM,CAAC;YAC/C,OAAO,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,SAAS,CAAC;SAC1E,CAAC,CAAC;QAEH,MAAM,UAAU,GAAG,oBAAoB,CAAC,MAAM,CAAC;YAC7C,OAAO,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC;YAChC,QAAQ,EAAE,OAAO,CAAC,YAAY;SAC/B,CAAC,CAAC;QAEH,KAAK,CAAC,CAAC,eAAe,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QAEnD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,yDAAyD;IACzD,eAAe;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IAED,oEAAoE;IACpE,UAAU;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IAED;;;;;;OAMG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,eAAe,EAAE,CAAC;IAChC,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;IAC3B,CAAC;IAED,6DAA6D;IAC7D,UAAU,CAAC,OAAgB;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,CAAC;IACpE,CAAC;CACF"}

package/dist/2-of-2/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./ark-contract.js";
+export * from "./contract-handler.js";
+export * from "./escrow-script.js";
+export * from "./monitor.js";
+export * from "./release.js";
+export * from "./verify.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/2-of-2/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/2-of-2/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/2-of-2/index.js

@@ -0,0 +1,7 @@
+export * from "./ark-contract.js";
+export * from "./contract-handler.js";
+export * from "./escrow-script.js";
+export * from "./monitor.js";
+export * from "./release.js";
+export * from "./verify.js";
+//# sourceMappingURL=index.js.map

package/dist/2-of-2/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/2-of-2/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/2-of-2/monitor.d.ts

@@ -0,0 +1,67 @@
+import { type Contract, type ContractManagerConfig, type ContractVtxo, type IContractManager, type Network } from "@arkade-os/sdk";
+import { type EscrowContractMeta } from "./ark-contract.js";
+import type { EscrowScriptOptions } from "./escrow-script.js";
+/** The subset of `IContractManager` the monitor relies on. */
+export type EscrowManagerLike = Pick<IContractManager, "createContract" | "getContractsWithVtxos" | "onContractEvent" | "deleteContract" | "dispose">;
+/** Funding observed at an escrow address. */
+export interface EscrowFundedEvent {
+    contract: Contract;
+    vtxos: ContractVtxo[];
+    /** Sum of the received vtxo values, in sats. */
+    totalSats: number;
+}
+/** The escrow VTXO was spent (cooperative release or arbiter escape). */
+export interface EscrowReleasedEvent {
+    contract: Contract;
+    vtxos: ContractVtxo[];
+}
+/**
+ * A thin facade over the Arkade {@link ContractManager} scoped to 2-of-2
+ * escrows. It registers the escrow handler, owns the manager lifecycle, and
+ * exposes escrow-shaped helpers so a consumer never touches the handler
+ * registry, the watcher, or the repositories directly.
+ *
+ * Watching, persistence, reconnection, and failsafe polling are all handled
+ * by the underlying manager.
+ */
+export declare class EscrowMonitor {
+    private readonly manager;
+    private constructor();
+    /**
+     * Construct a monitor, creating and starting a real {@link ContractManager}
+     * from the given providers and repositories.
+     */
+    static create(config: ContractManagerConfig): Promise<EscrowMonitor>;
+    /**
+     * Wrap an existing manager (or a test double). Registers the escrow handler.
+     */
+    static fromManager(manager: EscrowManagerLike): EscrowMonitor;
+    /**
+     * Register an escrow (built from its parameters) for monitoring. Returns the
+     * persisted {@link Contract}; its `address` is where the seller funds.
+     */
+    watch(options: EscrowScriptOptions, network: Network, meta?: EscrowContractMeta): Promise<Contract>;
+    /**
+     * Register an escrow received as an `arkcontract=` string (the server→client
+     * handoff) for monitoring.
+     */
+    watchArkContract(encoded: string, aspPubKey: Uint8Array, network: Network, meta?: EscrowContractMeta): Promise<Contract>;
+    /** Stop monitoring an escrow by its pkScript hex. */
+    unwatch(script: string): Promise<void>;
+    /** List all monitored escrows together with their current virtual outputs. */
+    listEscrows(): Promise<EscrowFundedEvent[]>;
+    /**
+     * Fire `cb` when funds land at an escrow address (the FUNDED signal). Only
+     * fires for escrow contracts. Returns an unsubscribe function.
+     */
+    onFunded(cb: (event: EscrowFundedEvent) => void): () => void;
+    /**
+     * Fire `cb` when an escrow VTXO is spent (the RELEASED signal — cooperative
+     * release or arbiter escape). Only fires for escrow contracts. Returns an
+     * unsubscribe function.
+     */
+    onReleased(cb: (event: EscrowReleasedEvent) => void): () => void;
+    /** Release the manager's resources (stop watching, clear listeners). */
+    dispose(): void;
+}
+//# sourceMappingURL=monitor.d.ts.map

package/dist/2-of-2/monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.d.ts","sourceRoot":"","sources":["../../src/2-of-2/monitor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EAEb,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,OAAO,EACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,KAAK,kBAAkB,EAExB,MAAM,mBAAmB,CAAC;AAK3B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,8DAA8D;AAC9D,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,gBAAgB,EACd,gBAAgB,GAChB,uBAAuB,GACvB,iBAAiB,GACjB,gBAAgB,GAChB,SAAS,CACZ,CAAC;AAEF,6CAA6C;AAC7C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,yEAAyE;AACzE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAMD;;;;;;;;GAQG;AACH,qBAAa,aAAa;IACJ,OAAO,CAAC,QAAQ,CAAC,OAAO;IAA5C,OAAO;IAEP;;;OAGG;WACU,MAAM,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC;IAM1E;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa;IAK7D;;;OAGG;IACH,KAAK,CACH,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,kBAAkB,GACxB,OAAO,CAAC,QAAQ,CAAC;IAMpB;;;OAGG;IACH,gBAAgB,CACd,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,kBAAkB,GACxB,OAAO,CAAC,QAAQ,CAAC;IAUpB,qDAAqD;IACrD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,8EAA8E;IACxE,WAAW,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAWjD;;;OAGG;IACH,QAAQ,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI;IAe5D;;;;OAIG;IACH,UAAU,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GAAG,MAAM,IAAI;IAWhE,wEAAwE;IACxE,OAAO,IAAI,IAAI;CAGhB"}

package/dist/2-of-2/monitor.js

@@ -0,0 +1,101 @@
+import { ContractManager, } from "@arkade-os/sdk";
+import { decodeEscrowArkContract, escrowCreateContractParams, } from "./ark-contract.js";
+import { ESCROW_2OF2_CONTRACT_TYPE, registerEscrowContractHandler, } from "./contract-handler.js";
+function totalSats(vtxos) {
+    return vtxos.reduce((acc, v) => acc + v.value, 0);
+}
+/**
+ * A thin facade over the Arkade {@link ContractManager} scoped to 2-of-2
+ * escrows. It registers the escrow handler, owns the manager lifecycle, and
+ * exposes escrow-shaped helpers so a consumer never touches the handler
+ * registry, the watcher, or the repositories directly.
+ *
+ * Watching, persistence, reconnection, and failsafe polling are all handled
+ * by the underlying manager.
+ */
+export class EscrowMonitor {
+    manager;
+    constructor(manager) {
+        this.manager = manager;
+    }
+    /**
+     * Construct a monitor, creating and starting a real {@link ContractManager}
+     * from the given providers and repositories.
+     */
+    static async create(config) {
+        registerEscrowContractHandler();
+        const manager = await ContractManager.create(config);
+        return new EscrowMonitor(manager);
+    }
+    /**
+     * Wrap an existing manager (or a test double). Registers the escrow handler.
+     */
+    static fromManager(manager) {
+        registerEscrowContractHandler();
+        return new EscrowMonitor(manager);
+    }
+    /**
+     * Register an escrow (built from its parameters) for monitoring. Returns the
+     * persisted {@link Contract}; its `address` is where the seller funds.
+     */
+    watch(options, network, meta) {
+        return this.manager.createContract(escrowCreateContractParams(options, network, meta));
+    }
+    /**
+     * Register an escrow received as an `arkcontract=` string (the server→client
+     * handoff) for monitoring.
+     */
+    watchArkContract(encoded, aspPubKey, network, meta) {
+        const { createdAt: _createdAt, ...params } = decodeEscrowArkContract(encoded, aspPubKey, network, meta);
+        return this.manager.createContract(params);
+    }
+    /** Stop monitoring an escrow by its pkScript hex. */
+    unwatch(script) {
+        return this.manager.deleteContract(script);
+    }
+    /** List all monitored escrows together with their current virtual outputs. */
+    async listEscrows() {
+        const all = await this.manager.getContractsWithVtxos({
+            type: ESCROW_2OF2_CONTRACT_TYPE,
+        });
+        return all.map(({ contract, vtxos }) => ({
+            contract,
+            vtxos,
+            totalSats: totalSats(vtxos),
+        }));
+    }
+    /**
+     * Fire `cb` when funds land at an escrow address (the FUNDED signal). Only
+     * fires for escrow contracts. Returns an unsubscribe function.
+     */
+    onFunded(cb) {
+        return this.manager.onContractEvent((event) => {
+            if (event.type === "vtxo_received" &&
+                event.contract.type === ESCROW_2OF2_CONTRACT_TYPE) {
+                cb({
+                    contract: event.contract,
+                    vtxos: event.vtxos,
+                    totalSats: totalSats(event.vtxos),
+                });
+            }
+        });
+    }
+    /**
+     * Fire `cb` when an escrow VTXO is spent (the RELEASED signal — cooperative
+     * release or arbiter escape). Only fires for escrow contracts. Returns an
+     * unsubscribe function.
+     */
+    onReleased(cb) {
+        return this.manager.onContractEvent((event) => {
+            if (event.type === "vtxo_spent" &&
+                event.contract.type === ESCROW_2OF2_CONTRACT_TYPE) {
+                cb({ contract: event.contract, vtxos: event.vtxos });
+            }
+        });
+    }
+    /** Release the manager's resources (stop watching, clear listeners). */
+    dispose() {
+        this.manager.dispose();
+    }
+}
+//# sourceMappingURL=monitor.js.map

package/dist/2-of-2/monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.js","sourceRoot":"","sources":["../../src/2-of-2/monitor.ts"],"names":[],"mappings":"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"}

package/dist/2-of-2/release.d.ts

@@ -0,0 +1,80 @@
+import { type ArkInfo, type ArkProvider, CSVMultisigTapscript, type RelativeTimelock, Transaction } from "@arkade-os/sdk";
+import type { EscrowVtxoScript } from "./escrow-script.js";
+/**
+ * ASP-derived parameters needed to build and submit an escrow release.
+ *
+ * Derive once at startup from `ArkProvider.getInfo()` via
+ * {@link escrowArkConfigFromInfo}; these values are fixed by the ASP and
+ * cannot be chosen by the escrow parties.
+ */
+export interface EscrowArkConfig {
+    /** ASP x-only pubkey (32 bytes). */
+    aspPubKey: Uint8Array;
+    /** ASP-mandated unilateral-exit timelock (the escrow escape-leaf CSV). */
+    exitTimelock: RelativeTimelock;
+    /** CSV+multisig tapscript used as the second leaf of every checkpoint VTXO. */
+    serverUnrollScript: CSVMultisigTapscript.Type;
+    /** ASP dust threshold (sats). Sub-dust outputs use an OP_RETURN-shaped script. */
+    dust: bigint;
+}
+/**
+ * Derive {@link EscrowArkConfig} from the ASP's `getInfo()` response.
+ *
+ * Mirrors the connect step every party performs: x-only the signer key,
+ * decode the checkpoint tapscript, and map the unilateral-exit delay to a
+ * relative timelock.
+ */
+export declare function escrowArkConfigFromInfo(info: ArkInfo): EscrowArkConfig;
+/** The escrow funding VTXO being spent by the release. */
+export interface EscrowFundingOutpoint {
+    txid: string;
+    vout: number;
+    valueSats: number;
+}
+/** The two release outputs: buyer payout and escrow fee. */
+export interface EscrowReleaseOutputs {
+    /** Buyer's payout Ark address (committed to at take time). */
+    buyerArkAddress: string;
+    /** Sats paid to the buyer. */
+    buyerAmountSats: number;
+    /** Fee-collection Ark address. */
+    feeArkAddress: string;
+    /** Sats paid to the fee output. */
+    feeSats: number;
+}
+export interface BuiltEscrowRelease {
+    arkTx: Transaction;
+    checkpoints: Transaction[];
+}
+/**
+ * Build the cooperative release ark-tx and its checkpoint(s) spending the
+ * escrow funding VTXO to `buyer` and `fee` outputs via the cooperative leaf.
+ *
+ * Deterministic: identical inputs produce identical PSBT bytes and txids, so
+ * the arbiter can rebuild on a later round instead of persisting state.
+ */
+export declare function buildEscrowReleaseTx(escrow: EscrowVtxoScript, funding: EscrowFundingOutpoint, outputs: EscrowReleaseOutputs, config: EscrowArkConfig): BuiltEscrowRelease;
+/**
+ * Sign input 0 of the ark-tx and every checkpoint with `secretKey`, in place.
+ *
+ * Defaults to a deterministic auxRand (see above). Used by the arbiter, who
+ * signs across rounds; a single-shot signer (the seller) can use
+ * {@link signEscrowArkTx} on the base64 PSBTs instead.
+ */
+export declare function signEscrowReleaseInPlace(built: BuiltEscrowRelease, secretKey: Uint8Array, auxRand?: Uint8Array): void;
+/**
+ * Submit the fully-signed ark-tx with UNSIGNED checkpoints to the ASP, merge
+ * the user (seller+arbiter) checkpoint sigs into the ASP-signed responses, and
+ * finalize. Returns the arkTxid.
+ *
+ * The submit/finalize split lets the ASP reject a malformed ark-tx before any
+ * checkpoint signature is spent. Crash recovery between submit and finalize is
+ * the caller's responsibility.
+ *
+ * @param provider ASP provider used to submit and finalize the ark-tx
+ * @param fullySignedArkTx ark-tx carrying both arbiter and seller tapscript sigs
+ * @param userSignedCheckpoints checkpoints with arbiter+seller sigs (kept aside)
+ * @param unsignedCheckpoints fresh-from-build checkpoints (no signatures)
+ */
+export declare function submitAndFinalizeEscrowRelease(provider: ArkProvider, fullySignedArkTx: Transaction, userSignedCheckpoints: Transaction[], unsignedCheckpoints: Transaction[]): Promise<string>;
+//# sourceMappingURL=release.d.ts.map

package/dist/2-of-2/release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../../src/2-of-2/release.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,WAAW,EAGhB,oBAAoB,EAEpB,KAAK,gBAAgB,EACrB,WAAW,EACZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,SAAS,EAAE,UAAU,CAAC;IACtB,0EAA0E;IAC1E,YAAY,EAAE,gBAAgB,CAAC;IAC/B,+EAA+E;IAC/E,kBAAkB,EAAE,oBAAoB,CAAC,IAAI,CAAC;IAC9C,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,CAYtE;AAED,0DAA0D;AAC1D,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,4DAA4D;AAC5D,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,eAAe,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,EAAE,WAAW,EAAE,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,eAAe,GACtB,kBAAkB,CA8BpB;AAUD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,UAAU,EACrB,OAAO,GAAE,UAAmC,GAC3C,IAAI,CAKN;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,8BAA8B,CAClD,QAAQ,EAAE,WAAW,EACrB,gBAAgB,EAAE,WAAW,EAC7B,qBAAqB,EAAE,WAAW,EAAE,EACpC,mBAAmB,EAAE,WAAW,EAAE,GACjC,OAAO,CAAC,MAAM,CAAC,CAkBjB"}

package/dist/2-of-2/release.js

@@ -0,0 +1,133 @@
+import { ArkAddress, buildOffchainTx, CSVMultisigTapscript, combineTapscriptSigs, Transaction, } from "@arkade-os/sdk";
+import { base64, hex } from "@scure/base";
+/**
+ * Derive {@link EscrowArkConfig} from the ASP's `getInfo()` response.
+ *
+ * Mirrors the connect step every party performs: x-only the signer key,
+ * decode the checkpoint tapscript, and map the unilateral-exit delay to a
+ * relative timelock.
+ */
+export function escrowArkConfigFromInfo(info) {
+    if (!info.checkpointTapscript) {
+        throw new Error("ASP info is missing checkpointTapscript");
+    }
+    return {
+        aspPubKey: toXOnly(hex.decode(info.signerPubkey)),
+        exitTimelock: delayToTimelock(info.unilateralExitDelay),
+        serverUnrollScript: CSVMultisigTapscript.decode(hex.decode(info.checkpointTapscript)),
+        dust: info.dust,
+    };
+}
+/**
+ * Build the cooperative release ark-tx and its checkpoint(s) spending the
+ * escrow funding VTXO to `buyer` and `fee` outputs via the cooperative leaf.
+ *
+ * Deterministic: identical inputs produce identical PSBT bytes and txids, so
+ * the arbiter can rebuild on a later round instead of persisting state.
+ */
+export function buildEscrowReleaseTx(escrow, funding, outputs, config) {
+    const arkInput = {
+        txid: funding.txid,
+        vout: funding.vout,
+        value: funding.valueSats,
+        tapLeafScript: escrow.cooperativeLeaf(),
+        tapTree: escrow.encode(),
+    };
+    const buyerAmount = BigInt(outputs.buyerAmountSats);
+    const feeAmount = BigInt(outputs.feeSats);
+    const buyerAddress = ArkAddress.decode(outputs.buyerArkAddress);
+    const feeAddress = ArkAddress.decode(outputs.feeArkAddress);
+    const { arkTx, checkpoints } = buildOffchainTx([arkInput], [
+        {
+            script: pkScriptFor(buyerAddress, buyerAmount, config.dust),
+            amount: buyerAmount,
+        },
+        {
+            script: pkScriptFor(feeAddress, feeAmount, config.dust),
+            amount: feeAmount,
+        },
+    ], config.serverUnrollScript);
+    return { arkTx, checkpoints };
+}
+/**
+ * Deterministic auxRand so signing the same PSBT twice yields the same
+ * signature. Required because the arbiter rebuilds and re-signs the release
+ * across rounds, and `combineTapscriptSigs` rejects a second, differing
+ * signature at the same (pubkey, leafHash) slot.
+ */
+const DETERMINISTIC_AUX_RAND = new Uint8Array(32);
+/**
+ * Sign input 0 of the ark-tx and every checkpoint with `secretKey`, in place.
+ *
+ * Defaults to a deterministic auxRand (see above). Used by the arbiter, who
+ * signs across rounds; a single-shot signer (the seller) can use
+ * {@link signEscrowArkTx} on the base64 PSBTs instead.
+ */
+export function signEscrowReleaseInPlace(built, secretKey, auxRand = DETERMINISTIC_AUX_RAND) {
+    built.arkTx.signIdx(secretKey, 0, undefined, auxRand);
+    for (const checkpoint of built.checkpoints) {
+        checkpoint.signIdx(secretKey, 0, undefined, auxRand);
+    }
+}
+/**
+ * Submit the fully-signed ark-tx with UNSIGNED checkpoints to the ASP, merge
+ * the user (seller+arbiter) checkpoint sigs into the ASP-signed responses, and
+ * finalize. Returns the arkTxid.
+ *
+ * The submit/finalize split lets the ASP reject a malformed ark-tx before any
+ * checkpoint signature is spent. Crash recovery between submit and finalize is
+ * the caller's responsibility.
+ *
+ * @param provider ASP provider used to submit and finalize the ark-tx
+ * @param fullySignedArkTx ark-tx carrying both arbiter and seller tapscript sigs
+ * @param userSignedCheckpoints checkpoints with arbiter+seller sigs (kept aside)
+ * @param unsignedCheckpoints fresh-from-build checkpoints (no signatures)
+ */
+export async function submitAndFinalizeEscrowRelease(provider, fullySignedArkTx, userSignedCheckpoints, unsignedCheckpoints) {
+    const { arkTxid, signedCheckpointTxs } = await provider.submitTx(base64.encode(fullySignedArkTx.toPSBT()), unsignedCheckpoints.map((c) => base64.encode(c.toPSBT())));
+    const finalCheckpoints = signedCheckpointTxs.map((c, i) => {
+        const aspSigned = Transaction.fromPSBT(base64.decode(c));
+        const userSigned = userSignedCheckpoints[i];
+        if (!userSigned) {
+            throw new Error(`missing user-signed checkpoint at index ${i}`);
+        }
+        combineTapscriptSigs(userSigned, aspSigned);
+        return base64.encode(aspSigned.toPSBT());
+    });
+    await provider.finalizeTx(arkTxid, finalCheckpoints);
+    return arkTxid;
+}
+/**
+ * The ASP rejects any non-OP_RETURN output below `dust`. Ark addresses expose
+ * a {@link ArkAddress.subdustPkScript} encoding the destination as an
+ * OP_RETURN-shaped script for amounts the recipient still wants but that are
+ * sub-dust on L1 (e.g. a 1-sat fee on a small trade).
+ */
+function pkScriptFor(address, amount, dust) {
+    return amount < dust ? address.subdustPkScript : address.pkScript;
+}
+/**
+ * BIP-68: a relative-timelock value below 512 is encoded as a block height;
+ * otherwise it is a 512-second-granularity time value (rounded up to the next
+ * valid multiple). ASP-reported values are already valid.
+ */
+function delayToTimelock(delay) {
+    if (delay < 512n) {
+        return { value: delay, type: "blocks" };
+    }
+    const rounded = ((delay + 511n) / 512n) * 512n;
+    return { value: rounded, type: "seconds" };
+}
+/**
+ * Drop the sign byte from a 33-byte compressed secp256k1 pubkey to get the
+ * 32-byte x-only form used by BIP-340 / tapscripts. The ASP returns its
+ * `signerPubkey` compressed.
+ */
+function toXOnly(pubkey) {
+    if (pubkey.length === 32)
+        return pubkey;
+    if (pubkey.length === 33)
+        return pubkey.subarray(1);
+    throw new Error(`unexpected pubkey length ${pubkey.length}`);
+}
+//# sourceMappingURL=release.js.map

package/dist/2-of-2/release.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.js","sourceRoot":"","sources":["../../src/2-of-2/release.ts"],"names":[],"mappings":"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"}

package/dist/2-of-2/verify.d.ts

@@ -0,0 +1,40 @@
+import { type Transaction } from "@arkade-os/sdk";
+export interface ReleaseArkTxExpectations {
+    /** The escrow VTXO outpoint that funds the release. */
+    escrowOutpoint: {
+        txid: string;
+        vout: number;
+    };
+    /** Buyer's payout Ark address (committed to during take). */
+    buyerArkAddress: string;
+    /** Buyer payout amount in sats. */
+    buyerAmountSats: bigint;
+    /** Escrow fee Ark address. */
+    feeArkAddress: string;
+    /** Escrow fee amount in sats. */
+    feeAmountSats: bigint;
+}
+/** The release as the seller receives it: the ark-tx and its checkpoint(s). */
+export interface ReleaseToVerify {
+    arkTx: Transaction;
+    checkpoints: Transaction[];
+}
+export declare class ReleaseArkTxValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Seller-side check before signing the cooperative release.
+ *
+ * An Arkade offchain spend is a two-tx chain: a **checkpoint** spends the
+ * funding VTXO, and the **ark-tx** spends the checkpoint and pays the final
+ * outputs (plus a zero-value P2A fee-bump anchor). This verifies the whole
+ * chain the seller is about to sign:
+ *   - the checkpoint spends the escrow funding outpoint,
+ *   - the ark-tx spends that checkpoint,
+ *   - the ark-tx pays the agreed buyer and fee amounts — and nothing else
+ *     except the anchor (no rogue payout).
+ *
+ * Throws on any mismatch. Caller must NOT sign if this throws.
+ */
+export declare function verifyReleaseArkTx(release: ReleaseToVerify, expected: ReleaseArkTxExpectations): void;
+//# sourceMappingURL=verify.d.ts.map

package/dist/2-of-2/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/2-of-2/verify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGnE,MAAM,WAAW,wBAAwB;IACvC,uDAAuD;IACvD,cAAc,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,6DAA6D;IAC7D,eAAe,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,EAAE,WAAW,EAAE,CAAC;CAC5B;AAED,qBAAa,2BAA4B,SAAQ,KAAK;gBACxC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,wBAAwB,GACjC,IAAI,CA2FN"}

package/dist/2-of-2/verify.js

@@ -0,0 +1,100 @@
+import { ArkAddress, P2A } from "@arkade-os/sdk";
+import { hex } from "@scure/base";
+export class ReleaseArkTxValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ReleaseArkTxValidationError";
+    }
+}
+/**
+ * Seller-side check before signing the cooperative release.
+ *
+ * An Arkade offchain spend is a two-tx chain: a **checkpoint** spends the
+ * funding VTXO, and the **ark-tx** spends the checkpoint and pays the final
+ * outputs (plus a zero-value P2A fee-bump anchor). This verifies the whole
+ * chain the seller is about to sign:
+ *   - the checkpoint spends the escrow funding outpoint,
+ *   - the ark-tx spends that checkpoint,
+ *   - the ark-tx pays the agreed buyer and fee amounts — and nothing else
+ *     except the anchor (no rogue payout).
+ *
+ * Throws on any mismatch. Caller must NOT sign if this throws.
+ */
+export function verifyReleaseArkTx(release, expected) {
+    const { arkTx, checkpoints } = release;
+    // A single funding VTXO yields exactly one checkpoint.
+    if (checkpoints.length !== 1) {
+        throw new ReleaseArkTxValidationError(`expected exactly 1 checkpoint, got ${checkpoints.length}`);
+    }
+    const checkpoint = checkpoints[0];
+    // (1) The checkpoint must spend the escrow funding outpoint.
+    const cpIn = checkpoint.getInput(0);
+    if (!cpIn.txid || cpIn.index === undefined) {
+        throw new ReleaseArkTxValidationError("checkpoint input 0 missing prevout");
+    }
+    const cpInTxid = hex.encode(cpIn.txid);
+    if (cpInTxid !== expected.escrowOutpoint.txid ||
+        cpIn.index !== expected.escrowOutpoint.vout) {
+        throw new ReleaseArkTxValidationError(`checkpoint input ${cpInTxid}:${cpIn.index} does not spend funding ${expected.escrowOutpoint.txid}:${expected.escrowOutpoint.vout}`);
+    }
+    // (2) The ark-tx must spend that checkpoint.
+    if (arkTx.inputsLength !== 1) {
+        throw new ReleaseArkTxValidationError(`expected exactly 1 ark-tx input, got ${arkTx.inputsLength}`);
+    }
+    const arkIn = arkTx.getInput(0);
+    if (!arkIn.txid) {
+        throw new ReleaseArkTxValidationError("ark-tx input 0 missing prevout");
+    }
+    const arkInTxid = hex.encode(arkIn.txid);
+    if (arkInTxid !== checkpoint.id) {
+        throw new ReleaseArkTxValidationError(`ark-tx input ${arkInTxid} does not spend checkpoint ${checkpoint.id}`);
+    }
+    // (3) The ark-tx must pay buyer + fee, and nothing else but the anchor.
+    const buyerAddress = ArkAddress.decode(expected.buyerArkAddress);
+    const feeAddress = ArkAddress.decode(expected.feeArkAddress);
+    const anchorScriptHex = hex.encode(P2A.script);
+    let foundBuyer = false;
+    let foundFee = false;
+    for (let i = 0; i < arkTx.outputsLength; i++) {
+        const output = arkTx.getOutput(i);
+        if (!output.script || output.amount === undefined) {
+            throw new ReleaseArkTxValidationError(`ark-tx output ${i} missing script or amount`);
+        }
+        if (matchesAddress(output.script, buyerAddress) &&
+            output.amount === expected.buyerAmountSats) {
+            foundBuyer = true;
+        }
+        else if (matchesAddress(output.script, feeAddress) &&
+            output.amount === expected.feeAmountSats) {
+            foundFee = true;
+        }
+        else if (hex.encode(output.script) === anchorScriptHex &&
+            output.amount === P2A.amount) {
+            // Zero-value P2A fee-bump anchor — expected.
+        }
+        else {
+            throw new ReleaseArkTxValidationError(`unexpected ark-tx output ${i}: ${output.amount} sats to ${hex.encode(output.script)}`);
+        }
+    }
+    if (!foundBuyer) {
+        throw new ReleaseArkTxValidationError(`no output paying ${expected.buyerAmountSats} sats to buyer ${expected.buyerArkAddress}`);
+    }
+    if (!foundFee) {
+        throw new ReleaseArkTxValidationError(`no output paying ${expected.feeAmountSats} sats to fee ${expected.feeArkAddress}`);
+    }
+}
+/** Match a pkScript against an Ark address, allowing its sub-dust form. */
+function matchesAddress(script, address) {
+    return (bytesEqual(script, address.pkScript) ||
+        bytesEqual(script, address.subdustPkScript));
+}
+function bytesEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i])
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=verify.js.map

package/dist/2-of-2/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/2-of-2/verify.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./2-of-2/index.js";
+export * from "./payout-commitment.js";
+export * from "./sign.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from "./2-of-2/index.js";
+export * from "./payout-commitment.js";
+export * from "./sign.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC"}

package/dist/payout-commitment.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Buyer's commitment to a payout Ark address.
+ *
+ * The buyer's destination is an Ark address (bech32m wrapping a server
+ * pubkey + vtxo taproot key), not an L1 P2WPKH/P2TR address, so an L1
+ * BIP-322 flow does not apply directly. Instead the buyer Schnorr-signs a
+ * deterministic message tying the offer, the destination address, and the
+ * x-only pubkey embedded in that destination — binding them to the payout
+ * destination used in the cooperative release.
+ */
+export declare function payoutCommitmentMessage(offerId: string, payoutArkAddress: string): string;
+//# sourceMappingURL=payout-commitment.d.ts.map

package/dist/payout-commitment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payout-commitment.d.ts","sourceRoot":"","sources":["../src/payout-commitment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,GACvB,MAAM,CAER"}

package/dist/payout-commitment.js

@@ -0,0 +1,14 @@
+/**
+ * Buyer's commitment to a payout Ark address.
+ *
+ * The buyer's destination is an Ark address (bech32m wrapping a server
+ * pubkey + vtxo taproot key), not an L1 P2WPKH/P2TR address, so an L1
+ * BIP-322 flow does not apply directly. Instead the buyer Schnorr-signs a
+ * deterministic message tying the offer, the destination address, and the
+ * x-only pubkey embedded in that destination — binding them to the payout
+ * destination used in the cooperative release.
+ */
+export function payoutCommitmentMessage(offerId, payoutArkAddress) {
+    return `escrow:take:${offerId}:${payoutArkAddress}`;
+}
+//# sourceMappingURL=payout-commitment.js.map

package/dist/payout-commitment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payout-commitment.js","sourceRoot":"","sources":["../src/payout-commitment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAe,EACf,gBAAwB;IAExB,OAAO,eAAe,OAAO,IAAI,gBAAgB,EAAE,CAAC;AACtD,CAAC"}

package/dist/sign.d.ts

@@ -0,0 +1,19 @@
+export interface SignedEscrowTx {
+    signedPsbt: string;
+    txid: string;
+}
+/**
+ * Sign input 0 of an Arkade ark-tx PSBT with `secretKey`.
+ *
+ * Equivalent to `signEscrowArkTx` from `@lendasat/lendaswap-sdk-pure`,
+ * lifted into this SDK so consumers don't have to pull in Lendaswap's
+ * EVM dependency stack (zerodev/viem) just to sign one tapscript leaf.
+ *
+ * The PSBT must already carry the cooperative tapleaf script, control
+ * block, and the sighash type on input 0. The arbiter (server) attaches
+ * those when it builds the release tx. Does not finalize.
+ */
+export declare function signEscrowArkTx(psbtB64: string, secretKey: Uint8Array): SignedEscrowTx;
+/** Same as {@link signEscrowArkTx} but for an array of checkpoint PSBTs. */
+export declare function signEscrowCheckpoints(psbtB64s: string[], secretKey: Uint8Array): string[];
+//# sourceMappingURL=sign.d.ts.map

package/dist/sign.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sign.d.ts","sourceRoot":"","sources":["../src/sign.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,UAAU,GACpB,cAAc,CAOhB;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAAE,EAClB,SAAS,EAAE,UAAU,GACpB,MAAM,EAAE,CAEV"}

package/dist/sign.js

@@ -0,0 +1,26 @@
+import { Transaction } from "@arkade-os/sdk";
+import { base64 } from "@scure/base";
+/**
+ * Sign input 0 of an Arkade ark-tx PSBT with `secretKey`.
+ *
+ * Equivalent to `signEscrowArkTx` from `@lendasat/lendaswap-sdk-pure`,
+ * lifted into this SDK so consumers don't have to pull in Lendaswap's
+ * EVM dependency stack (zerodev/viem) just to sign one tapscript leaf.
+ *
+ * The PSBT must already carry the cooperative tapleaf script, control
+ * block, and the sighash type on input 0. The arbiter (server) attaches
+ * those when it builds the release tx. Does not finalize.
+ */
+export function signEscrowArkTx(psbtB64, secretKey) {
+    const tx = Transaction.fromPSBT(base64.decode(psbtB64));
+    tx.signIdx(secretKey, 0);
+    return {
+        signedPsbt: base64.encode(tx.toPSBT()),
+        txid: tx.id,
+    };
+}
+/** Same as {@link signEscrowArkTx} but for an array of checkpoint PSBTs. */
+export function signEscrowCheckpoints(psbtB64s, secretKey) {
+    return psbtB64s.map((b) => signEscrowArkTx(b, secretKey).signedPsbt);
+}
+//# sourceMappingURL=sign.js.map

package/dist/sign.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sign.js","sourceRoot":"","sources":["../src/sign.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAOrC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,SAAqB;IAErB,MAAM,EAAE,GAAG,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACxD,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IACzB,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC;QACtC,IAAI,EAAE,EAAE,CAAC,EAAE;KACZ,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,qBAAqB,CACnC,QAAkB,EAClB,SAAqB;IAErB,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,UAAU,CAAC,CAAC;AACvE,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@satora/escrow",
+  "version": "0.0.1-alpha.0",
+  "description": "Escrow primitives for Arkade",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./2-of-2": {
+      "types": "./dist/2-of-2/index.d.ts",
+      "import": "./dist/2-of-2/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@arkade-os/sdk": "^0.4.32",
+    "@scure/base": "^2.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.15",
+    "@noble/curves": "^2.0.0",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "check-types": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "clean": "rm -rf dist"
+  }
+}