@0xkey-io/core 0.1.0

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

@@ -0,0 +1,132 @@
+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;
+    private sessionUpdateHandlers;
+    private sessionEventHandlers;
+    private sessionDeleteHandlers;
+    private pairingExpireHandlers;
+    /**
+     * Registers a callback for WalletConnect `session_update`.
+     *
+     * - Triggered when the wallet updates the session namespaces
+     *   (e.g., accounts/chains/permissions). Use this to refresh providers.
+     * - Returns an unsubscribe function to remove the listener.
+     *
+     * @param fn - Callback invoked when a `session_update` occurs.
+     * @returns A function that unsubscribes this listener.
+     */
+    onSessionUpdate(fn: () => void): () => void;
+    /**
+     * Registers a callback for WalletConnect `session_event`.
+     *
+     * - Emits ephemeral wallet events such as `chainChanged` or `accountsChanged`.
+     * - The raw event payload is forwarded so callers can inspect `{ event, chainId, topic }`.
+     * - Returns an unsubscribe function to remove the listener.
+     *
+     * @param fn - Callback receiving the raw session event args.
+     * @returns A function that unsubscribes this listener.
+     */
+    onSessionEvent(fn: (args: any) => void): () => void;
+    /**
+     * Registers a callback for WalletConnect `session_delete`.
+     *
+     * - Fired from the underlying SignClient when a session is terminated.
+     * - Useful for clearing UI state or internal session data after a disconnect.
+     *
+     * @param fn - Callback to invoke when the session is deleted.
+     */
+    onSessionDelete(fn: () => void): void;
+    /**
+     * Registers a callback for WalletConnect `pairing_expire`.
+     *
+     * - Fired from the underlying SignClient when a session proposal expires.
+     * - Useful for re-initiating the pairing process, and refreshing the pairing URI.
+     *
+     * @param fn - Callback to invoke when the pairing expires.
+     */
+    onPairingExpire(fn: () => void): void;
+    /**
+     * Initializes the WalletConnect SignClient with your project credentials.
+     *
+     * - 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.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: {
+        projectId: string;
+        appMetadata: CoreTypes.Metadata;
+        relayUrl?: string;
+    }): Promise<void>;
+    /**
+     * Initiates a pairing request and returns a URI to be scanned or deep-linked.
+     *
+     * - 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 - Optional namespaces requesting capabilities.
+     * @returns A WalletConnect URI for the wallet to connect with.
+     * @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.
+     *
+     * - 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 if approval fails.
+     */
+    approve(): Promise<SessionTypes.Struct>;
+    /**
+     * Retrieves the most recent active WalletConnect session.
+     *
+     * @returns The most recent session, or `null` if none are active.
+     */
+    getSession(): SessionTypes.Struct | null;
+    /**
+     * Sends a JSON-RPC request over the active WalletConnect session.
+     *
+     * - Requires `init()` and an active session.
+     *
+     * @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 exists.
+     */
+    request(chainId: string, method: string, params: any[] | Record<string, any>): Promise<any>;
+    /**
+     * Disconnects the active session, if one exists.
+     *
+     * - Sends a disconnect signal to the wallet.
+     * - Does nothing if no session is currently active.
+     *
+     * @returns A promise that resolves once disconnection is complete.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Cancels all in-progress WalletConnect pairings, if any.
+     *
+     * - Iterates through the core pairing registry and disconnects every active pairing
+     * - Always clears the pending approval callback so subsequent `pair()` calls
+     *   can be made
+     * - Safe to call even if no pairings exist. it simply resets internal state
+     *
+     * @returns A promise that resolves once cancellation is complete.
+     */
+    cancelPairing(): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +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;;;;;;GAMG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAc;IAG5B,OAAO,CAAC,eAAe,CAAqD;IAW5E,OAAO,CAAC,qBAAqB,CAAyB;IACtD,OAAO,CAAC,oBAAoB,CAAkC;IAC9D,OAAO,CAAC,qBAAqB,CAAyB;IACtD,OAAO,CAAC,qBAAqB,CAAyB;IAEtD;;;;;;;;;OASG;IACI,eAAe,CAAC,EAAE,EAAE,MAAM,IAAI;IASrC;;;;;;;;;OASG;IACI,cAAc,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI;IAS7C;;;;;;;OAOG;IACI,eAAe,CAAC,EAAE,EAAE,MAAM,IAAI;IAIrC;;;;;;;OAOG;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;IAsBjB;;;;;;;;;;OAUG;IACG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBzE;;;;;;;OAOG;IACG,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC;IA6B7C;;;;OAIG;IACH,UAAU,IAAI,YAAY,CAAC,MAAM,GAAG,IAAI;IAUxC;;;;;;;;;;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;IAUjC;;;;;;;;;OASG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CA6BrC"}

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

