@bwalletx/connect 0.3.0 → 0.4.1

package/dist/index.cjs

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,33 +17,57 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
+  BRC29_PROTOCOL: () => BRC29_PROTOCOL,
   BWALLETX_RDNS: () => BWALLETX_RDNS,
   GET_URL: () => GET_URL,
   LOGIN_PROTOCOL: () => LOGIN_PROTOCOL,
   LOGO_URL: () => LOGO_URL,
+  PaymentError: () => PaymentError,
   RDNS_EXTENSION: () => RDNS_EXTENSION,
   RDNS_MOBILE: () => RDNS_MOBILE,
   SIGNIN_CSS: () => SIGNIN_CSS,
   SIGNIN_TAG: () => SIGNIN_TAG,
   WEB_WALLET_URL: () => WEB_WALLET_URL,
+  amountInSats: () => amountInSats,
+  brc100Option: () => brc100Option,
   buildAuthorizeUrl: () => buildAuthorizeUrl,
+  buyToken: () => buyToken,
   clearPairing: () => clearPairing,
   connectBwalletX: () => connectBwalletX,
   defineBwalletxSignin: () => defineBwalletxSignin,
   discoverBwalletX: () => discoverBwalletX,
+  discoverWallets: () => discoverWallets,
   findBwalletX: () => findBwalletX,
+  handcashAdapter: () => handcashAdapter,
   inOrder: () => inOrder,
+  isIdentityKeyHex: () => isIdentityKeyHex,
+  isPaymail: () => isPaymail,
   markSvg: () => markSvg,
   pairBwalletX: () => pairBwalletX,
+  pairingModal: () => pairingModal,
+  pairingOption: () => pairingOption,
+  pay: () => pay,
+  pickWallet: () => pickWallet,
+  qrSvg: () => qrSvg,
   renderButton: () => renderButton,
+  resolvePaymailP2P: () => resolvePaymailP2P,
   restorePairing: () => restorePairing,
   signInWithBwalletX: () => signInWithBwalletX,
-  signinText: () => signinText
+  signinText: () => signinText,
+  tip: () => tip
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -480,9 +506,9 @@ var CSS = `
 .bwx-signin .bwx-mark{display:inline-flex;align-items:center;justify-content:center;width:32px;height:32px;border-radius:50%;background:#000;flex:none}
 .bwx-signin small{display:block;font-size:11px;font-weight:500;color:rgba(0,0,0,.6)}`;
 var LOGO_URL = "https://bwalletx.com/logo.svg";
