@bwalletx/connect 0.3.0 → 0.5.0

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,69 @@ 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, {
+  ACCESS_ERROR_STATUS: () => ACCESS_ERROR_STATUS,
+  ACCESS_PROTOCOL: () => ACCESS_PROTOCOL,
+  ACCESS_VERSION: () => ACCESS_VERSION,
+  AccessError: () => AccessError,
+  BRC29_PROTOCOL: () => BRC29_PROTOCOL,
   BWALLETX_RDNS: () => BWALLETX_RDNS,
   GET_URL: () => GET_URL,
   LOGIN_PROTOCOL: () => LOGIN_PROTOCOL,
   LOGO_URL: () => LOGO_URL,
+  PROTOCOL_MEDIA: () => PROTOCOL_MEDIA,
+  PaymentError: () => PaymentError,
   RDNS_EXTENSION: () => RDNS_EXTENSION,
   RDNS_MOBILE: () => RDNS_MOBILE,
   SIGNIN_CSS: () => SIGNIN_CSS,
   SIGNIN_TAG: () => SIGNIN_TAG,
   WEB_WALLET_URL: () => WEB_WALLET_URL,
+  accessErrorMessage: () => accessErrorMessage,
+  amountInSats: () => amountInSats,
+  brc100Option: () => brc100Option,
   buildAuthorizeUrl: () => buildAuthorizeUrl,
+  buyToken: () => buyToken,
+  canonicalJson: () => canonicalJson,
   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,
+  protocolMediaUrl: () => protocolMediaUrl,
+  proveHoldings: () => proveHoldings,
+  qrSvg: () => qrSvg,
   renderButton: () => renderButton,
+  requestAccess: () => requestAccess,
+  resolvePaymailP2P: () => resolvePaymailP2P,
   restorePairing: () => restorePairing,
   signInWithBwalletX: () => signInWithBwalletX,
-  signinText: () => signinText
+  signinText: () => signinText,
+  throwIfAccessError: () => throwIfAccessError,
+  tip: () => tip,
+  toAccessError: () => toAccessError
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -480,9 +518,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";
@@ -515,6 +553,239 @@ function renderButton(el, opts = {}) {
   return b;
 }
 
+// src/access-client.ts
+var import_sdk3 = require("@bsv/sdk");
+
+// src/access.ts
+var ACCESS_VERSION = 1;
+var ACCESS_PROTOCOL = [2, "bwalletx access"];
+var MAX_HOLDING_PROOFS = 50;
+var ACCESS_ERROR_STATUS = {
+  not_installed: 424,
+  user_rejected: 403,
+  wrong_account: 409,
+  insufficient_tokens: 403,
+  identity_level_too_low: 403,
+  kyc_required: 403,
+  indexer_unavailable: 503,
+  expired: 401,
+  replay: 401,
+  invalid_signature: 401,
+  bad_request: 400
+};
+var AccessError = class extends Error {
+  code;
+  have;
+  need;
+  constructor(code, message, extra = {}) {
+    super(message ?? code);
+    this.name = "AccessError";
+    this.code = code;
+    this.have = extra.have;
+    this.need = extra.need;
+  }
+  toJSON() {
+    const b = { error: this.code, message: this.message };
+    if (this.have !== void 0) b.have = this.have;
+    if (this.need !== void 0) b.need = this.need;
+    return b;
+  }
+};
+var PROTOCOL_MEDIA = {
+  "401": { name: "Identity", color: "#22c55e", video: "assets/protocol/401.mp4", poster: "assets/protocol/401.jpg" },
+  "402": { name: "Payment", color: "#3b82f6", video: "assets/protocol/402.mp4", poster: "assets/protocol/402.jpg" },
+  "403": { name: "Access", color: "#ef4444", video: "assets/protocol/403.mp4", poster: "assets/protocol/403.jpg" }
+};
+function protocolMediaUrl(kind, which, version = "latest") {
+  return `https://unpkg.com/@bwalletx/connect@${version}/${PROTOCOL_MEDIA[kind][which]}`;
+}
+function canonicalJson(v) {
+  if (v === null) return "null";
+  if (typeof v === "string" || typeof v === "boolean") return JSON.stringify(v);
+  if (typeof v === "number") {
+    if (!Number.isFinite(v)) throw new Error("canonicalJson: non-finite number");
+    return JSON.stringify(v);
+  }
+  if (Array.isArray(v)) return `[${v.map((x) => canonicalJson(x)).join(",")}]`;
+  if (typeof v === "object") {
+    const o = v;
+    const keys = Object.keys(o).filter((k) => o[k] !== void 0).sort();
+    return `{${keys.map((k) => `${JSON.stringify(k)}:${canonicalJson(o[k])}`).join(",")}}`;
+  }
+  throw new Error(`canonicalJson: unsupported ${typeof v}`);
+}
+function challengeBytes(challenge) {
+  return Array.from(new TextEncoder().encode(challenge));
+}
+var TOKEN_ID = /^bsv21:[0-9a-f]{64}_\d{1,6}$/;
+var RAW = /^[1-9]\d{0,38}$/;
+function normaliseRequirement(r) {
+  if (!r || typeof r !== "object") throw new AccessError("bad_request", "require must be an object");
+  const req = r;
+  const out = {};
+  if (req.token !== void 0) {
+    const t = req.token;
+    if (!t || typeof t !== "object" || typeof t.id !== "string") throw new AccessError("bad_request", "require.token.id is required");
+    const id = t.id.trim().toLowerCase();
+    if (!TOKEN_ID.test(id)) throw new AccessError("bad_request", "require.token.id must be 'bsv21:<txid>_<vout>'");
+    const hasMin = t.min !== void 0;
+    const hasBps = t.minBps !== void 0;
+    if (hasMin === hasBps) throw new AccessError("bad_request", "require.token needs exactly one of min or minBps");
+    out.token = { id };
+    if (hasMin) {
+      if (typeof t.min !== "string" || !RAW.test(t.min)) throw new AccessError("bad_request", "require.token.min must be a positive integer string (raw units)");
+      out.token.min = t.min;
+    } else {
+      if (!Number.isInteger(t.minBps) || t.minBps < 1 || t.minBps > 1e4) {
+        throw new AccessError("bad_request", "require.token.minBps must be an integer 1..10000");
+      }
+      out.token.minBps = t.minBps;
+    }
+  }
+  if (req.identityLevel !== void 0) {
+    if (!Number.isInteger(req.identityLevel) || req.identityLevel < 1 || req.identityLevel > 10) {
+      throw new AccessError("bad_request", "require.identityLevel must be an integer 1..10");
+    }
+    out.identityLevel = req.identityLevel;
+  }
+  if (req.kyc !== void 0) {
+    if (typeof req.kyc !== "boolean") throw new AccessError("bad_request", "require.kyc must be a boolean");
+    if (req.kyc) out.kyc = true;
+  }
+  if (!out.token && !out.identityLevel && !out.kyc) throw new AccessError("bad_request", "require is empty");
+  return out;
+}
+function parseAccessChallenge(s) {
+  if (typeof s !== "string" || s.length > 4096) throw new AccessError("bad_request", "challenge must be a string");
+  let c;
+  try {
+    c = JSON.parse(s);
+  } catch {
+    throw new AccessError("bad_request", "challenge is not JSON");
+  }
+  if (!c || typeof c !== "object" || c.v !== 1) throw new AccessError("bad_request", "unsupported challenge version");
+  if (c.kind !== "401" && c.kind !== "402" && c.kind !== "403") throw new AccessError("bad_request", "bad kind");
+  if (typeof c.origin !== "string" || typeof c.nonce !== "string" || !/^[A-Za-z0-9_-]{16,64}$/.test(c.nonce)) {
+    throw new AccessError("bad_request", "bad origin or nonce");
+  }
+  if (!Number.isInteger(c.iat) || !Number.isInteger(c.exp) || c.exp <= c.iat) throw new AccessError("bad_request", "bad iat/exp");
+  if (c.sub !== void 0 && (typeof c.sub !== "string" || !/^0[23][0-9a-f]{64}$/.test(c.sub))) throw new AccessError("bad_request", "bad sub");
+  c.require = normaliseRequirement(c.require);
+  if (canonicalJson(c) !== s) throw new AccessError("bad_request", "challenge is not canonical");
+  return c;
+}
+function accessErrorMessage(code, e = {}) {
+  switch (code) {
+    case "not_installed":
+      return "No bWalletX (or other BRC-100 wallet) was found.";
+    case "user_rejected":
+      return "The request was declined in the wallet.";
+    case "wrong_account":
+      return "The wallet is signed in to a different account than this site expects.";
+    case "insufficient_tokens":
+      return `Not enough tokens: holding ${e.have ?? 0}, need ${e.need ?? "?"}.`;
+    case "identity_level_too_low":
+      return `Identity level ${e.have ?? 0} is below the required level ${e.need ?? "?"}.`;
+    case "kyc_required":
+      return "A verified identity (KYC) is required.";
+    case "indexer_unavailable":
+      return "Holdings could not be checked right now. Try again shortly.";
+    case "expired":
+      return "The request expired. Try again.";
+    case "replay":
+      return "That request was already used. Try again.";
+    case "invalid_signature":
+      return "The wallet signature did not verify.";
+    case "bad_request":
+      return "The request was malformed.";
+  }
+}
+
+// src/access-client.ts
+var ONESAT = [0, "onesat"];
+var LEGACY_ONESAT = [0, "p 1sat"];
+function toAccessError(e) {
+  if (e instanceof AccessError) return e;
+  const err = e;
+  const msg = String(err?.message ?? e ?? "");
+  if (err?.code === "NOT_FOUND") return new AccessError("not_installed", msg);
+  if (/reject|denied|declin|cancel|user/i.test(msg) || err?.code === "ERR_USER_REJECTED" || err?.status === 4001) {
+    return new AccessError("user_rejected", msg);
+  }
+  return new AccessError("bad_request", msg || "access failed");
+}
+function throwIfAccessError(body) {
+  const b = body;
+  if (b && typeof b.error === "string") throw new AccessError(b.error, b.message, { have: b.have, need: b.need });
+}
+function hash160FromP2pkh(script) {
+  const m = /^76a914([0-9a-f]{40})88ac$/i.exec(script.slice(-50));
+  return m ? m[1].toLowerCase() : null;
+}
+async function proveHoldings(wallet, challenge, tokenId, basket = "bsv21") {
+  const bare = tokenId.replace(/^bsv21:/, "");
+  const list = await wallet.listOutputs({ basket, include: "locking scripts", includeCustomInstructions: true, limit: 1e4 });
+  const byKey = /* @__PURE__ */ new Map();
+  const data = challengeBytes(challenge);
+  for (const out of list.outputs) {
+    if (byKey.size >= MAX_HOLDING_PROOFS) break;
+    let ci = {};
+    try {
+      ci = JSON.parse(out.customInstructions ?? "{}");
+    } catch {
+      continue;
+    }
+    if (ci.id !== bare || !ci.keyID) continue;
+    const want = out.lockingScript ? hash160FromP2pkh(out.lockingScript) : null;
+    const counterparty = ci.counterparty ?? "self";
+    for (const protocolID of ci.protocolID ? [ci.protocolID] : [ONESAT, LEGACY_ONESAT]) {
+      const { publicKey } = await wallet.getPublicKey({ protocolID, keyID: ci.keyID, counterparty });
+      const h = import_sdk3.Utils.toHex(import_sdk3.Hash.hash160(import_sdk3.PublicKey.fromString(publicKey).encode(true)));
+      if (want && h !== want) continue;
+      const existing = byKey.get(publicKey);
+      if (existing) {
+        existing.outpoints.push(out.outpoint.replace(".", "_"));
+        break;
+      }
+      const { signature } = await wallet.createSignature({ protocolID, keyID: ci.keyID, counterparty, data });
+      byKey.set(publicKey, { pubkey: publicKey, signature: Array.from(signature), outpoints: [out.outpoint.replace(".", "_")] });
+      break;
+    }
+  }
+  return [...byKey.values()];
+}
+async function requestAccess(o) {
+  let wallet;
+  try {
+    ({ wallet } = await connectBwalletX({ wallet: o.wallet, pairing: o.pairing, discoverMs: o.discoverMs }));
+  } catch (e) {
+    throw e?.code === "NOT_FOUND" ? new AccessError("not_installed") : toAccessError(e);
+  }
+  try {
+    const { publicKey: identityKey } = await wallet.getPublicKey({ identityKey: true });
+    const { challenge } = await o.challenge(identityKey);
+    const c = parseAccessChallenge(challenge);
+    if (c.sub && c.sub !== identityKey.toLowerCase()) throw new AccessError("wrong_account");
+    if (Date.now() / 1e3 >= c.exp) throw new AccessError("expired");
+    const { signature } = await wallet.createSignature({
+      protocolID: ACCESS_PROTOCOL,
+      keyID: c.nonce,
+      counterparty: "anyone",
+      data: challengeBytes(challenge)
+    });
+    const response = { v: 1, challenge, identityKey, signature: Array.from(signature) };
+    if (c.require.token) response.holdings = await proveHoldings(wallet, challenge, c.require.token.id, o.tokenBasket);
+    let verified;
+    if (o.verify) {
+      verified = await o.verify(response);
+      throwIfAccessError(verified);
+    }
+    return { response, verified, wallet };
+  } catch (e) {
+    throw toAccessError(e);
+  }
+}
+
 // src/element.ts
 var SIGNIN_TAG = "bwalletx-signin";
 var GET_URL = "https://bwalletx.com/get";
@@ -610,6 +881,10 @@ async function postJson(url, body) {
   if (!res.ok) throw new Error(data.error ?? `HTTP ${res.status}`);
   return data;
 }
+async function postAccess(url, body) {
+  const res = await fetch(url, { method: "POST", credentials: "include", headers: { "content-type": "application/json" }, body: JSON.stringify(body) });
+  return res.json().catch(() => ({ error: "bad_request", message: `HTTP ${res.status}` }));
+}
 var OBSERVED = ["size", "theme", "label", "brand", "subtitle", "loading", "disabled", "full-width", "aria-label", "get-url", "web-url"];
 function createClass() {
   return class BwalletxSigninElement extends HTMLElement {
@@ -692,6 +967,26 @@ function createClass() {
         if (!found) {
           this.#notFound = true;
           this.#emit("bwalletx-not-found");
+          if (this.#attr("require-token")) this.#emit("bwalletx-access-denied", { code: "not_installed", message: "No wallet found" });
+          return;
+        }
+        const requireToken = this.#attr("require-token");
+        if (requireToken) {
+          const verifyUrl2 = this.#attr("verify-url");
+          const min = this.#attr("min");
+          const minBps = this.#attr("min-bps");
+          const hint = { token: { id: requireToken, ...minBps ? { minBps: Number(minBps) } : { min: min ?? "1" } } };
+          try {
+            const a = await requestAccess({
+              wallet: found.wallet,
+              challenge: (identityKey) => postJson(challengeUrl, { identityKey, require: hint }),
+              verify: verifyUrl2 ? (response2) => postAccess(verifyUrl2, response2) : void 0
+            });
+            this.#emit("bwalletx-access-granted", { identityKey: a.response.identityKey, response: a.verified });
+          } catch (e) {
+            const err = e instanceof AccessError ? e : new AccessError("bad_request", String(e));
+            this.#emit("bwalletx-access-denied", { code: err.code, message: err.message, have: err.have, need: err.need });
+          }
           return;
         }
         const r = await signInWithBwalletX({ wallet: found.wallet, challenge: (identityKey) => postJson(challengeUrl, { identityKey }) });
@@ -714,29 +1009,435 @@ function defineBwalletxSignin(tag = SIGNIN_TAG) {
   customElements.define(tag, C);
   return C;
 }
+
+// src/pay.ts
+var import_sdk4 = 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_sdk4.Utils.toBase64(Array.from(b));
+}
+function opReturn(text) {
+  const d = import_sdk4.Utils.toArray(text, "utf8");
+  const len = d.length;
+  const push = len < 76 ? [len] : len <= 255 ? [76, len] : [77, len & 255, len >> 8];
+  return import_sdk4.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_sdk4.P2PKH().lock(import_sdk4.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_sdk4.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_sdk4.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_sdk5 = 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_sdk5.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 = {
+  ACCESS_ERROR_STATUS,
+  ACCESS_PROTOCOL,
+  ACCESS_VERSION,
+  AccessError,
+  BRC29_PROTOCOL,
   BWALLETX_RDNS,
   GET_URL,
   LOGIN_PROTOCOL,
   LOGO_URL,
+  PROTOCOL_MEDIA,
+  PaymentError,
   RDNS_EXTENSION,
   RDNS_MOBILE,
   SIGNIN_CSS,
   SIGNIN_TAG,
   WEB_WALLET_URL,
+  accessErrorMessage,
+  amountInSats,
+  brc100Option,
   buildAuthorizeUrl,
+  buyToken,
+  canonicalJson,
   clearPairing,
   connectBwalletX,
   defineBwalletxSignin,
   discoverBwalletX,
+  discoverWallets,
   findBwalletX,
+  handcashAdapter,
   inOrder,
+  isIdentityKeyHex,
+  isPaymail,
   markSvg,
   pairBwalletX,
+  pairingModal,
+  pairingOption,
+  pay,
+  pickWallet,
+  protocolMediaUrl,
+  proveHoldings,
+  qrSvg,
   renderButton,
+  requestAccess,
+  resolvePaymailP2P,
   restorePairing,
   signInWithBwalletX,
-  signinText
+  signinText,
+  throwIfAccessError,
+  tip,
+  toAccessError
 });
 //# sourceMappingURL=index.cjs.map