@satora/escrow-client 0.0.1-alpha.2 → 0.0.1-alpha.4

package/README.md

@@ -0,0 +1,243 @@
+# @satora/escrow-client
+
+High-level escrow flows for [Arkade](https://arkade.sh): fund a 2-of-2 escrow
+from Lightning, and withdraw a released payout to Lightning or to L1. It bundles
+[`@satora/escrow`](../escrow) (the escrow primitives, all re-exported) with the
+escrow monitor, and an **injected** swap client.
+
+You set up two things — a Satora swap client and an `EscrowClient` — and this
+README walks through both from scratch. Everything else (escrow primitives, the
+monitor) comes from this package.
+
+## Install
+
+```sh
+npm install @satora/escrow-client
+```
+
+Peer dependencies (you provide these):
+
+```sh
+npm install @arkade-os/sdk @satora/swap
+```
+
+- `@arkade-os/sdk` — Ark providers, repositories, and the `Wallet` used for withdrawals.
+- `@satora/swap` — the Satora swap client: the Lightning/L1 on/off-ramp. You
+  build one (shown below) and inject it; escrow-client only imports its type, so it
+  carries none of that bundle's runtime weight.
+
+## Setup
+
+Two pieces: a **swap client** and an **`EscrowClient`**.
+
+### 1. Build the swap client
+
+```ts
+import { Client } from "@satora/swap";
+
+// The minimal form generates a fresh ephemeral wallet on build(). For anything
+// real, persist it — pass .withMnemonic("abandon abandon …") (or a storage
+// backend) so pending swaps survive restarts.
+const swap = await Client.builder()
+  .withBaseUrl("https://api.satora.io") // the Satora API
+  .build();
+```
+
+### 2. Build the EscrowClient
+
+It needs the swap client plus Ark providers and repositories. Create one for the
+lifetime of your app.
+
+```ts
+import {
+  RestArkProvider,
+  RestIndexerProvider,
+  InMemoryContractRepository,
+  InMemoryWalletRepository,
+  networks,
+} from "@arkade-os/sdk";
+import { EscrowClient } from "@satora/escrow-client";
+
+const ARK_URL = "https://master.arkade.sh"; // the ASP (serves Ark + indexer)
+
+const arkProvider = new RestArkProvider(ARK_URL);
+const indexerProvider = new RestIndexerProvider(ARK_URL);
+
+const escrowClient = await EscrowClient.create({
+  swap,
+  arkProvider,
+  indexerProvider,
+  contractRepository: new InMemoryContractRepository(),
+  walletRepository: new InMemoryWalletRepository(),
+});
+
+// Resolve the network from the ASP (used for address derivation below).
+const info = await arkProvider.getInfo();
+const network = networks[info.network as keyof typeof networks];
+```
+
+> Works the same in the browser — build the providers and the swap client there
+> (the SDK ships browser storage backends) and pass them in.
+
+## Fund an escrow from Lightning
+
+Describe the escrow you want to fund as `EscrowScriptOptions` (x-only 32-byte
+pubkeys; `exitTimelock` is the ASP-mandated CSV). `fundFromLightning` derives the
+escrow address, starts watching it, and creates a Lightning→Arkade swap whose
+payout claims into that escrow.
+
+```ts
+import type { EscrowScriptOptions } from "@satora/escrow-client"; // re-exported from @satora/escrow
+
+const escrow: EscrowScriptOptions = {
+  sellerPubKey,            // Uint8Array(32)
+  arbiterPubKey,           // Uint8Array(32)
+  aspPubKey,               // Uint8Array(32) — the ASP's signer pubkey
+  exitTimelock: {type: "blocks", value: 144n},
+};
+
+const handle = await escrowClient.fundFromLightning({
+  escrow,
+  network,
+  amountSats: 50_000, // sats to receive at the escrow
+});
+
+console.log("pay this invoice:", handle.invoice);
+console.log("escrow address:", handle.escrowAddress);
+
+// After the invoice is paid: claim the swap into the escrow and wait for the
+// VTXO to land (rejects on timeout).
+const funded = await handle.awaitFunded(120_000);
+console.log("escrow funded:", funded.contract.script);
+```
+
+`handle` is `{ swapId, invoice, escrowAddress, awaitFunded(timeoutMs?) }`.
+
+## Withdraw a released payout
+
+Once the escrow has been cooperatively released to the recipient's wallet, the
+payout sits as a normal VTXO in their `@arkade-os/sdk` `Wallet`. You hand that
+`Wallet` to the withdrawal methods — build it from the recipient's key and the
+same providers:
+
+```ts
+import { Wallet, SingleKey } from "@arkade-os/sdk";
+
+const wallet = await Wallet.create({
+  identity: SingleKey.fromPrivateKey(recipientSecretKey), // Uint8Array(32)
+  arkProvider,
+  indexerProvider,
+  // ...onchain provider + repositories as your environment needs
+});
+```
+
+Then withdraw it — either with the smart `withdraw` (which auto-routes by
+inspecting the destination) or with a specific method.
+
+### Smart withdraw (auto-route)
+
+`withdraw` figures out where `destination` points and dispatches accordingly:
+
+```ts
+const result = await escrowClient.withdraw({
+  wallet,
+  destination,        // BOLT11 / LNURL / user@host → Lightning
+                      // ark1… / tark1…             → Arkade transfer
+                      // bc1… / tb1… / 1…           → L1 offboard
+  amountSats,         // required for Arkade + LNURL/address; optional for L1; ignored for BOLT11
+});
+
+result.txid;          // present on every branch
+if (result.method === "lightning") result.swapId; // lightning also has swapId + sourceAmountSats
+```
+
+`result` is discriminated by `method` (`"lightning" | "l1" | "arkade"`). Use the
+specific methods below if you already know the destination type.
+
+### To Lightning
+
+`destination` may be a **BOLT11 invoice**, an **LNURL** (`lnurl1…`), or a
+**Lightning address** (`user@host`). For LNURL / address the swap backend
+resolves and negotiates the invoice, so pass `amountSats` (what the recipient
+receives); for a BOLT11 invoice the amount is in the invoice and `amountSats` is
+ignored.
+
+```ts
+// Optional: quote the recipient amount for a full-payout withdrawal
+// (payout minus the swap fee) so you don't have to do fee math.
+// `availableSats` is the spendable payout in your wallet.
+const {recipientSats} = await escrowClient.quoteLightningWithdrawal(availableSats);
+
+const {swapId, fundingTxid, sourceAmountSats} =
+  await escrowClient.withdrawToLightning({
+    wallet,                                  // @arkade-os/sdk Wallet holding the payout
+    destination: "user@lnurl.example.com",   // invoice | lnurl1… | user@host
+    amountSats: recipientSats,               // required for LNURL / address
+  });
+```
+
+`sourceAmountSats` is what was spent from the payout (recipient amount + swap fee);
+the swap server then pays the recipient.
+
+### To L1 (onchain)
+
+A collaborative Arkade offboard (settlement round) to an onchain address:
+
+```ts
+const settlementTxid = await escrowClient.withdrawToL1({
+  wallet,
+  destinationAddress: "bc1q…",
+  // amountSats?: bigint  // omit to offboard the whole payout
+});
+```
+
+### To another Arkade address
+
+A plain offchain Ark transfer — the funds stay on Ark, so it's the cheapest and
+fastest withdrawal (no swap, no settlement round):
+
+```ts
+const arkTxid = await escrowClient.withdrawToArkade({
+  wallet,
+  destinationAddress: "ark1…", // or tark1… off mainnet
+  amountSats: 50_000,
+});
+```
+
+## Escrow primitives
+
+`@satora/escrow-client` re-exports everything from `@satora/escrow`, so you can
+build/verify/sign escrow transactions and access the monitor without a second
+import:
+
+```ts
+import {
+  EscrowVtxoScript,        // 2-of-2 escrow VtxoScript
+  buildEscrowReleaseTx,    // build the cooperative release ark-tx
+  signEscrowArkTx,         // sign a release as a co-party
+  verifyReleaseArkTx,      // verify a release pays the agreed outputs
+} from "@satora/escrow-client";
+
+// The underlying monitor (onFunded/onReleased, watch, listEscrows):
+escrowClient.escrowMonitor;
+```
+
+## Cleanup
+
+```ts
+escrowClient.dispose(); // stop watching, clear listeners
+```
+
+## API summary
+
+| Method                                                         | Purpose                                                                                                  |
+| -------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
+| `EscrowClient.create(config)`                                  | Construct with `{ swap, arkProvider, indexerProvider, contractRepository, walletRepository }`.           |
+| `fundFromLightning({ escrow, network, amountSats })`           | Create a LN→escrow swap; returns `{ swapId, invoice, escrowAddress, awaitFunded() }`.                    |
+| `withdraw({ wallet, destination, amountSats? })`               | Smart withdrawal — auto-routes to Lightning / L1 / Arkade by destination. Returns `{ method, txid, … }`. |
+| `quoteLightningWithdrawal(sourceAmountSats)`                   | `{ recipientSats, sourceSats }` — recipient amount after the swap fee.                                   |
+| `withdrawToLightning({ wallet, destination, amountSats? })`    | Withdraw the payout to a BOLT11 / LNURL / Lightning address.                                             |
+| `withdrawToL1({ wallet, destinationAddress, amountSats? })`    | Withdraw the payout onchain via collaborative offboard.                                                  |
+| `withdrawToArkade({ wallet, destinationAddress, amountSats })` | Withdraw the payout to another Arkade address (offchain Ark transfer).                                   |
+| `escrowMonitor`                                                | The underlying `EscrowMonitor`.                                                                          |
+| `dispose()`                                                    | Release monitor resources.                                                                               |

package/dist/destination.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Pure classification of a withdrawal destination string — which rail it
+ * targets, and (for Lightning) how to map it to the swap SDK's fields. No
+ * network calls; the swap backend resolves LNURL / Lightning addresses.
+ */
+export declare const isBolt11: (s: string) => boolean;
+export declare const isLnurl: (s: string) => boolean;
+export declare const isLnAddress: (s: string) => boolean;
+/** A Lightning destination: a BOLT11 invoice, an LNURL, or a Lightning address. */
+export declare function isLightningDestination(s: string): boolean;
+/** An Arkade address (bech32m, hrp `ark` mainnet / `tark` test networks). */
+export declare function isArkadeAddress(s: string): boolean;
+/** Which withdrawal rail a destination string targets. */
+export type DestinationKind = "lightning" | "arkade" | "l1";
+/**
+ * Classify a withdrawal destination. Lightning (invoice/LNURL/address) and
+ * Arkade (`ark1…`/`tark1…`) are matched explicitly; everything else is treated
+ * as an onchain Bitcoin (L1) address.
+ */
+export declare function classifyDestination(destination: string): DestinationKind;
+/** Fields of the swap SDK's Arkade→Lightning options we route a destination to. */
+export interface LightningDestination {
+    lightningInvoice?: string;
+    lightningAddress?: string;
+    lnurl?: string;
+    amountSats?: number;
+}
+/**
+ * Map a Lightning destination string to the swap SDK's mutually-exclusive
+ * `lightningInvoice` / `lightningAddress` / `lnurl` fields. Throws if it isn't a
+ * Lightning destination, or if `amountSats` is missing for LNURL / address.
+ */
+export declare function toLightningDestination(destination: string, amountSats?: number): LightningDestination;
+//# sourceMappingURL=destination.d.ts.map

package/dist/destination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"destination.d.ts","sourceRoot":"","sources":["../src/destination.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,eAAO,MAAM,QAAQ,GAAI,GAAG,MAAM,KAAG,OACF,CAAC;AACpC,eAAO,MAAM,OAAO,GAAI,GAAG,MAAM,KAAG,OACC,CAAC;AACtC,eAAO,MAAM,WAAW,GAAI,GAAG,MAAM,KAAG,OACF,CAAC;AAEvC,mFAAmF;AACnF,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAGzD;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,0DAA0D;AAC1D,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,QAAQ,GAAG,IAAI,CAAC;AAE5D;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,CAKxE;AAED,mFAAmF;AACnF,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,oBAAoB,CAsBtB"}

package/dist/destination.js

@@ -0,0 +1,56 @@
+/**
+ * Pure classification of a withdrawal destination string — which rail it
+ * targets, and (for Lightning) how to map it to the swap SDK's fields. No
+ * network calls; the swap backend resolves LNURL / Lightning addresses.
+ */
+// BOLT11 on any network: bc / tb / tbs / bcrt / sb.
+export const isBolt11 = (s) => /^ln(bcrt|bc|tbs|tb|sb)/i.test(s);
+export const isLnurl = (s) => /^lnurl1[0-9ac-hj-np-z]+$/i.test(s);
+export const isLnAddress = (s) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(s);
+/** A Lightning destination: a BOLT11 invoice, an LNURL, or a Lightning address. */
+export function isLightningDestination(s) {
+    const input = s.trim();
+    return isBolt11(input) || isLnurl(input) || isLnAddress(input);
+}
+/** An Arkade address (bech32m, hrp `ark` mainnet / `tark` test networks). */
+export function isArkadeAddress(s) {
+    return /^t?ark1[0-9ac-hj-np-z]+$/i.test(s.trim());
+}
+/**
+ * Classify a withdrawal destination. Lightning (invoice/LNURL/address) and
+ * Arkade (`ark1…`/`tark1…`) are matched explicitly; everything else is treated
+ * as an onchain Bitcoin (L1) address.
+ */
+export function classifyDestination(destination) {
+    const input = destination.trim();
+    if (isLightningDestination(input))
+        return "lightning";
+    if (isArkadeAddress(input))
+        return "arkade";
+    return "l1";
+}
+/**
+ * Map a Lightning destination string to the swap SDK's mutually-exclusive
+ * `lightningInvoice` / `lightningAddress` / `lnurl` fields. Throws if it isn't a
+ * Lightning destination, or if `amountSats` is missing for LNURL / address.
+ */
+export function toLightningDestination(destination, amountSats) {
+    const input = destination.trim();
+    // The BOLT11 invoice carries its own amount, so amountSats is not needed.
+    if (isBolt11(input)) {
+        return { lightningInvoice: input };
+    }
+    const address = isLnAddress(input);
+    const lnurl = isLnurl(input);
+    if (!address && !lnurl) {
+        throw new Error("unrecognized Lightning destination: expected a BOLT11 invoice, " +
+            "LNURL (lnurl1...), or Lightning address (user@host)");
+    }
+    if (amountSats === undefined) {
+        throw new Error(`amountSats is required for a Lightning ${address ? "address" : "LNURL"} destination`);
+    }
+    return address
+        ? { lightningAddress: input, amountSats }
+        : { lnurl: input, amountSats };
+}
+//# sourceMappingURL=destination.js.map

package/dist/destination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"destination.js","sourceRoot":"","sources":["../src/destination.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,oDAAoD;AACpD,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAW,EAAE,CAC7C,yBAAyB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpC,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAS,EAAW,EAAE,CAC5C,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACtC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAS,EAAW,EAAE,CAChD,4BAA4B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEvC,mFAAmF;AACnF,MAAM,UAAU,sBAAsB,CAAC,CAAS;IAC9C,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACvB,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC;AACjE,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAAC,CAAS;IACvC,OAAO,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC;AAKD;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IACjC,IAAI,sBAAsB,CAAC,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC;IACtD,IAAI,eAAe,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC5C,OAAO,IAAI,CAAC;AACd,CAAC;AAUD;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,WAAmB,EACnB,UAAmB;IAEnB,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IACjC,0EAA0E;IAC1E,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC;IACrC,CAAC;IACD,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,iEAAiE;YAC/D,qDAAqD,CACxD,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,0CAA0C,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,cAAc,CACtF,CAAC;IACJ,CAAC;IACD,OAAO,OAAO;QACZ,CAAC,CAAC,EAAE,gBAAgB,EAAE,KAAK,EAAE,UAAU,EAAE;QACzC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AACnC,CAAC"}

package/dist/escrow-client.d.ts

@@ -11,7 +11,7 @@ import type { Client } from "@satora/swap";
  * has private fields, so the full class would be a nominal mismatch across
  * copies).
  */
