@lydianpay/lydianconnect 1.2.0 → 1.3.0

package/dist/index.cjs

@@ -72,6 +72,14 @@ var ConnectManager = class {
   get(walletId) {
     return this.connections.get(walletId);
   }
+  /**
+   * Fire a wallet's deep link. Goes straight to the fallback: it is the only
+   * connector that owns a link table, and the only one that emits the
+   * `display_uri` a host is responding to when it calls this.
+   */
+  openWallet(input) {
+    return this.fallback.openWallet?.(input) ?? false;
+  }
   async disconnect(walletId) {
     if (walletId) {
       await this.connections.get(walletId)?.disconnect().catch(() => {
@@ -79,7 +87,9 @@ var ConnectManager = class {
       this.connections.delete(walletId);
       return;
     }
-    await Promise.allSettled([...this.connections.values()].map((c) => c.disconnect()));
+    await Promise.allSettled(
+      [...this.connections.values()].map((c) => c.disconnect())
+    );
     this.connections.clear();
   }
   async reset() {
@@ -111,7 +121,11 @@ var NAMESPACE_DEFAULTS = {
     events: ["chainChanged", "accountsChanged"]
   },
   solana: {
-    methods: ["solana_signTransaction", "solana_signMessage", "solana_signAndSendTransaction"],
+    methods: [
+      "solana_signTransaction",
+      "solana_signMessage",
+      "solana_signAndSendTransaction"
+    ],
     events: []
   },
   bip122: {
@@ -129,11 +143,17 @@ function buildNamespace(chainId) {
     );
   }
   if (name === "eip155" && !(/^\d+$/.test(reference) && Number(reference) > 0)) {
-    throw new Error(`Invalid eip155 chain "${caip}" \u2014 the reference must be a positive integer.`);
+    throw new Error(
+      `Invalid eip155 chain "${caip}" \u2014 the reference must be a positive integer.`
+    );
   }
   return {
     name,
-    value: { chains: [caip], methods: defaults.methods, events: defaults.events }
+    value: {
+      chains: [caip],
+      methods: defaults.methods,
+      events: defaults.events
+    }
   };
 }
 
@@ -232,10 +252,15 @@ var WALLET_CATALOG = WALLETS.map((w) => ({
 }));
 
 // src/core/connector.ts
+function requestedChain(req) {
+  return req.namespace.value.chains?.[0];
+}
 var BaseConnector = class {
   constructor() {
     this.walletIds = [];
     this.handlers = /* @__PURE__ */ new Set();
+    /** Depth of in-flight connects; see {@link duringConnect}. */
+    this.connecting = 0;
   }
   servesNamespace(_namespaceName) {
     return true;
@@ -249,7 +274,28 @@ var BaseConnector = class {
     this.handlers.add(handler);
     return () => this.handlers.delete(handler);
   }
+  /**
+   * Run a connect with its handshake events suppressed.
+   *
+   * A connector that binds provider listeners before requesting accounts sees the
+   * wallet's own setup traffic — an initial `chainChanged`, and another when
+   * `ensureChain` switches. Forwarding those makes the host believe the user moved
+   * networks mid-connect. Nothing is lost by dropping them: connect() reads the
+   * authoritative account and chain when it settles, and only changes made after
+   * that are the user's.
+   */
+  async duringConnect(run) {
+    this.connecting++;
+    try {
+      return await run();
+    } finally {
+      this.connecting--;
+    }
+  }
   emit(event) {
+    if (this.connecting > 0 && (event.type === "chainChanged" || event.type === "accountsChanged")) {
+      return;
+    }
     for (const handler of this.handlers) handler(event);
   }
 };
@@ -259,6 +305,80 @@ function deriveUrl() {
   return typeof window !== "undefined" ? window.location.origin : "";
 }
 
+// src/connectors/eip155/chain.ts
+var CHAIN_SETTLE = { timeoutMs: 4e3, intervalMs: 100 };
+function toCaip(chainId) {
+  if (!chainId) return "eip155:1";
+  const num = chainId.startsWith("0x") ? parseInt(chainId, 16) : Number(chainId);
+  return `eip155:${Number.isFinite(num) ? num : 1}`;
+}
+async function currentChain(rpc2) {
+  const raw = await rpc2({ method: "eth_chainId" }).catch(() => null);
+  return toCaip(typeof raw === "string" ? raw : null);
+}
+async function settleChain({
+  rpc: rpc2,
+  chainId,
+  timeoutMs,
+  intervalMs
+}) {
+  const deadline = Date.now() + timeoutMs;
+  for (; ; ) {
+    const actual = await currentChain(rpc2);
+    if (actual === chainId || Date.now() >= deadline) return;
+    await new Promise((resolve) => setTimeout(resolve, intervalMs));
+  }
+}
+async function ensureChain({
+  rpc: rpc2,
+  chainId,
+  timeoutMs = CHAIN_SETTLE.timeoutMs,
+  intervalMs = CHAIN_SETTLE.intervalMs
+}) {
+  const chainNumber = chainId ? Number(chainId.split(":")[1]) : NaN;
+  if (!Number.isFinite(chainNumber) || chainNumber <= 0) return;
+  const requested = `eip155:${chainNumber}`;
+  if (await currentChain(rpc2) === requested) return;
+  const switched = await rpc2({
+    method: "wallet_switchEthereumChain",
+    params: [{ chainId: `0x${chainNumber.toString(16)}` }]
+  }).then(
+    () => true,
+    // Chain not added to the wallet, or the user declined — the caller's
+    // chainChanged will reflect reality. No settle: the chain isn't moving.
+    () => false
+  );
+  if (switched) {
+    await settleChain({ rpc: rpc2, chainId: requested, timeoutMs, intervalMs });
+  }
+}
+
+// src/core/abort.ts
+function withSignal(promise, signal, onAbort) {
+  if (!signal) return promise;
+  if (signal.aborted) {
+    onAbort?.();
+    return Promise.reject(new DOMException("Aborted", "AbortError"));
+  }
+  return new Promise((resolve, reject) => {
+    const abortHandler = () => {
+      onAbort?.();
+      reject(new DOMException("Aborted", "AbortError"));
+    };
+    signal.addEventListener("abort", abortHandler, { once: true });
+    promise.then(
+      (value) => {
+        signal.removeEventListener("abort", abortHandler);
+        resolve(value);
+      },
+      (error) => {
+        signal.removeEventListener("abort", abortHandler);
+        reject(error);
+      }
+    );
+  });
+}
+
 // src/connectors/metamask/connector.ts
 var WALLET_ID = "metamask";
 var MetaMaskConnector = class extends BaseConnector {
@@ -298,23 +418,41 @@ var MetaMaskConnector = class extends BaseConnector {
     if (this.listenersBound) return;
     this.listenersBound = true;
     provider.on("chainChanged", (hex) => {
-      this.emit({ type: "chainChanged", walletId: WALLET_ID, chainId: toCaip(String(hex)) });
+      this.emit({
+        type: "chainChanged",
+        walletId: WALLET_ID,
+        chainId: toCaip(String(hex))
+      });
     });
     provider.on("accountsChanged", (accounts) => {
       const account = Array.isArray(accounts) ? accounts[0] : void 0;
-      if (account) this.emit({ type: "accountsChanged", walletId: WALLET_ID, account });
+      if (account)
+        this.emit({ type: "accountsChanged", walletId: WALLET_ID, account });
       else this.emit({ type: "disconnect", walletId: WALLET_ID });
     });
-    provider.on("disconnect", () => this.emit({ type: "disconnect", walletId: WALLET_ID }));
+    provider.on(
+      "disconnect",
+      () => this.emit({ type: "disconnect", walletId: WALLET_ID })
+    );
   }
   async connect(req) {
-    const provider = await this.getProvider();
-    const accounts = await provider.request({ method: "eth_requestAccounts" });
-    const account = accounts?.[0];
-    if (!account) throw new Error("MetaMask returned no account");
-    await this.ensureChain(provider, req);
-    const chainId = toCaip(await provider.request({ method: "eth_chainId" }));
-    return this.toConnection(provider, account, chainId);
+    return this.duringConnect(async () => {
+      const provider = await this.getProvider();
+      const accounts = await withSignal(
+        provider.request({ method: "eth_requestAccounts" }),
+        req.signal
+      );
+      const account = accounts?.[0];
+      if (!account) throw new Error("MetaMask returned no account");
+      await ensureChain({
+        rpc: rpcFor(provider),
+        chainId: requestedChain(req)
+      });
+      const chainId = toCaip(
+        await provider.request({ method: "eth_chainId" })
+      );
+      return this.toConnection(provider, account, chainId);
+    });
   }
   async restore() {
     const provider = await this.getProvider().catch(() => null);
@@ -332,28 +470,15 @@ var MetaMaskConnector = class extends BaseConnector {
     this.provider = null;
     this.listenersBound = false;
   }
-  /** Best-effort switch to the requested chain; leaves the wallet as-is if it's unknown to it. */
-  async ensureChain(provider, req) {
-    const wanted = req.namespace.value.chains?.[0];
-    const wantedNum = wanted ? Number(wanted.split(":")[1]) : NaN;
-    if (!Number.isFinite(wantedNum) || wantedNum <= 0) return;
-    const current = parseInt(
-      await provider.request({ method: "eth_chainId" }).catch(() => "0x0") ?? "0x0",
-      16
-    );
-    if (current === wantedNum) return;
-    await provider.request({
-      method: "wallet_switchEthereumChain",
-      params: [{ chainId: `0x${wantedNum.toString(16)}` }]
-    }).catch(() => {
-    });
-  }
   toConnection(provider, account, chainId) {
     return {
       walletId: WALLET_ID,
       account,
       chainId,
-      request: async (args) => await provider.request({ method: args.method, params: args.params }),
+      request: async (args) => await provider.request({
+        method: args.method,
+        params: args.params
+      }),
       openWallet: () => {
       },
       // MetaMask SDK foregrounds the wallet on request
@@ -366,17 +491,18 @@ var MetaMaskConnector = class extends BaseConnector {
     };
   }
 };
-function toCaip(hexChainId) {
-  if (!hexChainId) return "eip155:1";
-  const num = hexChainId.startsWith("0x") ? parseInt(hexChainId, 16) : Number(hexChainId);
-  return `eip155:${Number.isFinite(num) ? num : 1}`;
+function rpcFor(provider) {
+  return (args) => provider.request(args);
 }
 
 // src/connectors/coinbase/connector.ts
+var WALLET_ID2 = "coinbase";
 function rpc(provider, method, params) {
-  return provider.request({ method, params });
+  return provider.request({
+    method,
+    params
+  });
 }
-var WALLET_ID2 = "coinbase";
 var CoinbaseConnector = class extends BaseConnector {
   constructor(app) {
     super();
@@ -410,31 +536,48 @@ var CoinbaseConnector = class extends BaseConnector {
     if (this.listenersBound) return;
     this.listenersBound = true;
     provider.on("chainChanged", (hex) => {
-      this.emit({ type: "chainChanged", walletId: WALLET_ID2, chainId: toCaip2(String(hex)) });
+      this.emit({
+        type: "chainChanged",
+        walletId: WALLET_ID2,
+        chainId: toCaip(String(hex))
+      });
     });
     provider.on("accountsChanged", (accounts) => {
       const account = Array.isArray(accounts) ? accounts[0] : void 0;
-      if (account) this.emit({ type: "accountsChanged", walletId: WALLET_ID2, account });
+      if (account)
+        this.emit({ type: "accountsChanged", walletId: WALLET_ID2, account });
       else this.emit({ type: "disconnect", walletId: WALLET_ID2 });
     });
-    provider.on("disconnect", () => this.emit({ type: "disconnect", walletId: WALLET_ID2 }));
+    provider.on(
+      "disconnect",
+      () => this.emit({ type: "disconnect", walletId: WALLET_ID2 })
+    );
   }
   async connect(req) {
-    const provider = await this.getProvider(evmChainIds(req));
-    const accounts = await rpc(provider, "eth_requestAccounts");
-    const account = accounts?.[0];
-    if (!account) throw new Error("Coinbase Wallet returned no account");
-    await this.ensureChain(provider, req);
-    const chainId = toCaip2(await rpc(provider, "eth_chainId"));
-    return this.toConnection(provider, account, chainId);
+    return this.duringConnect(async () => {
+      const provider = await this.getProvider(evmChainIds(req));
+      const accounts = await rpc(provider, "eth_requestAccounts");
+      const account = accounts?.[0];
+      if (!account) throw new Error("Coinbase Wallet returned no account");
+      await ensureChain({
+        rpc: rpcFor2(provider),
+        chainId: requestedChain(req)
+      });
+      const chainId = toCaip(await rpc(provider, "eth_chainId"));
+      return this.toConnection(provider, account, chainId);
+    });
   }
   async restore() {
     const provider = await this.getProvider().catch(() => null);
     if (!provider) return [];
-    const accounts = await rpc(provider, "eth_accounts").catch(() => []);
+    const accounts = await rpc(provider, "eth_accounts").catch(
+      () => []
+    );
     const account = accounts?.[0];
     if (!account) return [];
-    const chainId = toCaip2(await rpc(provider, "eth_chainId").catch(() => "0x1"));
+    const chainId = toCaip(
+      await rpc(provider, "eth_chainId").catch(() => "0x1")
+    );
     return [this.toConnection(provider, account, chainId)];
   }
   async reset() {
@@ -443,20 +586,6 @@ var CoinbaseConnector = class extends BaseConnector {
     this.provider = null;
     this.listenersBound = false;
   }
-  async ensureChain(provider, req) {
-    const wanted = req.namespace.value.chains?.[0];
-    const wantedNum = wanted ? Number(wanted.split(":")[1]) : NaN;
-    if (!Number.isFinite(wantedNum) || wantedNum <= 0) return;
-    const current = parseInt(
-      await rpc(provider, "eth_chainId").catch(() => "0x0") ?? "0x0",
-      16
-    );
-    if (current === wantedNum) return;
-    await rpc(provider, "wallet_switchEthereumChain", [{ chainId: `0x${wantedNum.toString(16)}` }]).catch(
-      () => {
-      }
-    );
-  }
   toConnection(provider, account, chainId) {
     return {
       walletId: WALLET_ID2,
@@ -476,10 +605,8 @@ var CoinbaseConnector = class extends BaseConnector {
     };
   }
 };
-function toCaip2(hexChainId) {
-  if (!hexChainId) return "eip155:1";
-  const num = hexChainId.startsWith("0x") ? parseInt(hexChainId, 16) : Number(hexChainId);
-  return `eip155:${Number.isFinite(num) ? num : 1}`;
+function rpcFor2(provider) {
+  return ({ method, params }) => rpc(provider, method, params);
 }
 function evmChainIds(req) {
   const wanted = req.namespace.value.chains?.[0];
@@ -513,7 +640,8 @@ var InjectedConnector = class extends BaseConnector {
     this.listening = true;
     window.addEventListener("eip6963:announceProvider", (event) => {
       const detail = event.detail;
-      if (detail?.info?.rdns && detail.provider) this.discovered.set(detail.info.rdns, detail);
+      if (detail?.info?.rdns && detail.provider)
+        this.discovered.set(detail.info.rdns, detail);
     });
     window.dispatchEvent(new Event("eip6963:requestProvider"));
   }
@@ -532,16 +660,20 @@ var InjectedConnector = class extends BaseConnector {
   }
   async connect(req) {
     const provider = this.providerFor(req.walletId);
-    if (!provider) throw new Error(`No injected provider announced for "${req.walletId}"`);
+    if (!provider)
+      throw new Error(`No injected provider announced for "${req.walletId}"`);
     const accounts = await withSignal(
       provider.request({ method: "eth_requestAccounts" }),
       // triggers the extension popup
       req.signal
     );
     const account = accounts?.[0];
-    if (!account) throw new Error(`${req.walletId} extension returned no account`);
-    await this.ensureChain(provider, req);
-    const chainId = toCaip3(await provider.request({ method: "eth_chainId" }));
+    if (!account)
+      throw new Error(`${req.walletId} extension returned no account`);
+    await ensureChain({ rpc: rpcFor3(provider), chainId: requestedChain(req) });
+    const chainId = toCaip(
+      await provider.request({ method: "eth_chainId" })
+    );
     this.bindEvents(provider, req.walletId);
     return this.toConnection(provider, req.walletId, account, chainId);
   }
@@ -558,7 +690,7 @@ var InjectedConnector = class extends BaseConnector {
       const accounts = await provider.request({ method: "eth_accounts" }).catch(() => []);
       const account = accounts?.[0];
       if (!account) continue;
-      const chainId = toCaip3(
+      const chainId = toCaip(
         await provider.request({ method: "eth_chainId" }).catch(() => "0x1")
       );
       this.bindEvents(provider, walletId);
@@ -574,133 +706,480 @@ var InjectedConnector = class extends BaseConnector {
     if (this.bound.has(provider)) return;
     this.bound.add(provider);
     provider.on("chainChanged", (hex) => {
-      this.emit({ type: "chainChanged", walletId, chainId: toCaip3(String(hex)) });
+      this.emit({
+        type: "chainChanged",
+        walletId,
+        chainId: toCaip(String(hex))
+      });
     });
     provider.on("accountsChanged", (accounts) => {
       const account = Array.isArray(accounts) ? accounts[0] : void 0;
       if (account) this.emit({ type: "accountsChanged", walletId, account });
       else this.emit({ type: "disconnect", walletId });
     });
-    provider.on("disconnect", () => this.emit({ type: "disconnect", walletId }));
-  }
-  /** Best-effort switch to the requested chain; leaves the wallet as-is if it's unknown to it. */
-  async ensureChain(provider, req) {
-    const wanted = req.namespace.value.chains?.[0];
-    const wantedNum = wanted ? Number(wanted.split(":")[1]) : NaN;
-    if (!Number.isFinite(wantedNum) || wantedNum <= 0) return;
-    const current = parseInt(
-      await provider.request({ method: "eth_chainId" }).catch(() => "0x0") ?? "0x0",
-      16
+    provider.on(
+      "disconnect",
+      () => this.emit({ type: "disconnect", walletId })
     );
-    if (current === wantedNum) return;
-    await provider.request({
-      method: "wallet_switchEthereumChain",
-      params: [{ chainId: `0x${wantedNum.toString(16)}` }]
-    }).catch(() => {
-    });
   }
   toConnection(provider, walletId, account, chainId) {
     return {
       walletId,
       account,
       chainId,
-      request: async (args) => await provider.request({ method: args.method, params: args.params }),
+      request: async (args) => await provider.request({
+        method: args.method,
+        params: args.params
+      }),
       openWallet: () => {
       },
       // the extension foregrounds its own popup on request
       disconnect: async () => {
-        await provider.request({ method: "wallet_revokePermissions", params: [{ eth_accounts: {} }] }).catch(() => {
+        await provider.request({
+          method: "wallet_revokePermissions",
+          params: [{ eth_accounts: {} }]
+        }).catch(() => {
         });
         this.emit({ type: "disconnect", walletId });
       }
     };
   }
 };
-function toCaip3(hexChainId) {
-  if (!hexChainId) return "eip155:1";
-  const num = hexChainId.startsWith("0x") ? parseInt(hexChainId, 16) : Number(hexChainId);
-  return `eip155:${Number.isFinite(num) ? num : 1}`;
-}
-function withSignal(promise, signal) {
-  if (!signal) return promise;
-  if (signal.aborted) return Promise.reject(new DOMException("Aborted", "AbortError"));
-  return new Promise((resolve, reject) => {
-    const onAbort = () => reject(new DOMException("Aborted", "AbortError"));
-    signal.addEventListener("abort", onAbort, { once: true });
-    promise.then(
-      (value) => {
-        signal.removeEventListener("abort", onAbort);
-        resolve(value);
-      },
-      (error) => {
-        signal.removeEventListener("abort", onAbort);
-        reject(error);
-      }
-    );
-  });
+function rpcFor3(provider) {
+  return (args) => provider.request(args);
 }
 
 // src/connectors/walletconnect/wallet-links.ts
 var WALLET_LINKS = {
-  metamask: { "native": "metamask://", "scheme": "metamask://wc", "universal": "https://metamask.app.link/wc", "store": { "ios": "https://apps.apple.com/us/app/metamask/id1438144202", "android": "https://play.google.com/store/apps/details?id=io.metamask" } },
-  trust: { "native": "trust://", "scheme": "trust://wc", "universal": "https://link.trustwallet.com/wc", "store": { "ios": "https://apps.apple.com/app/apple-store/id1288339409", "android": "https://play.google.com/store/apps/details?id=com.wallet.crypto.trustapp" } },
-  rainbow: { "native": "rainbow://", "scheme": "rainbow://wc", "universal": "https://rnbwapp.com/wc", "store": { "ios": "https://apps.apple.com/app/apple-store/id1457119021?pt=119997837&ct=wc&mt=8", "android": "https://play.google.com/store/apps/details?id=me.rainbow&referrer=utm_source%3Dwc%26utm_medium%3Dconnector%26utm_campaign%3Dwc" } },
-  coinbase: { "store": { "ios": "https://apps.apple.com/us/app/base-formerly-coinbase-wallet/id1278383455" } },
-  zerion: { "native": "zerion://", "scheme": "zerion://wc", "universal": "https://wallet.zerion.io/wc/wc", "store": { "ios": "https://apps.apple.com/app/id1456732565", "android": "https://play.google.com/store/apps/details?id=io.zerion.android&hl=en&gl=US" } },
-  tokenpocket: { "native": "tpoutside://", "scheme": "tpoutside://wc", "store": { "ios": "https://apps.apple.com/us/app/tp-wallet/id6444625622?l=en", "android": "https://play.google.com/store/apps/details?id=vip.mytokenpocket" } },
-  blockchaincom: { "native": "blockchain-wallet://", "scheme": "blockchain-wallet://wc", "universal": "https://login.blockchain.com/app/wc", "store": { "ios": "https://apps.apple.com/us/app/blockchain-bitcoin-wallet/id493253309", "android": "https://play.google.com/store/apps/details?id=piuk.blockchain.android" } },
-  exodus: { "native": "exodus://", "scheme": "exodus://wc", "universal": "https://exodus.com/m/wc", "store": { "ios": "https://apps.apple.com/us/app/exodus-crypto-bitcoin-wallet/id1414384820", "android": "https://play.google.com/store/apps/details?id=exodusmovement.exodus&hl=en&gl=US" } },
-  phantom: { "store": { "ios": "https://apps.apple.com/us/app/phantom-crypto-wallet/id1598432977", "android": "https://play.google.com/store/apps/details?id=app.phantom&hl=en" } },
-  okx: { "native": "okxwallet://main", "scheme": "okxwallet://main/wc", "store": { "ios": "https://apps.apple.com/us/app/okx-buy-bitcoin-eth-crypto/id1327268470", "android": "https://play.google.com/store/apps/details?id=com.okinc.okex.gp" } },
-  cryptocom: { "native": "cryptowallet://", "scheme": "cryptowallet://wc", "store": { "ios": "https://apps.apple.com/US/app/id1512048310?mt=8", "android": "https://play.google.com/store/apps/details?id=com.defi.wallet" } },
-  argent: { "native": "argent://app/", "scheme": "argent://app/wc", "universal": "https://www.argent.xyz/app/wc", "store": { "ios": "https://apps.apple.com/us/app/argent-defi-in-a-tap/id1358741926", "android": "https://play.google.com/store/apps/details?id=im.argent.contractwalletclient&hl=en&gl=US&pli=1" } },
-  safepal: { "native": "safepalwallet://", "scheme": "safepalwallet://wc", "universal": "https://link.safepal.io/wc", "store": { "ios": "https://apps.apple.com/app/safepal-wallet/id1548297139", "android": "https://play.google.com/store/apps/details?id=io.safepal.wallet" } },
-  imtoken: { "native": "imtokenv2://", "scheme": "imtokenv2://wc", "store": { "ios": "https://apps.apple.com/us/app/imtoken2/id1384798940", "android": "https://play.google.com/store/apps/details?id=im.token.app" } },
-  ronin: { "native": "roninwallet://", "scheme": "roninwallet://wc", "universal": "https://wallet.roninchain.com/wc", "store": { "ios": "https://apps.apple.com/us/app/ronin-wallet/id1592675001", "android": "https://play.google.com/store/apps/details?id=com.skymavis.genesis" } },
-  coin98: { "native": "coin98://", "scheme": "coin98://wc", "universal": "https://coin98.com/wc", "store": { "ios": "https://apps.apple.com/vn/app/coin98-wallet/id1561969966", "android": "https://play.google.com/store/apps/details?id=coin98.crypto.finance.media&hl=vi&gl=US" } },
-  bitkeep: { "native": "bitkeep://", "scheme": "bitkeep://wc", "universal": "https://bkapp.vip/wc", "store": { "ios": "https://web3.bitget.com/en/wallet-download?type=0", "android": "https://web3.bitget.com/en/wallet-download?type=0" } },
-  "1inch": { "native": "oneinch://open/nobodywilleveruseit", "scheme": "oneinch://open/nobodywilleveruseit/wc", "universal": "https://wallet.1inch.io/app/nobodywilleveruseit/wc", "store": { "ios": "https://apps.apple.com/us/app/1inch-defi-wallet/id1546049391", "android": "https://play.google.com/store/apps/details?id=io.oneinch.android" } },
-  ledgerlive: { "native": "ledgerlive://", "scheme": "ledgerlive://wc", "store": { "ios": "https://itunes.apple.com/app/id1361671700", "android": "https://play.google.com/store/apps/details?id=com.ledger.live" } },
-  atomic: { "native": "atomicwallet://", "scheme": "atomicwallet://wc", "store": { "ios": "https://apps.apple.com/us/app/atomic-wallet/id1478257827", "android": "https://play.google.com/store/apps/details?id=io.atomicwallet" } },
-  alpha: { "native": "awallet://", "scheme": "awallet://wc", "universal": "https://aw.app/wc", "store": { "ios": "https://apps.apple.com/us/app/alphawallet-eth-wallet/id1358230430", "android": "https://play.google.com/store/apps/details?id=io.stormbird.wallet" } },
-  math: { "native": "mathwallet://", "scheme": "mathwallet://wc", "universal": "https://www.mathwallet.org/wc", "store": { "ios": "https://apps.apple.com/us/app/mathwallet5/id1582612388", "android": "https://play.google.com/store/apps/details?id=com.mathwallet.android" } },
-  bitpay: { "native": "bitpay://", "scheme": "bitpay://wc", "universal": "https://link.bitpay.com/wc", "store": { "ios": "https://bitpay.onelink.me/Cenw/ejjaw7bs", "android": "https://bitpay.onelink.me/Cenw/ejjaw7bs" } },
-  rabby: { "native": "rabby://", "scheme": "rabby://wc", "store": { "ios": "https://apps.apple.com/us/app/rabby-wallet-crypto-evm/id6474381673", "android": "https://play.google.com/store/apps/details?id=com.debank.rabbymobile" } },
+  metamask: {
+    native: "metamask://",
+    scheme: "metamask://wc",
+    universal: "https://metamask.app.link/wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/metamask/id1438144202",
+      android: "https://play.google.com/store/apps/details?id=io.metamask"
+    }
+  },
+  trust: {
+    native: "trust://",
+    scheme: "trust://wc",
+    universal: "https://link.trustwallet.com/wc",
+    store: {
+      ios: "https://apps.apple.com/app/apple-store/id1288339409",
+      android: "https://play.google.com/store/apps/details?id=com.wallet.crypto.trustapp"
+    }
+  },
+  rainbow: {
+    native: "rainbow://",
+    scheme: "rainbow://wc",
+    universal: "https://rnbwapp.com/wc",
+    store: {
+      ios: "https://apps.apple.com/app/apple-store/id1457119021?pt=119997837&ct=wc&mt=8",
+      android: "https://play.google.com/store/apps/details?id=me.rainbow&referrer=utm_source%3Dwc%26utm_medium%3Dconnector%26utm_campaign%3Dwc"
+    }
+  },
+  coinbase: {
+    store: {
+      ios: "https://apps.apple.com/us/app/base-formerly-coinbase-wallet/id1278383455"
+    }
+  },
+  zerion: {
+    native: "zerion://",
+    scheme: "zerion://wc",
+    universal: "https://wallet.zerion.io/wc/wc",
+    store: {
+      ios: "https://apps.apple.com/app/id1456732565",
+      android: "https://play.google.com/store/apps/details?id=io.zerion.android&hl=en&gl=US"
+    }
+  },
+  tokenpocket: {
+    native: "tpoutside://",
+    scheme: "tpoutside://wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/tp-wallet/id6444625622?l=en",
+      android: "https://play.google.com/store/apps/details?id=vip.mytokenpocket"
+    }
+  },
+  blockchaincom: {
+    native: "blockchain-wallet://",
+    scheme: "blockchain-wallet://wc",
+    universal: "https://login.blockchain.com/app/wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/blockchain-bitcoin-wallet/id493253309",
+      android: "https://play.google.com/store/apps/details?id=piuk.blockchain.android"
+    }
+  },
+  exodus: {
+    native: "exodus://",
+    scheme: "exodus://wc",
+    universal: "https://exodus.com/m/wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/exodus-crypto-bitcoin-wallet/id1414384820",
+      android: "https://play.google.com/store/apps/details?id=exodusmovement.exodus&hl=en&gl=US"
+    }
+  },
+  phantom: {
+    store: {
+      ios: "https://apps.apple.com/us/app/phantom-crypto-wallet/id1598432977",
+      android: "https://play.google.com/store/apps/details?id=app.phantom&hl=en"
+    }
+  },
+  okx: {
+    native: "okxwallet://main",
+    scheme: "okxwallet://main/wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/okx-buy-bitcoin-eth-crypto/id1327268470",
+      android: "https://play.google.com/store/apps/details?id=com.okinc.okex.gp"
+    }
+  },
+  cryptocom: {
+    native: "cryptowallet://",
+    scheme: "cryptowallet://wc",
+    store: {
+      ios: "https://apps.apple.com/US/app/id1512048310?mt=8",
+      android: "https://play.google.com/store/apps/details?id=com.defi.wallet"
+    }
+  },
+  argent: {
+    native: "argent://app/",
+    scheme: "argent://app/wc",
+    universal: "https://www.argent.xyz/app/wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/argent-defi-in-a-tap/id1358741926",
+      android: "https://play.google.com/store/apps/details?id=im.argent.contractwalletclient&hl=en&gl=US&pli=1"
+    }
+  },
+  safepal: {
+    native: "safepalwallet://",
+    scheme: "safepalwallet://wc",
+    universal: "https://link.safepal.io/wc",
+    store: {
+      ios: "https://apps.apple.com/app/safepal-wallet/id1548297139",
+      android: "https://play.google.com/store/apps/details?id=io.safepal.wallet"
+    }
+  },
+  imtoken: {
+    native: "imtokenv2://",
+    scheme: "imtokenv2://wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/imtoken2/id1384798940",
+      android: "https://play.google.com/store/apps/details?id=im.token.app"
+    }
+  },
+  ronin: {
+    native: "roninwallet://",
+    scheme: "roninwallet://wc",
+    universal: "https://wallet.roninchain.com/wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/ronin-wallet/id1592675001",
+      android: "https://play.google.com/store/apps/details?id=com.skymavis.genesis"
+    }
+  },
+  coin98: {
+    native: "coin98://",
+    scheme: "coin98://wc",
+    universal: "https://coin98.com/wc",
+    store: {
+      ios: "https://apps.apple.com/vn/app/coin98-wallet/id1561969966",
+      android: "https://play.google.com/store/apps/details?id=coin98.crypto.finance.media&hl=vi&gl=US"
+    }
+  },
+  bitkeep: {
+    native: "bitkeep://",
+    scheme: "bitkeep://wc",
+    universal: "https://bkapp.vip/wc",
+    store: {
+      ios: "https://web3.bitget.com/en/wallet-download?type=0",
+      android: "https://web3.bitget.com/en/wallet-download?type=0"
+    }
+  },
+  "1inch": {
+    native: "oneinch://open/nobodywilleveruseit",
+    scheme: "oneinch://open/nobodywilleveruseit/wc",
+    universal: "https://wallet.1inch.io/app/nobodywilleveruseit/wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/1inch-defi-wallet/id1546049391",
+      android: "https://play.google.com/store/apps/details?id=io.oneinch.android"
+    }
+  },
+  ledgerlive: {
+    native: "ledgerlive://",
+    scheme: "ledgerlive://wc",
+    store: {
+      ios: "https://itunes.apple.com/app/id1361671700",
+      android: "https://play.google.com/store/apps/details?id=com.ledger.live"
+    }
+  },
+  atomic: {
+    native: "atomicwallet://",
+    scheme: "atomicwallet://wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/atomic-wallet/id1478257827",
+      android: "https://play.google.com/store/apps/details?id=io.atomicwallet"
+    }
+  },
+  alpha: {
+    native: "awallet://",
+    scheme: "awallet://wc",
+    universal: "https://aw.app/wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/alphawallet-eth-wallet/id1358230430",
+      android: "https://play.google.com/store/apps/details?id=io.stormbird.wallet"
+    }
+  },
+  math: {
+    native: "mathwallet://",
+    scheme: "mathwallet://wc",
+    universal: "https://www.mathwallet.org/wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/mathwallet5/id1582612388",
+      android: "https://play.google.com/store/apps/details?id=com.mathwallet.android"
+    }
+  },
+  bitpay: {
+    native: "bitpay://",
+    scheme: "bitpay://wc",
+    universal: "https://link.bitpay.com/wc",
+    store: {
+      ios: "https://bitpay.onelink.me/Cenw/ejjaw7bs",
+      android: "https://bitpay.onelink.me/Cenw/ejjaw7bs"
+    }
+  },
+  rabby: {
+    native: "rabby://",
+    scheme: "rabby://wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/rabby-wallet-crypto-evm/id6474381673",
+      android: "https://play.google.com/store/apps/details?id=com.debank.rabbymobile"
+    }
+  },
   // Bybit's WC deep link nests the uri inside a targetUrl wrapper (bybitapp://open/route?targetUrl=by://web3/walletconnect/wc?uri=...), which the `${scheme}?uri=` builder can't express — QR/scan connect only.
-  bybit: { "store": { "ios": "https://apps.apple.com/us/app/bybit-buy-trade-crypto/id1488296980", "android": "https://play.google.com/store/apps/details?id=com.bybit.app" } },
-  binance: { "native": "bnc://app.binance.com/cedefi/", "scheme": "bnc://app.binance.com/cedefi/wc", "store": { "ios": "https://apps.apple.com/us/app/id1436799971", "android": "https://play.google.com/store/apps/details?id=com.binance.dev" } },
-  gate: { "native": "gtweb3wallet://", "scheme": "gtweb3wallet://wc", "store": { "ios": "https://apps.apple.com/us/app/gate-io-buy-bitcoin-crypto/id1294998195", "android": "https://play.google.com/store/apps/details?id=com.gateio.gateio" } },
+  bybit: {
+    store: {
+      ios: "https://apps.apple.com/us/app/bybit-buy-trade-crypto/id1488296980",
+      android: "https://play.google.com/store/apps/details?id=com.bybit.app"
+    }
+  },
+  binance: {
+    native: "bnc://app.binance.com/cedefi/",
+    scheme: "bnc://app.binance.com/cedefi/wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/id1436799971",
+      android: "https://play.google.com/store/apps/details?id=com.binance.dev"
+    }
+  },
+  gate: {
+    native: "gtweb3wallet://",
+    scheme: "gtweb3wallet://wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/gate-io-buy-bitcoin-crypto/id1294998195",
+      android: "https://play.google.com/store/apps/details?id=com.gateio.gateio"
+    }
+  },
   // Core: `core://` scheme not corroborated to 2 sources — QR/scan connect only.
-  core: { "store": { "ios": "https://apps.apple.com/us/app/core-wallet/id6443685999", "android": "https://play.google.com/store/apps/details?id=com.avaxwallet" } },
+  core: {
+    store: {
+      ios: "https://apps.apple.com/us/app/core-wallet/id6443685999",
+      android: "https://play.google.com/store/apps/details?id=com.avaxwallet"
+    }
+  },
   // Backpack: `backpack://` scheme not corroborated to 2 sources — QR/scan connect only.
-  backpack: { "store": { "ios": "https://apps.apple.com/us/app/backpack-wallet-exchange/id6445964121", "android": "https://play.google.com/store/apps/details?id=app.backpack.mobile" } },
-  frontier: { "native": "frontier://", "scheme": "frontier://wc", "store": { "ios": "https://apps.apple.com/us/app/frontier-crypto-defi-wallet/id1482380988", "android": "https://play.google.com/store/apps/details?id=com.frontierwallet" } },
-  onekey: { "native": "onekey-wallet://", "scheme": "onekey-wallet://wc", "store": { "ios": "https://apps.apple.com/us/app/onekey-open-source-wallet/id1609559473", "android": "https://play.google.com/store/apps/details?id=so.onekey.app.wallet" } },
-  kraken: { "native": "krakenwallet://", "scheme": "krakenwallet://wc", "store": { "ios": "https://apps.apple.com/us/app/kraken-wallet/id1626327149", "android": "https://play.google.com/store/apps/details?id=com.kraken.superwallet" } },
-  uniswap: { "native": "uniswap://", "scheme": "uniswap://wc", "store": { "ios": "https://apps.apple.com/us/app/uniswap-crypto-nft-wallet/id6443944476", "android": "https://play.google.com/store/apps/details?id=com.uniswap.mobile" } },
-  omni: { "native": "omni://", "scheme": "omni://wc", "store": { "ios": "https://apps.apple.com/us/app/omni-web3-wallet/id1569375204", "android": "https://play.google.com/store/apps/details?id=fi.steakwallet.app" } },
-  mew: { "universal": "https://mewwallet.com/wc", "store": { "ios": "https://apps.apple.com/app/id1464614025", "android": "https://play.google.com/store/apps/details?id=com.myetherwallet.mewwallet" } },
-  foxwallet: { "native": "foxwallet://", "scheme": "foxwallet://wc", "universal": "https://link.foxwallet.com/wc", "store": { "ios": "https://apps.apple.com/app/foxwallet-crypto-web3/id1590983231", "android": "https://play.google.com/store/apps/details?id=com.foxwallet.play" } },
-  nova: { "native": "novawallet://", "scheme": "novawallet://wc", "store": { "ios": "https://apps.apple.com/us/app/nova-polkadot-wallet/id1597119355", "android": "https://play.google.com/store/apps/details?id=io.novafoundation.nova.market" } },
-  subwallet: { "native": "subwallet://", "scheme": "subwallet://wc", "store": { "ios": "https://apps.apple.com/us/app/subwallet-polkadot-wallet/id1633050285", "android": "https://play.google.com/store/apps/details?id=app.subwallet.mobile" } },
-  safe: { "native": "safe://", "scheme": "safe://wc", "store": { "ios": "https://apps.apple.com/us/app/safe-mobile/id6748754793", "android": "https://play.google.com/store/apps/details?id=global.safe.mobileapp" } },
-  robinhood: { "native": "robinhood-wallet://", "scheme": "robinhood-wallet://wc", "store": { "ios": "https://apps.apple.com/us/app/robinhood-wallet-swap-crypto/id1634080733", "android": "https://play.google.com/store/apps/details?id=com.robinhood.gateway" } },
-  tangem: { "native": "tangem://", "scheme": "tangem://wc", "store": { "ios": "https://apps.apple.com/app/tangem/id1354868448", "android": "https://play.google.com/store/apps/details?id=com.tangem.wallet" } },
+  backpack: {
+    store: {
+      ios: "https://apps.apple.com/us/app/backpack-wallet-exchange/id6445964121",
+      android: "https://play.google.com/store/apps/details?id=app.backpack.mobile"
+    }
+  },
+  frontier: {
+    native: "frontier://",
+    scheme: "frontier://wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/frontier-crypto-defi-wallet/id1482380988",
+      android: "https://play.google.com/store/apps/details?id=com.frontierwallet"
+    }
+  },
+  onekey: {
+    native: "onekey-wallet://",
+    scheme: "onekey-wallet://wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/onekey-open-source-wallet/id1609559473",
+      android: "https://play.google.com/store/apps/details?id=so.onekey.app.wallet"
+    }
+  },
+  kraken: {
+    native: "krakenwallet://",
+    scheme: "krakenwallet://wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/kraken-wallet/id1626327149",
+      android: "https://play.google.com/store/apps/details?id=com.kraken.superwallet"
+    }
+  },
+  uniswap: {
+    native: "uniswap://",
+    scheme: "uniswap://wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/uniswap-crypto-nft-wallet/id6443944476",
+      android: "https://play.google.com/store/apps/details?id=com.uniswap.mobile"
+    }
+  },
+  omni: {
+    native: "omni://",
+    scheme: "omni://wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/omni-web3-wallet/id1569375204",
+      android: "https://play.google.com/store/apps/details?id=fi.steakwallet.app"
+    }
+  },
+  mew: {
+    universal: "https://mewwallet.com/wc",
+    store: {
+      ios: "https://apps.apple.com/app/id1464614025",
+      android: "https://play.google.com/store/apps/details?id=com.myetherwallet.mewwallet"
+    }
+  },
+  foxwallet: {
+    native: "foxwallet://",
+    scheme: "foxwallet://wc",
+    universal: "https://link.foxwallet.com/wc",
+    store: {
+      ios: "https://apps.apple.com/app/foxwallet-crypto-web3/id1590983231",
+      android: "https://play.google.com/store/apps/details?id=com.foxwallet.play"
+    }
+  },
+  nova: {
+    native: "novawallet://",
+    scheme: "novawallet://wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/nova-polkadot-wallet/id1597119355",
+      android: "https://play.google.com/store/apps/details?id=io.novafoundation.nova.market"
+    }
+  },
+  subwallet: {
+    native: "subwallet://",
+    scheme: "subwallet://wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/subwallet-polkadot-wallet/id1633050285",
+      android: "https://play.google.com/store/apps/details?id=app.subwallet.mobile"
+    }
+  },
+  safe: {
+    native: "safe://",
+    scheme: "safe://wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/safe-mobile/id6748754793",
+      android: "https://play.google.com/store/apps/details?id=global.safe.mobileapp"
+    }
+  },
+  robinhood: {
+    native: "robinhood-wallet://",
+    scheme: "robinhood-wallet://wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/robinhood-wallet-swap-crypto/id1634080733",
+      android: "https://play.google.com/store/apps/details?id=com.robinhood.gateway"
+    }
+  },
+  tangem: {
+    native: "tangem://",
+    scheme: "tangem://wc",
+    store: {
+      ios: "https://apps.apple.com/app/tangem/id1354868448",
+      android: "https://play.google.com/store/apps/details?id=com.tangem.wallet"
+    }
+  },
   // Trezor Suite: WalletConnect pairing is QR/paste-into-Suite (no corroborated custom scheme) — QR connect only.
