@bwalletx/connect 0.5.4 → 0.7.0

package/dist/react.cjs

@@ -34,12 +34,16 @@ __export(react_exports, {
   BwalletxProvider: () => BwalletxProvider,
   BwalletxSignin: () => BwalletxSignin,
   PaymentError: () => PaymentError,
+  accountFor: () => accountFor,
+  autoChoice: () => autoChoice,
   brc100Option: () => brc100Option,
   default: () => react_default,
   discoverWallets: () => discoverWallets,
   handcashAdapter: () => handcashAdapter,
   pairingOption: () => pairingOption,
-  useBwalletX: () => useBwalletX
+  signinStateFor: () => signinStateFor,
+  useBwalletX: () => useBwalletX,
+  useBwalletXAccount: () => useBwalletXAccount
 });
 module.exports = __toCommonJS(react_exports);
 var import_react = require("react");
@@ -446,6 +450,74 @@ function declareWalletTheme(theme) {
   if (meta.content !== id) meta.content = id;
 }
 
+// src/account.ts
+var PAYMAIL_LOOKUP_URL = "https://pay.bwallet.space/api/paymail/lookup?key=";
+var BAVATAR_URL = "https://chat.bwalletx.com/api/bavatar/";
+function shortKey(key) {
+  return key.length > 12 ? `${key.slice(0, 6)}\u2026${key.slice(-4)}` : key;
+}
+function accountLabel(a) {
+  if (a.paymail && /@bwalletx\.com$/i.test(a.paymail)) return "$" + a.paymail.split("@")[0];
+  if (a.handle) return a.handle;
+  if (a.paymail) return a.paymail;
+  return a.identityKey ? shortKey(a.identityKey) : "";
+}
+function avatarUrlFor(identityKey) {
+  return identityKey && /^0[23][0-9a-fA-F]{64}$/.test(identityKey) ? `${BAVATAR_URL}${identityKey.toLowerCase()}.png` : null;
+}
+var cache = /* @__PURE__ */ new Map();
+function lookupPaymail(identityKey, url = PAYMAIL_LOOKUP_URL) {
+  if (url === "off" || typeof fetch === "undefined") return Promise.resolve(null);
+  const k = `${url}|${identityKey}`;
+  let p = cache.get(k);
+  if (!p) {
+    p = fetch(url + encodeURIComponent(identityKey)).then((r) => r.ok ? r.json() : null).then((j) => j && typeof j.paymail === "string" ? j.paymail : null).catch(() => null);
+    cache.set(k, p);
+  }
+  return p;
+}
+function isUserRejection(e) {
+  const code = e?.code;
+  if (code === "ERR_PERMISSION_DENIED" || code === 4001) return true;
+  const msg = e instanceof Error ? e.message : String(e ?? "");
+  return /denied|reject|cancel|declin|refused|not now|user closed/i.test(msg);
+}
+function signInErrorText(e) {
+  if (isUserRejection(e)) return "Sign-in cancelled";
+  if (e?.name === "MetanetUnreachableError") return e.message;
+  const code = e?.code;
+  if (code === "NOT_FOUND") return "bWalletX was not found in this browser";
+  const msg = e instanceof Error ? e.message : String(e ?? "");
+  if (/lock/i.test(msg)) return "Your wallet is locked. Unlock it and try again";
+  if (/timeout|timed out|expired/i.test(msg)) return "The wallet did not answer in time";
+  if (/origin/i.test(msg)) return "This page is not on the site\u2019s configured origin";
+  return "Sign-in failed";
+}
+async function copyText(text) {
+  try {
+    await navigator.clipboard.writeText(text);
+    return true;
+  } catch {
+    return false;
+  }
+}
+var IDENTITY_HINT_KEY = "bwx:identityKey";
+function rememberedIdentity() {
+  try {
+    const k = globalThis.localStorage?.getItem(IDENTITY_HINT_KEY) ?? "";
+    return /^0[23][0-9a-f]{64}$/i.test(k) ? k : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function rememberIdentity(key) {
+  try {
+    if (key) globalThis.localStorage?.setItem(IDENTITY_HINT_KEY, key);
+    else globalThis.localStorage?.removeItem(IDENTITY_HINT_KEY);
+  } catch {
+  }
+}
+
 // src/discover.ts
 var import_sdk3 = require("@bsv/sdk");
 var RDNS_EXTENSION = "com.bwalletx.extension";
@@ -457,7 +529,7 @@ function discoverBwalletX(ms = DEFAULT_DISCOVER_MS) {
   return new Promise((resolve) => {
     let done = false;
     let timer;
-    const finish = (r) => {
+    const finish2 = (r) => {
       if (done) return;
       done = true;
       if (timer !== void 0) clearTimeout(timer);
@@ -468,24 +540,19 @@ function discoverBwalletX(ms = DEFAULT_DISCOVER_MS) {
       const d = e.detail;
       const rdns = d?.info?.rdns ?? "";
       if (d?.wallet && BWALLETX_RDNS.includes(rdns)) {
-        finish({ wallet: d.wallet, method: rdns === RDNS_EXTENSION ? "extension" : "in-app", rdns });
+        finish2({ wallet: d.wallet, method: rdns === RDNS_EXTENSION ? "extension" : "in-app", rdns });
       }
     };
-    const cwiNow = () => {
-      const cwi = window.CWI;
-      if (cwi) finish({ wallet: cwi, method: "in-app", rdns: null });
-      return !!cwi;
-    };
     window.addEventListener("brc100:announceWallet", onAnnounce);
     window.dispatchEvent(new Event("brc100:requestWallet"));
-    if (done || cwiNow()) return;
+    if (done) return;
     if (isFramed()) {
-      void probeXdm(Math.max(ms, 1200)).then((w) => finish(w ? { wallet: w, method: "in-app", rdns: null } : null));
+      void probeXdm(Math.max(ms, 1200)).then((w) => finish2(w ? { wallet: w, method: "in-app", rdns: null } : null));
       return;
     }
     timer = setTimeout(() => {
       timer = void 0;
-      if (!cwiNow()) finish(null);
+      finish2(null);
     }, ms);
   });
 }
@@ -589,27 +656,68 @@ async function connectBwalletX(opts = {}) {
   status("pairing");
   return { wallet: await pairBwalletX(opts.pairing), method: "pairing" };
 }
+async function waitIfLocked(wallet) {
+  let ok = false;
+  try {
+    ok = !!(await wallet.isAuthenticated({}))?.authenticated;
+  } catch {
+  }
+  if (!ok) await Promise.resolve().then(() => wallet.waitForAuthentication({})).catch(() => {
+  });
+}
+function challengeWantsIdentityKey(e) {
+  const msg = e instanceof Error ? e.message : String(e ?? "");
+  return /identityKey/i.test(msg);
+}
 async function signInWithBwalletX(opts) {
   const { wallet, method } = await connectBwalletX(opts);
-  if (method !== "pairing") await wallet.waitForAuthentication({}).catch(() => {
+  if (method !== "pairing" && !opts.skipWaitForAuthentication) await waitIfLocked(wallet);
+  const status = () => {
+    try {
+      opts.onStatus?.("signing");
+    } catch {
+    }
+  };
+  const sign = (c2) => wallet.createSignature({
+    protocolID: c2.protocolID ?? LOGIN_PROTOCOL,
+    keyID: c2.keyID,
+    counterparty: "anyone",
+    data: Array.from(new TextEncoder().encode(c2.message))
   });
-  const { publicKey: identityKey } = await atStage("identity", () => wallet.getPublicKey({ identityKey: true }));
+  const keyFirst = async () => {
+    const { publicKey: identityKey2 } = await atStage("identity", () => wallet.getPublicKey({ identityKey: true }));
+    status();
+    const c2 = await atStage("challenge", () => opts.challenge(identityKey2));
+    const { signature: signature2 } = await atStage("signature", () => sign(c2));
+    return { identityKey: identityKey2, signature: Array.from(signature2), nonce: c2.nonce, method, wallet };
+  };
+  if (opts.challengeNeedsIdentityKey && !opts.identityKey) return keyFirst();
+  let c;
   try {
-    opts.onStatus?.("signing");
-  } catch {
+    c = await atStage("challenge", () => opts.challenge(opts.identityKey));
+  } catch (e) {
+    if (!opts.identityKey && challengeWantsIdentityKey(e)) return keyFirst();
+    throw e;
   }
-  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))
-    })
-  );
+  status();
+  const [{ publicKey: identityKey }, { signature }] = await Promise.all([
+    opts.identityKey ? Promise.resolve({ publicKey: opts.identityKey }) : atStage("identity", () => wallet.getPublicKey({ identityKey: true })),
+    atStage("signature", () => sign(c))
+  ]);
   return { identityKey, signature: Array.from(signature), nonce: c.nonce, method, wallet };
 }
+async function signInAndVerify(opts) {
+  const hinted = !opts.identityKey && !!opts.identityKeyHint;
+  const r = await signInWithBwalletX({ ...opts, identityKey: opts.identityKey ?? opts.identityKeyHint });
+  try {
+    return { result: r, verified: await atStage("verify", () => opts.verify(r)) };
+  } catch (e) {
+    const status = e?.status;
+    if (!hinted || status !== 401) throw e;
+    const again = await signInWithBwalletX({ ...opts, wallet: r.wallet, identityKey: void 0, skipWaitForAuthentication: true });
+    return { result: again, verified: await atStage("verify", () => opts.verify(again)) };
+  }
+}
 async function atStage(stage, run) {
   try {
     return await run();
@@ -620,11 +728,556 @@ async function atStage(stage, run) {
   }
 }
 
+// src/metanet.ts
+var import_sdk4 = require("@bsv/sdk");
+
+// src/device.ts
+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;
+  }
+}
+
+// src/metanet.ts
+var METANET_TYPE = "metanet";
+var METANET_OPTION_ID = METANET_TYPE;
+var METANET_LABEL = "Use Metanet Desktop or another BRC-100 wallet";
+var METANET_NOTE = "Metanet Desktop must be running on this computer";
+var METANET_REMEMBERED_NOTE = "Signs in with Metanet Desktop on this computer.";
+var NOT_YOU_LABEL = "Not you? Use another wallet";
+var METANET_UNREACHABLE = "We couldn\u2019t reach Metanet Desktop. Open it, then try again.";
+var METANET_ANSWER_MS = 4e3;
+var METANET_SILENT_MS = 2e3;
+var MetanetUnreachableError = class extends Error {
+  code = "NOT_FOUND";
+  constructor() {
+    super(METANET_UNREACHABLE);
+    this.name = "MetanetUnreachableError";
+  }
+};
+function inAnyFrame(win = typeof window === "undefined" ? void 0 : window) {
+  if (!win) return false;
+  try {
+    return win.top !== win.self;
+  } catch {
+    return true;
+  }
+}
+function metanetOffered(env = {}) {
+  const win = env.window ?? (typeof window === "undefined" ? void 0 : window);
+  if (!win) return false;
+  const nav = env.navigator ?? (typeof navigator === "undefined" ? void 0 : navigator);
+  const mm = env.matchMedia ?? (typeof matchMedia === "undefined" ? void 0 : (q) => matchMedia(q));
+  return !isTouchDevice({ navigator: nav, matchMedia: mm }) && !inAnyFrame(win);
+}
+function client(o) {
+  if (o.make) return o.make();
+  const originator = o.originator ?? (typeof location !== "undefined" && location.host ? location.host : void 0);
+  return new import_sdk4.WalletClient("json-api", originator);
+}
+async function answers(wallet) {
+  return Promise.resolve().then(() => wallet.getVersion({})).then((v) => typeof v?.version === "string", () => false);
+}
+async function connectMetanetDesktop(o = {}) {
+  let wallet;
+  try {
+    wallet = client(o);
+  } catch {
+    throw new MetanetUnreachableError();
+  }
+  let timer;
+  const ok = await Promise.race([answers(wallet), new Promise((r) => timer = setTimeout(() => r(false), o.timeoutMs ?? METANET_ANSWER_MS))]);
+  clearTimeout(timer);
+  if (!ok) throw new MetanetUnreachableError();
+  return wallet;
+}
+function metanetOption(o = {}) {
+  const opt = {
+    id: METANET_OPTION_ID,
+    name: METANET_LABEL,
+    kind: "brc100",
+    isBwalletX: false,
+    substrate: "json-api",
+    async connect() {
+      const wallet = await connectMetanetDesktop(o);
+      opt.wallet = wallet;
+      await waitIfLocked(wallet);
+      const { publicKey } = await wallet.getPublicKey({ identityKey: true });
+      return { wallet, payer: wallet, identityKey: publicKey, optionId: opt.id, kind: "brc100" };
+    }
+  };
+  return opt;
+}
+var KNOWN_KEYS_KEY = "bwx:known-keys";
+var KEY_RE = /^0[23][0-9a-f]{64}$/;
+var MAX_KNOWN = 8;
+function knownIdentityKeys() {
+  try {
+    const v = JSON.parse(globalThis.localStorage?.getItem(KNOWN_KEYS_KEY) || "[]");
+    return Array.isArray(v) ? v.filter((k) => typeof k === "string" && KEY_RE.test(k)) : [];
+  } catch {
+    return [];
+  }
+}
+function isKnownIdentityKey(key) {
+  if (!key) return false;
+  const k = key.toLowerCase();
+  if (!KEY_RE.test(k)) return false;
+  return knownIdentityKeys().includes(k) || rememberedIdentity()?.toLowerCase() === k;
+}
+function rememberKnownIdentityKey(key) {
+  const k = (key ?? "").toLowerCase();
+  if (!KEY_RE.test(k)) return;
+  try {
+    const list = [k, ...knownIdentityKeys().filter((x) => x !== k)].slice(0, MAX_KNOWN);
+    globalThis.localStorage?.setItem(KNOWN_KEYS_KEY, JSON.stringify(list));
+  } catch {
+  }
+}
+var triedThisLoad = false;
+function silentAttemptUsed() {
+  return triedThisLoad;
+}
+function claimSilentAttempt() {
+  if (triedThisLoad) return false;
+  triedThisLoad = true;
+  return true;
+}
+async function trySilentMetanet(o = {}) {
+  if (!metanetOffered()) return { ok: false, stop: "not-here" };
+  if (!claimSilentAttempt()) return { ok: false, stop: "used" };
+  const run = async () => {
+    let wallet;
+    try {
+      wallet = client(o);
+    } catch {
+      return { ok: false, stop: "unreachable" };
+    }
+    if (!await answers(wallet)) return { ok: false, stop: "unreachable" };
+    const unlocked = await Promise.resolve().then(() => wallet.isAuthenticated({})).then((r2) => r2?.authenticated === true, () => false);
+    if (!unlocked) return { ok: false, stop: "locked" };
+    const identityKey = await Promise.resolve().then(() => wallet.getPublicKey({ identityKey: true })).then((r2) => r2.publicKey, () => null);
+    if (!identityKey) return { ok: false, stop: "unreachable" };
+    if (!isKnownIdentityKey(identityKey)) return { ok: false, stop: "unknown-key" };
+    return { ok: true, wallet, identityKey };
+  };
+  let timer;
+  const r = await Promise.race([
+    run().catch(() => ({ ok: false, stop: "unreachable" })),
+    new Promise((res) => timer = setTimeout(() => res({ ok: false, stop: "slow" }), o.windowMs ?? METANET_SILENT_MS))
+  ]);
+  clearTimeout(timer);
+  return r;
+}
+var warnedLogout = false;
+var isProduction = () => {
+  try {
+    return globalThis.process?.env?.NODE_ENV === "production";
+  } catch {
+    return false;
+  }
+};
+function warnIfNoLogout(o) {
+  if (!o.verifyUrl || o.logoutUrl || warnedLogout || isProduction() || typeof console === "undefined") return false;
+  warnedLogout = true;
+  console.warn(
+    `@bwalletx/connect: ${o.where} has a verify URL but no logout URL. Set it: "Not you? Use another wallet" and Disconnect must be able to end a session the verify route created.`
+  );
+  return true;
+}
+
+// src/wallets.ts
+var import_sdk5 = require("@bsv/sdk");
+async function brc100Connected(wallet, o, c = {}) {
+  if (c.identity === false) return { wallet, payer: wallet, identityKey: null, optionId: o.id, kind: o.kind };
+  await waitIfLocked(wallet);
+  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,
+    substrate: info.substrate,
+    wallet,
+    connect: (c) => brc100Connected(wallet, opt, c)
+  };
+  return opt;
+}
+function pairingOption(pairing) {
+  const opt = {
+    id: "bwalletx-pairing",
+    name: "bWalletX on your phone",
+    kind: "pairing",
+    isBwalletX: true,
+    substrate: "pairing",
+    async connect(c) {
+      const p = typeof pairing === "function" ? pairing() : pairing;
+      const w = await restorePairing(p) ?? await pairBwalletX(p);
+      return brc100Connected(w, opt, c);
+    }
+  };
+  return opt;
+}
+function handcashAdapter(o) {
+  const opt = {
+    id: "handcash",
+    name: "HandCash",
+    icon: o.icon,
+    kind: "handcash",
+    isBwalletX: false,
+    substrate: "adapter",
+    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;
+  }
+}
+function cwiIsAnnounced(cwi, announced) {
+  return announced.some((o) => o.wallet === cwi || o.rdns === RDNS_MOBILE);
+}
+async function discoverWallets(o = {}) {
+  const out = [];
+  const ms = o.ms ?? 300;
+  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);
+      const substrate = rdns === RDNS_EXTENSION ? "extension" : rdns === RDNS_MOBILE ? "in-app" : "injected";
+      seen.set(rdns, brc100Option(d.wallet, { id: rdns, rdns, name: NAMES[rdns] ?? d.info?.name ?? rdns, icon: d.info?.icon, isBwalletX: isB, substrate }));
+    };
+    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, seen.size > 0 || window.CWI ? Math.min(ms, 50) : ms));
+    window.removeEventListener("brc100:announceWallet", onAnnounce);
+    out.push(...seen.values());
+    if (![...seen.values()].some((w) => w.isBwalletX) && isFramed()) {
+      const x = await probeXdm(Math.max(ms, 1200));
+      if (x) out.push(brc100Option(x, { id: "bwalletx-xdm", name: "bWalletX", isBwalletX: true, substrate: "xdm" }));
+    }
+    const cwi = window.CWI;
+    if (cwi && !cwiIsAnnounced(cwi, [...seen.values()])) {
+      out.push(brc100Option(cwi, { id: "window.CWI", name: seen.size ? "Another browser wallet" : "Browser wallet", isBwalletX: false, substrate: "window.CWI" }));
+    }
+    const [json, cicada] = await local;
+    if (json) out.push(brc100Option(json, { id: "localhost:3321", name: "Desktop wallet (localhost:3321)", substrate: "json-api" }));
+    if (cicada) out.push(brc100Option(cicada, { id: "localhost:3301", name: "Desktop wallet (localhost:3301)", substrate: "cicada" }));
+  }
+  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);
+}
+var DESKTOP_OPTION_ID = "desktop";
+function autoChoice(list, force = false) {
+  const auto = list.filter((w) => !isLocalDesktop(w));
+  const detected = auto.filter((w) => w.kind === "brc100");
+  const others = auto.filter((w) => w.kind === "handcash" || w.kind === "custom");
+  const hasLocal = auto.length !== list.length;
+  if (force) return detected[0] ?? auto.find((w) => w.kind !== "pairing") ?? auto[0] ?? null;
+  if (!list.length) return null;
+  if (list.length === 1) return hasLocal ? void 0 : list[0];
+  if (detected.length === 1 && others.length === 0 && !hasLocal) return detected[0];
+  if (detected.length === 0 && others.length === 0) return auto[0] ?? void 0;
+  return void 0;
+}
+function isLocalDesktop(w) {
+  return w.substrate === "json-api" || w.substrate === "cicada" || w.id === "localhost:3321" || w.id === "localhost:3301" || w.id === DESKTOP_OPTION_ID;
+}
+
+// src/choice.ts
+var BWALLETX_TYPE = "bwalletx";
+function substrateOf(o) {
+  if (o.substrate) return o.substrate;
+  if (o.kind === "pairing") return "pairing";
+  if (o.isBwalletX && o.kind === "brc100") return o.rdns === RDNS_MOBILE ? "in-app" : o.id === "bwalletx-xdm" ? "xdm" : "extension";
+  if (o.kind === "handcash" || o.kind === "custom") return "adapter";
+  if (o.rdns === RDNS_EXTENSION) return "extension";
+  if (o.rdns === RDNS_MOBILE) return "in-app";
+  if (o.id === "window.CWI") return "window.CWI";
+  if (o.id === "localhost:3321" || o.id === DESKTOP_OPTION_ID) return "json-api";
+  if (o.id === "localhost:3301") return "cicada";
+  return "injected";
+}
+function walletTypeOf(o) {
+  return o.isBwalletX ? BWALLETX_TYPE : o.rdns ?? o.id;
+}
+var OWN_MARKERS = ["extension", "in-app", "xdm"];
+function isPresentBwalletX(o) {
+  return o.isBwalletX && o.kind === "brc100" && !!o.wallet && OWN_MARKERS.includes(substrateOf(o));
+}
+function hasBwalletX(list) {
+  return list.some(isPresentBwalletX);
+}
+function otherDetected(list) {
+  return list.filter((o) => !o.isBwalletX && o.kind === "brc100" && !!o.wallet);
+}
+function chooserOrder(list) {
+  const rank = (o) => isPresentBwalletX(o) ? 0 : o.isBwalletX ? 1 : o.kind === "brc100" ? 2 : o.kind === "custom" ? 3 : 4;
+  return list.map((o, i) => ({ o, i })).sort((a, b) => rank(a.o) - rank(b.o) || a.i - b.i).map((x) => x.o);
+}
+function decideWallet(list, o = {}) {
+  if (o.walletId) {
+    const w = list.find((x) => x.id === o.walletId);
+    if (w) return { option: w, reason: "requested" };
+  }
+  if (o.chooser) return { option: null, reason: list.length || o.picker !== false ? "chooser" : "none" };
+  if (o.fastPath === false) {
+    const a = autoChoice([...list], o.picker === false);
+    return a === void 0 ? { option: null, reason: "chooser" } : a === null ? { option: null, reason: "none" } : { option: a, reason: "legacy" };
+  }
+  if (o.remembered && !o.preferBwalletX) {
+    const m = matchRemembered(list, o.remembered);
+    if (m) return { option: m, reason: "remembered" };
+  }
+  const b = list.find(isPresentBwalletX);
+  if (b) return { option: b, reason: "bwalletx" };
+  if (o.picker === false) {
+    const phone = list.find((x) => x.isBwalletX);
+    return phone ? { option: phone, reason: "bwalletx-phone" } : { option: null, reason: "none" };
+  }
+  return list.length ? { option: null, reason: "chooser" } : { option: null, reason: "none" };
+}
+function outcomeOf(e) {
+  const err = e;
+  if (err?.code === "NOT_FOUND") return "not-found";
+  if (err?.name === "AbortError" || err?.message === "cancelled") return "cancelled";
+  if (isUserRejection(e)) return "rejected";
+  return "error";
+}
+function attemptFor(option, outcome, startedAt, now = Date.now()) {
+  return {
+    walletType: option ? walletTypeOf(option) : null,
+    substrate: option ? substrateOf(option) : null,
+    outcome,
+    ms: Math.max(0, Math.round(now - startedAt))
+  };
+}
+function reportAttempt(hook, a) {
+  if (!hook) return;
+  try {
+    hook(Object.freeze({ walletType: a.walletType, substrate: a.substrate, outcome: a.outcome, ms: a.ms }));
+  } catch {
+  }
+}
+var WALLET_CHOICE_KEY = "bwx:wallet";
+var SUBSTRATES = ["extension", "in-app", "xdm", "injected", "window.CWI", "json-api", "cicada", "pairing", "adapter"];
+var TYPE_RE = /^[A-Za-z0-9._:-]{1,64}$/;
+var KEY_LIKE = /^(0[23][0-9a-f]{64}|04[0-9a-f]{128}|[13][1-9A-HJ-NP-Za-km-z]{25,34})$/i;
+function isRememberable(o) {
+  const t = walletTypeOf(o);
+  return substrateOf(o) !== "window.CWI" && TYPE_RE.test(t) && !KEY_LIKE.test(t);
+}
+function isExplicitPick(o, reason) {
+  return o.isBwalletX || reason === "chooser" || reason === "requested" || reason === "remembered";
+}
+function rememberWalletChoice(o) {
+  try {
+    if (!o) return void globalThis.localStorage?.removeItem(WALLET_CHOICE_KEY);
+    if (!isRememberable(o)) return;
+    const v = { type: walletTypeOf(o), substrate: substrateOf(o), v: 1 };
+    globalThis.localStorage?.setItem(WALLET_CHOICE_KEY, JSON.stringify(v));
+  } catch {
+  }
+}
+function rememberedWalletChoice() {
+  try {
+    const raw = globalThis.localStorage?.getItem(WALLET_CHOICE_KEY);
+    if (!raw) return null;
+    const j = JSON.parse(raw);
+    if (typeof j.type !== "string" || !TYPE_RE.test(j.type) || KEY_LIKE.test(j.type)) return null;
+    if (!SUBSTRATES.includes(j.substrate) || j.substrate === "window.CWI") return null;
+    return { type: j.type, substrate: j.substrate };
+  } catch {
+    return null;
+  }
+}
+function forgetWalletChoice() {
+  rememberWalletChoice(null);
+}
+function needsBwalletX(type) {
+  return !!type && type !== BWALLETX_TYPE;
+}
+function tapGoesElsewhere(type) {
+  return needsBwalletX(type) && type !== METANET_TYPE && type !== DESKTOP_OPTION_ID;
+}
+function isLocalDesktopType(r) {
+  return r.type === METANET_TYPE || r.type === DESKTOP_OPTION_ID || r.substrate === "json-api" || r.substrate === "cicada";
+}
+function matchRemembered(list, r) {
+  if (isLocalDesktopType(r)) return null;
+  if (r.type === BWALLETX_TYPE) {
+    return (r.substrate === "pairing" ? list.find((o) => o.kind === "pairing") : list.find(isPresentBwalletX)) ?? null;
+  }
+  return list.find((o) => !o.isBwalletX && !isLocalDesktop(o) && isRememberable(o) && walletTypeOf(o) === r.type) ?? null;
+}
+var ATTACHABLE = ["extension", "in-app", "xdm", "injected"];
+function planAutoConnect(o) {
+  const r = o.remembered;
+  if (!r || o.enabled === false) return { action: "none", remembered: r, needsBwalletX: false };
+  if (r.type === METANET_TYPE) {
+    return { action: o.metanetHere ?? metanetOffered() ? "silent-metanet" : "none", remembered: r, needsBwalletX: false };
+  }
+  if (isLocalDesktopType(r)) return { action: "none", remembered: r, needsBwalletX: false };
+  const action = o.signedIn && ATTACHABLE.includes(r.substrate) ? "attach" : "wait-for-tap";
+  return { action, remembered: r, needsBwalletX: needsBwalletX(r.type) };
+}
+async function attachRemembered(r, o = {}) {
+  if (!ATTACHABLE.includes(r.substrate)) return null;
+  const list = await discoverWallets({ ms: o.ms });
+  const m = matchRemembered(list, r);
+  return m && m.kind === "brc100" && m.wallet && ATTACHABLE.includes(substrateOf(m)) ? m : null;
+}
+
+// src/connect-flow.ts
+async function runConnect(o) {
+  const started = Date.now();
+  const { list } = o;
+  let choice = null;
+  let reason = "none";
+  try {
+    if (o.metanet) {
+      if (!metanetOffered()) throw Object.assign(new Error("Metanet Desktop runs on a computer, outside any frame."), { code: "NOT_SUPPORTED" });
+      choice = metanetOption(typeof o.metanet === "object" ? o.metanet : {});
+      reason = "requested";
+      return await finish(o, choice, reason, started);
+    }
+    const d = decideWallet(list, {
+      walletId: o.walletId,
+      chooser: o.chooser,
+      picker: o.picker,
+      fastPath: o.fastPath,
+      remembered: o.remembered,
+      preferBwalletX: o.preferBwalletX
+    });
+    choice = d.option;
+    reason = d.reason;
+    if (!choice && d.reason === "chooser") choice = await o.pick(list);
+    if (!choice) {
+      if (d.reason === "none" || !list.length) throw Object.assign(new Error("No wallet found. Get bWalletX at bwalletx.com."), { code: "NOT_FOUND" });
+      reportAttempt(o.onAttempt, attemptFor(null, "cancelled", started));
+      return null;
+    }
+    return await finish(o, choice, reason, started);
+  } catch (e) {
+    reportAttempt(o.onAttempt, attemptFor(choice, outcomeOf(e), started));
+    throw e;
+  }
+}
+async function finish(o, choice, reason, started) {
+  const signIn = !!(o.challengeUrl && o.verifyUrl) && choice.kind !== "handcash";
+  const cw = await choice.connect(signIn ? { identity: false } : void 0);
+  let handle = cw.handle ?? null;
+  let paymail = cw.paymail ?? null;
+  let identityKey = cw.identityKey;
+  let signedIn = false;
+  if (cw.wallet && signIn) {
+    const { result, verified } = await signInAndVerify({
+      wallet: cw.wallet,
+      identityKey: cw.identityKey ?? void 0,
+      // Metanet's connect() just checked the lock: don't ask again (rule 7, the minimum).
+      skipWaitForAuthentication: choice.id === METANET_OPTION_ID,
+      // The key that signed in here last time: a repeat sign-in is then the signature alone.
+      identityKeyHint: rememberedIdentity(),
+      challengeNeedsIdentityKey: o.challengeNeedsIdentityKey,
+      challenge: (key) => o.post(o.challengeUrl, key ? { identityKey: key } : {}),
+      verify: (r) => o.post(o.verifyUrl, { identityKey: r.identityKey, nonce: r.nonce, signature: r.signature })
+    });
+    rememberIdentity(result.identityKey);
+    identityKey = result.identityKey;
+    handle = verified.handle ?? handle;
+    paymail = verified.paymail ?? paymail;
+    signedIn = true;
+  } else if (cw.wallet && !identityKey) {
+    identityKey = (await cw.wallet.getPublicKey({ identityKey: true })).publicKey;
+  }
+  if (o.remember && isExplicitPick(choice, reason)) rememberWalletChoice(choice);
+  if (o.remember && signedIn) rememberKnownIdentityKey(identityKey);
+  reportAttempt(o.onAttempt, attemptFor(choice, signedIn ? "signed-in" : "connected", started));
+  return { connected: cw, identityKey, handle, paymail, signedIn, walletType: walletTypeOf(choice), substrate: substrateOf(choice), reason };
+}
+async function runSilentMetanet(o = {}) {
+  const s = await trySilentMetanet(o);
+  if (!s.ok || o.isAbandoned?.()) return null;
+  const started = Date.now();
+  const opt = metanetOption(o);
+  opt.wallet = s.wallet;
+  const cw = { wallet: s.wallet, payer: s.wallet, identityKey: s.identityKey, optionId: METANET_OPTION_ID, kind: "brc100" };
+  const done = (signedIn, handle = null, paymail = null) => {
+    rememberWalletChoice(opt);
+    if (signedIn) rememberKnownIdentityKey(s.identityKey);
+    reportAttempt(o.onAttempt, attemptFor(opt, signedIn ? "signed-in" : "connected", started));
+    return { connected: cw, identityKey: s.identityKey, handle, paymail, signedIn, walletType: walletTypeOf(opt), substrate: "json-api", reason: "remembered" };
+  };
+  if (o.sessionKey !== void 0 && o.sessionKey !== null) {
+    return o.sessionKey.toLowerCase() === s.identityKey.toLowerCase() ? done(true) : null;
+  }
+  if (!o.challengeUrl || !o.verifyUrl || !o.post) return done(false);
+  if (!isKnownIdentityKey(s.identityKey)) return null;
+  try {
+    o.onSignIn?.();
+    const post = o.post;
+    const { result, verified } = await signInAndVerify({
+      wallet: s.wallet,
+      identityKey: s.identityKey,
+      skipWaitForAuthentication: true,
+      // trySilentMetanet just saw it unlocked
+      challenge: (key) => post(o.challengeUrl, key ? { identityKey: key } : {}),
+      verify: (r) => post(o.verifyUrl, { identityKey: r.identityKey, nonce: r.nonce, signature: r.signature })
+    });
+    if (o.isAbandoned?.()) {
+      await Promise.resolve(o.logout?.()).catch(() => void 0);
+      return null;
+    }
+    rememberIdentity(result.identityKey);
+    return done(true, verified.handle ?? null, verified.paymail ?? null);
+  } catch (e) {
+    reportAttempt(o.onAttempt, attemptFor(opt, outcomeOf(e), started));
+    return null;
+  }
+}
+
 // src/modal.ts
 var import_qrcode_generator = __toESM(require("qrcode-generator"), 1);
 
 // src/access-client.ts