-export type SwapClient = Pick<Client, "createLightningToArkadeSwap" | "claimArkade" | "createArkadeToLightningSwap">;
+export type SwapClient = Pick<Client, "createLightningToArkadeSwap" | "claimArkade" | "createArkadeToLightningSwap" | "getArkadeToLightningQuote">;
 /**
  * Dependencies for {@link EscrowClient}.
  *
@@ -31,6 +31,23 @@ export interface EscrowClientConfig {
     /** Wallet repository (vtxo storage) for the escrow monitor. */
     walletRepository: WalletRepository;
 }
+/**
+ * Result of {@link EscrowClient.withdraw}, discriminated by `method`. `txid` is
+ * present on every branch — the VHTLC funding txid (lightning), the offboard
+ * settlement txid (l1), or the Ark transfer txid (arkade).
+ */
+export type WithdrawResult = {
+    method: "lightning";
+    txid: string;
+    swapId: string;
+    sourceAmountSats: number;
+} | {
+    method: "l1";
+    txid: string;
+} | {
+    method: "arkade";
+    txid: string;
+};
 export interface FundFromLightningParams {
     /** The escrow to fund (script params, used to derive the address + watch). */
     escrow: EscrowScriptOptions;
@@ -79,6 +96,21 @@ export declare class EscrowClient {
      * server-funded VHTLC into the escrow and resolves when the VTXO lands.
      */
     fundFromLightning(params: FundFromLightningParams): Promise<FundFromLightningHandle>;
+    /**
+     * Quote a Lightning withdrawal: given how many sats you'd spend from the
+     * payout (`sourceAmountSats`), returns what the recipient receives after the
+     * swap fee and what is actually spent.
+     *
+     * Use `recipientSats` as the `amountSats` for an LNURL / Lightning-address
+     * {@link withdrawToLightning} — e.g. pre-fill the amount from the available
+     * payout balance so the user doesn't have to compute fees by hand.
+     */
+    quoteLightningWithdrawal(sourceAmountSats: number): Promise<{
+        /** Sats the recipient receives (pass as `amountSats` to withdrawToLightning). */
+        recipientSats: number;
+        /** Sats actually spent from the payout to fund the swap VHTLC. */
+        sourceSats: number;
+    }>;
     /**
      * Withdraw a released payout to Lightning via an Arkade→Lightning swap.
      *
@@ -122,6 +154,42 @@ export declare class EscrowClient {
         /** Amount to offboard in sats; omit to offboard everything. */
         amountSats?: bigint;
     }): Promise<string>;
