@satora/swap 1.3.3 → 1.5.0

package/dist/index.js

@@ -1,11 +1,12 @@
+import {
+  electrumReader
+} from "./chunk-INWVLX4A.js";
 import {
   DEFAULT_ESPLORA_URLS,
   esploraReader,
-  htlcFactsFromEsploraTxs
-} from "./chunk-THI4UO6R.js";
-import {
-  electrumReader
-} from "./chunk-FTPIQSRW.js";
+  htlcFactsFromEsploraTxs,
+  resolveMinConfirmations
+} from "./chunk-LSCRTQOS.js";
 
 // src/index.ts
 export * from "@lendasat/lendaswap-sdk-pure";
@@ -19,7 +20,8 @@ function deriveSwapActions(input) {
     serverChainNow,
     clientRefundLocktime,
     serverRefundLocktime,
-    clientFunds = true
+    clientFunds = true,
+    serverFunds = true
   } = input;
   switch (status) {
     case "pending": {
@@ -104,6 +106,36 @@ function deriveSwapActions(input) {
       return { recommended: "wait", actions: [wait, refund] };
     }
     case "serverfunded": {
+      if (!serverFunds) {
+        const refundUnlocked2 = clientChainNow >= clientRefundLocktime;
+        if (refundUnlocked2) {
+          const refund3 = {
+            id: "refund_unilateral",
+            recommended: true,
+            automation: "confirm",
+            reason: "Reclaim your deposit."
+          };
+          return { recommended: "refund_unilateral", actions: [refund3] };
+        }
+        const wait2 = {
+          id: "wait",
+          waitingOn: "server_funding",
+          recommended: true,
+          automation: "auto",
+          reason: "Waiting for the Lightning payment to settle."
+        };
+        const refund2 = {
+          id: "refund_unilateral",
+          recommended: false,
+          automation: "confirm",
+          reason: "Refund becomes available once the timelock passes.",
+          blockedBy: {
+            kind: "timelock_not_expired",
+            message: "The refund timelock has not passed yet."
+          }
+        };
+        return { recommended: "wait", actions: [wait2, refund2] };
+      }
       const claimWindowClosed = serverChainNow >= serverRefundLocktime;
       if (!claimWindowClosed) {
         const claim = {
@@ -590,7 +622,7 @@ var BitcoinContractManager = class _BitcoinContractManager {
     return new _BitcoinContractManager(deps);
   }
   static async create(config) {
-    const { esploraReader: esploraReader2 } = await import("./bitcoin-reader-esplora-ZLPMM5FF.js");
+    const { esploraReader: esploraReader2 } = await import("./bitcoin-reader-esplora-B2BDEI6Z.js");
     let reader = esploraReader2(
       config.esploraUrl,
       void 0,
@@ -598,7 +630,7 @@ var BitcoinContractManager = class _BitcoinContractManager {
     );
     if (config.electrumWsUrl) {
       const [{ electrumReader: electrumReader2 }, { ElectrumWsClient }] = await Promise.all([
-        import("./bitcoin-reader-electrum-PY7DHD6T.js"),
+        import("./bitcoin-reader-electrum-Z2YCNDLB.js"),
         import("@lendasat/lendaswap-sdk-pure")
       ]);
       reader = electrumReader2(new ElectrumWsClient(config.electrumWsUrl), {
@@ -782,7 +814,8 @@ function refQueryKey(ref) {
 var AVG_BLOCK_MS = {
   1: 12e3,
   137: 2100,
-  42161: 250
+  42161: 250,
+  30: 3e4
 };
 var SCAN_MARGIN_BLOCKS = 1000n;
 var EvmContractManager = class _EvmContractManager {
@@ -1048,7 +1081,9 @@ var DEFAULT_EVM_RPCS = {
     "https://arb1.arbitrum.io/rpc",
     "https://arbitrum.drpc.org",
     "https://arbitrum-one-rpc.publicnode.com"
-  ]
+  ],
+  // Rootstock: the public node, HTTP only (no WebSocket endpoint exists).
+  30: ["https://public-node.rsk.co"]
 };
 var SWAP_CREATED = parseAbiItem(
   "event SwapCreated(bytes32 indexed preimageHash, address indexed refundAddress, address indexed claimAddress, address token, uint256 amount, uint256 timelock, bytes32 key)"
@@ -1081,25 +1116,52 @@ function activeKey(q) {
     }
   });
 }
-function evmReaderFromClient(client) {
+function evmReaderFromClient(client, options = {}) {
+  const { maxBlockRange } = options;
+  async function getLogs(filter, fromBlock) {
+    if (maxBlockRange === void 0) {
+      return client.request({
+        method: "eth_getLogs",
+        params: [{ ...filter, fromBlock: numberToHex(fromBlock) }]
+      });
+    }
+    const latest = (await client.getBlock()).number;
+    if (latest === null) {
+      throw new Error("latest block has no number");
+    }
+    const logs = [];
+    for (let from = fromBlock; from <= latest; from += maxBlockRange) {
+      const to = from + maxBlockRange - 1n < latest ? from + maxBlockRange - 1n : latest;
+      logs.push(
+        ...await client.request({
+          method: "eth_getLogs",
+          params: [
+            {
+              ...filter,
+              fromBlock: numberToHex(from),
+              toBlock: numberToHex(to)
+            }
+          ]
+        })
+      );
+    }
+    return logs;
+  }
   return {
     async getHtlcEventsBatch(queries, fromBlock = 0n) {
       const results = /* @__PURE__ */ new Map();
       if (queries.length === 0) return results;
       for (const q of queries) results.set(htlcQueryKey(q), []);
-      const logs = await client.request({
-        method: "eth_getLogs",
-        params: [
-          {
-            address: unique(queries.map((q) => q.htlc)),
-            topics: [
-              HTLC_EVENT_TOPICS,
-              unique(queries.map((q) => q.preimageHash))
-            ],
-            fromBlock: numberToHex(fromBlock)
-          }
-        ]
-      });
+      const logs = await getLogs(
+        {
+          address: unique(queries.map((q) => q.htlc)),
+          topics: [
+            HTLC_EVENT_TOPICS,
+            unique(queries.map((q) => q.preimageHash))
+          ]
+        },
+        fromBlock
+      );
       const grouped = /* @__PURE__ */ new Map();
       for (const log of logs) {
         const decoded = tryDecode(log);
@@ -1215,12 +1277,15 @@ function toHtlcEvent(decoded, query) {
 function unique(values) {
   return [...new Set(values)];
 }
-function createEvmRpcReader(rpcUrls) {
+function createEvmRpcReader(rpcUrls, options = {}) {
   const urls = Array.isArray(rpcUrls) ? rpcUrls : [rpcUrls];
   const transport = urls.length > 1 ? fallback(urls.map((url) => http(url))) : http(urls[0]);
   const client = createPublicClient({ transport });
-  return evmReaderFromClient(client);
+  return evmReaderFromClient(client, options);
 }
+var EVM_LOG_RANGE_LIMITS = {
+  30: 2000n
+};
 function defaultEvmReaders(overrides) {
   const chainIds = /* @__PURE__ */ new Set([
     ...Object.keys(DEFAULT_EVM_RPCS).map(Number),
@@ -1231,7 +1296,13 @@ function defaultEvmReaders(overrides) {
     const override = overrides?.[chainId];
     const defaults = DEFAULT_EVM_RPCS[chainId] ?? [];
     const urls = override ? [override, ...defaults] : defaults;
-    if (urls.length > 0) readers.set(chainId, createEvmRpcReader(urls));
+    if (urls.length > 0)
+      readers.set(
+        chainId,
+        createEvmRpcReader(urls, {
+          maxBlockRange: EVM_LOG_RANGE_LIMITS[chainId]
+        })
+      );
   }
   return readers;
 }
@@ -1328,8 +1399,10 @@ var HintTracker = class {
       serverChainNow: now,
       clientRefundLocktime: swap.clientRefundLocktime,
       serverRefundLocktime: swap.serverRefundLocktime,
-      // Pay-on-Lightning swaps have no client-funded on-chain leg.
-      clientFunds: swap.clientHtlc !== void 0
+      // Pay-on-Lightning swaps have no client-funded on-chain leg;
+      // receive-on-Lightning swaps have no server-funded one.
+      clientFunds: swap.clientHtlc !== void 0,
+      serverFunds: swap.serverHtlc !== void 0
     });
     const previous = this.#lastActions.get(swap.swapId);
     if (!force && previous && JSON.stringify(previous) === JSON.stringify(actions))
@@ -1955,6 +2028,29 @@ function swapToTracked(stored) {
         // no on-chain client leg
         serverRefundLocktime: ms(r.vhtlc_refund_locktime)
       };
+    // Client funds the EVM HTLC (evm_expected_sats of the BTC-pegged token);
+    // the server pays the Lightning invoice off-chain and claims the HTLC —
+    // no server leg to watch.
+    case "evm_to_lightning":
+      return {
+        swapId: r.id,
+        clientHtlc: evmLeg({
+          chainId: r.evm_chain_id,
+          htlc: r.evm_htlc_address,
+          hashLock: r.hash_lock,
+          claimAddress: r.server_evm_address,
+          // the server claims the client's EVM HTLC
+          expectedSats: r.evm_expected_sats,
+          token: r.wbtc_address,
+          sender: r.evm_coordinator_address,
+          // the coordinator locks on the client's behalf
+          timelockSec: r.evm_refund_locktime,
+          createdAt: r.created_at
+        }),
+        clientRefundLocktime: ms(r.evm_refund_locktime),
+        serverRefundLocktime: 0
+        // no on-chain server leg
+      };
     // Client funds the Arkade VHTLC (source_amount); the server pays the
     // Lightning invoice off-chain and claims the VHTLC — no server leg to
     // watch.
@@ -1976,21 +2072,38 @@ function swapToTracked(stored) {
 }
 
 // src/tracker/swap-tracker.ts
+var CLAIM_SUBMITTED = /* @__PURE__ */ new Set([
+  "clientredeeming",
+  "clientredeemed",
+  "serverredeemed"
+]);
+var DEFAULT_AT_RISK_RECONCILE_INTERVAL_MS = 6e4;
+var RETRY_UNREGISTERED_INTERVAL_MS = 6e4;
 var SwapTracker = class {
   #managers;
   #swaps = /* @__PURE__ */ new Map();
+  /**
+   * Swaps whose startup registration failed (a chain read that errored).
+   * Retried every minute; dropping them would leave an active swap
+   * unwatched for the whole session with no claim or refund surfaced.
+   */
+  #unregistered = /* @__PURE__ */ new Map();
   /** Last actions emitted per swap — for dedupe and the subscribe-time snapshot. */
   #lastActions = /* @__PURE__ */ new Map();
+  /** The latest server status hint per swap, for {@link #withClaimHint}. */
+  #hintStatuses = /* @__PURE__ */ new Map();
   #subscribers = /* @__PURE__ */ new Set();
   #refreshIntervalMs;
   #atRiskReconcileIntervalMs;
   #lastAtRiskReconcileAt = 0;
+  #lastRetryAt = 0;
   #eventUnsubs = [];
   #timer;
   constructor(managers, options) {
     this.#managers = managers;
     this.#refreshIntervalMs = options?.refreshIntervalMs ?? 0;
-    this.#atRiskReconcileIntervalMs = options?.atRiskReconcileIntervalMs ?? 6e4;
+    const atRisk = options?.atRiskReconcileIntervalMs ?? DEFAULT_AT_RISK_RECONCILE_INTERVAL_MS;
+    this.#atRiskReconcileIntervalMs = typeof atRisk === "function" ? atRisk : () => atRisk;
   }
   /**
    * Whether every on-chain leg of `swap` is observable — i.e. the tracker can
@@ -2013,7 +2126,22 @@ var SwapTracker = class {
         continue;
       }
       this.#swaps.set(swap.swapId, swap);
-      for (const leg of legsOf(swap)) await this.#managerFor(leg).register(leg);
+      const registered = [];
+      try {
+        for (const leg of legsOf(swap)) {
+          await this.#managerFor(leg).register(leg);
+          registered.push(leg);
+        }
+      } catch (error) {
+        this.#swaps.delete(swap.swapId);
+        for (const leg of registered)
+          void this.#managerFor(leg).unregister(leg);
+        this.#unregistered.set(swap.swapId, swap);
+        console.warn(
+          `SwapTracker: swap ${swap.swapId} not tracked yet, registering its legs failed (will retry):`,
+          error
+        );
+      }
     }
     for (const manager of new Set(this.#managers.values())) {
       this.#eventUnsubs.push(manager.onEvent(() => this.#recomputeAll()));
@@ -2021,6 +2149,7 @@ var SwapTracker = class {
     await this.#refreshManagers();
     this.#recomputeAll();
     this.#lastAtRiskReconcileAt = Date.now();
+    this.#lastRetryAt = this.#lastAtRiskReconcileAt;
     if (this.#refreshIntervalMs > 0)
       this.#timer = setInterval(
         () => void this.#tick(),
@@ -2070,7 +2199,11 @@ var SwapTracker = class {
    */
   async #tick() {
     const now = Date.now();
-    if (now - this.#lastAtRiskReconcileAt >= this.#atRiskReconcileIntervalMs) {
+    if (now - this.#lastRetryAt >= RETRY_UNREGISTERED_INTERVAL_MS) {
+      this.#lastRetryAt = now;
+      await this.#retryUnregistered();
+    }
+    if (now - this.#lastAtRiskReconcileAt >= this.#atRiskReconcileIntervalMs()) {
       this.#lastAtRiskReconcileAt = now;
       const legs = [...this.#swaps.values()].filter((swap) => this.#isAtRisk(swap)).flatMap((swap) => legsOf(swap));
       await Promise.all(
@@ -2083,6 +2216,25 @@ var SwapTracker = class {
     }
     this.#recomputeAll();
   }
+  /**
+   * Second attempt at swaps whose startup registration failed, on its own
+   * cadence so a slow at-risk interval can't delay it. `track` is idempotent
+   * and rolls back on failure, so a chain that is still down just leaves the
+   * swap here for the next round.
+   */
+  async #retryUnregistered() {
+    for (const [swapId, swap] of this.#unregistered) {
+      try {
+        await this.track(swap);
+        this.#unregistered.delete(swapId);
+      } catch (error) {
+        console.warn(
+          `SwapTracker: retrying registration of ${swapId} failed:`,
+          error
+        );
+      }
+    }
+  }
   /**
    * Whether a swap needs chain-verified monitoring independent of the server:
    * its client leg holds (or held) funds on-chain, so knowing when a refund
@@ -2142,6 +2294,7 @@ var SwapTracker = class {
   async applyHint(swapId, opts) {
     const swap = this.#swaps.get(swapId);
     if (!swap) return;
+    if (opts?.status !== void 0) this.#hintStatuses.set(swapId, opts.status);
     const legs = legsOf(swap);
     const results = await Promise.allSettled(
       legs.map((leg) => this.#managerFor(leg).reconcile(leg))
@@ -2178,6 +2331,7 @@ var SwapTracker = class {
       for (const leg of legsOf(swap))
         void this.#managerFor(leg).unregister(leg);
     this.#swaps.clear();
+    this.#unregistered.clear();
     this.#subscribers.clear();
   }
   #managerFor(ref) {
@@ -2189,6 +2343,28 @@ var SwapTracker = class {
   #recomputeAll() {
     for (const swap of this.#swaps.values()) this.#recompute(swap);
   }
+  /**
+   * A server hint that the claim was submitted overrides a chain view that
+   * still says "claim now". The claim is relayed by the server, so once it
+   * reports the redeem in flight, another claim can only be refused; and a
+   * chain that cannot be read (no `eth_getLogs` on the public Rootstock RPCs)
+   * keeps its stale pre-claim observation for good. The chain still wins once
+   * it moves: a fresh `spent_claim` derives past the hint on its own, and a
+   * refund observed on chain is not overridden.
+   *
+   * The override lasts only while the server's claim window is open. Once the
+   * server can refund its leg, the chain view is what protects the client: the
+   * `serverfunded` rules never claim then and lead to the client's own refund
+   * at its timelock. A claim that really landed shows up on chain long before
+   * that; a hint that never did must not hide the refund.
+   */
+  #withClaimHint(swap, derived, serverChainNow) {
+    const hint = this.#hintStatuses.get(swap.swapId);
+    if (hint === void 0 || !CLAIM_SUBMITTED.has(hint)) return derived;
+    if (derived !== "serverfunded") return derived;
+    const claimWindowOpen = serverChainNow < swap.serverRefundLocktime;
+    return claimWindowOpen ? hint : derived;
+  }
   #recompute(swap, force = false) {
     let clientHtlc;
     let serverHtlc;
@@ -2208,8 +2384,9 @@ var SwapTracker = class {
       if (serverHtlc === void 0 || now === void 0) return;
       serverChainNow = now;
     }
-    const status = deriveSwapStatus({ clientHtlc, serverHtlc });
-    if (status === void 0) return;
+    const derived = deriveSwapStatus({ clientHtlc, serverHtlc });
+    if (derived === void 0) return;
+    const status = this.#withClaimHint(swap, derived, serverChainNow);
     const actions = {
       ...deriveSwapActions({
         status,
@@ -2217,8 +2394,10 @@ var SwapTracker = class {
         serverChainNow,
         clientRefundLocktime: swap.clientRefundLocktime,
         serverRefundLocktime: swap.serverRefundLocktime,
-        // Pay-on-Lightning swaps have no client-funded on-chain leg.
-        clientFunds: swap.clientHtlc !== void 0
+        // Pay-on-Lightning swaps have no client-funded on-chain leg;
+        // receive-on-Lightning swaps have no server-funded one.
+        clientFunds: swap.clientHtlc !== void 0,
+        serverFunds: swap.serverHtlc !== void 0
       }),
       // Expose the raw observations so consumers can render progress from
       // chain facts (which leg is funded/spent) even when the server is
@@ -2258,12 +2437,16 @@ var Client = class {
   #startPromise;
   /** Swap ids whose settled status was already re-fetched this session. */
   #settledSyncDone = /* @__PURE__ */ new Set();
+  /** Read per chain read, so it can change without rebuilding the client. */
+  #bitcoinMinConfirmations;
   constructor(...args) {
     if (args[0] instanceof LegacyClient) {
       this.#legacy = args[0];
       this.#tracking = args[1] ?? {
         enabled: false
       };
+      assertMinConfirmations(this.#tracking.bitcoinMinConfirmations);
+      this.#bitcoinMinConfirmations = this.#tracking.bitcoinMinConfirmations;
     } else {
       this.#legacy = new LegacyClient(
         ...args
@@ -2510,6 +2693,12 @@ var Client = class {
     );
   }
   /** Delegated to the legacy client (migration checkpoint). */
+  createEvmToLightningSwap(...args) {
+    return this.#trackAfterCreate(
+      this.#legacy.createEvmToLightningSwap(...args)
+    );
+  }
+  /** Delegated to the legacy client (migration checkpoint). */
   createEvmToArkadeSwapGeneric(...args) {
     return this.#trackAfterCreate(
       this.#legacy.createEvmToArkadeSwapGeneric(...args)
@@ -2568,6 +2757,22 @@ var Client = class {
     return this.#legacy.hasReceivedVtxo(...args);
   }
   // --- Satora-native features go below ---
+  /** Confirmations a server-funded Bitcoin HTLC needs before it is claimable. */
+  getBitcoinMinConfirmations() {
+    return this.#bitcoinMinConfirmations;
+  }
+  /**
+   * At `0` the claim goes out against a mempool funding, trusting the funder
+   * not to replace it once the claim reveals the preimage.
+   *
+   * Only the chain monitors read a depth, so this does nothing unless the
+   * client was built with {@link ClientBuilder.withChainVerifiedTracking}.
+   * Takes effect on subsequent reads, including swaps already tracked.
+   */
+  setBitcoinMinConfirmations(minConfirmations) {
+    assertMinConfirmations(minConfirmations);
+    this.#bitcoinMinConfirmations = minConfirmations;
+  }
   /**
    * Start observing the user's active swaps and deriving each one's next action.
    *
@@ -2596,8 +2801,18 @@ var Client = class {
   async #doStartTracking() {
     try {
       const chainVerified = this.#tracking.chainVerified || this.#tracking.managers !== void 0;
+      if (!chainVerified && (this.#bitcoinMinConfirmations ?? 0) > 0)
+        console.warn(
+          "Client: bitcoinMinConfirmations is set but tracking follows server hints, which carry no depth. Build with ClientBuilder.withChainVerifiedTracking() for the depth to gate the claim."
+        );
       const tracker = chainVerified ? new SwapTracker(await this.#ensureManagers(), {
-        refreshIntervalMs: this.#tracking.refreshIntervalMs ?? 5e3
+        refreshIntervalMs: this.#tracking.refreshIntervalMs ?? 5e3,
+        // Depth is only re-derived on a chain read, and nothing pushes on a
+        // new block (an Electrum scripthash status doesn't change once the
+        // funding is in a block), so a deep policy would otherwise sit out
+        // the default interval after the block that satisfied it. Read per
+        // tick, like the depth itself, so a setter call after start counts.
+        atRiskReconcileIntervalMs: () => (this.#bitcoinMinConfirmations ?? 0) > 1 ? 15e3 : DEFAULT_AT_RISK_RECONCILE_INTERVAL_MS
       }) : new HintTracker({
         fetchStatus: async (swapId) => (await this.getSwap(swapId, { updateStorage: true })).status,
         refreshIntervalMs: this.#tracking.refreshIntervalMs ?? 5e3
@@ -2783,8 +2998,7 @@ var Client = class {
       evmRpcUrls,
       esploraUrl,
       electrumWsUrl,
-      bitcoinNetwork,
-      bitcoinMinConfirmations
+      bitcoinNetwork
     } = this.#tracking;
     const chainTime = async () => (await this.getMtp()).mtp * 1e3;
     const arkadeUrl = arkadeServerUrl ?? defaultArkadeServerUrl("bitcoin");
@@ -2805,7 +3019,7 @@ var Client = class {
         electrumWsUrl: electrumWsUrl ?? DEFAULT_ELECTRUM_WS_URLS[network],
         network,
         chainTime,
-        minConfirmations: bitcoinMinConfirmations
+        minConfirmations: () => this.#bitcoinMinConfirmations
       })
     );
     this.#managers = managers;
@@ -2926,9 +3140,11 @@ var ClientBuilder = class {
    * funding hits the mempool, which TRUSTS the funder not to double-spend it
    * (claiming publishes the preimage, so a funder that then replaced its
    * funding could take both legs). Set `1` (or more) for a block-depth policy
-   * that doesn't rely on the funder's good behaviour.
+   * that doesn't rely on the funder's good behaviour. Read only by the chain
+   * monitors, so it needs {@link withChainVerifiedTracking} to have any effect.
    */
   withBitcoinMinConfirmations(minConfirmations) {
+    assertMinConfirmations(minConfirmations);
     this.#bitcoinMinConfirmations = minConfirmations;
     return this;
   }
@@ -2985,6 +3201,13 @@ var ClientBuilder = class {
     });
   }
 };
+function assertMinConfirmations(value) {
+  if (value === void 0) return;
+  if (!Number.isInteger(value) || value < 0)
+    throw new Error(
+      `bitcoinMinConfirmations must be a non-negative integer, got ${value}`
+    );
+}
 function legacyBaseUrl(legacy) {
   try {
     return legacy.baseUrl;
@@ -3028,6 +3251,7 @@ export {
   htlcFactsFromEsploraTxs,
   htlcKey,
   htlcQueryKey,
+  resolveMinConfirmations,
   swapToTracked
 };
 //# sourceMappingURL=index.js.map