-var import_sdk4 = require("@bsv/sdk");
+var import_sdk6 = require("@bsv/sdk");
 
 // src/access.ts
 var ACCESS_PROTOCOL = [2, "bwalletx access"];
@@ -762,7 +1415,7 @@ async function proveHoldings(wallet, challenge, tokenId, basket = "bsv21") {
     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)));
+      const h = import_sdk6.Utils.toHex(import_sdk6.Hash.hash160(import_sdk6.PublicKey.fromString(publicKey).encode(true)));
       if (want && h !== want) continue;
       const existing = byKey.get(publicKey);
       if (existing) {
@@ -812,7 +1465,7 @@ async function requestAccess(o) {
 var SIGNIN_TAG = "bwalletx-signin";
 var GET_URL = "https://bwalletx.com/get";
 var WEB_WALLET_URL = "https://web.bwalletx.com";
-var VERBS = { signin: "Sign in with", continue: "Continue with", connect: "Connect" };
+var VERBS = { signin: "Sign in with", continue: "Continue with", connect: "Connect", get: "Get", play: "Play with" };
 function signinText(label = "signin", brand = "bWalletX") {
   return `${VERBS[label] ?? VERBS.signin} ${brand}`;
 }
@@ -867,7 +1520,60 @@ button[aria-busy=true]{cursor:wait}
 .nf a:focus-visible{outline:2px solid #b45309;outline-offset:2px;border-radius:2px}
 :host([theme=dark]) .nf,:host-context(.dark) .nf{color:#a1a1aa}
 .sr{position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap}
+/* pending: one plain line under the button */
+.note{margin:8px 0 0;width:0;min-width:100%;font-size:12px;line-height:1.4;color:#71717a;text-align:center;overflow-wrap:break-word}
+:host([theme=dark]) .note,:host-context(.dark) .note{color:#a1a1aa}
+/* "Other wallets" (0.5.6): one small link under the button */
+.ow{margin:8px 0 0;width:0;min-width:100%;font-size:12px;line-height:1.4;color:#71717a;text-align:center}
+:host([theme=dark]) .ow,:host-context(.dark) .ow{color:#a1a1aa}
+.sw{margin:8px 0 0;width:0;min-width:100%;font-size:12px;line-height:1.4;color:#a16207;text-align:center}
+:host([theme=dark]) .sw,:host-context(.dark) .sw{color:#fcd34d}
+.mn{margin:8px 0 0;width:0;min-width:100%;font-size:12px;line-height:1.4;color:#71717a;text-align:center}
+.mn small{display:block;font-size:11px;opacity:.85}
+:host([theme=dark]) .mn,:host-context(.dark) .mn{color:#a1a1aa}
+.lnk{all:unset;cursor:pointer;color:inherit;font-weight:600;text-decoration:underline;text-underline-offset:2px}
+.lnk:focus-visible{outline:2px solid #b45309;outline-offset:2px;border-radius:2px}
+/* error: one line plus Retry */
+.err{margin:0 0 8px;width:0;min-width:100%;font-size:13px;font-weight:600;line-height:1.4;color:#b91c1c;text-align:center;overflow-wrap:anywhere}
+:host([theme=dark]) .err,:host-context(.dark) .err{color:#fca5a5}
+/* signed in: the badge */
+button.chip{display:inline-flex;align-items:center;justify-content:flex-start;gap:10px;width:auto;max-width:100%;padding:5px 14px 5px 5px;border-radius:999px;
+ background:#0b0b0c;color:#ffd24d;border:1px solid rgba(255,210,77,.55);box-shadow:none;font-size:15px}
+button.chip:hover{background:#151517;border-color:#ffd24d}
+button.chip:active{background:#000;transform:none}
+button.chip:focus-visible{outline:2px solid #ffd24d;outline-offset:3px}
+:host([theme=light]) button.chip{background:#fff;color:#09090b;border-color:#f59e0b}
+:host([theme=light]) button.chip:hover{background:#fffbeb}
+:host([full-width]) button.chip{width:100%}
+.av{position:relative;flex:none;display:inline-grid;place-items:center;width:30px;height:30px;border-radius:50%;overflow:hidden;
+ background:radial-gradient(circle at 30% 30%,#ffe27a,#f5b800 55%,#b88600);color:#000;font-weight:800;font-size:14px}
+.av img{position:absolute;inset:0;width:100%;height:100%;object-fit:cover}
+.name{overflow:hidden;text-overflow:ellipsis;white-space:nowrap;min-width:0;max-width:min(52vw,260px)}
+.dot{flex:none;width:8px;height:8px;border-radius:50%;background:#ffd24d;box-shadow:0 0 0 3px rgba(255,210,77,.22)}
+:host([size=sm]) button.chip{font-size:13px;padding:3px 12px 3px 3px;gap:8px}
+:host([size=sm]) .av{width:26px;height:26px}
+:host([size=icon]) button.chip{width:48px;height:48px;padding:0;justify-content:center}
+:host([size=icon]) .name,:host([size=icon]) .dot{display:none}
+:host([size=icon]) .av{width:40px;height:40px}
+`;
+var MENU_CSS = `
+:host{all:initial}
+.menu{position:fixed;z-index:2147483600;box-sizing:border-box;min-width:200px;padding:6px;border-radius:14px;background:#0b0b0c;color:#ffd24d;
+ border:1px solid rgba(255,210,77,.55);box-shadow:0 12px 32px rgba(0,0,0,.45);font:600 14px/1.3 Inter,ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,sans-serif}
+.who{padding:8px 10px 10px;font-size:12px;font-weight:500;color:#e7d9a8;overflow-wrap:anywhere;border-bottom:1px solid rgba(255,210,77,.3);margin-bottom:4px}
+.item{all:unset;box-sizing:border-box;display:block;width:100%;padding:11px 10px;border-radius:10px;cursor:pointer;color:#ffd24d}
+.item:hover,.item:focus-visible{background:#ffd24d;color:#000;outline:none}
+.tip{position:fixed;z-index:2147483600;box-sizing:border-box;padding:8px 12px;border-radius:10px;background:#0b0b0c;color:#e7d9a8;
+ border:1px solid rgba(255,210,77,.4);box-shadow:0 8px 24px rgba(0,0,0,.35);font:500 12px/1.4 Inter,ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,sans-serif}
 `;
+var PENDING_NOTE = "Sign in: shares only your public identity key, moves no money";
+var PENDING_LABEL = "Approve in bWalletX\u2026";
+var PENDING_LABEL_OTHER = "Approve in your wallet\u2026";
+var SWITCH_NOTE = "Some features need bWalletX";
+var CONTINUE_OTHER_LABEL = "Continue with your wallet";
+function walletGlyph(px) {
+  return `<svg viewBox="0 0 24 24" width="${px}" height="${px}" aria-hidden="true" focusable="false" fill="none" stroke="#FFD24D" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M19 7V5a1 1 0 0 0-1-1H5a2 2 0 0 0 0 4h15a1 1 0 0 1 1 1v4h-3a2 2 0 0 0 0 4h3a1 1 0 0 0 1-1v-2"/><path d="M3 6v12a2 2 0 0 0 2 2h15a1 1 0 0 0 1-1v-3"/></svg>`;
+}
 function b64url2(bytes) {
   let s = "";
   for (const b of bytes) s += String.fromCharCode(b);
@@ -900,14 +1606,15 @@ async function buildAuthorizeUrl(p) {
 async function postJson(url, body) {
   const res = await fetch(url, { method: "POST", credentials: "include", headers: { "content-type": "application/json" }, body: JSON.stringify(body) });
   const data = await res.json().catch(() => ({}));
-  if (!res.ok) throw new Error(data.error ?? `HTTP ${res.status}`);
+  if (!res.ok) throw Object.assign(new Error(data.error ?? `HTTP ${res.status}`), { status: 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"];
+var OBSERVED = ["size", "theme", "label", "brand", "subtitle", "loading", "disabled", "full-width", "aria-label", "get-url", "web-url", "state", "identity-key", "paymail", "handle", "avatar-url", "error", "other-wallets", "challenge-url", "wallet-type", "switch-note", "remember", "metanet"];
+var STATES = ["signed-out", "restoring", "pending", "signed-in", "error"];
 function createClass() {
   return class BwalletxSigninElement extends HTMLElement {
     static get observedAttributes() {
@@ -916,12 +1623,30 @@ function createClass() {
     #root;
     #notFound = false;
     #busy = false;
+    #phase = "signed-out";
+    #account = null;
+    #error = "";
+    #restored = false;
+    #pendingLabel = PENDING_LABEL;
+    /** The wallet type signed in with here (0.6.0), for the Switch note. */
+    #signedType = null;
+    #menu = null;
+    /** (0.7.0) A Metanet sign-in (tapped or silent) is in flight. */
+    #viaMetanet = false;
+    /** (0.7.0) Bumped by "Not you?": a Metanet sign-in started before it lands nobody. */
+    #run = 0;
     constructor() {
       super();
       this.#root = this.attachShadow({ mode: "open" });
     }
     connectedCallback() {
+      if (!this.#controlled && this.#stateful) warnIfNoLogout({ verifyUrl: this.#attr("verify-url"), logoutUrl: this.#attr("logout-url"), where: "<bwalletx-signin>" });
       this.#render();
+      void this.#restore().then(() => this.#silentMetanet());
+    }
+    disconnectedCallback() {
+      this.#menu?.close(false);
+      this.#hideTip();
     }
     attributeChangedCallback() {
       if (this.isConnected) this.#render();
@@ -933,93 +1658,557 @@ function createClass() {
     get notFound() {
       return this.#notFound;
     }
+    /** The state shown now (the `state` attribute when set, else the element's own). */
+    get state() {
+      const a = this.#attr("state");
+      return a && STATES.includes(a) ? a : this.#phase;
+    }
+    /** The signed-in account, or null. */
+    get account() {
+      if (!this.#controlled) return this.#account;
+      const identityKey = this.#attr("identity-key");
+      return identityKey ? { identityKey, paymail: this.#attr("paymail"), handle: this.#attr("handle"), avatarUrl: this.#attr("avatar-url") } : null;
+    }
+    /** True while the menu is open (tests). */
+    get menuOpen() {
+      return !!this.#menu;
+    }
     focus(opts) {
       this.button?.focus(opts);
     }
+    get #controlled() {
+      return this.hasAttribute("state");
+    }
+    get #stateful() {
+      return !this.hasAttribute("stateless");
+    }
     #attr(name) {
       return this.getAttribute(name);
     }
+    /** Restore the badge from session-url once, with no wallet call. */
+    async #restore() {
+      const url = this.#attr("session-url");
+      if (this.#restored || !url || this.#controlled || !this.#stateful) return;
+      this.#restored = true;
+      this.#set("restoring");
+      try {
+        const r = await fetch(url, { credentials: "include", headers: { accept: "application/json" } });
+        const j = await r.json().catch(() => ({}));
+        if (this.#phase !== "restoring") return;
+        if (j.identityKey) this.#signedIn({ identityKey: j.identityKey, handle: j.handle ?? null, paymail: j.paymail ?? null });
+        else this.#set("signed-out");
+      } catch {
+        if (this.#phase === "restoring") this.#set("signed-out");
+      }
+    }
+    #set(p) {
+      this.#phase = p;
+      if (p !== "signed-in") this.#menu?.close(false);
+      this.#render();
+    }
+    #signedIn(a) {
+      this.#account = a;
+      this.#error = "";
+      this.#set("signed-in");
+      const lookup = this.#attr("lookup-url");
+      if (!a.paymail && lookup !== "off") {
+        void lookupPaymail(a.identityKey, lookup ?? void 0).then((pm) => {
+          if (pm && this.#account?.identityKey === a.identityKey && !this.#account.paymail) {
+            this.#account = { ...this.#account, paymail: pm };
+            this.#render();
+          }
+        });
+      }
+    }
     #render() {
       const size = this.#attr("size") ?? "lg";
       const brand = this.#attr("brand") === "bWallet" ? "bWallet" : "bWalletX";
-      const text = signinText(this.#attr("label") ?? "signin", brand);
+      const esc = (s) => s.replace(/[&<>"]/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" })[c]);
+      const state = this.state;
+      const acct = this.account;
+      if (state === "signed-in" && acct) {
+        this.#hideTip();
+        const name = accountLabel(acct);
+        const avatar = acct.avatarUrl ?? avatarUrlFor(acct.identityKey);
+        const initial = (name.replace(/^\$/, "").charAt(0) || "b").toUpperCase();
+        this.#root.innerHTML = `<style>${SIGNIN_CSS}</style><button type="button" class="chip" part="button chip" aria-haspopup="menu" aria-expanded="${this.#menu ? "true" : "false"}" aria-label="Signed in with bWalletX as ${esc(name)}. Account menu" title="Signed in as ${esc(name)}"><span class="av" part="avatar" aria-hidden="true">${esc(initial)}${avatar ? `<img alt="" src="${esc(avatar)}" referrerpolicy="no-referrer">` : ""}</span><span class="name" part="label">${esc(name)}</span><span class="dot" part="dot" aria-hidden="true"></span></button>`;
+        const img = this.#root.querySelector("img");
+        if (img) img.addEventListener("error", () => img.remove(), { once: true });
+        const chip = this.button;
+        chip.addEventListener("click", () => this.#menu ? this.#menu.close(true) : this.#openMenu());
+        chip.addEventListener("keydown", (e) => {
+          if ((e.key === "ArrowDown" || e.key === "Enter" || e.key === " ") && !this.#menu) {
+            e.preventDefault();
+            this.#openMenu();
+          }
+        });
+        return;
+      }
+      const pending = state === "pending";
+      const restoring = state === "restoring";
+      const error = state === "error";
+      const pendingLabel = this.#controlled ? PENDING_LABEL : this.#pendingLabel;
+      const elsewhere = state === "signed-out" && tapGoesElsewhere(this.#walletType());
+      const text = pending ? pendingLabel : error ? "Retry" : elsewhere ? CONTINUE_OTHER_LABEL : signinText(this.#attr("label") ?? "signin", brand);
       const subAttr = this.#attr("subtitle");
       const subDefault = brand === "bWalletX" && (size === "lg" || size === "md") ? "also works with bWallet" : null;
-      const subtitle = subAttr === null || subAttr === "" || subAttr === "on" ? subAttr === "on" ? "also works with bWallet" : subDefault : subAttr === "off" ? null : subAttr;
-      const loading = this.hasAttribute("loading") || this.#busy;
+      const subtitle = pending || error || elsewhere ? null : subAttr === null || subAttr === "" || subAttr === "on" ? subAttr === "on" ? "also works with bWallet" : subDefault : subAttr === "off" ? null : subAttr;
+      const loading = this.hasAttribute("loading") || this.#busy || pending || restoring;
       const disabled = this.hasAttribute("disabled");
       const markPx = size === "icon" ? 24 : size === "sm" ? 15 : size === "md" ? 17 : 20;
-      const aria = this.#attr("aria-label") ?? (subtitle && size !== "icon" ? `${text}, ${subtitle}` : text);
+      const aria = pending ? pendingLabel : this.#attr("aria-label") ?? (subtitle && size !== "icon" ? `${text}, ${subtitle}` : text);
       const getUrl = this.#attr("get-url") ?? GET_URL;
       const webUrl = this.#attr("web-url") ?? WEB_WALLET_URL;
-      const esc = (s) => s.replace(/[&<>"]/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" })[c]);
+      const errText = error ? (this.#controlled ? this.#attr("error") : this.#error) || "Sign-in failed" : "";
       const label = size === "icon" ? "" : `<span class="txt" part="text"><b part="label">${esc(text)}</b>${subtitle ? `<small part="subtitle">${esc(subtitle)}</small>` : ""}</span>`;
-      const mark = loading ? '<span class="spin" aria-hidden="true"></span>' : markSvg(markPx);
-      const nf = this.#notFound ? `<p class="nf" part="not-found" role="status">bWalletX wasn't found in this browser. <a href="${esc(getUrl)}" target="_blank" rel="noopener">Get ${brand}</a> or <a href="${esc(webUrl)}" target="_blank" rel="noopener">use the web wallet</a>.</p>` : "";
-      this.#root.innerHTML = `<style>${SIGNIN_CSS}</style><button type="button" part="button" aria-label="${esc(aria)}" title="${esc(subtitle ? `${text} (${subtitle})` : text)}"${disabled ? " disabled" : ""}${loading ? ' aria-busy="true"' : ""}><span class="mark" part="mark">${mark}</span>${label}</button>${loading ? '<span class="sr" role="status">Connecting to bWalletX\u2026</span>' : ""}${nf}`;
+      const mark = loading ? '<span class="spin" aria-hidden="true"></span>' : elsewhere ? walletGlyph(markPx - 4) : markSvg(markPx);
+      const otherOff = this.#attr("other-wallets") === "off";
+      const otherLink = '<button type="button" class="lnk" data-act="other" part="other-wallets-link">Other wallets</button>';
+      const nf = this.#notFound ? `<p class="nf" part="not-found" role="status">bWalletX wasn't found in this browser. <a href="${esc(getUrl)}" target="_blank" rel="noopener">Get ${brand}</a> or <a href="${esc(webUrl)}" target="_blank" rel="noopener">use the web wallet</a>.${otherOff ? "" : ` ${otherLink}`}</p>` : "";
+      const ow = !this.#notFound && !pending && !restoring && this.#otherWalletsShown(size) ? `<p class="ow" part="other-wallets">${otherLink}</p>` : "";
+      const sw = !pending && !restoring && this.#switchNoteShown(size) ? `<p class="sw" part="switch-note">${esc(SWITCH_NOTE)} \xB7 <button type="button" class="lnk" data-act="switch" part="switch-link">Switch</button></p>` : "";
+      const err = error ? `<p class="err" part="error" role="alert">${esc(errText)}</p>` : "";
+      const mnHere = this.#metanetShown(size);
+      const mnRemembered = mnHere && (pending ? this.#metanetPending() : !restoring && this.#walletType() === METANET_TYPE);
+      const notYou = `<button type="button" class="lnk" data-act="not-you" part="not-you-link">${esc(NOT_YOU_LABEL)}</button>`;
+      const mn = !mnHere ? "" : pending ? mnRemembered ? `<p class="mn" part="metanet">${esc(METANET_REMEMBERED_NOTE)} ${notYou}</p>` : "" : restoring ? "" : `<p class="mn" part="metanet"><button type="button" class="lnk" data-act="metanet" part="metanet-link" title="Connects to Metanet Desktop on this computer, never to a browser extension.">${esc(METANET_LABEL)}</button><small>${esc(METANET_NOTE)}</small>${mnRemembered ? `<small>${esc(METANET_REMEMBERED_NOTE)} ${notYou}</small>` : ""}</p>`;
+      const compact = size === "sm" || size === "icon";
+      const note = pending && !compact ? `<p class="note" part="note">${esc(PENDING_NOTE)}</p>` : "";
+      const status = pending ? `<span class="sr" role="status">${esc(pendingLabel)}</span>` : loading ? '<span class="sr" role="status">Connecting to bWalletX\u2026</span>' : "";
+      this.#root.innerHTML = `<style>${SIGNIN_CSS}</style>${err}<button type="button" part="button" aria-label="${esc(aria)}" title="${esc(subtitle ? `${text} (${subtitle})` : text)}"${disabled ? " disabled" : ""}${loading ? ' aria-busy="true"' : ""}><span class="mark" part="mark">${mark}</span>${label}</button>${status}${note}${sw}${mn}${ow}${nf}`;
       this.button.addEventListener("click", () => void this.#click());
+      for (const l of Array.from(this.#root.querySelectorAll("[data-act=other]"))) l.addEventListener("click", () => void this.otherWallets());
+      this.#root.querySelector("[data-act=switch]")?.addEventListener("click", () => void this.switchToBwalletX());
+      this.#root.querySelector("[data-act=metanet]")?.addEventListener("click", () => void this.useMetanet());
+      this.#root.querySelector("[data-act=not-you]")?.addEventListener("click", () => this.notYou());
       bindPrewarm(this.button);
+      if (pending && compact) this.#showTip(PENDING_NOTE);
+      else this.#hideTip();
+    }
+    #tip = null;
+    #showTip(text) {
+      const b = this.button;
+      if (!b || typeof document === "undefined") return;
+      if (!this.#tip) {
+        const host = document.createElement("div");
+        host.setAttribute("data-bwalletx-tip", "");
+        const root = host.attachShadow({ mode: "open" });
+        root.innerHTML = `<style>${MENU_CSS}</style><div class="tip" role="note"></div>`;
+        document.body.appendChild(host);
+        this.#tip = host;
+      }
+      const tip2 = this.#tip.shadowRoot.querySelector(".tip");
+      tip2.textContent = text;
+      const r = b.getBoundingClientRect();
+      const vw = window.innerWidth || document.documentElement.clientWidth || 360;
+      const width = Math.min(280, vw - 32);
+      tip2.style.width = `${width}px`;
+      tip2.style.left = `${Math.max(16, Math.min(r.right - width, vw - width - 16))}px`;
+      tip2.style.top = `${r.bottom + 8}px`;
+    }
+    #hideTip() {
+      this.#tip?.remove();
+      this.#tip = null;
+    }
+    #openMenu() {
+      const acct = this.account;
+      const chip = this.button;
+      if (!acct || !chip || typeof document === "undefined") return;
+      const name = accountLabel(acct);
+      const host = document.createElement("div");
+      host.setAttribute("data-bwalletx-menu", "");
+      const root = host.attachShadow({ mode: "open" });
+      const style = document.createElement("style");
+      style.textContent = MENU_CSS;
+      const menu = document.createElement("div");
+      menu.className = "menu";
+      menu.setAttribute("role", "menu");
+      menu.setAttribute("aria-label", "bWalletX account");
+      const who = document.createElement("div");
+      who.className = "who";
+      who.textContent = `Signed in as ${acct.paymail || name}`;
+      const item = (text, run) => {
+        const b = document.createElement("button");
+        b.type = "button";
+        b.className = "item";
+        b.setAttribute("role", "menuitem");
+        b.tabIndex = -1;
+        b.textContent = text;
+        b.addEventListener("click", () => run(b));
+        return b;
+      };
+      const copyWhat = acct.paymail ? "paymail" : "key";
+      const copy = item(`Copy ${copyWhat}`, (b) => {
+        void copyText(acct.paymail || acct.identityKey).then((ok) => {
+          b.textContent = ok ? "Copied" : `Copy ${copyWhat}`;
+          setTimeout(() => close(true), ok ? 600 : 0);
+        });
+      });
+      const out = item("Disconnect", () => {
+        close(false);
+        void this.signOut();
+      });
+      const items = [copy, out];
+      menu.append(who);
+      if (needsBwalletX(this.#walletType())) {
+        const sw = item("Switch to bWalletX", () => {
+          close(false);
+          void this.switchToBwalletX();
+        });
+        const line = document.createElement("div");
+        line.className = "who";
+        line.textContent = SWITCH_NOTE;
+        menu.append(line, sw);
+        items.unshift(sw);
+      }
+      menu.append(copy, out);
+      root.append(style, menu);
+      document.body.appendChild(host);
+      const place = () => {
+        const r = chip.getBoundingClientRect();
+        const vw = window.innerWidth || document.documentElement.clientWidth || 360;
+        const vh = window.innerHeight || document.documentElement.clientHeight || 640;
+        const width = Math.min(260, vw - 32);
+        menu.style.width = `${width}px`;
+        const left = Math.max(16, Math.min(r.right - width, vw - width - 16));
+        menu.style.left = `${left}px`;
+        const h = menu.offsetHeight || 150;
+        const below = r.bottom + 8;
+        menu.style.top = `${below + h > vh && r.top - 8 - h > 0 ? r.top - 8 - h : below}px`;
+      };
+      place();
+      const focusAt = (i) => items[(i + items.length) % items.length].focus();
+      const onKey = (e) => {
+        const i = items.indexOf(root.activeElement);
+        if (e.key === "Escape") {
+          e.preventDefault();
+          close(true);
+        } else if (e.key === "ArrowDown") {
+          e.preventDefault();
+          focusAt(i + 1);
+        } else if (e.key === "ArrowUp") {
+          e.preventDefault();
+          focusAt(i - 1);
+        } else if (e.key === "Home") {
+          e.preventDefault();
+          focusAt(0);
+        } else if (e.key === "End") {
+          e.preventDefault();
+          focusAt(items.length - 1);
+        } else if (e.key === "Tab") close(false);
+      };
+      const onDown = (e) => {
+        const path = e.composedPath?.() ?? [];
+        if (!path.includes(host) && !path.includes(this)) close(false);
+      };
+      const onMove = () => close(false);
+      menu.addEventListener("keydown", onKey);
+      document.addEventListener("pointerdown", onDown, true);
+      window.addEventListener("resize", onMove);
+      window.addEventListener("scroll", place, true);
+      const close = (focusChip = false) => {
+        if (this.#menu?.host !== host) return;
+        this.#menu = null;
+        menu.removeEventListener("keydown", onKey);
+        document.removeEventListener("pointerdown", onDown, true);
+        window.removeEventListener("resize", onMove);
+        window.removeEventListener("scroll", place, true);
+        host.remove();
+        this.button?.setAttribute("aria-expanded", "false");
+        if (focusChip) this.button?.focus();
+      };
+      this.#menu = { host, close };
+      chip.setAttribute("aria-expanded", "true");
+      focusAt(0);
+    }
+    /**
+     * Disconnect: emits bwalletx-disconnect (cancelable). Unless a listener cancels it (BwalletXProvider signs out
+     * itself) or the element is driven by `state`, posts logout-url and shows signed out.
+     */
+    async signOut() {
+      this.#menu?.close(false);
+      if (!this.#emit("bwalletx-disconnect", { element: this, account: this.account }, true)) return;
+      if (this.#controlled) return;
+      const url = this.#attr("logout-url");
+      if (url) await fetch(url, { method: "POST", credentials: "include", headers: { "content-type": "application/json" }, body: "{}" }).catch(() => void 0);
+      if (this.#remember) forgetWalletChoice();
+      this.#signedType = null;
+      this.#account = null;
+      this.#set("signed-out");
+      this.#emit("bwalletx-signed-out");
+      this.button?.focus();
     }
     #emit(type, detail, cancelable = false) {
       return this.dispatchEvent(new CustomEvent(type, { detail, bubbles: true, composed: true, cancelable }));
     }
-    #setBusy(on) {
-      this.#busy = on;
+    /** "Other wallets" is offered under the button: other-wallets on, or auto at lg/md when this element signs in. */
+    #otherWalletsShown(size) {
+      const a = this.#attr("other-wallets");
+      if (a === "off") return false;
+      if (a === "on") return true;
+      return (size === "lg" || size === "md") && (this.#controlled || !!this.#attr("challenge-url"));
+    }
+    /** Open the wallet chooser (the "Other wallets" link): phone QR, other browser wallets, desktop wallets. */
+    otherWallets() {
+      return this.#click("chooser");
+    }
+    /** (0.6.0) "Switch": sign in with bWalletX (its sheet when here, else the chooser with Get bWalletX first). */
+    switchToBwalletX() {
+      return this.#click("bwalletx");
+    }
+    get #remember() {
+      return this.#attr("remember") !== "off";
+    }
+    /**
+     * (0.7.0) "Use Metanet Desktop or another BRC-100 wallet" is offered: metanet on, or auto at lg/md when this
+     * element signs in or follows a provider. Never on a phone or inside a frame.
+     */
+    #metanetShown(size) {
+      const a = this.#attr("metanet");
+      if (a === "off" || !metanetOffered()) return false;
+      if (a === "on") return true;
+      return (size === "lg" || size === "md") && (this.#controlled || !!this.#attr("challenge-url"));
+    }
+    /** A Metanet sign-in is on screen: our own, or (driven) the provider's with Metanet remembered. */
+    #metanetPending() {
+      return this.#controlled ? this.#attr("wallet-type") === METANET_TYPE : this.#viaMetanet;
+    }
+    /** (0.7.0) The Metanet link: connect to Metanet Desktop on localhost:3321 (after this tap, never before). */
+    useMetanet() {
+      return this.#click("metanet");
+    }
+    /**
+     * (0.7.0) "Not you? Use another wallet": forget the remembered wallet here, and drop a Metanet sign-in in flight
+     * (if its verify already set a session, logout-url ends it). Emits bwalletx-not-you (cancelable).
+     */
+    notYou() {
+      if (!this.#emit("bwalletx-not-you", { element: this }, true)) return;
+      this.#run++;
+      if (this.#remember) forgetWalletChoice();
+      this.#signedType = null;
+      if (this.#viaMetanet && !this.#controlled) {
+        this.#viaMetanet = false;
+        this.#busy = false;
+        if (this.#phase === "pending") this.#phase = "signed-out";
+      }
       this.#render();
     }
-    async #click() {
-      if (this.hasAttribute("disabled") || this.hasAttribute("loading") || this.#busy) return;
-      if (!this.#emit("bwalletx-signin", { element: this }, true)) return;
-      const href = this.#attr("href");
-      const authorizeUrl = this.#attr("authorize-url");
-      if (authorizeUrl) {
-        location.assign(await buildAuthorizeUrl({ authorizeUrl, clientId: this.#attr("client-id"), redirectUri: this.#attr("redirect-uri"), scope: this.#attr("scope") }));
+    /**
+     * (0.7.0) Rule 4: back with Metanet remembered and no session, ONE silent attempt per page load (2 s, a known
+     * identity key only), then the signature alone. Any stop or failure is silent: the normal button stays.
+     */
+    async #silentMetanet() {
+      if (this.#controlled || !this.#stateful || !this.#remember || this.#attr("require-token")) return;
+      if (!this.#metanetShown(this.#attr("size") ?? "lg")) return;
+      const challengeUrl = this.#attr("challenge-url");
+      const verifyUrl = this.#attr("verify-url");
+      if (!challengeUrl || !verifyUrl || this.#phase !== "signed-out" || this.#busy || silentAttemptUsed()) return;
+      if (rememberedWalletChoice()?.type !== METANET_TYPE || !metanetOffered()) return;
+      const run = ++this.#run;
+      const live = () => run === this.#run;
+      const started = Date.now();
+      const r = await runSilentMetanet({
+        challengeUrl,
+        verifyUrl,
+        post: (url, body) => postJson(url, body),
+        isAbandoned: () => !live(),
+        logout: async () => {
+          const out = this.#attr("logout-url");
+          if (out) await fetch(out, { method: "POST", credentials: "include", headers: { "content-type": "application/json" }, body: "{}" }).catch(() => void 0);
+        },
+        onSignIn: () => {
+          if (!live() || this.#phase !== "signed-out" || this.#busy) return;
+          this.#viaMetanet = true;
+          this.#busy = true;
+          this.#pendingLabel = PENDING_LABEL_OTHER;
+          this.#set("pending");
+        },
+        onAttempt: (a) => this.#emit("bwalletx-attempt", a)
+      });
+      if (!live()) return;
+      this.#viaMetanet = false;
+      this.#busy = false;
+      if (!r) {
+        if (this.#phase === "pending") this.#set("signed-out");
         return;
       }
-      if (href) {
-        location.assign(href);
-        return;
+      this.#signedType = r.walletType;
+      this.#signedIn({ identityKey: r.identityKey, handle: r.handle, paymail: r.paymail });
+      this.#emit("bwalletx-signed-in", { identityKey: r.identityKey, method: "wallet", nonce: null, signature: null, response: { handle: r.handle, paymail: r.paymail }, silent: true, ms: Date.now() - started });
+    }
+    /** The wallet type the Switch note judges: the provider's, else what signed in here, else the remembered one. */
+    #walletType() {
+      if (this.#controlled) return this.#attr("wallet-type");
+      return this.#signedType ?? (this.#remember ? rememberedWalletChoice()?.type ?? null : null);
+    }
+    #switchNoteShown(size) {
+      const a = this.#attr("switch-note");
+      if (a === "off" || !tapGoesElsewhere(this.#walletType())) return false;
+      return a === "on" || size === "lg" || size === "md";
+    }
+    /**
+     * Signed in: note the wallet type, and remember it for this origin when the user picked it (0.6.0), plus the
+     * identity key as known here (0.7.0, public keys only: Metanet's silent attempt goes on only for these). Pass a key
+     * only after the site's verify route accepted it.
+     */
+    #picked(option, reason, identityKey) {
+      this.#signedType = walletTypeOf(option);
+      if (this.#remember && isExplicitPick(option, reason)) rememberWalletChoice(option);
+      if (this.#remember) rememberKnownIdentityKey(identityKey);
+    }
+    #attempt(option, outcome, started) {
+      this.#emit("bwalletx-attempt", attemptFor(option, outcome, started));
+    }
+    /**
+     * Which wallet: bWalletX by its own marker goes straight to its sheet; otherwise the chooser ("Get bWalletX" first)
+     * when another wallet is here or the user asked; otherwise 'not-found'. null: the chooser was closed.
+     */
+    async #choose(mode, ms, pairing) {
+      if (mode === "metanet") return { option: metanetOption(), reason: "requested" };
+      const r = mode === "signin" && this.#remember ? rememberedWalletChoice() : null;
+      if (r && r.type !== METANET_TYPE && !(r.type === BWALLETX_TYPE && r.substrate !== "pairing")) {
+        const m = matchRemembered(await discoverWallets({ ms, pairing: () => pairing }), r);
+        if (m) return { option: m, reason: "remembered" };
+      }
+      if (mode !== "chooser") {
+        const f = await discoverBwalletX(ms);
+        if (f) {
+          const substrate = f.rdns === RDNS_EXTENSION ? "extension" : f.rdns === RDNS_MOBILE ? "in-app" : "xdm";
+          const option = brc100Option(f.wallet, { id: f.rdns ?? "bwalletx-xdm", rdns: f.rdns ?? void 0, name: "bWalletX", isBwalletX: true, substrate });
+          return { option, reason: "bwalletx" };
+        }
+      }
+      const list = await discoverWallets({ ms: 50, pairing: () => pairing });
+      if (mode !== "chooser" && !hasBwalletX(list) && !otherDetected(list).length) return "not-found";
+      const picked = await chooseWallet(list, { getUrl: this.#attr("get-url") ?? void 0 });
+      return picked ? { option: picked, reason: "chooser" } : null;
+    }
+    async #click(mode = "signin") {
+      if (this.hasAttribute("disabled") || this.hasAttribute("loading") || this.#busy || this.state === "pending") return;
+      if (!this.#emit("bwalletx-signin", { element: this, mode }, true)) return;
+      if (mode === "signin") {
+        const href = this.#attr("href");
+        const authorizeUrl = this.#attr("authorize-url");
+        if (authorizeUrl) {
+          location.assign(await buildAuthorizeUrl({ authorizeUrl, clientId: this.#attr("client-id"), redirectUri: this.#attr("redirect-uri"), scope: this.#attr("scope") }));
+          return;
+        }
+        if (href) {
+          location.assign(href);
+          return;
+        }
       }
       const challengeUrl = this.#attr("challenge-url");
       if (!challengeUrl) return;
+      const own = this.#stateful && !this.#controlled;
+      const prev = this.#phase === "signed-in" ? "signed-in" : "signed-out";
+      const started = Date.now();
+      const pairing = pairingModal();
+      let option = null;
+      const run = ++this.#run;
+      const live = () => run === this.#run;
       this.#notFound = false;
-      this.#setBusy(true);
+      this.#busy = true;
+      this.#viaMetanet = mode === "metanet";
+      this.#pendingLabel = mode === "metanet" ? PENDING_LABEL_OTHER : PENDING_LABEL;
+      if (own) this.#set("pending");
+      else this.#render();
       try {
         const ms = Number(this.#attr("discover-ms")) || DEFAULT_DISCOVER_MS;
-        const found = await discoverBwalletX(ms);
-        if (!found) {
+        const picked = await this.#choose(mode, ms, pairing);
+        if (picked === "not-found") {
           this.#notFound = true;
+          if (own) this.#phase = "signed-out";
+          this.#attempt(null, "not-found", started);
           this.#emit("bwalletx-not-found");
           if (this.#attr("require-token")) this.#emit("bwalletx-access-denied", { code: "not_installed", message: "No wallet found" });
           return;
         }
+        if (!picked) {
+          if (own) this.#phase = prev;
+          this.#attempt(null, "cancelled", started);
+          return;
+        }
+        option = picked.option;
+        const reason = picked.reason;
+        if (!option.isBwalletX) {
+          this.#pendingLabel = PENDING_LABEL_OTHER;
+          if (own) this.#render();
+        }
+        const cw = await option.connect({ identity: false });
+        if (!live()) return;
+        const wallet = cw.wallet;
+        if (!wallet) throw Object.assign(new Error("This wallet cannot sign in here"), { code: "NOT_SUPPORTED" });
+        const sub = substrateOf(option);
+        const method = sub === "extension" ? "extension" : sub === "in-app" || sub === "xdm" ? "in-app" : sub === "pairing" ? "pairing" : "wallet";
         const requireToken = this.#attr("require-token");
         if (requireToken) {
+          if (own) this.#phase = "signed-out";
           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,
+              wallet,
               challenge: (identityKey) => postJson(challengeUrl, { identityKey, require: hint }),
               verify: verifyUrl2 ? (response2) => postAccess(verifyUrl2, response2) : void 0
             });
+            this.#picked(option, reason, verifyUrl2 ? a.response.identityKey : null);
+            this.#attempt(option, "signed-in", started);
             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.#attempt(option, outcomeOf(e), started);
             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 }) });
         const verifyUrl = this.#attr("verify-url");
-        const response = verifyUrl ? await postJson(verifyUrl, { identityKey: r.identityKey, nonce: r.nonce, signature: r.signature }) : null;
-        this.#emit("bwalletx-signed-in", { identityKey: r.identityKey, method: found.method, nonce: r.nonce, signature: r.signature, response });
+        const { result: r, verified } = await signInAndVerify({
+          wallet,
+          // Metanet hands over its key on connect (one request at a time), so its sign-in is the signature alone.
+          identityKey: cw.identityKey ?? void 0,
+          skipWaitForAuthentication: option.id === METANET_OPTION_ID,
+          // its connect() just checked the lock
+          identityKeyHint: verifyUrl ? rememberedIdentity() : void 0,
+          challenge: (identityKey) => postJson(challengeUrl, identityKey ? { identityKey } : {}),
+          verify: async (res) => verifyUrl ? await postJson(verifyUrl, { identityKey: res.identityKey, nonce: res.nonce, signature: res.signature }) : {}
+        });
+        if (!live()) {
+          const out = this.#attr("logout-url");
+          if (verifyUrl && out) await fetch(out, { method: "POST", credentials: "include", headers: { "content-type": "application/json" }, body: "{}" }).catch(() => void 0);
+          return;
+        }
+        if (verifyUrl) rememberIdentity(r.identityKey);
+        const response = verifyUrl ? verified : null;
+        this.#picked(option, reason, verifyUrl ? r.identityKey : null);
+        if (own) this.#signedIn({ identityKey: r.identityKey, handle: response?.handle ?? null, paymail: response?.paymail ?? null });
+        this.#attempt(option, "signed-in", started);
+        this.#emit("bwalletx-signed-in", { identityKey: r.identityKey, method, nonce: r.nonce, signature: r.signature, response });
       } catch (error) {
-        this.#emit("bwalletx-error", { error });
+        const outcome = outcomeOf(error);
+        this.#attempt(option, outcome, started);
+        if (!live()) return;
+        const closedQr = outcome === "cancelled" && option?.kind === "pairing";
+        if (own) {
+          if (closedQr) this.#phase = prev;
+          else {
+            this.#error = signInErrorText(error);
+            this.#phase = "error";
+          }
+        }
+        if (!closedQr) this.#emit("bwalletx-error", { error });
       } finally {
-        this.#setBusy(false);
+        try {
+          pairing.close();
+        } catch {
+        }
+        if (live()) {
+          this.#busy = false;
+          this.#viaMetanet = false;
+          this.#render();
+        }
       }
     }
   };
@@ -1051,7 +2240,21 @@ a.bwx-btn{display:block;text-align:center;text-decoration:none;box-sizing:border
 .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}
+.bwx-tag{margin-left:auto;font-size:11px;color:#8d866f;white-space:nowrap}
+.bwx-opt{min-height:48px;box-sizing:border-box}
+a.bwx-btn.bwx-opt{display:flex;text-align:left}
+.bwx-btn:focus{outline:none}
+.bwx-btn:focus-visible{outline:2px solid #e8c766;outline-offset:2px}
+.bwx-mk{display:inline-flex;align-items:center;justify-content:center;flex:none;width:28px;height:28px;border-radius:50%;background:#000}
+.bwx-ico{display:inline-grid;place-items:center;flex:none;width:28px;height:28px;border-radius:8px;background:#2a2518;color:#e8c766;font-weight:700;font-size:13px}
+.bwx-opt img{width:28px;height:28px;border-radius:8px;flex:none}
+.bwx-txt{display:flex;flex-direction:column;min-width:0;gap:1px}
+.bwx-txt b{font-weight:600}
+.bwx-txt small{font-size:12px;color:#8d866f;font-weight:400}
+.bwx-primary .bwx-txt small{color:rgba(0,0,0,.68)}
+.bwx-primary .bwx-tag{color:rgba(0,0,0,.6)}
+.bwx-sep{font-size:12px;color:#8d866f;margin:6px 2px 0}
+.bwx-foot{font-size:12px;color:#8d866f;margin:12px 0 0}
 `;
 function mount() {
   const root = document.createElement("div");
@@ -1078,18 +2281,6 @@ 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;
@@ -1180,110 +2371,109 @@ function pickWallet(options, o = {}) {
     ui.box.lastChild.append(cancel);
   });
 }
-
-// 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;
+function optionRow(w, primary, sub, tag) {
+  const b = el("button", `bwx-btn bwx-opt${primary ? " bwx-primary" : ""}`);
+  b.type = "button";
+  b.dataset.wallet = w.id;
+  if (w.isBwalletX) {
+    const mk = el("span", "bwx-mk");
+    mk.innerHTML = markSvg(18);
+    b.append(mk);
+  } else if (w.icon) {
+    const img = el("img");
+    img.src = w.icon;
+    img.alt = "";
+    b.append(img);
+  } else {
+    b.append(el("span", "bwx-ico", (w.name.trim().charAt(0) || "W").toUpperCase()));
   }
+  const t = el("span", "bwx-txt");
+  t.append(el("b", "", w.name));
+  if (sub) t.append(el("small", "", sub));
+  b.append(t);
+  if (tag) b.append(el("span", "bwx-tag", tag));
+  return b;
 }
-async function discoverWallets(o = {}) {
-  const out = [];
-  const ms = o.ms ?? 300;
-  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 }));
+function chooseWallet(options, o = {}) {
+  if (typeof document === "undefined") return Promise.resolve(null);
+  return new Promise((resolve) => {
+    const ui = mount();
+    ui.root.dataset.bwxChooser = "";
+    const done = (w) => {
+      document.removeEventListener("keydown", onKey, true);
+      ui.close();
+      resolve(w);
     };
-    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, seen.size > 0 || window.CWI ? Math.min(ms, 50) : 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 onKey = (e) => {
+      if (e.key === "Escape") {
+        e.preventDefault();
+        done(null);
+      }
+    };
+    document.addEventListener("keydown", onKey, true);
+    ui.box.append(el("h2", "", o.title ?? "Choose a wallet"));
+    const list = el("div", "bwx-list");
+    const here = hasBwalletX(options);
+    if (!here) {
+      const get = el("a", "bwx-btn bwx-opt bwx-primary");
+      get.href = o.getUrl ?? GET_URL;
+      get.target = "_blank";
+      get.rel = "noopener";
+      get.dataset.wallet = "get-bwalletx";
+      const mk = el("span", "bwx-mk");
+      mk.innerHTML = markSvg(18);
+      const t = el("span", "bwx-txt");
+      t.append(el("b", "", "Get bWalletX"), el("small", "", "Free. Every feature on this site"));
+      get.append(mk, t);
+      list.append(get);
     }
-    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);
+    const ordered = chooserOrder(options);
+    const touch = isTouchDevice();
+    let sep = false;
+    for (const w of ordered) {
+      if (!here && !sep) {
+        list.append(el("p", "bwx-sep", "Or use"));
+        sep = true;
+      }
+      const sub = isPresentBwalletX(w) ? "Recommended" : w.kind === "pairing" ? touch ? "Open the bWalletX app" : "Scan a QR with your phone" : void 0;
+      const tag = w.kind === "handcash" ? "until BRC-100" : !w.isBwalletX && w.kind === "brc100" ? "Fewer features" : void 0;
+      const row2 = optionRow(w, isPresentBwalletX(w), sub, tag);
+      row2.onclick = () => done(w);
+      list.append(row2);
+    }
+    if (o.desktop !== false && metanetOffered() && !options.some((w) => w.substrate === "json-api" || w.substrate === "cicada")) {
+      if (!here && !sep) list.append(el("p", "bwx-sep", "Or use"));
+      const d = metanetOption();
+      const row2 = optionRow(d, false, METANET_NOTE);
+      row2.title = "Connects to Metanet Desktop on this computer, never to a browser extension.";
+      row2.onclick = () => done(d);
+      list.append(row2);
+    }
+    ui.box.append(list);
+    if (otherDetected(options).length || !here) ui.box.append(el("p", "bwx-foot", "Some features need bWalletX."));
+    const row = el("div", "bwx-row");
+    const cancel = el("button", "bwx-btn", "Cancel");
+    cancel.type = "button";
+    cancel.onclick = () => done(null);
+    row.append(cancel);
+    ui.box.append(row);
+    ui.root.onclick = (e) => e.target === ui.root && done(null);
+    list.querySelector("a,button")?.focus();
+  });
 }
 
 // src/pay.ts
-var import_sdk6 = require("@bsv/sdk");
+var import_sdk7 = require("@bsv/sdk");
 var BRC29_PROTOCOL = [2, "3241645161d8"];
+var NO_COINS_TEXT = "Your wallet doesn't have enough to cover this payment and its small network fee. Add a little and try again.";
+function isInsufficientFunds(e) {
+  const err = e;
+  if (!err) return false;
+  if (err.name === "WERR_INSUFFICIENT_FUNDS" || err.code === "WERR_INSUFFICIENT_FUNDS" || err.code === "ERR_INSUFFICIENT_FUNDS") return true;
+  if (err.isError === true && err.code === 7) return true;
+  const msg = typeof err.message === "string" ? err.message : String(e);
+  return /insufficient (funds|balance)|not enough (funds|coins|satoshis|sats)|more satoshis are needed/i.test(msg);
+}
 var PaymentError = class extends Error {
   constructor(code, message, maybeSent = false, cause) {
     super(message);
@@ -1302,13 +2492,13 @@ var isPaymail = (s) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(s);
 function randomB64(n) {
   const b = new Uint8Array(n);
   globalThis.crypto.getRandomValues(b);
-  return import_sdk6.Utils.toBase64(Array.from(b));
+  return import_sdk7.Utils.toBase64(Array.from(b));
 }
 function opReturn(text) {
-  const d = import_sdk6.Utils.toArray(text, "utf8");
+  const d = import_sdk7.Utils.toArray(text, "utf8");
   const len = d.length;
   const push = len < 76 ? [len] : len <= 255 ? [76, len] : [77, len & 255, len >> 8];
-  return import_sdk6.Utils.toHex([0, 106, ...push, ...d]);
+  return import_sdk7.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);
@@ -1379,6 +2569,7 @@ async function runAction(wallet, description, outputs, labels) {
       options: { randomizeOutputs: false }
     });
   } catch (e) {
+    if (isInsufficientFunds(e)) throw new PaymentError("INSUFFICIENT_FUNDS", NO_COINS_TEXT, false, 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);
@@ -1404,7 +2595,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_sdk6.P2PKH().lock(import_sdk6.PublicKey.fromString(pk).toHash()).toHex(), satoshis: sats, description: "payment" }];
+    outputs = [{ script: new import_sdk7.P2PKH().lock(import_sdk7.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);
@@ -1412,7 +2603,7 @@ async function pay(source, req, o = {}) {
     submit = r2.submit;
   } else {
     try {
-      outputs = [{ script: new import_sdk6.P2PKH().lock(to).toHex(), satoshis: sats, description: "payment" }];
+      outputs = [{ script: new import_sdk7.P2PKH().lock(to).toHex(), satoshis: sats, description: "payment" }];
     } catch {
       throw new PaymentError("BAD_REQUEST", `Not a paymail, address or identity key: ${to}`);
     }
@@ -1422,7 +2613,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_sdk6.Transaction.fromAtomicBEEF(tx).toHex()).catch(() => {
+    await submit(import_sdk7.Transaction.fromAtomicBEEF(tx).toHex()).catch(() => {
     });
   }
   return { txid: r.txid, tx, sats, outputs, remittance };
@@ -1443,19 +2634,62 @@ async function buyToken(source, req) {
 }
 
 // src/react.ts
+function signinStateFor(v) {
+  if (v.status === "restoring") return "restoring";
+  if (v.status === "connecting") return "pending";
+  if (v.status === "error") return "error";
+  if (v.status === "connected" && v.identityKey) return "signed-in";
+  return "signed-out";
+}
 function BwalletxSignin(props) {
   const ref = (0, import_react.useRef)(null);
   const cb = (0, import_react.useRef)(props);
   cb.current = props;
+  const ctx = (0, import_react.useContext)(Ctx);
+  const ctxRef = (0, import_react.useRef)(ctx);
+  ctxRef.current = ctx;
+  const driven = !!ctx && props.stateful !== false;
   (0, import_react.useEffect)(() => {
     defineBwalletxSignin();
     const el2 = ref.current;
     if (!el2) return;
     const on = [
-      ["bwalletx-signin", (e) => cb.current.onClick?.(e)],
+      [
+        "bwalletx-signin",
+        (e) => {
+          cb.current.onClick?.(e);
+          const c = ctxRef.current;
+          if (!e.defaultPrevented && c && cb.current.stateful !== false) {
+            e.preventDefault();
+            const mode = e.detail?.mode;
+            c.connect(mode === "chooser" ? { chooser: true } : mode === "bwalletx" ? { bwalletx: true } : mode === "metanet" ? { metanet: true } : {}).catch(() => void 0);
+          }
+        }
+      ],
       ["bwalletx-signed-in", (e) => cb.current.onSignedIn?.(e.detail)],
       ["bwalletx-not-found", () => cb.current.onNotFound?.()],
-      ["bwalletx-error", (e) => cb.current.onError?.(e.detail.error)]
+      ["bwalletx-error", (e) => cb.current.onError?.(e.detail.error)],
+      [
+        "bwalletx-disconnect",
+        (e) => {
+          const c = ctxRef.current;
+          if (c && cb.current.stateful !== false) {
+            e.preventDefault();
+            void c.disconnect().then(() => cb.current.onSignedOut?.());
+          }
+        }
+      ],
+      ["bwalletx-signed-out", () => cb.current.onSignedOut?.()],
+      [
+        "bwalletx-not-you",
+        (e) => {
+          const c = ctxRef.current;
+          if (c && cb.current.stateful !== false) {
+            e.preventDefault();
+            c.forgetWallet();
+          }
+        }
+      ]
     ];
     for (const [t, f] of on) el2.addEventListener(t, f);
     return () => {
@@ -1464,6 +2698,7 @@ function BwalletxSignin(props) {
   }, []);
   const p = props;
   const flag = (v) => v ? "" : void 0;
+  const state = driven ? signinStateFor(ctx) : void 0;
   return (0, import_react.createElement)("bwalletx-signin", {
     ref,
     id: p.id,
@@ -1479,6 +2714,16 @@ function BwalletxSignin(props) {
     disabled: flag(p.disabled),
     "challenge-url": p.challengeUrl,
     "verify-url": p.verifyUrl,
+    "session-url": driven ? void 0 : p.sessionUrl,
+    "logout-url": driven ? void 0 : p.logoutUrl,
+    "lookup-url": p.lookupUrl,
+    stateless: p.stateful === false ? "" : void 0,
+    state,
+    "identity-key": driven ? ctx.identityKey ?? void 0 : void 0,
+    paymail: driven ? ctx.paymail ?? void 0 : void 0,
+    handle: driven ? ctx.handle ?? void 0 : void 0,
+    "avatar-url": driven ? avatarUrlFor(ctx.identityKey) ?? void 0 : void 0,
+    error: driven && ctx.status === "error" ? signInErrorText(ctx.error) : void 0,
     "get-url": p.getUrl,
     "web-url": p.webUrl,
     href: p.href,
@@ -1487,6 +2732,9 @@ function BwalletxSignin(props) {
     "redirect-uri": p.redirectUri,
     scope: p.scope,
     "discover-ms": p.discoverMs,
+    "other-wallets": p.otherWallets,
+    metanet: p.metanet,
+    "wallet-type": driven ? ctx.walletType ?? ctx.rememberedWallet?.type ?? void 0 : void 0,
     "aria-label": p["aria-label"]
   });
 }
@@ -1498,9 +2746,13 @@ var empty = {
   paymail: null,
   wallet: null,
   walletId: null,
+  walletType: null,
   transitional: false,
   signedIn: false,
-  error: null
+  error: null,
+  rememberedWallet: null,
+  needsBwalletX: false,
+  metanetOffered: false
 };
 var Ctx = (0, import_react.createContext)(null);
 async function postJson2(url, body) {
@@ -1511,6 +2763,10 @@ async function postJson2(url, body) {
 }
 function BwalletXProvider(p) {
   const [state, setState] = (0, import_react.useState)(empty);
+  const stateRef = (0, import_react.useRef)(state);
+  stateRef.current = state;
+  const silentRun = (0, import_react.useRef)(0);
+  const sessionChecked = (0, import_react.useRef)(!p.sessionUrl);
   const [wallets, setWallets] = (0, import_react.useState)([]);
   const props = (0, import_react.useRef)(p);
   props.current = p;
@@ -1521,6 +2777,9 @@ function BwalletXProvider(p) {
     props.current.onError?.(err);
     return err;
   }, []);
+  (0, import_react.useEffect)(() => {
+    warnIfNoLogout({ verifyUrl: p.verifyUrl, logoutUrl: p.logoutUrl, where: "<BwalletXProvider>" });
+  }, [p.verifyUrl, p.logoutUrl]);
   const themeOn = !!p.theme && (state.status === "connecting" || state.status === "connected");
   (0, import_react.useEffect)(() => {
     if (!themeOn) return;
@@ -1534,10 +2793,15 @@ function BwalletXProvider(p) {
     setState((s) => ({ ...s, status: "restoring" }));
     fetch(url, { credentials: "same-origin" }).then((r) => r.json()).then((j) => {
       if (!live) return;
+      sessionChecked.current = true;
       setState(
         (s) => j.identityKey ? { ...s, status: "connected", identityKey: j.identityKey, handle: j.handle ?? null, paymail: j.paymail ?? null, signedIn: true } : { ...s, status: s.status === "restoring" ? "idle" : s.status }
       );
-    }).catch(() => live && setState((s) => ({ ...s, status: s.status === "restoring" ? "idle" : s.status })));
+    }).catch(() => {
+      if (!live) return;
+      sessionChecked.current = true;
+      setState((s) => ({ ...s, status: s.status === "restoring" ? "idle" : s.status }));
+    });
     return () => {
       live = false;
     };
@@ -1558,46 +2822,50 @@ function BwalletXProvider(p) {
       const c = props.current;
       setState((s) => ({ ...s, status: "connecting", error: null }));
       try {
-        const list = await listWallets();
-        let choice = opts.walletId ? list.find((w) => w.id === opts.walletId) : void 0;
-        if (!choice) {
-          const direct = list.filter((w) => w.kind !== "pairing");
-          choice = c.picker !== false && list.length > 1 ? await pickWallet(list) : direct[0] ?? list[0] ?? null;
-        }
-        if (!choice) {
-          if (!list.length) throw Object.assign(new Error("No wallet found. Get bWalletX at bwalletx.com."), { code: "NOT_FOUND" });
-          setState((s) => ({ ...s, status: s.identityKey ? "connected" : "idle" }));
+        const list = opts.metanet ? [] : await listWallets();
+        const fast = c.fastPath !== false;
+        const r = await runConnect({
+          list,
+          walletId: opts.walletId,
+          chooser: opts.chooser,
+          picker: c.picker,
+          fastPath: fast,
+          pick: fast ? (l) => chooseWallet(l) : pickWallet,
+          onAttempt: c.onAttempt,
+          remembered: fast && c.rememberChoice !== false ? rememberedWalletChoice() : null,
+          remember: fast && c.rememberChoice !== false,
+          preferBwalletX: opts.bwalletx,
+          metanet: opts.metanet,
+          challengeUrl: c.challengeUrl,
+          verifyUrl: c.verifyUrl,
+          challengeNeedsIdentityKey: c.challengeNeedsIdentityKey,
+          post: postJson2
+        });
+        if (!r) {
+          setState((s) => ({ ...s, status: s.identityKey && s.signedIn ? "connected" : "idle" }));
           return null;
         }
-        const cw = await choice.connect();
-        let { handle = null, paymail = null } = cw;
-        let signedIn = false;
-        if (cw.wallet && c.challengeUrl && c.verifyUrl) {
-          const r = await signInWithBwalletX({
-            wallet: cw.wallet,
-            challenge: (identityKey) => postJson2(c.challengeUrl, { identityKey })
-          });
-          const v = await atStage("verify", () => postJson2(c.verifyUrl, { identityKey: r.identityKey, nonce: r.nonce, signature: r.signature }));
-          handle = v.handle ?? handle;
-          paymail = v.paymail ?? paymail;
-          signedIn = true;
-        }
+        const cw = r.connected;
         payer.current = cw.payer;
         setState({
           status: "connected",
-          identityKey: cw.identityKey,
-          handle,
-          paymail,
+          identityKey: r.identityKey,
+          handle: r.handle,
+          paymail: r.paymail,
           wallet: cw.wallet,
           walletId: cw.optionId,
+          walletType: r.walletType,
           transitional: !!cw.transitional,
-          signedIn,
-          error: null
+          signedIn: r.signedIn,
+          error: null,
+          rememberedWallet: c.rememberChoice !== false ? rememberedWalletChoice() : null,
+          needsBwalletX: needsBwalletX(r.walletType),
+          metanetOffered: metanetOffered()
         });
-        return cw;
+        return { ...cw, identityKey: r.identityKey, handle: r.handle ?? void 0, paymail: r.paymail ?? void 0 };
       } catch (e) {
         if (e?.message === "cancelled") {
-          setState((s) => ({ ...s, status: s.identityKey ? "connected" : "idle" }));
+          setState((s) => ({ ...s, status: s.identityKey && s.signedIn ? "connected" : "idle" }));
           return null;
         }
         throw fail(e);
@@ -1610,9 +2878,107 @@ function BwalletXProvider(p) {
     if (c.logoutUrl) await postJson2(c.logoutUrl, {}).catch(() => {
     });
     if (state.walletId === "bwalletx-pairing") await clearPairing();
+    if (c.rememberChoice !== false) forgetWalletChoice();
+    silentRun.current++;
     payer.current = null;
-    setState(empty);
+    setState({ ...empty, metanetOffered: metanetOffered() });
   }, [state.walletId]);
+  const switchToBwalletX = (0, import_react.useCallback)(() => connect({ bwalletx: true }), [connect]);
+  const connectMetanet = (0, import_react.useCallback)(() => connect({ metanet: true }), [connect]);
+  const forgetWallet = (0, import_react.useCallback)(() => {
+    if (props.current.rememberChoice !== false) forgetWalletChoice();
+    silentRun.current++;
+    setState((s) => ({
+      ...s,
+      rememberedWallet: null,
+      needsBwalletX: s.walletType ? needsBwalletX(s.walletType) : false,
+      // A silent Metanet sign-in on screen goes back to the normal choice.
+      status: s.status === "connecting" && !s.wallet ? s.signedIn && s.identityKey ? "connected" : "idle" : s.status
+    }));
+  }, []);
+  (0, import_react.useEffect)(() => {
+    setState((s) => s.metanetOffered === metanetOffered() ? s : { ...s, metanetOffered: metanetOffered() });
+    if (p.rememberChoice === false) return;
+    const r = rememberedWalletChoice();
+    if (r) setState((s) => s.rememberedWallet ? s : { ...s, rememberedWallet: r, needsBwalletX: s.walletType ? s.needsBwalletX : needsBwalletX(r.type) && r.type !== METANET_TYPE });
+  }, [p.rememberChoice]);
+  const sessionOnly = state.status === "connected" && state.signedIn && !state.wallet;
+  (0, import_react.useEffect)(() => {
+    const c = props.current;
+    if (!sessionOnly || c.autoConnect === false || c.rememberChoice === false || c.fastPath === false) return;
+    const plan = planAutoConnect({ remembered: rememberedWalletChoice(), signedIn: true });
+    if (plan.action !== "attach" || !plan.remembered) return;
+    let live = true;
+    void attachRemembered(plan.remembered, { ms: c.discoverMs }).then((opt) => {
+      if (!live || !opt?.wallet) return;
+      payer.current = opt.wallet;
+      setState(
+        (s) => s.status === "connected" && !s.wallet ? { ...s, wallet: opt.wallet, walletId: opt.id, walletType: walletTypeOf(opt), needsBwalletX: needsBwalletX(walletTypeOf(opt)) } : s
+      );
+    });
+    return () => {
+      live = false;
+    };
+  }, [sessionOnly]);
+  const silentReady = state.status === "idle" || sessionOnly;
+  (0, import_react.useEffect)(() => {
+    const c = props.current;
+    if (!silentReady || !sessionChecked.current || c.autoConnect === false || c.rememberChoice === false || c.fastPath === false || silentAttemptUsed()) return;
+    const plan = planAutoConnect({ remembered: rememberedWalletChoice(), signedIn: sessionOnly });
+    if (plan.action !== "silent-metanet") return;
+    const run = ++silentRun.current;
+    const live = () => run === silentRun.current;
+    let shown = false;
+    const session = stateRef.current;
+    void runSilentMetanet({
+      sessionKey: sessionOnly ? session.identityKey : null,
+      challengeUrl: c.challengeUrl,
+      verifyUrl: c.verifyUrl,
+      post: postJson2,
+      onAttempt: c.onAttempt,
+      isAbandoned: () => !live(),
+      logout: () => props.current.logoutUrl ? postJson2(props.current.logoutUrl, {}) : Promise.resolve(),
+      onSignIn: () => {
+        if (!live()) return;
+        shown = true;
+        setState((s) => s.status === "idle" ? { ...s, status: "connecting", error: null } : s);
+      }
+    }).then((r) => {
+      if (!live()) return;
+      if (!r) {
+        if (shown) setState((s) => s.status === "connecting" && !s.wallet ? { ...s, status: s.signedIn && s.identityKey ? "connected" : "idle" } : s);
+        return;
+      }
+      const cw = r.connected;
+      payer.current = cw.payer;
+      setState((s) => ({
+        ...s,
+        status: "connected",
+        identityKey: r.identityKey,
+        handle: r.handle ?? s.handle,
+        paymail: r.paymail ?? s.paymail,
+        wallet: cw.wallet,
+        walletId: cw.optionId,
+        walletType: r.walletType,
+        transitional: false,
+        signedIn: r.signedIn || s.signedIn,
+        error: null,
+        rememberedWallet: rememberedWalletChoice(),
+        needsBwalletX: true
+      }));
+    });
+  }, [silentReady, sessionOnly]);
+  (0, import_react.useEffect)(() => {
+    const key = state.identityKey;
+    if (!key || state.paymail || p.lookupUrl === "off") return;
+    let live = true;
+    void lookupPaymail(key, p.lookupUrl).then((pm) => {
+      if (live && pm) setState((s) => s.identityKey === key && !s.paymail ? { ...s, paymail: pm } : s);
+    });
+    return () => {
+      live = false;
+    };
+  }, [state.identityKey, state.paymail, p.lookupUrl]);
   const need = () => {
     if (!payer.current) throw new PaymentError("NOT_SUPPORTED", "Connect a wallet first (connect()).");
     return payer.current;
@@ -1623,12 +2989,15 @@ function BwalletXProvider(p) {
       wallets,
       connect,
       disconnect,
+      switchToBwalletX,
+      connectMetanet,
+      forgetWallet,
       listWallets,
       pay: (req) => pay(need(), req, props.current.payOptions),
       tip: (req) => tip(need(), req, props.current.payOptions),
       buyToken: (req) => buyToken(need(), req)
     }),
-    [state, wallets, connect, disconnect, listWallets]
+    [state, wallets, connect, disconnect, switchToBwalletX, connectMetanet, forgetWallet, listWallets]
   );
   return (0, import_react.createElement)(Ctx.Provider, { value }, p.children);
 }
@@ -1637,6 +3006,24 @@ function useBwalletX() {
   if (!v) throw new Error("useBwalletX() must be used inside <BwalletXProvider>");
   return v;
 }
+function accountFor(v) {
+  const status = signinStateFor(v);
+  const signedIn = status === "signed-in";
+  return {
+    status,
+    identityKey: signedIn ? v.identityKey : null,
+    paymail: signedIn ? v.paymail : null,
+    handle: signedIn ? v.handle : null,
+    label: signedIn ? accountLabel(v) : null,
+    avatarUrl: signedIn ? avatarUrlFor(v.identityKey) : null,
+    error: status === "error" ? signInErrorText(v.error) : null,
+    login: () => v.connect().then(() => void 0, () => void 0),
+    logout: () => v.disconnect()
+  };
+}
+function useBwalletXAccount() {
+  return accountFor(useBwalletX());
+}
 var BwalletxProvider = BwalletXProvider;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -1644,10 +3031,14 @@ var BwalletxProvider = BwalletXProvider;
   BwalletxProvider,
   BwalletxSignin,
   PaymentError,
+  accountFor,
+  autoChoice,
   brc100Option,
   discoverWallets,
   handcashAdapter,
   pairingOption,
-  useBwalletX
+  signinStateFor,
+  useBwalletX,
+  useBwalletXAccount
 });
 //# sourceMappingURL=react.cjs.map