+    /**
+     * Withdraw a released payout to another Arkade address — a plain offchain Ark
+     * transfer. The funds stay on Ark (no swap, no settlement round), so this is
+     * the cheapest, fastest withdrawal. Returns the ark txid.
+     *
+     * The buyer holds the released payout as a normal VTXO at their wallet's
+     * address, so this is a plain send — no escrow-specific signing.
+     */
+    withdrawToArkade(params: {
+        /** Buyer wallet holding the released payout VTXO(s). */
+        wallet: IWallet;
+        /** Destination Arkade address. */
+        destinationAddress: string;
+        /** Amount to send in sats. */
+        amountSats: number;
+    }): Promise<string>;
+    /**
+     * Smart withdrawal: route the payout to wherever `destination` points by
+     * inspecting the string, dispatching to {@link withdrawToLightning},
+     * {@link withdrawToArkade}, or {@link withdrawToL1}.
+     *
+     * - BOLT11 invoice / LNURL / Lightning address → Lightning
+     * - Arkade address (`ark1…` / `tark1…`)        → offchain Ark transfer
+     * - anything else (a Bitcoin address)          → L1 offboard
+     *
+     * `amountSats` is **required** for an Arkade address and for a Lightning
+     * LNURL/address; **optional** for L1 (omit to offboard everything) and
+     * **ignored** for a BOLT11 invoice. The result is discriminated by `method`;
+     * `txid` is present for every branch.
+     */
+    withdraw(params: {
+        wallet: IWallet;
+        /** Lightning (invoice/LNURL/address), Arkade, or onchain Bitcoin address. */
+        destination: string;
+        amountSats?: number;
+    }): Promise<WithdrawResult>;
     /** Release the monitor's resources (stop watching, clear listeners). */
     dispose(): void;
 }