-  trezor: { "store": { "ios": "https://apps.apple.com/us/app/trezor-suite/id1631884497", "android": "https://play.google.com/store/apps/details?id=io.trezor.suite" } },
-  kucoin: { "native": "kucoin://", "scheme": "kucoin:///wallet/walletConnect", "store": { "ios": "https://apps.apple.com/app/kucoin-buy-bitcoin-crypto/id1378956601", "android": "https://play.google.com/store/apps/details?id=com.kubi.kucoin" } },
+  trezor: {
+    store: {
+      ios: "https://apps.apple.com/us/app/trezor-suite/id1631884497",
+      android: "https://play.google.com/store/apps/details?id=io.trezor.suite"
+    }
+  },
+  kucoin: {
+    native: "kucoin://",
+    scheme: "kucoin:///wallet/walletConnect",
+    store: {
+      ios: "https://apps.apple.com/app/kucoin-buy-bitcoin-crypto/id1378956601",
+      android: "https://play.google.com/store/apps/details?id=com.kubi.kucoin"
+    }
+  },
   // Jupiter (Solana): no corroborated WC deep-link scheme — QR connect only.
-  jupiter: { "store": { "ios": "https://apps.apple.com/us/app/jupiter-solana-swap-wallet/id6484069059", "android": "https://play.google.com/store/apps/details?id=ag.jup.jupiter.android" } },
-  zengo: { "native": "zengo://get.zengo.com/", "scheme": "zengo://get.zengo.com/wc", "store": { "ios": "https://apps.apple.com/us/app/zengo-crypto-bitcoin-wallet/id1440147115", "android": "https://play.google.com/store/apps/details?id=com.zengo.wallet" } },
+  jupiter: {
+    store: {
+      ios: "https://apps.apple.com/us/app/jupiter-solana-swap-wallet/id6484069059",
+      android: "https://play.google.com/store/apps/details?id=ag.jup.jupiter.android"
+    }
+  },
+  zengo: {
+    native: "zengo://get.zengo.com/",
+    scheme: "zengo://get.zengo.com/wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/zengo-crypto-bitcoin-wallet/id1440147115",
+      android: "https://play.google.com/store/apps/details?id=com.zengo.wallet"
+    }
+  },
   // Bitcoin.com Wallet: no corroborated WC deep-link scheme — QR connect only.
