@turnkey/core 1.0.0-beta.2 → 1.0.0-beta.4

package/dist/__wallet__/wallet-connect/base.mjs

@@ -6,20 +6,38 @@ import { WalletInterfaceType, Chain, SignIntent } from '../../__types__/base.mjs
 import { Transaction } from 'ethers';
 
 class WalletConnectWallet {
+    /**
+     * Constructs a WalletConnectWallet bound to a WalletConnect client.
+     *
+     * - Subscribes to session deletions and automatically re-initiates pairing,
+     *   updating `this.uri` so the UI can present a fresh QR/deeplink.
+     *
+     * @param client - The low-level WalletConnect client used for session/RPC.
+     */
     constructor(client) {
         this.client = client;
         this.interfaceType = WalletInterfaceType.WalletConnect;
         this.ethereumNamespaces = [];
         this.solanaNamespaces = [];
-        this.client.onSessionDelete(() => { });
+        this.client.onSessionDelete(async () => {
+            try {
+                this.uri = await this.client.pair(this.buildNamespaces());
+            }
+            catch (err) {
+                console.warn("WalletConnect: failed to re-pair after session delete", err);
+            }
+        });
     }
     /**
-     * Initializes WalletConnect pairing flow with the specified chains.
-     * If an active session already exists, pairing is skipped.
+     * Initializes WalletConnect pairing flow with the specified namespaces.
      *
-     * @param opts.ethereum - Whether to enable Ethereum pairing
-     * @param opts.solana - Whether to enable Solana pairing
-     * @throws {Error} If no chains are enabled
+     * - Saves the requested chain namespaces (e.g., `["eip155:1", "eip155:137", "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]`).
+     * - If an active session already has connected accounts, pairing is skipped.
+     * - Otherwise initiates a pairing and stores the resulting URI.
+     *
+     * @param opts.ethereumNamespaces - List of EVM CAIP IDs (e.g., "eip155:1").
+     * @param opts.solanaNamespaces - List of Solana CAIP IDs (e.g., "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp").
+     * @throws {Error} If no namespaces are provided for either chain.
      */
     async init(opts) {
         this.ethereumNamespaces = opts.ethereumNamespaces;
@@ -34,39 +52,23 @@ class WalletConnectWallet {
             this.solanaNamespaces.length === 0) {
             throw new Error("At least one namespace must be enabled for WalletConnect");
         }
+        // we don't want to create more than one active session
+        // so we don't make a pair request if one is already active
+        // since pairing would mean initializing a new session
         const session = this.client.getSession();
         if (hasConnectedAccounts(session)) {
             return;
         }
-        const namespaces = {};
-        if (this.ethereumNamespaces.length > 0) {
-            namespaces.eip155 = {
-                methods: [
-                    "personal_sign",
-                    "eth_sendTransaction",
-                    "eth_chainId",
-                    "wallet_switchEthereumChain",
-                    "wallet_addEthereumChain",
-                ],
-                chains: this.ethereumNamespaces,
-                events: ["accountsChanged", "chainChanged"],
-            };
-        }
-        if (this.solanaNamespaces.length > 0) {
-            namespaces.solana = {
-                methods: [
-                    "solana_signMessage",
-                    "solana_signTransaction",
-                    "solana_sendTransaction",
-                ],
-                chains: this.solanaNamespaces,
-                events: ["accountsChanged", "chainChanged"],
-            };
-        }
+        const namespaces = this.buildNamespaces();
         this.uri = await this.client.pair(namespaces);
     }
     /**
      * Returns WalletConnect providers with associated chain/account metadata.
+     *
+     * - Builds an EVM provider (if Ethereum namespaces are enabled).
+     * - Builds a Solana provider (if Solana namespaces are enabled).
+     *
+     * @returns A promise resolving to an array of WalletProvider objects.
      */
     async getProviders() {
         const session = this.client.getSession();
@@ -85,6 +87,12 @@ class WalletConnectWallet {
     }
     /**
      * Approves the session if needed and ensures at least one account is available.
+     *
+     * - Calls `approve()` on the underlying client when pairing is pending.
+     * - Throws if the approved session contains no connected accounts.
+     *
+     * @param _provider - Unused (present for interface compatibility).
+     * @throws {Error} If the session contains no accounts.
      */
     async connectWalletAccount(_provider) {
         const session = await this.client.approve();
@@ -92,12 +100,20 @@ class WalletConnectWallet {
             throw new Error("No account found in session");
     }
     /**
-     * Switch the user’s WalletConnect session to a new EVM chain.
+     * Switches the user’s WalletConnect session to a new EVM chain.
+     *
+     * - Ethereum-only: only supported for providers on the Ethereum namespace.
+     * - No add-then-switch: WalletConnect cannot add chains mid-session. The target chain
+     *   must be present in `ethereumNamespaces` negotiated at pairing time. To support a new chain,
+     *   you must include it in the walletConfig.
+     * - Accepts a hex chain ID (e.g., "0x1"). If a `SwitchableChain` is passed, only its `id`
+     *   (hex chain ID) is used; metadata is ignored for WalletConnect.
      *
-     * @param provider   – the WalletProvider returned by getProviders()
-     * @param chainOrId  – either:
-     *                     • a CAIP string ("eip155:1", "eip155:137", …)
-     *                     • a SwitchableChain object carrying full metadata
+     * @param provider - The WalletProvider returned by `getProviders()`.
+     * @param chainOrId - Hex chain ID (e.g., "0x1") or a `SwitchableChain` (its `id` is used).
+     * @returns A promise that resolves when the switch completes.
+     * @throws {Error} If no active session, provider is non-EVM, the chain is not in `ethereumNamespaces`,
+     *                 or the switch RPC fails.
      */
     async switchChain(provider, chainOrId) {
         if (provider.chainInfo.namespace !== Chain.Ethereum) {
@@ -124,13 +140,27 @@ class WalletConnectWallet {
         }
     }
     /**
-     * Signs a message or transaction using the specified provider and intent.
+     * Signs a message or transaction using the specified wallet provider and intent.
+     *
+     * - Ensures an active WalletConnect session:
+     *   - If a pairing is in progress (URI shown but not yet approved), this call will
+     *     wait for the user to approve the session and may appear stuck until they do.
+     *   - If no pairing is in progress, this will throw (e.g., "call pair() before approve()").
+     * - Ethereum:
+     *   - `SignMessage` → `personal_sign` (returns hex signature).
+     *   - `SignAndSendTransaction` → `eth_sendTransaction` (returns tx hash).
+     * - Solana:
+     *   - `SignMessage` → `solana_signMessage` (returns hex signature).
+     *   - `SignTransaction` → `solana_signTransaction` (returns hex signature).
+     *   - `SignAndSendTransaction` → `solana_sendTransaction` (returns hex signature of the submitted tx).
      *
-     * @param message - The message or serialized transaction to sign.
+     * @param payload - Payload or serialized transaction to sign.
      * @param provider - The WalletProvider to use.
-     * @param intent - The type of signing intent (message, tx, send).
+     * @param intent - The signing intent.
+     * @returns A hex string (signature or transaction hash, depending on intent).
+     * @throws {Error} If no account is available, no pairing is in progress, or the intent is unsupported.
      */
-    async sign(message, provider, intent) {
+    async sign(payload, provider, intent) {
         const session = await this.ensureSession();
         if (!hasConnectedAccounts(session)) {
             await this.connectWalletAccount(provider);
@@ -143,12 +173,12 @@ class WalletConnectWallet {
             switch (intent) {
                 case SignIntent.SignMessage:
                     return (await this.client.request(this.ethChain, "personal_sign", [
-                        message,
+                        payload,
                         address,
                     ]));
                 case SignIntent.SignAndSendTransaction:
                     const account = provider.connectedAddresses[0];
-                    const tx = Transaction.from(message);
+                    const tx = Transaction.from(payload);
                     const txParams = {
                         from: account,
                         to: tx.to?.toString(),
@@ -172,7 +202,7 @@ class WalletConnectWallet {
             }
             switch (intent) {
                 case SignIntent.SignMessage: {
-                    const msgBytes = new TextEncoder().encode(message);
+                    const msgBytes = new TextEncoder().encode(payload);
                     const msgB58 = bs58.encode(msgBytes);
                     const { signature: sigB58 } = await this.client.request(this.solChain, "solana_signMessage", {
                         pubkey: address,
@@ -181,7 +211,7 @@ class WalletConnectWallet {
                     return uint8ArrayToHexString(bs58.decode(sigB58));
                 }
                 case SignIntent.SignTransaction: {
-                    const txBytes = uint8ArrayFromHexString(message);
+                    const txBytes = uint8ArrayFromHexString(payload);
                     const txBase64 = stringToBase64urlString(String.fromCharCode(...txBytes));
                     const { signature: sigB58 } = await this.client.request(this.solChain, "solana_signTransaction", {
                         feePayer: address,
@@ -190,7 +220,7 @@ class WalletConnectWallet {
                     return uint8ArrayToHexString(bs58.decode(sigB58));
                 }
                 case SignIntent.SignAndSendTransaction: {
-                    const txBytes = uint8ArrayFromHexString(message);
+                    const txBytes = uint8ArrayFromHexString(payload);
                     const txBase64 = stringToBase64urlString(String.fromCharCode(...txBytes));
                     const sigB58 = await this.client.request(this.solChain, "solana_sendTransaction", {
                         feePayer: address,
@@ -208,8 +238,12 @@ class WalletConnectWallet {
     /**
      * Retrieves the public key of the connected wallet.
      *
+     * - Ethereum: signs a fixed challenge and recovers the compressed secp256k1 public key.
+     * - Solana: decodes the base58-encoded address to raw bytes.
+     *
      * @param provider - The WalletProvider to fetch the key from.
-     * @returns Compressed public key as a hex string.
+     * @returns A compressed public key as a hex string.
+     * @throws {Error} If no account is available or the namespace is unsupported.
      */
     async getPublicKey(provider) {
         const session = this.client.getSession();
@@ -245,34 +279,13 @@ class WalletConnectWallet {
     }
     /**
      * Disconnects the current session and re-initiates a fresh pairing URI.
+     *
+     * - Calls `disconnect()` on the client, then `pair()` with current namespaces.
+     * - Updates `this.uri` so the UI can present a new QR/deeplink.
      */
     async disconnectWalletAccount(_provider) {
         await this.client.disconnect();
-        const namespaces = {};
-        if (this.ethereumNamespaces.length > 0) {
-            namespaces.eip155 = {
-                methods: [
-                    "personal_sign",
-                    "eth_sendTransaction",
-                    "eth_chainId",
-                    "wallet_switchEthereumChain",
-                    "wallet_addEthereumChain",
-                ],
-                chains: this.ethereumNamespaces,
-                events: ["accountsChanged", "chainChanged"],
-            };
-        }
-        if (this.solanaNamespaces.length > 0) {
-            namespaces.solana = {
-                methods: [
-                    "solana_signMessage",
-                    "solana_signTransaction",
-                    "solana_sendTransaction",
-                ],
-                chains: this.solanaNamespaces,
-                events: ["accountsChanged", "chainChanged"],
-            };
-        }
+        const namespaces = this.buildNamespaces();
         await this.client.pair(namespaces).then((newUri) => {
             this.uri = newUri;
         });
@@ -280,8 +293,8 @@ class WalletConnectWallet {
     /**
      * Builds a lightweight provider interface for the given chain.
      *
-     * @param chainId - The namespace chain ID (e.g., eip155:1)
-     * @returns A WalletConnect-compatible provider implementation
+     * @param chainId - Namespace chain ID (e.g., "eip155:1" or "solana:101").
+     * @returns A WalletConnect-compatible provider that proxies JSON-RPC via WC.
      */
     makeProvider(chainId) {
         return {
@@ -293,8 +306,15 @@ class WalletConnectWallet {
     /**
      * Ensures there is an active WalletConnect session, initiating approval if necessary.
      *
-     * @returns The current WalletConnect session
-     * @throws {Error} If approval fails or session is not established
+     * - If a session exists, returns it immediately.
+     * - If no session exists but a pairing is in progress, awaits `approve()` —
+     *   this will block until the user approves (or rejects) in their wallet.
+     * - If no session exists and no pairing is in progress, throws; the caller
+     *   must have initiated pairing via `pair()` elsewhere.
+     *
+     * @returns The active WalletConnect session.
+     * @throws {Error} If approval is rejected, completes without establishing a session,
+     *                 or no pairing is in progress.
      */
     async ensureSession() {
         let session = this.client.getSession();
@@ -308,6 +328,13 @@ class WalletConnectWallet {
     }
     /**
      * Builds a WalletProvider descriptor for an EVM chain.
+     *
+     * - Extracts the connected address (if any) and current chain ID.
+     * - Includes the pairing `uri` if available.
+     *
+     * @param session - Current WalletConnect session (or null).
+     * @param info - Provider branding info (name, icon).
+     * @returns A WalletProvider object for Ethereum.
      */
     async buildEthProvider(session, info) {
         const raw = session?.namespaces.eip155?.accounts?.[0] ?? "";
@@ -329,6 +356,13 @@ class WalletConnectWallet {
     }
     /**
      * Builds a WalletProvider descriptor for Solana.
+     *
+     * - Extracts the connected address (if any).
+     * - Includes the fresh pairing `uri` if available.
+     *
+     * @param session - Current WalletConnect session (or null).
+     * @param info - Provider branding info (name, icon).
+     * @returns A WalletProvider object for Solana.
      */
     buildSolProvider(session, info) {
         const raw = session?.namespaces.solana?.accounts?.[0] ?? "";
@@ -342,15 +376,78 @@ class WalletConnectWallet {
             ...(this.uri && { uri: this.uri }),
         };
     }
+    /**
+     * Builds the requested WalletConnect namespaces from the current config.
+     *
+     * - Includes methods and events for Ethereum and/or Solana based on enabled namespaces.
+     *
+     * @returns A namespaces object suitable for `WalletConnectClient.pair()`.
+     */
+    buildNamespaces() {
+        const namespaces = {};
+        if (this.ethereumNamespaces.length > 0) {
+            namespaces.eip155 = {
+                methods: [
+                    "personal_sign",
+                    "eth_sendTransaction",
+                    "eth_chainId",
+                    "wallet_switchEthereumChain",
+                    "wallet_addEthereumChain",
+                ],
+                chains: this.ethereumNamespaces,
+                events: ["accountsChanged", "chainChanged"],
+            };
+        }
+        if (this.solanaNamespaces.length > 0) {
+            namespaces.solana = {
+                methods: [
+                    "solana_signMessage",
+                    "solana_signTransaction",
+                    "solana_sendTransaction",
+                ],
+                chains: this.solanaNamespaces,
+                events: ["accountsChanged", "chainChanged"],
+            };
+        }
+        return namespaces;
+    }
 }
+/**
+ * Determines whether the session has at least one connected account
+ * across any namespace.
+ *
+ * - Safe to call with `null` (returns `false`).
+ * - Checks all namespaces for a non-empty `accounts` array.
+ *
+ * @param session - The current WalletConnect session, or `null`.
+ * @returns `true` if any namespace has ≥1 account; otherwise `false`.
+ */
 function hasConnectedAccounts(session) {
     return (!!session &&
         Object.values(session.namespaces).some((ns) => ns.accounts?.length > 0));
 }
+/**
+ * Retrieves the first connected Ethereum account.
+ *
+ * - Safe to call with `null` (returns `undefined`).
+ * - Returns only the address portion (e.g., `0xabc...`), not the full CAIP string.
+ *
+ * @param session - The current WalletConnect session, or `null`.
+ * @returns The connected EVM address, or `undefined` if none.
+ */
 function getConnectedEthereum(session) {
     const acc = session?.namespaces.eip155?.accounts?.[0];
     return acc ? acc.split(":")[2] : undefined;
 }
+/**
+ * Retrieves the first connected Solana account.
+ *
+ * - Safe to call with `null` (returns `undefined`).
+ * - Returns only the base58 address portion, not the full CAIP string.
+ *
+ * @param session - The current WalletConnect session, or `null`.
+ * @returns The connected Solana address (base58), or `undefined` if none.
+ */
 function getConnectedSolana(session) {
     const acc = session?.namespaces.solana?.accounts?.[0];
     return acc ? acc.split(":")[2] : undefined;

package/dist/__wallet__/wallet-connect/base.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"base.mjs","sources":["../../../src/__wallet__/wallet-connect/base.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"base.mjs","sources":["../../../src/__wallet__/wallet-connect/base.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/__wallet__/wallet-connect/client.d.ts

@@ -1,4 +1,11 @@
 import type { CoreTypes, ProposalTypes, SessionTypes } from "@walletconnect/types";
+/**
+ * WalletConnectClient is a low-level wrapper around the WalletConnect SignClient.
+ *
+ * - Used internally by `WalletConnectWallet` to manage connections and sessions.
+ * - Handles pairing, approval, session tracking, RPC requests, and disconnects.
+ * - Exposes a minimal API for lifecycle control; higher-level logic lives in `WalletConnectWallet`.
+ */
 export declare class WalletConnectClient {
     private client;
     private pendingApproval;
@@ -14,12 +21,12 @@ export declare class WalletConnectClient {
     /**
      * Initializes the WalletConnect SignClient with your project credentials.
      *
-     * - Must be called before calling `pair()` or `request()`.
-     * - Configures metadata and optionally a custom relay server.
+     * - Must be called before `pair()`, `approve()`, or `request()`.
+     * - Configures app metadata and an optional custom relay server.
      *
      * @param opts.projectId - WalletConnect project ID.
-     * @param opts.metadata - Metadata about your app (name, URL, icons).
-     * @param opts.relayUrl - (Optional) Custom relay server URL.
+     * @param opts.appMetadata - Metadata about your app (name, URL, icons).
+     * @param opts.relayUrl - (Optional) custom relay server URL.
      * @returns A promise that resolves once the client is initialized.
      */
     init(opts: {
@@ -30,21 +37,22 @@ export declare class WalletConnectClient {
     /**
      * Initiates a pairing request and returns a URI to be scanned or deep-linked.
      *
-     * - Must be followed by a call to `approve()` to complete the pairing.
+     * - Requires `init()` to have been called.
+     * - Must be followed by `approve()` after the wallet approves.
      * - Throws if a pairing is already in progress.
      *
-     * @param namespaces - Namespaces to request for optional capabilities.
+     * @param namespaces - Optional namespaces requesting capabilities.
      * @returns A WalletConnect URI for the wallet to connect with.
-     * @throws {Error} If a pairing is already in progress or URI is not returned.
+     * @throws {Error} If a pairing is already in progress or no URI is returned.
      */
     pair(namespaces: ProposalTypes.OptionalNamespaces): Promise<string>;
     /**
      * Completes the pairing approval process after the wallet approves the request.
      *
-     * - Must be called after `pair()` and after the wallet has scanned and approved the URI.
+     * - Requires `init()` and a pending pairing started via `pair()`.
      *
      * @returns A promise that resolves to the established session.
-     * @throws {Error} If called before `pair()` or approval fails.
+     * @throws {Error} If called before `pair()` or if approval fails.
      */
     approve(): Promise<SessionTypes.Struct>;
     /**
@@ -56,13 +64,13 @@ export declare class WalletConnectClient {
     /**
      * Sends a JSON-RPC request over the active WalletConnect session.
      *
-     * - The session must already be connected.
+     * - Requires `init()` and an active session.
      *
-     * @param chainId - Chain ID of the target blockchain (e.g. `eip155:1`).
-     * @param method - The RPC method name to call.
-     * @param params - The parameters to pass into the RPC method.
+     * @param chainId - Target chain ID (e.g. `eip155:1`).
+     * @param method - RPC method name.
+     * @param params - Parameters for the RPC method.
      * @returns A promise that resolves with the RPC response.
-     * @throws {Error} If no active session is found.
+     * @throws {Error} If no active session exists.
      */
     request(chainId: string, method: string, params: any[] | Record<string, any>): Promise<any>;
     /**

package/dist/__wallet__/wallet-connect/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/__wallet__/wallet-connect/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,YAAY,EACb,MAAM,sBAAsB,CAAC;AAE9B,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAc;IAG5B,OAAO,CAAC,eAAe,CAAqD;IAG5E,OAAO,CAAC,qBAAqB,CAAyB;IAEtD;;;;;;OAMG;IACI,eAAe,CAAC,EAAE,EAAE,MAAM,IAAI;IAIrC;;;;;;;;;;OAUG;IACG,IAAI,CAAC,IAAI,EAAE;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,SAAS,CAAC,QAAQ,CAAC;QAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,IAAI,CAAC;IAajB;;;;;;;;;OASG;IACG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBzE;;;;;;;OAOG;IACG,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC;IAc7C;;;;OAIG;IACH,UAAU,IAAI,YAAY,CAAC,MAAM,GAAG,IAAI;IAKxC;;;;;;;;;;OAUG;IACG,OAAO,CACX,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAClC,OAAO,CAAC,GAAG,CAAC;IAaf;;;;;;;OAOG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CASlC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/__wallet__/wallet-connect/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,YAAY,EACb,MAAM,sBAAsB,CAAC;AAE9B;;;;;;GAMG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAc;IAG5B,OAAO,CAAC,eAAe,CAAqD;IAG5E,OAAO,CAAC,qBAAqB,CAAyB;IAEtD;;;;;;OAMG;IACI,eAAe,CAAC,EAAE,EAAE,MAAM,IAAI;IAIrC;;;;;;;;;;OAUG;IACG,IAAI,CAAC,IAAI,EAAE;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,SAAS,CAAC,QAAQ,CAAC;QAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,IAAI,CAAC;IAajB;;;;;;;;;;OAUG;IACG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBzE;;;;;;;OAOG;IAEG,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC;IAc7C;;;;OAIG;IACH,UAAU,IAAI,YAAY,CAAC,MAAM,GAAG,IAAI;IAKxC;;;;;;;;;;OAUG;IACG,OAAO,CACX,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAClC,OAAO,CAAC,GAAG,CAAC;IAaf;;;;;;;OAOG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CASlC"}

package/dist/__wallet__/wallet-connect/client.js

@@ -2,6 +2,13 @@
 
 var SignClient = require('@walletconnect/sign-client');
 
+/**
+ * WalletConnectClient is a low-level wrapper around the WalletConnect SignClient.
+ *
+ * - Used internally by `WalletConnectWallet` to manage connections and sessions.
+ * - Handles pairing, approval, session tracking, RPC requests, and disconnects.
+ * - Exposes a minimal API for lifecycle control; higher-level logic lives in `WalletConnectWallet`.
+ */
 class WalletConnectClient {
     constructor() {
         // tracks the pending approval callback returned from `connect()`
@@ -22,12 +29,12 @@ class WalletConnectClient {
     /**
      * Initializes the WalletConnect SignClient with your project credentials.
      *
-     * - Must be called before calling `pair()` or `request()`.
-     * - Configures metadata and optionally a custom relay server.
+     * - Must be called before `pair()`, `approve()`, or `request()`.
+     * - Configures app metadata and an optional custom relay server.
      *
      * @param opts.projectId - WalletConnect project ID.
-     * @param opts.metadata - Metadata about your app (name, URL, icons).
-     * @param opts.relayUrl - (Optional) Custom relay server URL.
+     * @param opts.appMetadata - Metadata about your app (name, URL, icons).
+     * @param opts.relayUrl - (Optional) custom relay server URL.
      * @returns A promise that resolves once the client is initialized.
      */
     async init(opts) {
@@ -44,12 +51,13 @@ class WalletConnectClient {
     /**
      * Initiates a pairing request and returns a URI to be scanned or deep-linked.
      *
-     * - Must be followed by a call to `approve()` to complete the pairing.
+     * - Requires `init()` to have been called.
+     * - Must be followed by `approve()` after the wallet approves.
      * - Throws if a pairing is already in progress.
      *
-     * @param namespaces - Namespaces to request for optional capabilities.
+     * @param namespaces - Optional namespaces requesting capabilities.
      * @returns A WalletConnect URI for the wallet to connect with.
-     * @throws {Error} If a pairing is already in progress or URI is not returned.
+     * @throws {Error} If a pairing is already in progress or no URI is returned.
      */
     async pair(namespaces) {
         if (this.pendingApproval) {
@@ -67,10 +75,10 @@ class WalletConnectClient {
     /**
      * Completes the pairing approval process after the wallet approves the request.
      *
-     * - Must be called after `pair()` and after the wallet has scanned and approved the URI.
+     * - Requires `init()` and a pending pairing started via `pair()`.
      *
      * @returns A promise that resolves to the established session.
-     * @throws {Error} If called before `pair()` or approval fails.
+     * @throws {Error} If called before `pair()` or if approval fails.
      */
     async approve() {
         if (!this.pendingApproval) {
@@ -97,13 +105,13 @@ class WalletConnectClient {
     /**
      * Sends a JSON-RPC request over the active WalletConnect session.
      *
-     * - The session must already be connected.
+     * - Requires `init()` and an active session.
      *
-     * @param chainId - Chain ID of the target blockchain (e.g. `eip155:1`).
-     * @param method - The RPC method name to call.
-     * @param params - The parameters to pass into the RPC method.
+     * @param chainId - Target chain ID (e.g. `eip155:1`).
+     * @param method - RPC method name.
+     * @param params - Parameters for the RPC method.
      * @returns A promise that resolves with the RPC response.
-     * @throws {Error} If no active session is found.
+     * @throws {Error} If no active session exists.
      */
     async request(chainId, method, params) {
         const session = this.getSession();

package/dist/__wallet__/wallet-connect/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sources":["../../../src/__wallet__/wallet-connect/client.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sources":["../../../src/__wallet__/wallet-connect/client.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}