package/dist/escrow-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"escrow-client.d.ts","sourceRoot":"","sources":["../src/escrow-client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,OAAO,EACZ,KAAK,OAAO,EAEZ,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,iBAAiB,EACtB,aAAa,EACb,KAAK,mBAAmB,EAEzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,CAC3B,MAAM,EACN,6BAA6B,GAAG,aAAa,GAAG,6BAA6B,CAC9E,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,IAAI,EAAE,UAAU,CAAC;IACjB,oDAAoD;IACpD,WAAW,EAAE,WAAW,CAAC;IACzB,uDAAuD;IACvD,eAAe,EAAE,eAAe,CAAC;IACjC,kDAAkD;IAClD,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,+DAA+D;IAC/D,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED,MAAM,WAAW,uBAAuB;IACtC,8EAA8E;IAC9E,MAAM,EAAE,mBAAmB,CAAC;IAC5B,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC7D;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH1B,OAAO;WAMM,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAStE,+EAA+E;IAC/E,IAAI,aAAa,IAAI,aAAa,CAEjC;IAED;;;;;;;OAOG;IACG,iBAAiB,CACrB,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,uBAAuB,CAAC;IA6CnC;;;;;;;;;;;;;OAaG;IACG,mBAAmB,CAAC,MAAM,EAAE;QAChC,wDAAwD;QACxD,MAAM,EAAE,OAAO,CAAC;QAChB,+EAA+E;QAC/E,WAAW,EAAE,MAAM,CAAC;QACpB,kFAAkF;QAClF,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC;QACV,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IAaF;;;;;;;;OAQG;IACG,YAAY,CAAC,MAAM,EAAE;QACzB,wDAAwD;QACxD,MAAM,EAAE,OAAO,CAAC;QAChB,wCAAwC;QACxC,kBAAkB,EAAE,MAAM,CAAC;QAC3B,+DAA+D;QAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,MAAM,CAAC;IASnB,wEAAwE;IACxE,OAAO,IAAI,IAAI;CAGhB"}
+{"version":3,"file":"escrow-client.d.ts","sourceRoot":"","sources":["../src/escrow-client.ts"],"names":[],"mappings":"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"}

