@satoshai/kit 0.7.0 → 0.8.1

package/dist/index.js

@@ -7,6 +7,7 @@ import { getPrimaryName } from 'bns-v2-sdk';
 // src/errors.ts
 var BaseError = class extends Error {
   name = "StacksKitError";
+  /** Short, human-readable error summary without details or cause chain. */
   shortMessage;
   constructor(shortMessage, options) {
     const message = [
@@ -16,6 +17,10 @@ var BaseError = class extends Error {
     super(message, options?.cause ? { cause: options.cause } : void 0);
     this.shortMessage = shortMessage;
   }
+  /**
+   * Walk the error cause chain. If `fn` is provided, returns the first error
+   * where `fn` returns `true`; otherwise returns the root cause.
+   */
   walk(fn) {
     return walk(this, fn);
   }
@@ -35,6 +40,7 @@ var WalletNotConnectedError = class extends BaseError {
 };
 var WalletNotFoundError = class extends BaseError {
   name = "WalletNotFoundError";
+  /** The wallet ID that was not found. */
   wallet;
   constructor({ wallet }) {
     super(`${wallet} wallet not found`, {
@@ -45,7 +51,9 @@ var WalletNotFoundError = class extends BaseError {
 };
 var UnsupportedMethodError = class extends BaseError {
   name = "UnsupportedMethodError";
+  /** The SIP-030 method name that is not supported. */
   method;
+  /** The wallet that does not support the method. */
   wallet;
   constructor({ method, wallet }) {
     super(`${method} is not supported by ${wallet} wallet`);
@@ -55,7 +63,9 @@ var UnsupportedMethodError = class extends BaseError {
 };
 var WalletRequestError = class extends BaseError {
   name = "WalletRequestError";
+  /** The SIP-030 method name that failed. */
   method;
+  /** The wallet that returned the error. */
   wallet;
   constructor({ method, wallet, cause }) {
     super(`${wallet} wallet request failed`, {
@@ -212,6 +222,102 @@ var extractStacksAddress = (typedProvider, addresses) => {
     `No valid Stacks address found for ${typedProvider} wallet`
   );
 };
+
+// src/hooks/use-wallet-connect/use-wallet-connect.helpers.ts
+var getWcUniversalProvider = () => window.WalletConnectProvider?.connector?.provider ?? null;
+var extractStacksAddress2 = (accounts) => {
+  for (const entry of accounts) {
+    if (typeof entry === "object" && entry !== null && "address" in entry) {
+      return entry.address;
+    }
+    if (typeof entry === "string") {
+      if (entry.startsWith("S")) return entry;
+      if (entry.startsWith("stacks:")) return entry.split(":")[2] ?? null;
+    }
+  }
+  return null;
+};
+var PING_TIMEOUT_MS = 1e4;
+var pingSession = async () => {
+  const wcProvider = getWcUniversalProvider();
+  const client = wcProvider?.client;
+  const session = wcProvider?.session;
+  if (!client || !session) return false;
+  try {
+    await Promise.race([
+      client.ping({ topic: session.topic }),
+      new Promise(
+        (_, reject) => setTimeout(() => reject(new Error("Ping timeout")), PING_TIMEOUT_MS)
+      )
+    ]);
+    return true;
+  } catch {
+    return false;
+  }
+};
+
+// src/hooks/use-wallet-connect/use-wallet-connect.ts
+var useWalletConnect = ({
+  address,
+  provider,
+  onAddressChange,
+  onDisconnect
+}) => {
+  useEffect(() => {
+    if (provider !== "wallet-connect" || !address) return;
+    let cancelled = false;
+    const validateSession = async () => {
+      const alive = await pingSession();
+      if (cancelled) return;
+      if (!alive) {
+        const wcProvider = getWcUniversalProvider();
+        try {
+          await wcProvider?.disconnect();
+        } catch {
+        }
+        clearSelectedProviderId();
+        onDisconnect();
+      }
+    };
+    void validateSession();
+    return () => {
+      cancelled = true;
+    };
+  }, [provider, address, onDisconnect]);
+  useEffect(() => {
+    if (provider !== "wallet-connect" || !address) return;
+    const wcProvider = getWcUniversalProvider();
+    if (!wcProvider) return;
+    const handleDisconnect = () => {
+      clearSelectedProviderId();
+      onDisconnect();
+    };
+    const handleAccountsChanged = (...args) => {
+      const accounts = args[0];
+      const newAddress = extractStacksAddress2(accounts);
+      if (newAddress && newAddress !== address) {
+        onAddressChange(newAddress);
+      }
+    };
+    wcProvider.on("disconnect", handleDisconnect);
+    wcProvider.on("accountsChanged", handleAccountsChanged);
+    wcProvider.on("stx_accountChange", handleAccountsChanged);
+    wcProvider.on("stx_accountsChanged", handleAccountsChanged);
+    return () => {
+      try {
+        wcProvider.off("disconnect", handleDisconnect);
+        wcProvider.off("accountsChanged", handleAccountsChanged);
+        wcProvider.off("stx_accountChange", handleAccountsChanged);
+        wcProvider.off("stx_accountsChanged", handleAccountsChanged);
+      } catch (error) {
+        console.error(
+          "Failed to remove WalletConnect listeners:",
+          error
+        );
+      }
+    };
+  }, [address, provider, onAddressChange, onDisconnect]);
+};
 var getXverseProductInfo = async () => await window.XverseProviders?.StacksProvider?.getProductInfo?.() ?? null;
 var shouldSupportAccountChange = (version) => version !== void 0 && version !== "1.0.0";
 var waitForXverseProvider = async (maxAttempts = 10, initialDelay = 200) => {
@@ -590,6 +696,18 @@ var StacksWalletProvider = ({
     onAddressChange: handleAddressChange,
     connect
   });
+  const handleWcDisconnect = useCallback(() => {
+    localStorage.removeItem(LOCAL_STORAGE_STACKS);
+    setAddress(void 0);
+    setProvider(void 0);
+    onDisconnect?.();
+  }, [onDisconnect]);
+  useWalletConnect({
+    address,
+    provider,
+    onAddressChange: handleAddressChange,
+    onDisconnect: handleWcDisconnect
+  });
   const { installed } = getStacksWallets();
   const configured = wallets ?? [...SUPPORTED_STACKS_WALLETS];
   const walletInfos = configured.map((w) => ({