-function renderButton(el, opts = {}) {
-  const host = typeof el === "string" ? document.querySelector(el) : el;
-  if (!host) throw new Error(`renderButton: no element ${String(el)}`);
+function renderButton(el2, opts = {}) {
+  const host = typeof el2 === "string" ? document.querySelector(el2) : el2;
+  if (!host) throw new Error(`renderButton: no element ${String(el2)}`);
   if (!document.getElementById("bwx-signin-css")) {
     const style = document.createElement("style");
     style.id = "bwx-signin-css";
@@ -714,29 +740,423 @@ function defineBwalletxSignin(tag = SIGNIN_TAG) {
   customElements.define(tag, C);
   return C;
 }
+
+// src/pay.ts
+var import_sdk3 = require("@bsv/sdk");
+var BRC29_PROTOCOL = [2, "3241645161d8"];
+var PaymentError = class extends Error {
+  constructor(code, message, maybeSent = false, cause) {
+    super(message);
+    this.code = code;
+    this.maybeSent = maybeSent;
+    this.cause = cause;
+    this.name = "PaymentError";
+  }
+  code;
+  maybeSent;
+  cause;
+};
+var isLegacy = (s) => typeof s.pay === "function" && typeof s.createAction !== "function";
+var isIdentityKeyHex = (s) => /^0[23][0-9a-fA-F]{64}$/.test(s);
+var isPaymail = (s) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(s);
+function randomB64(n) {
+  const b = new Uint8Array(n);
+  globalThis.crypto.getRandomValues(b);
+  return import_sdk3.Utils.toBase64(Array.from(b));
+}
+function opReturn(text) {
+  const d = import_sdk3.Utils.toArray(text, "utf8");
+  const len = d.length;
+  const push = len < 76 ? [len] : len <= 255 ? [76, len] : [77, len & 255, len >> 8];
+  return import_sdk3.Utils.toHex([0, 106, ...push, ...d]);
+}
+var clip = (s, n) => s.length > n ? s.slice(0, n - 1) + "\u2026" : s;
+var describe = (s) => clip(s.length < 5 ? `${s} payment`.trim() : s, 50);
+async function usdRate(o) {
+  if (typeof o.usdPerBsv === "number") return o.usdPerBsv;
+  try {
+    if (typeof o.usdPerBsv === "function") return await o.usdPerBsv();
+    const r = await (o.fetch ?? fetch)("https://api.whatsonchain.com/v1/bsv/main/exchangerate");
+    const j = await r.json();
+    if (!r.ok || !(Number(j.rate) > 0)) throw new Error(`status ${r.status}`);
+    return Number(j.rate);
+  } catch (e) {
+    throw new PaymentError("RATE_FAILED", `Could not get the BSV/USD rate: ${e.message}`, false, e);
+  }
+}
+async function amountInSats(req, o = {}) {
+  if (req.sats != null) {
+    if (!Number.isSafeInteger(req.sats) || req.sats <= 0) throw new PaymentError("BAD_REQUEST", "sats must be a positive integer");
+    return req.sats;
+  }
+  if (req.usd != null) {
+    if (!(req.usd > 0)) throw new PaymentError("BAD_REQUEST", "usd must be positive");
+    return Math.max(1, Math.ceil(req.usd / await usdRate(o) * 1e8));
+  }
+  throw new PaymentError("BAD_REQUEST", "Give sats or usd");
+}
+async function resolvePaymailP2P(paymail, sats, f = fetch) {
+  const [alias, domain] = paymail.split("@");
+  const fail = (m, e) => new PaymentError("RESOLVE_FAILED", `Could not resolve ${paymail}: ${m}`, false, e);
+  let caps;
+  try {
+    const r = await f(`https://${domain}/.well-known/bsvalias`);
+    caps = (await r.json()).capabilities;
+  } catch (e) {
+    throw fail("no bsvalias document (or CORS blocked it; resolve on your server and pass resolvePaymail)", e);
+  }
+  const fill = (u) => u.replace("{alias}", encodeURIComponent(alias)).replace("{domain.tld}", domain);
+  const dest = caps?.["2a40af698840"];
+  if (!dest) throw fail("it does not offer P2P payment destinations");
+  let body;
+  try {
+    const r = await f(fill(dest), { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ satoshis: sats }) });
+    if (!r.ok) throw new Error(`status ${r.status}`);
+    body = await r.json();
+  } catch (e) {
+    throw fail(e.message, e);
+  }
+  if (!body.outputs?.length) throw fail("no outputs returned");
+  const receive = caps["5f1323cddf31"];
+  return {
+    outputs: body.outputs.map((o) => ({ script: o.script, satoshis: o.satoshis })),
+    reference: body.reference,
+    submit: receive ? async (hex) => {
+      await f(fill(receive), {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ hex, reference: body.reference, metadata: {} })
+      });
+    } : void 0
+  };
+}
+async function runAction(wallet, description, outputs, labels) {
+  try {
+    return await wallet.createAction({
+      description: describe(description),
+      outputs: outputs.map((o) => ({ lockingScript: o.script, satoshis: o.satoshis, outputDescription: describe(o.description ?? "payment") })),
+      labels: labels?.length ? labels : void 0,
+      options: { randomizeOutputs: false }
+    });
+  } catch (e) {
+    const msg = e?.message ?? String(e);
+    const rejected = /denied|reject|cancel|abort|user/i.test(msg) || e?.code === 4001;
+    throw new PaymentError(rejected ? "WALLET_REJECTED" : "WALLET_ERROR", rejected ? "The payment was declined in the wallet." : `The wallet could not make the payment: ${msg}`, !rejected, e);
+  }
+}
+async function pay(source, req, o = {}) {
+  const to = (req.to ?? "").trim();
+  if (!to) throw new PaymentError("BAD_REQUEST", "Give a recipient (to)");
+  if (req.memo && req.memo.length > 1e3) throw new PaymentError("BAD_REQUEST", "memo is too long");
+  const sats = await amountInSats(req, o);
+  if (isLegacy(source)) return source.pay({ ...req, to, sats });
+  let outputs;
+  let remittance;
+  let submit;
+  if (isIdentityKeyHex(to)) {
+    const derivationPrefix = randomB64(8);
+    const derivationSuffix = randomB64(8);
+    let pk;
+    let me;
+    try {
+      ({ publicKey: pk } = await source.getPublicKey({ protocolID: BRC29_PROTOCOL, keyID: `${derivationPrefix} ${derivationSuffix}`, counterparty: to.toLowerCase() }));
+      ({ publicKey: me } = await source.getPublicKey({ identityKey: true }));
+    } catch (e) {
+      throw new PaymentError("WALLET_ERROR", `The wallet could not derive the payment key: ${e.message}`, false, e);
+    }
+    outputs = [{ script: new import_sdk3.P2PKH().lock(import_sdk3.PublicKey.fromString(pk).toHash()).toHex(), satoshis: sats, description: "payment" }];
+    remittance = { senderIdentityKey: me, derivationPrefix, derivationSuffix, outputIndex: 0 };
+  } else if (isPaymail(to)) {
+    const r2 = await (o.resolvePaymail ?? ((p, s) => resolvePaymailP2P(p, s, o.fetch ?? fetch)))(to, sats);
+    outputs = r2.outputs;
+    submit = r2.submit;
+  } else {
+    try {
+      outputs = [{ script: new import_sdk3.P2PKH().lock(to).toHex(), satoshis: sats, description: "payment" }];
+    } catch {
+      throw new PaymentError("BAD_REQUEST", `Not a paymail, address or identity key: ${to}`);
+    }
+  }
+  if (req.memo && req.memoOnChain) outputs = [...outputs, { script: opReturn(req.memo), satoshis: 0, description: "memo" }];
+  const r = await runAction(source, req.memo || `Pay ${clip(to, 30)}`, outputs, req.labels);
+  if (!r.txid) throw new PaymentError("WALLET_ERROR", "The wallet did not return a txid", true);
+  const tx = r.tx ? Array.from(r.tx) : void 0;
+  if (submit && tx) {
+    await submit(import_sdk3.Transaction.fromAtomicBEEF(tx).toHex()).catch(() => {
+    });
+  }
+  return { txid: r.txid, tx, sats, outputs, remittance };
+}
+function tip(source, req, o = {}) {
+  return pay(source, { memo: "Tip", ...req, labels: [...req.labels ?? [], "tip"] }, o);
+}
+async function buyToken(source, req) {
+  if (isLegacy(source)) throw new PaymentError("NOT_SUPPORTED", "This wallet cannot buy tokens. Use a BRC-100 wallet such as bWalletX.");
+  const q = await req.quote({ token: req.token, amount: req.amount });
+  if (!q?.outputs?.length) throw new PaymentError("BAD_REQUEST", "The quote returned no outputs");
+  const sats = q.outputs.reduce((n, x) => n + x.satoshis, 0);
+  const r = await runAction(source, q.description ?? `Buy ${clip(req.token, 30)}`, q.outputs, [...req.labels ?? [], "token-buy"]);
+  if (!r.txid) throw new PaymentError("WALLET_ERROR", "The wallet did not return a txid", true);
+  const res = { txid: r.txid, tx: r.tx ? Array.from(r.tx) : void 0, sats, outputs: q.outputs };
+  await q.onPaid?.(res);
+  return res;
+}
+
+// src/wallets.ts
+var import_sdk4 = require("@bsv/sdk");
+async function brc100Connected(wallet, o) {
+  await wallet.waitForAuthentication({}).catch(() => {
+  });
+  const { publicKey } = await wallet.getPublicKey({ identityKey: true });
+  return { wallet, payer: wallet, identityKey: publicKey, optionId: o.id, kind: o.kind };
+}
+function brc100Option(wallet, info) {
+  const opt = {
+    id: info.id,
+    name: info.name,
+    icon: info.icon,
+    rdns: info.rdns,
+    kind: "brc100",
+    isBwalletX: info.isBwalletX ?? false,
+    connect: () => brc100Connected(wallet, opt)
+  };
+  return opt;
+}
+function pairingOption(pairing) {
+  const opt = {
+    id: "bwalletx-pairing",
+    name: "bWalletX on your phone",
+    kind: "pairing",
+    isBwalletX: true,
+    async connect() {
+      const p = typeof pairing === "function" ? pairing() : pairing;
+      const w = await restorePairing(p) ?? await pairBwalletX(p);
+      return brc100Connected(w, opt);
+    }
+  };
+  return opt;
+}
+function handcashAdapter(o) {
+  const opt = {
+    id: "handcash",
+    name: "HandCash",
+    icon: o.icon,
+    kind: "handcash",
+    isBwalletX: false,
+    async connect() {
+      const p = await o.login();
+      return {
+        wallet: null,
+        payer: o.pay ? { pay: o.pay } : null,
+        identityKey: p.identityKey ?? null,
+        handle: p.handle,
+        paymail: p.paymail ?? `${p.handle.replace(/^\$/, "")}@handcash.io`,
+        optionId: opt.id,
+        kind: "handcash",
+        transitional: true
+      };
+    }
+  };
+  return opt;
+}
+var NAMES = { [RDNS_EXTENSION]: "bWalletX", "space.bwallet.mobile": "bWalletX" };
+async function probe(substrate, ms) {
+  try {
+    const w = new import_sdk4.WalletClient(substrate);
+    const ok = await Promise.race([w.isAuthenticated({}).then(() => true), new Promise((r) => setTimeout(() => r(false), ms))]);
+    return ok ? w : null;
+  } catch {
+    return null;
+  }
+}
+async function discoverWallets(o = {}) {
+  const out = [];
+  const ms = o.ms ?? 1200;
+  if (typeof window !== "undefined") {
+    const seen = /* @__PURE__ */ new Map();
+    const onAnnounce = (e) => {
+      const d = e.detail;
+      if (!d?.wallet) return;
+      const rdns = d.info?.rdns ?? d.info?.uuid ?? `wallet-${seen.size}`;
+      if (seen.has(rdns)) return;
+      const isB = BWALLETX_RDNS.includes(rdns);
+      seen.set(rdns, brc100Option(d.wallet, { id: rdns, rdns, name: NAMES[rdns] ?? d.info?.name ?? rdns, icon: d.info?.icon, isBwalletX: isB }));
+    };
+    window.addEventListener("brc100:announceWallet", onAnnounce);
+    window.dispatchEvent(new Event("brc100:requestWallet"));
+    const local = o.probeLocal ? Promise.all([probe("json-api", ms), probe("Cicada", ms)]) : Promise.resolve([null, null]);
+    await new Promise((r) => setTimeout(r, ms));
+    window.removeEventListener("brc100:announceWallet", onAnnounce);
+    out.push(...seen.values());
+    const cwi = window.CWI;
+    if (cwi && ![...seen.values()].some((x) => x.rdns === "space.bwallet.mobile")) {
+      out.push(brc100Option(cwi, { id: "window.CWI", name: "This app\u2019s wallet", isBwalletX: false }));
+    }
+    const [json, cicada] = await local;
+    if (json) out.push(brc100Option(json, { id: "localhost:3321", name: "Desktop wallet (localhost:3321)" }));
+    if (cicada) out.push(brc100Option(cicada, { id: "localhost:3301", name: "Desktop wallet (localhost:3301)" }));
+  }
+  if (o.pairing) out.push(pairingOption(o.pairing));
+  out.push(...o.extra ?? []);
+  const rank = (w) => w.isBwalletX ? 0 : w.kind === "handcash" ? 2 : 1;
+  return out.map((w, i) => ({ w, i })).sort((a, b) => rank(a.w) - rank(b.w) || a.i - b.i).map((x) => x.w);
+}
+
+// src/modal.ts
+var import_qrcode_generator = __toESM(require("qrcode-generator"), 1);
+var CSS2 = `
+.bwx-ov{position:fixed;inset:0;z-index:2147483000;background:rgba(0,0,0,.6);display:flex;align-items:center;justify-content:center;padding:16px;font:15px/1.4 system-ui,-apple-system,Segoe UI,Roboto,sans-serif}
+.bwx-box{background:#0b0b0b;color:#f4f1e8;border:1px solid #3a3220;border-radius:16px;width:min(360px,100%);padding:20px;box-shadow:0 20px 60px rgba(0,0,0,.5)}
+.bwx-box h2{margin:0 0 6px;font-size:18px;color:#e8c766}
+.bwx-box p{margin:0 0 14px;color:#bdb6a3;font-size:14px}
+.bwx-qr{background:#fff;border-radius:12px;padding:12px;display:flex;justify-content:center}
+.bwx-qr svg{width:100%;height:auto;max-width:260px}
+.bwx-code{margin:14px 0 0;text-align:center;font-size:28px;letter-spacing:.3em;color:#e8c766;font-variant-numeric:tabular-nums}
+.bwx-row{display:flex;gap:8px;margin-top:14px}
+.bwx-btn{flex:1;border:1px solid #3a3220;background:#15130e;color:#f4f1e8;border-radius:10px;padding:10px 12px;font:inherit;cursor:pointer}
+.bwx-btn:hover{border-color:#e8c766}
+.bwx-list{display:flex;flex-direction:column;gap:8px}
+.bwx-opt{display:flex;align-items:center;gap:10px;text-align:left}
+.bwx-opt img{width:24px;height:24px;border-radius:6px}
+.bwx-tag{margin-left:auto;font-size:11px;color:#8d866f}
+`;
+function mount() {
+  const root = document.createElement("div");
+  root.className = "bwx-ov";
+  root.setAttribute("role", "dialog");
+  root.setAttribute("aria-modal", "true");
+  const style = document.createElement("style");
+  style.textContent = CSS2;
+  const box = document.createElement("div");
+  box.className = "bwx-box";
+  root.append(style, box);
+  document.body.appendChild(root);
+  return { root, box, close: () => root.remove() };
+}
+function el(tag, cls, text) {
+  const e = document.createElement(tag);
+  if (cls) e.className = cls;
+  if (text != null) e.textContent = text;
+  return e;
+}
+function qrSvg(text) {
+  const q = (0, import_qrcode_generator.default)(0, "M");
+  q.addData(text);
+  q.make();
+  return q.createSvgTag({ cellSize: 4, margin: 2, scalable: true });
+}
+function pairingModal(o = {}) {
+  const ac = new AbortController();
+  let ui = null;
+  let codeEl = null;
+  const close = () => {
+    ui?.close();
+    ui = null;
+  };
+  ac.signal.addEventListener("abort", close);
+  return {
+    signal: ac.signal,
+    close,
+    onLink(link) {
+      if (typeof document === "undefined") return;
+      close();
+      ui = mount();
+      const h = el("h2", "", o.title ?? "Connect bWalletX");
+      const p = el("p", "", "Scan with bWalletX on your phone, or paste the link into web.bwalletx.com.");
+      const qr = el("div", "bwx-qr");
+      qr.innerHTML = qrSvg(link);
+      codeEl = el("div", "bwx-code", "");
+      codeEl.setAttribute("aria-live", "polite");
+      const row = el("div", "bwx-row");
+      const copy = el("button", "bwx-btn", "Copy link");
+      copy.onclick = () => void navigator.clipboard?.writeText(link).then(() => copy.textContent = "Copied");
+      const cancel = el("button", "bwx-btn", "Cancel");
+      cancel.onclick = () => {
+        o.onCancel?.();
+        ac.abort();
+      };
+      row.append(copy, cancel);
+      ui.box.append(h, p, qr, codeEl, row);
+    },
+    onCode(code) {
+      if (codeEl) {
+        codeEl.textContent = code;
+        const p = ui?.box.querySelector("p");
+        if (p) p.textContent = "Check bWalletX shows the same code, then tap Connect.";
+      }
+    }
+  };
+}
+function pickWallet(options, o = {}) {
+  if (typeof document === "undefined") return Promise.resolve(null);
+  return new Promise((resolve) => {
+    const ui = mount();
+    const done = (w) => {
+      ui.close();
+      resolve(w);
+    };
+    ui.box.append(el("h2", "", o.title ?? "Choose a wallet"));
+    if (!options.length) ui.box.append(el("p", "", "No wallet found. Get bWalletX at bwalletx.com."));
+    const list = el("div", "bwx-list");
+    for (const w of options) {
+      const b = el("button", "bwx-btn bwx-opt");
+      if (w.icon) {
+        const img = el("img");
+        img.src = w.icon;
+        img.alt = "";
+        b.append(img);
+      }
+      b.append(el("span", "", w.name));
+      if (w.kind === "handcash") b.append(el("span", "bwx-tag", "until BRC-100"));
+      b.onclick = () => done(w);
+      list.append(b);
+    }
+    const cancel = el("button", "bwx-btn", "Cancel");
+    cancel.onclick = () => done(null);
+    ui.root.onclick = (e) => e.target === ui.root && done(null);
+    ui.box.append(list, el("div", "bwx-row"));
+    ui.box.lastChild.append(cancel);
+  });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BRC29_PROTOCOL,
   BWALLETX_RDNS,
   GET_URL,
   LOGIN_PROTOCOL,
   LOGO_URL,
+  PaymentError,
   RDNS_EXTENSION,
   RDNS_MOBILE,
   SIGNIN_CSS,
   SIGNIN_TAG,
   WEB_WALLET_URL,
+  amountInSats,
+  brc100Option,
   buildAuthorizeUrl,
+  buyToken,
   clearPairing,
   connectBwalletX,
   defineBwalletxSignin,
   discoverBwalletX,
+  discoverWallets,
   findBwalletX,
+  handcashAdapter,
   inOrder,
+  isIdentityKeyHex,
+  isPaymail,
   markSvg,
   pairBwalletX,
+  pairingModal,
+  pairingOption,
+  pay,
+  pickWallet,
+  qrSvg,
   renderButton,
+  resolvePaymailP2P,
   restorePairing,
   signInWithBwalletX,
-  signinText
+  signinText,
+  tip
 });
 //# sourceMappingURL=index.cjs.map