@bwalletx/connect 0.4.1 → 0.5.3

package/dist/index.cjs

@@ -30,23 +30,32 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // 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,
+  WALLET_THEME_META: () => WALLET_THEME_META,
   WEB_WALLET_URL: () => WEB_WALLET_URL,
+  accessErrorMessage: () => accessErrorMessage,
   amountInSats: () => amountInSats,
   brc100Option: () => brc100Option,
   buildAuthorizeUrl: () => buildAuthorizeUrl,
   buyToken: () => buyToken,
+  canonicalJson: () => canonicalJson,
   clearPairing: () => clearPairing,
   connectBwalletX: () => connectBwalletX,
+  declareWalletTheme: () => declareWalletTheme,
   defineBwalletxSignin: () => defineBwalletxSignin,
   discoverBwalletX: () => discoverBwalletX,
   discoverWallets: () => discoverWallets,
@@ -55,23 +64,30 @@ __export(src_exports, {
   inOrder: () => inOrder,
   isIdentityKeyHex: () => isIdentityKeyHex,
   isPaymail: () => isPaymail,
+  isTouchDevice: () => isTouchDevice,
   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,
-  tip: () => tip
+  throwIfAccessError: () => throwIfAccessError,
+  tip: () => tip,
+  toAccessError: () => toAccessError
 });
 module.exports = __toCommonJS(src_exports);
 
 // src/discover.ts
+var import_sdk = require("@bsv/sdk");
 var RDNS_EXTENSION = "com.bwalletx.extension";
 var RDNS_MOBILE = "space.bwallet.mobile";
 var BWALLETX_RDNS = [RDNS_EXTENSION, RDNS_MOBILE];
@@ -96,16 +112,70 @@ function discoverBwalletX(ms = 1200) {
     window.dispatchEvent(new Event("brc100:requestWallet"));
     setTimeout(() => {
       const cwi = window.CWI;
-      finish(cwi ? { wallet: cwi, method: "in-app", rdns: null } : null);
+      if (cwi) return finish({ wallet: cwi, method: "in-app", rdns: null });
+      if (!isFramed()) return finish(null);
+      void probeXdm(ms).then((w) => finish(w ? { wallet: w, method: "in-app", rdns: null } : null));
     }, ms);
   });
 }
 async function findBwalletX(ms = 1200) {
   return (await discoverBwalletX(ms))?.wallet ?? null;
 }
+var isFramed = () => {
+  try {
+    return window.parent !== window;
+  } catch {
+    return true;
+  }
+};
+var BWALLETX_PARENT_ORIGINS = [
+  "https://web.bwalletx.com",
+  "https://desktop.bwalletx.com",
+  "https://bwalletx.com",
+  "https://www.bwallet.space",
+  "https://bwallet.space",
+  "capacitor://localhost",
+  // iOS app shell
+  "https://localhost",
+  // Android app shell
+  "tauri://localhost",
+  // bWalletX Desktop (macOS)
+  "https://tauri.localhost",
+  // bWalletX Desktop (Windows)
+  "chrome-extension://bombmmcjghjdlbmcclnhjodgcelnehgl"
+  // bWalletX for Chrome (fixed id)
+];
+var parentOrigin = () => {
+  try {
+    const anc = window.location.ancestorOrigins;
+    if (anc && anc.length > 0) return anc[0] ?? null;
+    if (!document.referrer) return null;
+    const u = new URL(document.referrer);
+    return `${u.protocol}//${u.host}`;
+  } catch {
+    return null;
+  }
+};
+async function probeXdm(ms = 1200, allowed = BWALLETX_PARENT_ORIGINS) {
+  const origin = parentOrigin();
+  if (!origin || !allowed.includes(origin)) return null;
+  try {
+    const w = new import_sdk.WalletClient(new import_sdk.XDM(origin));
+    const ok = await Promise.race([
+      w.isAuthenticated({}).then(
+        () => true,
+        () => false
+      ),
+      new Promise((r) => setTimeout(() => r(false), ms))
+    ]);
+    return ok ? w : null;
+  } catch {
+    return null;
+  }
+}
 
 // src/pair.ts
