@satora/swap 0.0.5 → 0.1.0

package/README.md

@@ -3,10 +3,12 @@
 The Satora swap client — a Lightning / on-chain BTC / Arkade ↔ EVM on/off-ramp.
 Pure TypeScript, works in every JS environment (browser, Node, React Native).
 
-This is the `@satora`-scoped name for the swap client and re-exports the
+This is the `@satora`-scoped swap client. `Client` and `ClientBuilder` are
+drop-in replacements that wrap the underlying
 [`@lendasat/lendaswap-sdk-pure`](https://www.npmjs.com/package/@lendasat/lendaswap-sdk-pure)
-bundle verbatim (`Client`, `ClientBuilder`, `Asset`, `EvmSigner`, storage
-backends, …). New code should import `@satora/swap`.
+client — same API, plus room for Satora-native features. Everything else
+(`Asset`, `EvmSigner`, storage backends, types, …) is re-exported verbatim.
+New code should import `@satora/swap`.
 
 ## Install
 

package/dist/bitcoin-reader-esplora-GRUP7RAG.js

@@ -0,0 +1,11 @@
+import {
+  DEFAULT_ESPLORA_URLS,
+  esploraReader,
+  htlcFactsFromEsploraTxs
+} from "./chunk-J35RZBDW.js";
+export {
+  DEFAULT_ESPLORA_URLS,
+  esploraReader,
+  htlcFactsFromEsploraTxs
+};
+//# sourceMappingURL=bitcoin-reader-esplora-GRUP7RAG.js.map

package/dist/bitcoin-reader-esplora-GRUP7RAG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-J35RZBDW.js

@@ -0,0 +1,65 @@
+// src/contracts/bitcoin-reader-esplora.ts
+function htlcFactsFromEsploraTxs(txs, address) {
+  for (const tx of txs) {
+    const spend = tx.vin.find(
+      (vin) => vin.prevout?.scriptpubkey_address === address
+    );
+    if (spend)
+      return {
+        funding: "confirmed",
+        fundedSats: 0,
+        // already spent — the amount no longer matters
+        spendWitness: spend.witness ?? []
+      };
+  }
+  const funding = txs.find(
+    (tx) => tx.vout.some((vout) => vout.scriptpubkey_address === address)
+  );
+  if (funding) {
+    const fundedSats = funding.vout.filter((vout) => vout.scriptpubkey_address === address).reduce((sum, vout) => sum + (vout.value ?? 0), 0);
+    return {
+      funding: funding.status?.confirmed ? "confirmed" : "mempool",
+      fundedSats
+    };
+  }
+  return { funding: "absent", fundedSats: 0 };
+}
+var DEFAULT_ESPLORA_URLS = [
+  "https://mempool.space/api",
+  "https://blockstream.info/api"
+];
+function esploraReader(esploraUrls, fetchImpl = fetch) {
+  const bases = (Array.isArray(esploraUrls) ? esploraUrls : [esploraUrls]).map(
+    (url) => url.replace(/\/+$/, "")
+  );
+  let start = 0;
+  return {
+    async getHtlcFacts(address) {
+      const from = start++ % bases.length;
+      let lastError;
+      for (let i = 0; i < bases.length; i++) {
+        const base = bases[(from + i) % bases.length];
+        try {
+          const res = await fetchImpl(
+            `${base}/address/${encodeURIComponent(address)}/txs`
+          );
+          if (!res.ok) throw new Error(`esplora ${res.status} at ${base}`);
+          return htlcFactsFromEsploraTxs(
+            await res.json(),
+            address
+          );
+        } catch (error) {
+          lastError = error;
+        }
+      }
+      throw lastError ?? new Error("no esplora endpoints configured");
+    }
+  };
+}
+
+export {
+  htlcFactsFromEsploraTxs,
+  DEFAULT_ESPLORA_URLS,
+  esploraReader
+};
+//# sourceMappingURL=chunk-J35RZBDW.js.map

package/dist/chunk-J35RZBDW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/contracts/bitcoin-reader-esplora.ts"],"sourcesContent":["/**\n * A esplora-backed {@link BitcoinChainReader} — the concrete chain source the\n * {@link BitcoinContractManager} uses in production.\n *\n * Kept separate from the manager so the manager stays free of any HTTP/esplora\n * dependency (and unit-testable against a fake reader). A single\n * `GET /address/{addr}/txs` yields both the funding state and the spending\n * input's witness, so no extra round-trips are needed.\n */\n\nimport type { BitcoinHtlcFacts } from \"./bitcoin.js\";\nimport type { BitcoinChainReader } from \"./bitcoin-manager.js\";\n\n/** The slice of esplora's tx JSON we read. */\ntype EsploraTx = {\n  vin: Array<{\n    witness?: string[];\n    prevout?: { scriptpubkey_address?: string } | null;\n  }>;\n  vout: Array<{ scriptpubkey_address?: string; value?: number }>;\n  status?: { confirmed?: boolean };\n};\n\n/**\n * Reduce an address's esplora tx history to HTLC facts. If a tx spends an output\n * at the address, that's the resolving spend (its witness classifies claim vs\n * refund); otherwise a tx paying the address is the funding.\n */\nexport function htlcFactsFromEsploraTxs(\n  txs: EsploraTx[],\n  address: string,\n): BitcoinHtlcFacts {\n  for (const tx of txs) {\n    const spend = tx.vin.find(\n      (vin) => vin.prevout?.scriptpubkey_address === address,\n    );\n    if (spend)\n      return {\n        funding: \"confirmed\",\n        fundedSats: 0, // already spent — the amount no longer matters\n        spendWitness: spend.witness ?? [],\n      };\n  }\n  const funding = txs.find((tx) =>\n    tx.vout.some((vout) => vout.scriptpubkey_address === address),\n  );\n  if (funding) {\n    const fundedSats = funding.vout\n      .filter((vout) => vout.scriptpubkey_address === address)\n      .reduce((sum, vout) => sum + (vout.value ?? 0), 0);\n    return {\n      funding: funding.status?.confirmed ? \"confirmed\" : \"mempool\",\n      fundedSats,\n    };\n  }\n  return { funding: \"absent\", fundedSats: 0 };\n}\n\n/**\n * Public esplora endpoints tried in rotation (mainnet). blockstream.info runs the\n * reference esplora, so it's API-compatible with mempool.space; spreading calls\n * across both halves the per-provider load and survives one being throttled.\n */\nexport const DEFAULT_ESPLORA_URLS = [\n  \"https://mempool.space/api\",\n  \"https://blockstream.info/api\",\n];\n\n/**\n * Build a {@link BitcoinChainReader} over one or more esplora REST endpoints.\n * With several, each call starts at a rotating endpoint (to spread load across\n * providers) and fails over to the rest on error — so a throttled or failing\n * provider doesn't stall tracking.\n */\nexport function esploraReader(\n  esploraUrls: string | string[],\n  fetchImpl: typeof fetch = fetch,\n): BitcoinChainReader {\n  const bases = (Array.isArray(esploraUrls) ? esploraUrls : [esploraUrls]).map(\n    (url) => url.replace(/\\/+$/, \"\"),\n  );\n  let start = 0;\n  return {\n    async getHtlcFacts(address) {\n      const from = start++ % bases.length; // rotate the primary to spread load\n      let lastError: unknown;\n      for (let i = 0; i < bases.length; i++) {\n        const base = bases[(from + i) % bases.length];\n        try {\n          const res = await fetchImpl(\n            `${base}/address/${encodeURIComponent(address)}/txs`,\n          );\n          if (!res.ok) throw new Error(`esplora ${res.status} at ${base}`);\n          return htlcFactsFromEsploraTxs(\n            (await res.json()) as EsploraTx[],\n            address,\n          );\n        } catch (error) {\n          lastError = error;\n        }\n      }\n      throw lastError ?? new Error(\"no esplora endpoints configured\");\n    },\n  };\n}\n"],"mappings":";AA4BO,SAAS,wBACd,KACA,SACkB;AAClB,aAAW,MAAM,KAAK;AACpB,UAAM,QAAQ,GAAG,IAAI;AAAA,MACnB,CAAC,QAAQ,IAAI,SAAS,yBAAyB;AAAA,IACjD;AACA,QAAI;AACF,aAAO;AAAA,QACL,SAAS;AAAA,QACT,YAAY;AAAA;AAAA,QACZ,cAAc,MAAM,WAAW,CAAC;AAAA,MAClC;AAAA,EACJ;AACA,QAAM,UAAU,IAAI;AAAA,IAAK,CAAC,OACxB,GAAG,KAAK,KAAK,CAAC,SAAS,KAAK,yBAAyB,OAAO;AAAA,EAC9D;AACA,MAAI,SAAS;AACX,UAAM,aAAa,QAAQ,KACxB,OAAO,CAAC,SAAS,KAAK,yBAAyB,OAAO,EACtD,OAAO,CAAC,KAAK,SAAS,OAAO,KAAK,SAAS,IAAI,CAAC;AACnD,WAAO;AAAA,MACL,SAAS,QAAQ,QAAQ,YAAY,cAAc;AAAA,MACnD;AAAA,IACF;AAAA,EACF;AACA,SAAO,EAAE,SAAS,UAAU,YAAY,EAAE;AAC5C;AAOO,IAAM,uBAAuB;AAAA,EAClC;AAAA,EACA;AACF;AAQO,SAAS,cACd,aACA,YAA0B,OACN;AACpB,QAAM,SAAS,MAAM,QAAQ,WAAW,IAAI,cAAc,CAAC,WAAW,GAAG;AAAA,IACvE,CAAC,QAAQ,IAAI,QAAQ,QAAQ,EAAE;AAAA,EACjC;AACA,MAAI,QAAQ;AACZ,SAAO;AAAA,IACL,MAAM,aAAa,SAAS;AAC1B,YAAM,OAAO,UAAU,MAAM;AAC7B,UAAI;AACJ,eAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACrC,cAAM,OAAO,OAAO,OAAO,KAAK,MAAM,MAAM;AAC5C,YAAI;AACF,gBAAM,MAAM,MAAM;AAAA,YAChB,GAAG,IAAI,YAAY,mBAAmB,OAAO,CAAC;AAAA,UAChD;AACA,cAAI,CAAC,IAAI,GAAI,OAAM,IAAI,MAAM,WAAW,IAAI,MAAM,OAAO,IAAI,EAAE;AAC/D,iBAAO;AAAA,YACJ,MAAM,IAAI,KAAK;AAAA,YAChB;AAAA,UACF;AAAA,QACF,SAAS,OAAO;AACd,sBAAY;AAAA,QACd;AAAA,MACF;AACA,YAAM,aAAa,IAAI,MAAM,iCAAiC;AAAA,IAChE;AAAA,EACF;AACF;","names":[]}