package/dist/escrow-client.js

@@ -1,6 +1,7 @@
 import { Ramps, } from "@arkade-os/sdk";
 import { EscrowMonitor, EscrowVtxoScript, } from "@satora/escrow";
 import { hex } from "@scure/base";
+import { classifyDestination, toLightningDestination } from "./destination.js";
 /**
  * High-level escrow flows that bundle the swap on/off-ramp with the escrow
  * monitor: fund an escrow from Lightning, and withdraw a released payout to
@@ -78,6 +79,23 @@ export class EscrowClient {
             awaitFunded,
         };
     }
+    /**
+     * Quote a Lightning withdrawal: given how many sats you'd spend from the
+     * payout (`sourceAmountSats`), returns what the recipient receives after the
+     * swap fee and what is actually spent.
+     *
+     * Use `recipientSats` as the `amountSats` for an LNURL / Lightning-address
+     * {@link withdrawToLightning} — e.g. pre-fill the amount from the available
+     * payout balance so the user doesn't have to compute fees by hand.
+     */
+    async quoteLightningWithdrawal(sourceAmountSats) {
+        const quote = await this.swap.getArkadeToLightningQuote(sourceAmountSats);
+        // Amounts are serialized as strings over the wire.
+        return {
+            recipientSats: Number(quote.net_target_amount),
+            sourceSats: Number(quote.net_source_amount),
+        };
+    }
     /**
      * Withdraw a released payout to Lightning via an Arkade→Lightning swap.
      *
@@ -115,36 +133,78 @@ export class EscrowClient {
         const { fees } = await this.arkProvider.getInfo();
         return new Ramps(params.wallet).offboard(params.destinationAddress, fees, params.amountSats);
     }
+    /**
+     * Withdraw a released payout to another Arkade address — a plain offchain Ark
+     * transfer. The funds stay on Ark (no swap, no settlement round), so this is
+     * the cheapest, fastest withdrawal. Returns the ark txid.
+     *
+     * The buyer holds the released payout as a normal VTXO at their wallet's
+     * address, so this is a plain send — no escrow-specific signing.
+     */
+    async withdrawToArkade(params) {
+        return params.wallet.send({
+            address: params.destinationAddress,
+            amount: params.amountSats,
+        });
+    }
+    /**
+     * Smart withdrawal: route the payout to wherever `destination` points by
+     * inspecting the string, dispatching to {@link withdrawToLightning},
+     * {@link withdrawToArkade}, or {@link withdrawToL1}.
+     *
+     * - BOLT11 invoice / LNURL / Lightning address → Lightning
+     * - Arkade address (`ark1…` / `tark1…`)        → offchain Ark transfer
+     * - anything else (a Bitcoin address)          → L1 offboard
+     *
+     * `amountSats` is **required** for an Arkade address and for a Lightning
+     * LNURL/address; **optional** for L1 (omit to offboard everything) and
+     * **ignored** for a BOLT11 invoice. The result is discriminated by `method`;
+     * `txid` is present for every branch.
+     */
+    async withdraw(params) {
+        const destination = params.destination.trim();
+        switch (classifyDestination(destination)) {
+            case "lightning": {
+                const { swapId, fundingTxid, sourceAmountSats } = await this.withdrawToLightning({
+                    wallet: params.wallet,
+                    destination,
+                    amountSats: params.amountSats,
+                });
+                return {
+                    method: "lightning",
+                    txid: fundingTxid,
+                    swapId,
+                    sourceAmountSats,
+                };
+            }
+            case "arkade": {
+                if (params.amountSats === undefined) {
+                    throw new Error("amountSats is required to withdraw to an Arkade address");
+                }
+                const txid = await this.withdrawToArkade({
+                    wallet: params.wallet,
+                    destinationAddress: destination,
+                    amountSats: params.amountSats,
+                });
+                return { method: "arkade", txid };
+            }
+            case "l1": {
+                const txid = await this.withdrawToL1({
+                    wallet: params.wallet,
+                    destinationAddress: destination,
+                    amountSats: params.amountSats === undefined
+                        ? undefined
+                        : BigInt(params.amountSats),
+                });
+                return { method: "l1", txid };
+            }
+        }
+    }
     /** Release the monitor's resources (stop watching, clear listeners). */
     dispose() {
         this.monitor.dispose();
     }
 }