-var import_sdk2 = require("@bsv/sdk");
+var import_sdk3 = require("@bsv/sdk");
 
 // src/in-order.ts
 function inOrder(handle, onError) {
@@ -117,7 +187,7 @@ function inOrder(handle, onError) {
 }
 
 // src/protocol.ts
-var import_sdk = require("@bsv/sdk");
+var import_sdk2 = require("@bsv/sdk");
 var PAIR_VERSION = "1";
 var PAIR_INFO = "bwallet-pair-v1";
 var PAIR_HOST = "www.bwallet.space";
@@ -150,7 +220,7 @@ var relaySocketUrl = (relay, channel, role, expiry) => {
   return `${local ? "ws" : "wss"}://${relay}/v1/c/${channel}?${q}`;
 };
 async function deriveSession(mine, theirs, channel) {
-  const point = mine.deriveSharedSecret(import_sdk.PublicKey.fromString(theirs));
+  const point = mine.deriveSharedSecret(import_sdk2.PublicKey.fromString(theirs));
   const ikm = new Uint8Array(point.encode(true));
   const base = await crypto.subtle.importKey("raw", ikm, "HKDF", false, ["deriveBits"]);
   const bits = new Uint8Array(
@@ -392,7 +462,7 @@ function pairBwalletX(opts) {
   const relay = opts.relay ?? DEFAULT_RELAY;
   const origin = opts.origin ?? (typeof location !== "undefined" ? location.origin : "");
   if (!origin) return Promise.reject(new Error("pairBwalletX needs options.origin outside a browser"));
-  const siteKey = import_sdk2.PrivateKey.fromRandom();
+  const siteKey = import_sdk3.PrivateKey.fromRandom();
   const channel = newChannel();
   const expiry = Math.floor(Date.now() / 1e3) + QR_LIFETIME_S;
   return new Promise((resolve, reject) => {
@@ -456,7 +526,7 @@ async function restorePairing(opts = {}) {
   const key = opts.storageKey ?? DEFAULT_KEY;
   const p = parseStored(await Promise.resolve(storage.getItem(key)).catch(() => null));
   if (!p) return null;
-  const { key: aes } = await deriveSession(import_sdk2.PrivateKey.fromHex(p.s), p.k, p.c);
+  const { key: aes } = await deriveSession(import_sdk3.PrivateKey.fromHex(p.s), p.k, p.c);
   const sealer = new Sealer(aes, "site");
   sealer.restore({ sent: p.sent, lastSeen: p.lastSeen });
   return new Link(p, sealer, storage, key, opts.socket ?? defaultSocket(), opts.callTimeoutMs ?? 12e4).wallet();
@@ -486,16 +556,28 @@ async function signInWithBwalletX(opts) {
   const { wallet, method } = await connectBwalletX(opts);
   if (method !== "pairing") await wallet.waitForAuthentication({}).catch(() => {
   });
-  const { publicKey: identityKey } = await wallet.getPublicKey({ identityKey: true });
-  const c = await opts.challenge(identityKey);
-  const { signature } = await wallet.createSignature({
-    protocolID: c.protocolID ?? LOGIN_PROTOCOL,
-    keyID: c.keyID,
-    counterparty: "anyone",
-    data: Array.from(new TextEncoder().encode(c.message))
-  });
+  const { publicKey: identityKey } = await atStage("identity", () => wallet.getPublicKey({ identityKey: true }));
+  const c = await atStage("challenge", () => opts.challenge(identityKey));
+  const { signature } = await atStage(
+    "signature",
+    () => wallet.createSignature({
+      protocolID: c.protocolID ?? LOGIN_PROTOCOL,
+      keyID: c.keyID,
+      counterparty: "anyone",
+      data: Array.from(new TextEncoder().encode(c.message))
+    })
+  );
   return { identityKey, signature: Array.from(signature), nonce: c.nonce, method, wallet };
 }
+async function atStage(stage, run) {
+  try {
+    return await run();
+  } catch (e) {
+    const err = e instanceof Error ? e : new Error(String(e));
+    if (!err.stage) Object.assign(err, { stage });
+    throw err;
+  }
+}
 
 // src/button.ts
 var CSS = `
@@ -541,6 +623,239 @@ function renderButton(el2, opts = {}) {
   return b;
 }
 
+// src/access-client.ts
+var import_sdk4 = 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_sdk4.Utils.toHex(import_sdk4.Hash.hash160(import_sdk4.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";
@@ -636,6 +951,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 {
@@ -718,6 +1037,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 }) });
@@ -742,7 +1081,7 @@ function defineBwalletxSignin(tag = SIGNIN_TAG) {
 }
 
 // src/pay.ts
-var import_sdk3 = require("@bsv/sdk");
+var import_sdk5 = require("@bsv/sdk");
 var BRC29_PROTOCOL = [2, "3241645161d8"];
 var PaymentError = class extends Error {
   constructor(code, message, maybeSent = false, cause) {
@@ -762,13 +1101,13 @@ 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));
+  return import_sdk5.Utils.toBase64(Array.from(b));
 }
 function opReturn(text) {
-  const d = import_sdk3.Utils.toArray(text, "utf8");
+  const d = import_sdk5.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]);
+  return import_sdk5.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);
@@ -864,7 +1203,7 @@ async function pay(source, req, o = {}) {
     } 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" }];
+    outputs = [{ script: new import_sdk5.P2PKH().lock(import_sdk5.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);
@@ -872,7 +1211,7 @@ async function pay(source, req, o = {}) {
     submit = r2.submit;
   } else {
     try {
-      outputs = [{ script: new import_sdk3.P2PKH().lock(to).toHex(), satoshis: sats, description: "payment" }];
+      outputs = [{ script: new import_sdk5.P2PKH().lock(to).toHex(), satoshis: sats, description: "payment" }];
     } catch {
       throw new PaymentError("BAD_REQUEST", `Not a paymail, address or identity key: ${to}`);
     }
@@ -882,7 +1221,7 @@ async function pay(source, req, o = {}) {
   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(() => {
+    await submit(import_sdk5.Transaction.fromAtomicBEEF(tx).toHex()).catch(() => {
     });
   }
   return { txid: r.txid, tx, sats, outputs, remittance };
@@ -903,7 +1242,7 @@ async function buyToken(source, req) {
 }
 
 // src/wallets.ts
-var import_sdk4 = require("@bsv/sdk");
+var import_sdk6 = require("@bsv/sdk");
 async function brc100Connected(wallet, o) {
   await wallet.waitForAuthentication({}).catch(() => {
   });
@@ -962,7 +1301,7 @@ function handcashAdapter(o) {
 var NAMES = { [RDNS_EXTENSION]: "bWalletX", "space.bwallet.mobile": "bWalletX" };
 async function probe(substrate, ms) {
   try {
-    const w = new import_sdk4.WalletClient(substrate);
+    const w = new import_sdk6.WalletClient(substrate);
     const ok = await Promise.race([w.isAuthenticated({}).then(() => true), new Promise((r) => setTimeout(() => r(false), ms))]);
     return ok ? w : null;
   } catch {
@@ -1015,6 +1354,9 @@ var CSS2 = `
 .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}
+a.bwx-btn{display:block;text-align:center;text-decoration:none;box-sizing:border-box}
+.bwx-primary{background:linear-gradient(180deg,#fcd34d,#f59e0b);color:#000;border:0;font-weight:700;min-height:48px;padding:13px 12px}
+.bwx-stack{display:flex;flex-direction:column;gap:8px}
 .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}
@@ -1045,6 +1387,18 @@ function qrSvg(text) {
   q.make();
   return q.createSvgTag({ cellSize: 4, margin: 2, scalable: true });
 }
+function isTouchDevice(env = globalThis) {
+  const nav = env.navigator;
+  if (!nav) return false;
+  const ua = nav.userAgent ?? "";
+  if (/Android|iPhone|iPad|iPod|Mobile|Silk|Kindle/i.test(ua)) return true;
+  if (/Macintosh/.test(ua) && (nav.maxTouchPoints ?? 0) > 1) return true;
+  try {
+    return !!env.matchMedia?.("(pointer: coarse)").matches && !env.matchMedia?.("(hover: hover)").matches;
+  } catch {
+    return false;
+  }
+}
 function pairingModal(o = {}) {
   const ac = new AbortController();
   let ui = null;
@@ -1061,20 +1415,37 @@ function pairingModal(o = {}) {
       if (typeof document === "undefined") return;
       close();
       ui = mount();
+      const app = o.mode === "app" || (o.mode ?? "auto") === "auto" && isTouchDevice();
       const h = el("h2", "", o.title ?? "Connect bWalletX");
+      const cancel = el("button", "bwx-btn", "Cancel");
+      cancel.onclick = () => {
+        o.onCancel?.();
+        ac.abort();
+      };
+      codeEl = el("div", "bwx-code", "");
+      codeEl.setAttribute("aria-live", "polite");
+      if (app) {
+        const p2 = el("p", "", "Open bWalletX, approve, then come back to this page.");
+        const stack = el("div", "bwx-stack");
+        const open = el("a", "bwx-btn bwx-primary", "Open bWalletX");
+        open.href = link;
+        open.rel = "noopener";
+        const web = el("button", "bwx-btn", "Use web.bwalletx.com instead");
+        web.onclick = () => {
+          void navigator.clipboard?.writeText(link).catch(() => void 0);
+          window.open(WEB_WALLET_URL, "_blank", "noopener");
+          p2.textContent = "Link copied. In web.bwalletx.com tap Connect and paste it, then come back here.";
+        };
+        stack.append(open, web, cancel);
+        ui.box.append(h, p2, codeEl, stack);
+        return;
+      }
       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);
     },
@@ -1118,25 +1489,53 @@ function pickWallet(options, o = {}) {
     ui.box.lastChild.append(cancel);
   });
 }
+
+// src/theme.ts
+var WALLET_THEME_META = "bwalletx-theme";
+var ID = /^[a-z0-9-]{1,32}$/;
+function declareWalletTheme(theme) {
+  if (typeof document === "undefined") return;
+  const id = (theme ?? "").trim().toLowerCase();
+  let meta = document.head.querySelector(`meta[name="${WALLET_THEME_META}"]`);
+  if (!id || !ID.test(id)) {
+    meta?.remove();
+    return;
+  }
+  if (!meta) {
+    meta = document.createElement("meta");
+    meta.name = WALLET_THEME_META;
+    document.head.appendChild(meta);
+  }
+  if (meta.content !== id) meta.content = id;
+}
 // 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,
+  WALLET_THEME_META,
   WEB_WALLET_URL,
+  accessErrorMessage,
   amountInSats,
   brc100Option,
   buildAuthorizeUrl,
   buyToken,
+  canonicalJson,
   clearPairing,
   connectBwalletX,
+  declareWalletTheme,
   defineBwalletxSignin,
   discoverBwalletX,
   discoverWallets,
@@ -1145,18 +1544,24 @@ function pickWallet(options, o = {}) {
   inOrder,
   isIdentityKeyHex,
   isPaymail,
+  isTouchDevice,
   markSvg,
   pairBwalletX,
   pairingModal,
   pairingOption,
   pay,
   pickWallet,
+  protocolMediaUrl,
+  proveHoldings,
   qrSvg,
   renderButton,
+  requestAccess,
   resolvePaymailP2P,
   restorePairing,
   signInWithBwalletX,
   signinText,
-  tip
+  throwIfAccessError,
+  tip,
+  toAccessError
 });
 //# sourceMappingURL=index.cjs.map