-  bitcoincom: { "store": { "ios": "https://apps.apple.com/us/app/bitcoin-wallet-by-bitcoin-com/id1252903728", "android": "https://play.google.com/store/apps/details?id=com.bitcoin.mwallet" } },
-  keplr: { "native": "keplrwallet://", "scheme": "keplrwallet://wcV2", "store": { "ios": "https://apps.apple.com/us/app/keplr-wallet/id1567851089", "android": "https://play.google.com/store/apps/details?id=com.chainapsis.keplr" } },
-  cake: { "native": "cakewallet://", "scheme": "cakewallet://wc", "store": { "ios": "https://apps.apple.com/us/app/cake-wallet/id1334702542", "android": "https://play.google.com/store/apps/details?id=com.cakewallet.cake_wallet" } },
-  unstoppable: { "native": "unstoppable.money://", "scheme": "unstoppable.money://wc", "store": { "ios": "https://apps.apple.com/us/app/unstoppable-crypto-wallet/id1447619907", "android": "https://play.google.com/store/apps/details?id=io.horizontalsystems.bankwallet" } },
-  bifrost: { "native": "bifrostwallet://", "scheme": "bifrostwallet://wc", "store": { "ios": "https://apps.apple.com/us/app/bifrost-wallet/id1577198351", "android": "https://play.google.com/store/apps/details?id=com.bifrostwallet.app" } },
-  pintu: { "native": "pintu://web3wallet", "scheme": "pintu://web3wallet/wc", "store": { "ios": "https://apps.apple.com/id/app/pintu-buy-invest-crypto/id1494119678", "android": "https://play.google.com/store/apps/details?id=com.valar.pintu" } },
-  hot: { "native": "hotwallet://", "scheme": "hotwallet://wc", "store": { "ios": "https://apps.apple.com/us/app/hot-wallet/id6740916148", "android": "https://play.google.com/store/apps/details?id=app.herewallet.hot" } },
-  arculus: { "native": "arculuswc://", "scheme": "arculuswc://wc", "universal": "https://gw.arculus.co/app/wc", "store": { "ios": "https://apps.apple.com/us/app/arculus-wallet/id1575425801", "android": "https://play.google.com/store/apps/details?id=co.arculus.wallet.android" } }
+  bitcoincom: {
+    store: {
+      ios: "https://apps.apple.com/us/app/bitcoin-wallet-by-bitcoin-com/id1252903728",
+      android: "https://play.google.com/store/apps/details?id=com.bitcoin.mwallet"
+    }
+  },
+  keplr: {
+    native: "keplrwallet://",
+    scheme: "keplrwallet://wcV2",
+    store: {
+      ios: "https://apps.apple.com/us/app/keplr-wallet/id1567851089",
+      android: "https://play.google.com/store/apps/details?id=com.chainapsis.keplr"
+    }
+  },
+  cake: {
+    native: "cakewallet://",
+    scheme: "cakewallet://wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/cake-wallet/id1334702542",
+      android: "https://play.google.com/store/apps/details?id=com.cakewallet.cake_wallet"
+    }
+  },
+  unstoppable: {
+    native: "unstoppable.money://",
+    scheme: "unstoppable.money://wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/unstoppable-crypto-wallet/id1447619907",
+      android: "https://play.google.com/store/apps/details?id=io.horizontalsystems.bankwallet"
+    }
+  },
+  bifrost: {
+    native: "bifrostwallet://",
+    scheme: "bifrostwallet://wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/bifrost-wallet/id1577198351",
+      android: "https://play.google.com/store/apps/details?id=com.bifrostwallet.app"
+    }
+  },
+  pintu: {
+    native: "pintu://web3wallet",
+    scheme: "pintu://web3wallet/wc",
+    store: {
+      ios: "https://apps.apple.com/id/app/pintu-buy-invest-crypto/id1494119678",
+      android: "https://play.google.com/store/apps/details?id=com.valar.pintu"
+    }
+  },
+  hot: {
+    native: "hotwallet://",
+    scheme: "hotwallet://wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/hot-wallet/id6740916148",
+      android: "https://play.google.com/store/apps/details?id=app.herewallet.hot"
+    }
+  },
+  arculus: {
+    native: "arculuswc://",
+    scheme: "arculuswc://wc",
+    universal: "https://gw.arculus.co/app/wc",
+    store: {
+      ios: "https://apps.apple.com/us/app/arculus-wallet/id1575425801",
+      android: "https://play.google.com/store/apps/details?id=co.arculus.wallet.android"
+    }
+  }
 };
 
 // src/connectors/walletconnect/registry.ts