-/**
- * Classify a Lightning destination string and map it to the swap SDK's
- * mutually-exclusive `lightningInvoice` / `lightningAddress` / `lnurl` fields.
- * Pure string inspection — no network calls; the backend resolves LNURL.
- */
-function toLightningDestination(destination, amountSats) {
-    const input = destination.trim();
-    // BOLT11 on any network: bc / tb / tbs / bcrt / sb. The invoice carries its
-    // own amount, so amountSats is not needed.
-    if (/^ln(bcrt|bc|tbs|tb|sb)/i.test(input)) {
-        return { lightningInvoice: input };
-    }
-    const isAddress = /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(input);
-    const isLnurl = /^lnurl1[0-9ac-hj-np-z]+$/i.test(input);
-    if (!isAddress && !isLnurl) {
-        throw new Error("unrecognized Lightning destination: expected a BOLT11 invoice, " +
-            "LNURL (lnurl1...), or Lightning address (user@host)");
-    }
-    if (amountSats === undefined) {
-        throw new Error(`amountSats is required for a Lightning ${isAddress ? "address" : "LNURL"} destination`);
-    }
-    return isAddress
-        ? { lightningAddress: input, amountSats }
-        : { lnurl: input, amountSats };
-}
 function withTimeout(p, ms, label) {
     let timer;
     const timeout = new Promise((_, reject) => {

package/dist/escrow-client.js.map

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

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export * from "@satora/escrow";
+export { classifyDestination, type DestinationKind } from "./destination.js";
 export * from "./escrow-client.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,gBAAgB,CAAC;AAE/B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EAAE,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE7E,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,6 +1,9 @@
 // One-stop import: re-export all escrow primitives so consumers need only
 // `@satora/escrow-client` (plus the swap Client they already run).
 export * from "@satora/escrow";
+// Destination classification used by the smart `withdraw` (useful for routing
+// or labelling a destination in a UI before calling it).
+export { classifyDestination } from "./destination.js";
 // High-level escrow flows (EscrowClient).
 export * from "./escrow-client.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,mEAAmE;AACnE,cAAc,gBAAgB,CAAC;AAC/B,0CAA0C;AAC1C,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,mEAAmE;AACnE,cAAc,gBAAgB,CAAC;AAC/B,8EAA8E;AAC9E,yDAAyD;AACzD,OAAO,EAAE,mBAAmB,EAAwB,MAAM,kBAAkB,CAAC;AAC7E,0CAA0C;AAC1C,cAAc,oBAAoB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@satora/escrow-client",
-  "version": "0.0.1-alpha.2",
+  "version": "0.0.1-alpha.4",
   "description": "High-level escrow flows (funding/withdrawing) bundling @satora/escrow with an injected swap client",
   "type": "module",
   "main": "dist/index.js",
@@ -27,6 +27,7 @@
     "@arkade-os/sdk": "^0.4.32",
     "@biomejs/biome": "2.3.15",
     "typescript": "^5.7.0",
+    "vitest": "^3.0.0",
     "@satora/swap": "0.0.1-alpha.1"
   },
   "license": "MIT",
@@ -36,6 +37,8 @@
   "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"