@@ -0,0 +1,262 @@
+'use strict';
+
+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()`
+        this.pendingApproval = null;
+        // these are subscribers we forward from the underlying WalletConnect SignClient:
+        //
+        // - sessionUpdateHandlers: fired on 'session_update' when session namespaces
+        //   (accounts/chains/permissions) change
+        //
+        // - sessionEventHandlers: fired on 'session_event' for ephemeral wallet events
+        //   like { event: { name: 'chainChanged' | 'accountsChanged', data }, chainId, topic }
+        //
+        // - sessionDeleteHandlers: fired on 'session_delete' when the session is terminated
+        this.sessionUpdateHandlers = [];
+        this.sessionEventHandlers = [];
+        this.sessionDeleteHandlers = [];
+        this.pairingExpireHandlers = [];
+    }
+    /**
+     * Registers a callback for WalletConnect `session_update`.
+     *
+     * - Triggered when the wallet updates the session namespaces
+     *   (e.g., accounts/chains/permissions). Use this to refresh providers.
+     * - Returns an unsubscribe function to remove the listener.
+     *
+     * @param fn - Callback invoked when a `session_update` occurs.
+     * @returns A function that unsubscribes this listener.
+     */
+    onSessionUpdate(fn) {
+        this.sessionUpdateHandlers.push(fn);
+        return () => {
+            this.sessionUpdateHandlers = this.sessionUpdateHandlers.filter((h) => h !== fn);
+        };
+    }
+    /**
+     * Registers a callback for WalletConnect `session_event`.
+     *
+     * - Emits ephemeral wallet events such as `chainChanged` or `accountsChanged`.
+     * - The raw event payload is forwarded so callers can inspect `{ event, chainId, topic }`.
+     * - Returns an unsubscribe function to remove the listener.
+     *
+     * @param fn - Callback receiving the raw session event args.
+     * @returns A function that unsubscribes this listener.
+     */
+    onSessionEvent(fn) {
+        this.sessionEventHandlers.push(fn);
+        return () => {
+            this.sessionEventHandlers = this.sessionEventHandlers.filter((h) => h !== fn);
+        };
+    }
+    /**
+     * Registers a callback for WalletConnect `session_delete`.
+     *
+     * - Fired from the underlying SignClient when a session is terminated.
+     * - Useful for clearing UI state or internal session data after a disconnect.
+     *
+     * @param fn - Callback to invoke when the session is deleted.
+     */
+    onSessionDelete(fn) {
+        this.sessionDeleteHandlers.push(fn);
+    }
+    /**
+     * Registers a callback for WalletConnect `pairing_expire`.
+     *
+     * - Fired from the underlying SignClient when a session proposal expires.
+     * - Useful for re-initiating the pairing process, and refreshing the pairing URI.
+     *
+     * @param fn - Callback to invoke when the pairing expires.
+     */
+    onPairingExpire(fn) {
+        this.pairingExpireHandlers.push(fn);
+    }
+    /**
+     * Initializes the WalletConnect SignClient with your project credentials.
+     *
+     * - 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.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) {
+        this.client = await SignClient.init({
+            projectId: opts.projectId,
+            metadata: opts.appMetadata,
+            ...(opts.relayUrl ? { relayUrl: opts.relayUrl } : {}),
+        });
+        // fan out WalletConnect SignClient events to our subscribers
+        this.client.on("session_delete", () => {
+            this.sessionDeleteHandlers.forEach((h) => h());
+        });
+        this.client.on("session_update", () => {
+            this.sessionUpdateHandlers.forEach((h) => h());
+        });
+        this.client.on("session_event", (args) => {
+            this.sessionEventHandlers.forEach((h) => h(args));
+        });
+        this.client.core.pairing.events.on("pairing_expire", () => {
+            this.pairingExpireHandlers.forEach((h) => h());
+        });
+    }
+    /**
+     * Initiates a pairing request and returns a URI to be scanned or deep-linked.
+     *
+     * - 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 - Optional namespaces requesting capabilities.
+     * @returns A WalletConnect URI for the wallet to connect with.
+     * @throws {Error} If a pairing is already in progress or no URI is returned.
+     */
+    async pair(namespaces) {
+        if (this.pendingApproval) {
+            throw new Error("WalletConnect: Pairing already in progress");
+        }
+        const { uri, approval } = await this.client.connect({
+            optionalNamespaces: namespaces,
+        });
+        if (!uri) {
+            throw new Error("WalletConnect: no URI returned");
+        }
+        this.pendingApproval = approval;
+        return uri;
+    }
+    /**
+     * Completes the pairing approval process after the wallet approves the request.
+     *
+     * - 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 if approval fails.
+     */
+    async approve() {
+        if (!this.pendingApproval) {
+            throw new Error("WalletConnect: call pair() before approve()");
+        }
+        try {
+            const session = await this.pendingApproval();
+            return session;
+        }
+        catch (error) {
+            // we sanitize common errors to be more user-friendly
+            if (error.message?.includes("Proposal expired")) {
+                throw new Error("WalletConnect: The connection request has expired. Please scan the QR code again.");
+            }
+            if (error.message?.includes("User rejected")) {
+                throw new Error("WalletConnect: The connection request was rejected by the user.");
+            }
+            throw new Error(`WalletConnect: Approval failed: ${error.message}`);
+        }
+        finally {
+            // we clear the pending state regardless of outcome
+            this.pendingApproval = null;
+        }
+    }
+    /**
+     * Retrieves the most recent active WalletConnect session.
+     *
+     * @returns The most recent session, or `null` if none are active.
+     */
+    getSession() {
+        // we return null if the client hasn't been initialized yet
+        if (!this.client?.session) {
+            return null;
+        }
+        const sessions = this.client.session.getAll();
+        return sessions.length ? sessions[sessions.length - 1] : null;
+    }
+    /**
+     * Sends a JSON-RPC request over the active WalletConnect session.
+     *
+     * - Requires `init()` and an active session.
+     *
+     * @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 exists.
+     */
+    async request(chainId, method, params) {
+        const session = this.getSession();
+        if (!session) {
+            throw new Error("WalletConnect: no active session");
+        }
+        return this.client.request({
+            topic: session.topic,
+            chainId,
+            request: { method, params },
+        });
+    }
+    /**
+     * Disconnects the active session, if one exists.
+     *
+     * - Sends a disconnect signal to the wallet.
+     * - Does nothing if no session is currently active.
+     *
+     * @returns A promise that resolves once disconnection is complete.
+     */
+    async disconnect() {
+        const session = this.getSession();
+        if (!session)
+            return;
+        await this.client.disconnect({
+            topic: session.topic,
+            reason: { code: 6000, message: "User disconnected" },
+        });
+    }
+    /**
+     * Cancels all in-progress WalletConnect pairings, if any.
+     *
+     * - Iterates through the core pairing registry and disconnects every active pairing
+     * - Always clears the pending approval callback so subsequent `pair()` calls
+     *   can be made
+     * - Safe to call even if no pairings exist. it simply resets internal state
+     *
+     * @returns A promise that resolves once cancellation is complete.
+     */
+    async cancelPairing() {
+        try {
+            const pairings = this.client.core.pairing.getPairings();
+            // disconnect all active pairings
+            // technically there should only be one active pairing at a tim
+            const disconnectPromises = pairings.map(async (pairing) => {
+                try {
+                    await this.client.core.pairing.disconnect({
+                        topic: pairing.topic,
+                    });
+                }
+                catch (err) {
+                    if (err.message?.includes("Expired") ||
+                        err.message?.includes("Not found") ||
+                        err.message?.includes("No matching key")) {
+                        // already expired/disconnected, so we ignore
+                        return;
+                    }
+                    console.warn("failed to disconnect pairing:", err);
+                }
+            });
+            await Promise.allSettled(disconnectPromises);
+        }
+        finally {
+            this.pendingApproval = null;
+        }
+    }
+}
+
+exports.WalletConnectClient = WalletConnectClient;
+//# sourceMappingURL=client.js.map

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

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

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

@@ -0,0 +1,260 @@
+import SignClient from '@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()`
+        this.pendingApproval = null;
+        // these are subscribers we forward from the underlying WalletConnect SignClient:
+        //
+        // - sessionUpdateHandlers: fired on 'session_update' when session namespaces
+        //   (accounts/chains/permissions) change
+        //
+        // - sessionEventHandlers: fired on 'session_event' for ephemeral wallet events
+        //   like { event: { name: 'chainChanged' | 'accountsChanged', data }, chainId, topic }
+        //
+        // - sessionDeleteHandlers: fired on 'session_delete' when the session is terminated
+        this.sessionUpdateHandlers = [];
+        this.sessionEventHandlers = [];
+        this.sessionDeleteHandlers = [];
+        this.pairingExpireHandlers = [];
+    }
+    /**
+     * Registers a callback for WalletConnect `session_update`.
+     *
+     * - Triggered when the wallet updates the session namespaces
+     *   (e.g., accounts/chains/permissions). Use this to refresh providers.
+     * - Returns an unsubscribe function to remove the listener.
+     *
+     * @param fn - Callback invoked when a `session_update` occurs.
+     * @returns A function that unsubscribes this listener.
+     */
+    onSessionUpdate(fn) {
+        this.sessionUpdateHandlers.push(fn);
+        return () => {
+            this.sessionUpdateHandlers = this.sessionUpdateHandlers.filter((h) => h !== fn);
+        };
+    }
+    /**
+     * Registers a callback for WalletConnect `session_event`.
+     *
+     * - Emits ephemeral wallet events such as `chainChanged` or `accountsChanged`.
+     * - The raw event payload is forwarded so callers can inspect `{ event, chainId, topic }`.
+     * - Returns an unsubscribe function to remove the listener.
+     *
+     * @param fn - Callback receiving the raw session event args.
+     * @returns A function that unsubscribes this listener.
+     */
+    onSessionEvent(fn) {
+        this.sessionEventHandlers.push(fn);
+        return () => {
+            this.sessionEventHandlers = this.sessionEventHandlers.filter((h) => h !== fn);
+        };
+    }
+    /**
+     * Registers a callback for WalletConnect `session_delete`.
+     *
+     * - Fired from the underlying SignClient when a session is terminated.
+     * - Useful for clearing UI state or internal session data after a disconnect.
+     *
+     * @param fn - Callback to invoke when the session is deleted.
+     */
+    onSessionDelete(fn) {
+        this.sessionDeleteHandlers.push(fn);
+    }
+    /**
+     * Registers a callback for WalletConnect `pairing_expire`.
+     *
+     * - Fired from the underlying SignClient when a session proposal expires.
+     * - Useful for re-initiating the pairing process, and refreshing the pairing URI.
+     *
+     * @param fn - Callback to invoke when the pairing expires.
+     */
+    onPairingExpire(fn) {
+        this.pairingExpireHandlers.push(fn);
+    }
+    /**
+     * Initializes the WalletConnect SignClient with your project credentials.
+     *
+     * - 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.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) {
+        this.client = await SignClient.init({
+            projectId: opts.projectId,
+            metadata: opts.appMetadata,
+            ...(opts.relayUrl ? { relayUrl: opts.relayUrl } : {}),
+        });
+        // fan out WalletConnect SignClient events to our subscribers
+        this.client.on("session_delete", () => {
+            this.sessionDeleteHandlers.forEach((h) => h());
+        });
+        this.client.on("session_update", () => {
+            this.sessionUpdateHandlers.forEach((h) => h());
+        });
+        this.client.on("session_event", (args) => {
+            this.sessionEventHandlers.forEach((h) => h(args));
+        });
+        this.client.core.pairing.events.on("pairing_expire", () => {
+            this.pairingExpireHandlers.forEach((h) => h());
+        });
+    }
+    /**
+     * Initiates a pairing request and returns a URI to be scanned or deep-linked.
+     *
+     * - 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 - Optional namespaces requesting capabilities.
+     * @returns A WalletConnect URI for the wallet to connect with.
+     * @throws {Error} If a pairing is already in progress or no URI is returned.
+     */
+    async pair(namespaces) {
+        if (this.pendingApproval) {
+            throw new Error("WalletConnect: Pairing already in progress");
+        }
+        const { uri, approval } = await this.client.connect({
+            optionalNamespaces: namespaces,
+        });
+        if (!uri) {
+            throw new Error("WalletConnect: no URI returned");
+        }
+        this.pendingApproval = approval;
+        return uri;
+    }
+    /**
+     * Completes the pairing approval process after the wallet approves the request.
+     *
+     * - 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 if approval fails.
+     */
+    async approve() {
+        if (!this.pendingApproval) {
+            throw new Error("WalletConnect: call pair() before approve()");
+        }
+        try {
+            const session = await this.pendingApproval();
+            return session;
+        }
+        catch (error) {
+            // we sanitize common errors to be more user-friendly
+            if (error.message?.includes("Proposal expired")) {
+                throw new Error("WalletConnect: The connection request has expired. Please scan the QR code again.");
+            }
+            if (error.message?.includes("User rejected")) {
+                throw new Error("WalletConnect: The connection request was rejected by the user.");
+            }
+            throw new Error(`WalletConnect: Approval failed: ${error.message}`);
+        }
+        finally {
+            // we clear the pending state regardless of outcome
+            this.pendingApproval = null;
+        }
+    }
+    /**
+     * Retrieves the most recent active WalletConnect session.
+     *
+     * @returns The most recent session, or `null` if none are active.
+     */
+    getSession() {
+        // we return null if the client hasn't been initialized yet
+        if (!this.client?.session) {
+            return null;
+        }
+        const sessions = this.client.session.getAll();
+        return sessions.length ? sessions[sessions.length - 1] : null;
+    }
+    /**
+     * Sends a JSON-RPC request over the active WalletConnect session.
+     *
+     * - Requires `init()` and an active session.
+     *
+     * @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 exists.
+     */
+    async request(chainId, method, params) {
+        const session = this.getSession();
+        if (!session) {
+            throw new Error("WalletConnect: no active session");
+        }
+        return this.client.request({
+            topic: session.topic,
+            chainId,
+            request: { method, params },
+        });
+    }
+    /**
+     * Disconnects the active session, if one exists.
+     *
+     * - Sends a disconnect signal to the wallet.
+     * - Does nothing if no session is currently active.
+     *
+     * @returns A promise that resolves once disconnection is complete.
+     */
+    async disconnect() {
+        const session = this.getSession();
+        if (!session)
+            return;
+        await this.client.disconnect({
+            topic: session.topic,
+            reason: { code: 6000, message: "User disconnected" },
+        });
+    }
+    /**
+     * Cancels all in-progress WalletConnect pairings, if any.
+     *
+     * - Iterates through the core pairing registry and disconnects every active pairing
+     * - Always clears the pending approval callback so subsequent `pair()` calls
+     *   can be made
+     * - Safe to call even if no pairings exist. it simply resets internal state
+     *
+     * @returns A promise that resolves once cancellation is complete.
+     */
+    async cancelPairing() {
+        try {
+            const pairings = this.client.core.pairing.getPairings();
+            // disconnect all active pairings
+            // technically there should only be one active pairing at a tim
+            const disconnectPromises = pairings.map(async (pairing) => {
+                try {
+                    await this.client.core.pairing.disconnect({
+                        topic: pairing.topic,
+                    });
+                }
+                catch (err) {
+                    if (err.message?.includes("Expired") ||
+                        err.message?.includes("Not found") ||
+                        err.message?.includes("No matching key")) {
+                        // already expired/disconnected, so we ignore
+                        return;
+                    }
+                    console.warn("failed to disconnect pairing:", err);
+                }
+            });
+            await Promise.allSettled(disconnectPromises);
+        }
+        finally {
+            this.pendingApproval = null;
+        }
+    }
+}
+
+export { WalletConnectClient };
+//# sourceMappingURL=client.mjs.map

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

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