@@ -717,13 +1196,15 @@ function buildLink(base, uri) {
   const sep = base.includes("?") ? "&" : "?";
   return `${base}${sep}uri=${encodeURIComponent(uri)}`;
 }
-function openWallet(link, uri) {
-  if (typeof document === "undefined") return;
-  if (link.scheme) {
-    openHref(buildLink(link.scheme, uri));
-  } else if (link.universal) {
-    openHref(buildLink(link.universal, uri));
-  }
+function canOpen(link) {
+  return !!(link?.scheme || link?.universal);
+}
+function openWallet(link, uri, via = "scheme") {
+  if (typeof document === "undefined") return false;
+  const base = via === "universal" ? link.universal : link.scheme ?? link.universal;
+  if (!base) return false;
+  openHref(buildLink(base, uri));
+  return true;
 }
 function openWalletApp(link) {
   if (typeof document === "undefined") return;
@@ -762,6 +1243,7 @@ function detectAppOpen(timeoutMs) {
 
 // src/connectors/walletconnect/connector.ts
 var STORAGE_KEY = "lydianconnect.wc.topics";
+var PING_TIMEOUT_MS = 3e3;
 var WalletConnectConnector = class extends BaseConnector {
   constructor(app, options) {
     super();
@@ -772,6 +1254,9 @@ var WalletConnectConnector = class extends BaseConnector {
     // claims any wallet not served by an SDK connector
     this.client = null;
     this.topics = /* @__PURE__ */ new Map();
+    /** walletId -> pairing URI of the connect currently awaiting approval, so a
+     *  host-driven open button can fire without the host tracking the URI itself. */
+    this.pending = /* @__PURE__ */ new Map();
     this.links = { ...DEFAULT_WALLET_LINKS, ...options.walletLinks ?? {} };
   }
   isAvailable() {
@@ -815,43 +1300,71 @@ var WalletConnectConnector = class extends BaseConnector {
   }
   async connect(req) {
     const client = await this.getClient();
-    const reused = this.tryReuse(client, req);
+    const reused = await this.tryReuse(client, req);
     if (reused) return reused;
     const { uri, approval } = await client.connect({
       requiredNamespaces: { [req.namespace.name]: req.namespace.value }
     });
     if (!uri) throw new Error("WalletConnect did not return a pairing URI");
-    this.emit({ type: "display_uri", walletId: req.walletId, uri });
-    if (isMobile()) {
-      const link = this.links[req.walletId];
-      if (link) {
-        openWallet(link, uri);
-        void detectAppOpen(this.options.openTimeoutMs ?? 2e3).then((opened) => {
-          if (!opened)
-            this.emit({
-              type: "wallet_open_failed",
-              walletId: req.walletId,
-              uri,
-              store: link.store
-            });
-        });
-      }
+    const link = isMobile() ? this.links[req.walletId] : void 0;
+    this.emit({
+      type: "display_uri",
+      walletId: req.walletId,
+      uri,
+      deepLink: canOpen(link)
+    });
+    if (link && canOpen(link)) {
+      this.pending.set(req.walletId, uri);
+      openWallet(link, uri);
+      void detectAppOpen(this.options.openTimeoutMs ?? 2e3).then((opened) => {
+        if (!opened)
+          this.emit({
+            type: "wallet_open_failed",
+            walletId: req.walletId,
+            uri,
+            store: link.store
+          });
+      });
     }
     const pairingTopic = utils.parseUri(uri).topic;
-    const session = await withSignal2(approval(), req.signal, () => {
+    const session = await withSignal(approval(), req.signal, () => {
       void client.core.pairing.disconnect({ topic: pairingTopic }).catch(() => {
       });
-    });
-    const connection = this.toConnection(client, req.walletId, session, req.namespace);
+    }).finally(() => this.pending.delete(req.walletId));
+    const connection = this.toConnection(
+      client,
+      req.walletId,
+      session,
+      req.namespace
+    );
     this.topics.set(req.walletId, session.topic);
     this.persist();
     return connection;
   }
+  /**
+   * Fire a wallet's deep link on demand. The host calls this from a real click,
+   * which is the one context a mobile browser reliably allows a scheme
+   * navigation from — see the note on {@link openWallet}.
+   */
+  openWallet(input) {
+    const link = this.links[input.walletId];
+    if (!link) return false;
+    const uri = input.uri ?? this.pending.get(input.walletId);
+    if (!uri) {
+      openWalletApp(link);
+      return !!link.native;
+    }
+    return openWallet(link, uri, input.via ?? "scheme");
+  }
   async restore() {
     const client = await this.getClient();
+    const checked = await Promise.all(
+      [...this.topics].map(
+        async ([walletId, topic]) => [walletId, await this.liveSession(client, topic)]
+      )
+    );
     const out = [];
-    for (const [walletId, topic] of [...this.topics]) {
-      const session = this.liveSession(client, topic);
+    for (const [walletId, session] of checked) {
       if (!session) {
         this.topics.delete(walletId);
         continue;
@@ -866,19 +1379,26 @@ var WalletConnectConnector = class extends BaseConnector {
     const client = this.client;
     if (client) {
       await Promise.allSettled(
-        client.session.getAll().map((s) => client.disconnect({ topic: s.topic, reason: utils.getSdkError("USER_DISCONNECTED") }))
+        client.session.getAll().map(
+          (s) => client.disconnect({
+            topic: s.topic,
+            reason: utils.getSdkError("USER_DISCONNECTED")
+          })
+        )
       );
     }
     this.topics.clear();
+    this.pending.clear();
     this.persist();
   }
   // --- helpers ---
-  tryReuse(client, req) {
+  async tryReuse(client, req) {
     const topic = this.topics.get(req.walletId);
     if (!topic) return null;
-    const session = this.liveSession(client, topic);
+    const session = await this.liveSession(client, topic);
     if (!session) {
       this.topics.delete(req.walletId);
+      this.persist();
       return null;
     }
     const ns = session.namespaces[req.namespace.name];
@@ -889,7 +1409,9 @@ var WalletConnectConnector = class extends BaseConnector {
   toConnection(client, walletId, session, namespace) {
     const ns = session.namespaces[namespace.name];
     const account = (ns?.accounts ?? []).map((a) => a.split(":")[2]).find((a) => !!a) ?? "";
-    const chainId = ns?.chains?.[0] ?? (ns?.accounts?.[0] ? ns.accounts[0].split(":").slice(0, 2).join(":") : `${namespace.name}:1`);
+    const approved = ns?.chains?.length ? ns.chains : (ns?.accounts ?? []).map((a) => a.split(":").slice(0, 2).join(":"));
+    const wanted = namespace.value.chains?.[0];
+    const chainId = wanted && approved.includes(wanted) ? wanted : approved[0] ?? `${namespace.name}:1`;
     const topic = session.topic;
     return {
       walletId,
@@ -914,12 +1436,27 @@ var WalletConnectConnector = class extends BaseConnector {
       }
     };
   }
-  liveSession(client, topic) {
+  /**
+   * A stored session the wallet is still on the other end of. The local record
+   * is not evidence — it survives the user clearing the dApp inside their
+   * wallet — and reusing a dead one returns a Connection that looks healthy
+   * while every request hangs. So the peer has to answer for it.
+   */
+  async liveSession(client, topic) {
+    let session;
     try {
-      return client.session.get(topic);
+      session = client.session.get(topic);
     } catch {
       return void 0;
     }
+    let timer;
+    const alive = await Promise.race([
+      client.ping({ topic }).then(() => true).catch(() => false),
+      new Promise((resolve) => {
+        timer = setTimeout(() => resolve(false), PING_TIMEOUT_MS);
+      })
+    ]).finally(() => clearTimeout(timer));
+    return alive ? session : void 0;
   }
   walletForTopic(topic) {
     for (const [walletId, t] of this.topics) if (t === topic) return walletId;
@@ -934,7 +1471,8 @@ var WalletConnectConnector = class extends BaseConnector {
   load() {
     try {
       const raw = localStorage.getItem(STORAGE_KEY);
-      if (raw) this.topics = new Map(JSON.parse(raw));
+      if (raw)
+        this.topics = new Map(JSON.parse(raw));
     } catch {
     }
   }
@@ -944,38 +1482,18 @@ function firstNamespace(session) {
   if (!name) return null;
   const v = session.namespaces[name];
   if (!v) return null;
-  return { name, value: { chains: v.chains, methods: v.methods, events: v.events } };
-}
-function withSignal2(promise, signal, onAbort) {
-  if (!signal) return promise;
-  if (signal.aborted) {
-    onAbort();
-    return Promise.reject(new DOMException("Aborted", "AbortError"));
-  }
-  return new Promise((resolve, reject) => {
-    const abortHandler = () => {
-      onAbort();
-      reject(new DOMException("Aborted", "AbortError"));
-    };
-    signal.addEventListener("abort", abortHandler, { once: true });
-    promise.then(
-      (v) => {
-        signal.removeEventListener("abort", abortHandler);
-        resolve(v);
-      },
-      (e) => {
-        signal.removeEventListener("abort", abortHandler);
-        reject(e);
-      }
-    );
-  });
+  return {
+    name,
+    value: { chains: v.chains, methods: v.methods, events: v.events }
+  };
 }
 
 // src/core/lydian-connect.ts
 function injectedRdnsMap(sdkServed) {
   const map = {};
   for (const w of WALLET_CATALOG) {
-    if (w.rdns && w.namespaces.includes("eip155") && !sdkServed.has(w.id)) map[w.id] = w.rdns;
+    if (w.rdns && w.namespaces.includes("eip155") && !sdkServed.has(w.id))
+      map[w.id] = w.rdns;
   }
   return map;
 }
@@ -990,7 +1508,9 @@ function createConnectors(config) {
   return [
     ...sdk,
     new InjectedConnector(injectedRdnsMap(sdkServed)),
-    new WalletConnectConnector(app, { projectId: config.walletConnectProjectId })
+    new WalletConnectConnector(app, {
+      projectId: config.walletConnectProjectId
+    })
   ];
 }
 var LydianConnect = class {
@@ -1002,7 +1522,9 @@ var LydianConnect = class {
   }
   async connect(input) {
     if (input.chainId === void 0 || input.chainId === null) {
-      throw new Error('connect() requires a chainId (a number like 137 or an "eip155:<id>" string)');
+      throw new Error(
+        'connect() requires a chainId (a number like 137 or an "eip155:<id>" string)'
+      );
     }
     return this.manager.connect({
       walletId: input.walletId,
@@ -1010,6 +1532,20 @@ var LydianConnect = class {
       signal: input.signal
     });
   }
+  /**
+   * Open a wallet app, optionally handing it the pairing URI from `display_uri`.
+   *
+   * Call this from a real click handler. A mobile browser will suppress the same
+   * navigation issued automatically after an async step, which is why the
+   * `display_uri` event reports `deepLink` — that is the library asking the host
+   * for a button to put this behind.
+   *
+   * Returns whether a link was fired. `false` means nothing is known for this
+   * wallet on this device; show the QR code instead.
+   */
+  openWallet(input) {
+    return this.manager.openWallet(input);
+  }
   restore() {
     return this.manager.restore();
   }