@marigoldlabs/web3-tester 0.1.2 → 0.4.1

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,aAAa,GAAG,SAAS,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;AAErF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAC/B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC7B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAE9C,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACxD,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,OAAO,OAAO,CAAC;AAExC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,OAAO,EAAE,GAAG,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,aAAa,GAAG,SAAS,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;AAErF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAC/B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC7B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAE9C,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACxD,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,OAAO,OAAO,CAAC;AAExC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,OAAO,EAAE,GAAG,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACzC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC"}

package/dist/walletconnect.d.ts

@@ -0,0 +1,206 @@
+import type { Page } from '@playwright/test';
+import { type Hex } from 'viem';
+import type { MockWalletController } from './mock-wallet-controller.js';
+export type WalletConnectMetadata = {
+    name: string;
+    description: string;
+    url: string;
+    icons: string[];
+};
+/** Structural IKeyValueStorage (getKeys/getEntries/getItem/setItem/removeItem). */
+export type WalletConnectStorage = {
+    getKeys(): Promise<string[]>;
+    getEntries<T = unknown>(): Promise<[string, T][]>;
+    getItem<T = unknown>(key: string): Promise<T | undefined>;
+    setItem<T = unknown>(key: string, value: T): Promise<void>;
+    removeItem(key: string): Promise<void>;
+};
+/** The slice of SignClient this module drives — the raw client is exposed as an escape hatch. */
+export type WalletConnectSignClient = {
+    on(event: string, handler: (payload: never) => void): unknown;
+    off?(event: string, handler: (payload: never) => void): unknown;
+    removeListener?(event: string, handler: (payload: never) => void): unknown;
+    pair(args: {
+        uri: string;
+    }): Promise<unknown>;
+    approve(args: {
+        id: number;
+        namespaces: Record<string, unknown>;
+    }): Promise<{
+        topic: string;
+        acknowledged: () => Promise<{
+            namespaces?: Record<string, unknown>;
+        } | undefined>;
+    }>;
+    reject(args: {
+        id: number;
+        reason: unknown;
+    }): Promise<void>;
+    respond(args: {
+        topic: string;
+        response: unknown;
+    }): Promise<void>;
+    emit(args: {
+        topic: string;
+        event: {
+            name: string;
+            data: unknown;
+        };
+        chainId: string;
+    }): Promise<void>;
+    update(args: {
+        topic: string;
+        namespaces: Record<string, unknown>;
+    }): Promise<unknown>;
+    disconnect(args: {
+        topic: string;
+        reason: unknown;
+    }): Promise<void>;
+    core?: {
+        relayer?: {
+            transportClose?: () => Promise<void>;
+        };
+        heartbeat?: {
+            stop?: () => void;
+        };
+    };
+};
+export type WalletConnectWalletOptions = {
+    /**
+     * The mock/live controller. EVERY session proposal and session_request
+     * dispatches through its approval gating and transaction recording —
+     * approveNext/autoApprove/holdNextRequest/simulateRejection govern WC
+     * traffic exactly like injected traffic.
+     */
+    wallet: MockWalletController;
+    /** Reown dashboard project id (the public relay requires one). */
+    projectId: string;
+    /** Defaults to the SDK default (wss://relay.walletconnect.org). */
+    relayUrl?: string;
+    /** Chains offered in the approved eip155 namespace. Default: [wallet.currentChainId]. */
+    chains?: readonly (number | Hex)[];
+    /** Namespace methods. Default: DEFAULT_WALLETCONNECT_METHODS. */
+    methods?: readonly string[];
+    /** Namespace events. Default: ['chainChanged', 'accountsChanged']. */
+    events?: readonly string[];
+    /** Peer metadata shown in the dapp UI. */
+    metadata?: Partial<WalletConnectMetadata>;
+    /**
+     * Enforce the controller's allowedOrigins against the relay's
+     * verifyContext origin. Default true. Note: when Verify reports
+     * validation 'UNKNOWN' the origin derives from unattested proposer
+     * metadata — a hostile dapp can spoof it, so origin scoping over WC is
+     * weaker than the injected bridge. false dispatches with the controller's
+     * bypassOriginCheck opt-out (approval gating still applies).
+     */
+    enforceOrigins?: boolean;
+    /** SignClient storage override. Default: SDK in-memory (nothing on disk). */
+    storage?: WalletConnectStorage;
+};
+export type WalletConnectSession = {
+    topic: string;
+    namespaces: Record<string, unknown>;
+    peerMetadata: WalletConnectMetadata;
+};
+export type GetUriOptions = {
+    /** Default 15_000. */
+    timeoutMs?: number;
+    /** Default 'wui-qr-code' (AppKit's QR element; its uri attribute is what Reown's own E2E suite reads). */
+    selector?: string;
+};
+export declare const DEFAULT_WALLETCONNECT_METHODS: readonly string[];
+/** @internal Test hook: stub the dynamic importer; call with no args to restore. */
+export declare const __setWalletConnectModuleLoader: (loader?: (specifier: string) => Promise<unknown>) => void;
+export type SessionRequestEvent = {
+    id: number;
+    topic: string;
+    params: {
+        request: {
+            method: string;
+            params?: unknown;
+        };
+        chainId: string;
+    };
+    verifyContext?: {
+        verified?: {
+            origin?: string;
+            validation?: string;
+        };
+    };
+};
+export type SessionRequestResponse = {
+    id: number;
+    jsonrpc: '2.0';
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: string;
+    };
+};
+/**
+ * The session_request loop, exported for hermetic tests: validates the CAIP
+ * chain against the approved set, switches the wallet when an approved
+ * non-active chain is requested (single-active-chain semantics, like a
+ * mobile wallet), and dispatches through the controller's gating. Errors map
+ * through serializeRpcError, so 4001/4100/4200/4902/-32602 cross the relay
+ * verbatim.
+ */
+export declare const createSessionRequestHandler: (wallet: MockWalletController, config: {
+    chains: readonly Hex[];
+    enforceOrigins: boolean;
+}, respond: (topic: string, response: SessionRequestResponse) => Promise<void>) => ((event: SessionRequestEvent) => Promise<void>);
+/**
+ * Polls the AppKit/W3M modal for the pairing URI: Playwright CSS locators
+ * pierce the shadow DOM, and AppKit's w3m-connecting-wc-qrcode renders
+ * `<wui-qr-code uri=...>` as a real DOM attribute (the same contract
+ * Reown's own laboratory tests read). For non-AppKit modals pass a
+ * `selector` or use the connect() `getUri` hook.
+ */
+export declare function getWalletConnectUri(page: Page, options?: GetUriOptions): Promise<string>;
+export declare class WalletConnectWallet {
+    /** Underlying SignClient — escape hatch for protocol-level access. */
+    readonly client: WalletConnectSignClient;
+    private readonly wallet;
+    private readonly utils;
+    private chains;
+    private readonly methods;
+    private readonly events;
+    private readonly enforceOrigins;
+    private readonly sessionList;
+    private readonly requestHandler;
+    private readonly deleteHandler;
+    private readonly unsubscribeProviderEvents;
+    private closed;
+    private constructor();
+    /**
+     * Async factory: dynamically imports the optional peers and throws an
+     * install hint when they are missing.
+     */
+    static create(options: WalletConnectWalletOptions): Promise<WalletConnectWallet>;
+    get sessions(): readonly WalletConnectSession[];
+    /**
+     * Pairs with a wc: URI, gates the session proposal through the controller
+     * (as a synthetic eth_requestAccounts — approveNext('eth_requestAccounts')
+     * arms it; the match callback receives the proposal payload), builds the
+     * approved namespaces, and settles the session.
+     */
+    pair(options: {
+        uri: string;
+        timeoutMs?: number;
+    }): Promise<WalletConnectSession>;
+    /** Convenience: extract the URI from the dapp's modal, then pair(). */
+    connect(page: Page, options?: GetUriOptions & {
+        getUri?: (page: Page) => Promise<string>;
+    }): Promise<WalletConnectSession>;
+    /** Wallet-initiated disconnect; all sessions when topic is omitted. */
+    disconnect(topic?: string): Promise<void>;
+    /**
+     * Best-effort teardown: disconnect sessions (5s cap), unsubscribe the
+     * controller listener, close the relay transport, stop the heartbeat.
+     * Always call in finally / fixture teardown.
+     */
+    close(): Promise<void>;
+    private forwardProviderEvent;
+}
+//# sourceMappingURL=walletconnect.d.ts.map

package/dist/walletconnect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walletconnect.d.ts","sourceRoot":"","sources":["../src/walletconnect.ts"],"names":[],"mappings":"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"}

package/dist/walletconnect.js

@@ -0,0 +1,359 @@
+import { toHex } from 'viem';
+import { serializeRpcError } from './errors.js';
+export const DEFAULT_WALLETCONNECT_METHODS = [
+    'eth_sendTransaction',
+    'eth_sendRawTransaction',
+    'personal_sign',
+    'eth_sign',
+    'eth_signTypedData',
+    'eth_signTypedData_v3',
+    'eth_signTypedData_v4',
+    'eth_accounts',
+    'eth_requestAccounts',
+    'eth_chainId',
+    'wallet_switchEthereumChain',
+    'wallet_addEthereumChain',
+    'wallet_getPermissions',
+    'wallet_requestPermissions',
+    'wallet_watchAsset',
+];
+const DEFAULT_EVENTS = ['chainChanged', 'accountsChanged'];
+// Injectable so the missing-optional-peer hint is hermetically testable
+// (the peers are devDependencies here, so they always resolve in-repo).
+let loadModule = (specifier) => import(specifier);
+/** @internal Test hook: stub the dynamic importer; call with no args to restore. */
+export const __setWalletConnectModuleLoader = (loader) => {
+    loadModule = loader ?? ((specifier) => import(specifier));
+};
+const parseCaipChainId = (caip) => {
+    const match = typeof caip === 'string' ? /^eip155:(\d+)$/.exec(caip) : null;
+    return match ? toHex(BigInt(match[1])) : undefined;
+};
+const toCaipChainId = (chainId) => `eip155:${Number(BigInt(chainId))}`;
+/**
+ * The session_request loop, exported for hermetic tests: validates the CAIP
+ * chain against the approved set, switches the wallet when an approved
+ * non-active chain is requested (single-active-chain semantics, like a
+ * mobile wallet), and dispatches through the controller's gating. Errors map
+ * through serializeRpcError, so 4001/4100/4200/4902/-32602 cross the relay
+ * verbatim.
+ */
+export const createSessionRequestHandler = (wallet, config, respond) => {
+    return async (event) => {
+        const { id, topic, params, verifyContext } = event;
+        try {
+            const chainId = parseCaipChainId(params.chainId);
+            if (!chainId || !config.chains.includes(chainId)) {
+                await respond(topic, {
+                    id,
+                    jsonrpc: '2.0',
+                    error: { code: 5100, message: 'Requested chain is not approved for this session.' },
+                });
+                return;
+            }
+            if (chainId !== wallet.currentChainId) {
+                await wallet.switchNetwork(chainId);
+            }
+            const result = await wallet.handleExternalRequest({ method: params.request.method, params: params.request.params }, config.enforceOrigins
+                ? { origin: verifyContext?.verified?.origin }
+                : { bypassOriginCheck: true });
+            await respond(topic, { id, jsonrpc: '2.0', result });
+        }
+        catch (error) {
+            const serialized = serializeRpcError(error);
+            await respond(topic, {
+                id,
+                jsonrpc: '2.0',
+                error: {
+                    code: serialized.code,
+                    message: serialized.message,
+                    ...(typeof serialized.data === 'string' ? { data: serialized.data } : {}),
+                },
+            });
+        }
+    };
+};
+/**
+ * Polls the AppKit/W3M modal for the pairing URI: Playwright CSS locators
+ * pierce the shadow DOM, and AppKit's w3m-connecting-wc-qrcode renders
+ * `<wui-qr-code uri=...>` as a real DOM attribute (the same contract
+ * Reown's own laboratory tests read). For non-AppKit modals pass a
+ * `selector` or use the connect() `getUri` hook.
+ */
+export async function getWalletConnectUri(page, options = {}) {
+    const timeoutMs = options.timeoutMs ?? 15_000;
+    const selector = options.selector ?? 'wui-qr-code';
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        // Bounded per attempt: getAttribute would otherwise auto-wait for the
+        // element with Playwright's default timeout.
+        const uri = await page
+            .locator(selector)
+            .first()
+            .getAttribute('uri', { timeout: 250 })
+            .catch(() => null);
+        if (uri?.startsWith('wc:')) {
+            return uri;
+        }
+        await new Promise((resolve) => setTimeout(resolve, 100));
+    }
+    throw new Error(`Timed out after ${timeoutMs}ms waiting for a wc: pairing URI on "${selector}". ` +
+        'For non-AppKit modals pass { selector } or supply a getUri(page) hook to connect().');
+}
+export class WalletConnectWallet {
+    /** Underlying SignClient — escape hatch for protocol-level access. */
+    client;
+    wallet;
+    utils;
+    chains;
+    methods;
+    events;
+    enforceOrigins;
+    sessionList = [];
+    requestHandler;
+    deleteHandler;
+    unsubscribeProviderEvents;
+    closed = false;
+    constructor(client, utils, options) {
+        this.client = client;
+        this.utils = utils;
+        this.wallet = options.wallet;
+        this.chains = (options.chains ?? [options.wallet.currentChainId]).map((chainId) => toHex(typeof chainId === 'number' ? chainId : BigInt(chainId)));
+        this.methods = options.methods ?? DEFAULT_WALLETCONNECT_METHODS;
+        this.events = options.events ?? DEFAULT_EVENTS;
+        this.enforceOrigins = options.enforceOrigins ?? true;
+        // INVARIANT: never register a 'session_authenticate' listener. With zero
+        // listeners, sign-client routes One-Click Auth (SIWE) dapps through the
+        // wc_sessionPropose fallback — a plain session plus personal_sign —
+        // which this wallet handles. Subscribing would suppress that fallback.
+        this.requestHandler = createSessionRequestHandler(this.wallet, { chains: this.chains, enforceOrigins: this.enforceOrigins }, (topic, response) => this.client.respond({ topic, response }));
+        client.on('session_request', this.requestHandler);
+        this.deleteHandler = ({ topic }) => {
+            const index = this.sessionList.findIndex((session) => session.topic === topic);
+            if (index !== -1) {
+                this.sessionList.splice(index, 1);
+            }
+        };
+        client.on('session_delete', this.deleteHandler);
+        this.unsubscribeProviderEvents = this.wallet.onProviderEvent((event, payload) => {
+            void this.forwardProviderEvent(event, payload);
+        });
+    }
+    /**
+     * Async factory: dynamically imports the optional peers and throws an
+     * install hint when they are missing.
+     */
+    static async create(options) {
+        let signClientModule;
+        let utils;
+        try {
+            signClientModule = (await loadModule('@walletconnect/sign-client'));
+            utils = (await loadModule('@walletconnect/utils'));
+        }
+        catch (error) {
+            throw new Error("The './walletconnect' module requires optional peer dependencies. " +
+                'Install with: npm i -D @walletconnect/sign-client @walletconnect/utils @walletconnect/types', { cause: error });
+        }
+        const SignClient = (signClientModule.SignClient ??
+            signClientModule.default ??
+            signClientModule);
+        const client = await SignClient.init({
+            projectId: options.projectId,
+            ...(options.relayUrl ? { relayUrl: options.relayUrl } : {}),
+            metadata: {
+                name: 'web3-tester Wallet',
+                description: 'Headless WalletConnect wallet for E2E tests',
+                url: 'https://github.com/AndyMarigoldLabs/web3-tester',
+                icons: [],
+                ...options.metadata,
+            },
+            // A request parked by holdNextRequest must not starve delivery of
+            // subsequent session_requests (sign-client serializes them by default).
+            signConfig: { disableRequestQueue: true },
+            // Nothing touches disk: the SDK default would persist ./walletconnect.db.
+            ...(options.storage ? { storage: options.storage } : { storageOptions: { database: ':memory:' } }),
+        });
+        return new WalletConnectWallet(client, utils, options);
+    }
+    get sessions() {
+        return [...this.sessionList];
+    }
+    /**
+     * Pairs with a wc: URI, gates the session proposal through the controller
+     * (as a synthetic eth_requestAccounts — approveNext('eth_requestAccounts')
+     * arms it; the match callback receives the proposal payload), builds the
+     * approved namespaces, and settles the session.
+     */
+    async pair(options) {
+        const timeoutMs = options.timeoutMs ?? 30_000;
+        const { topic: pairingTopic } = this.utils.parseUri(options.uri);
+        const proposal = await new Promise((resolve, reject) => {
+            const cleanup = () => {
+                clearTimeout(timer);
+                (this.client.off ?? this.client.removeListener)?.call(this.client, 'session_proposal', handler);
+            };
+            const timer = setTimeout(() => {
+                cleanup();
+                reject(new Error(`Timed out after ${timeoutMs}ms waiting for the session proposal.`));
+            }, timeoutMs);
+            const handler = (event) => {
+                if (event.params?.pairingTopic && event.params.pairingTopic !== pairingTopic) {
+                    return;
+                }
+                cleanup();
+                resolve(event);
+            };
+            this.client.on('session_proposal', handler);
+            this.client.pair({ uri: options.uri }).catch((error) => {
+                cleanup();
+                reject(error instanceof Error ? error : new Error(String(error)));
+            });
+        });
+        // Gate the connect through the controller. Deny-by-default live mode,
+        // simulateRejection, and holds all apply with zero new machinery.
+        let accounts;
+        try {
+            accounts = (await this.wallet.handleExternalRequest({
+                method: 'eth_requestAccounts',
+                params: [
+                    {
+                        origin: proposal.verifyContext?.verified?.origin,
+                        proposer: proposal.params?.proposer?.metadata,
+                        requiredNamespaces: proposal.params?.requiredNamespaces,
+                        optionalNamespaces: proposal.params?.optionalNamespaces,
+                    },
+                ],
+            }, this.enforceOrigins
+                ? { origin: proposal.verifyContext?.verified?.origin }
+                : { bypassOriginCheck: true }));
+        }
+        catch (error) {
+            await this.client
+                .reject({ id: proposal.id, reason: this.utils.getSdkError('USER_REJECTED') })
+                .catch(() => undefined);
+            throw error;
+        }
+        let namespaces;
+        try {
+            namespaces = this.utils.buildApprovedNamespaces({
+                proposal: proposal.params,
+                supportedNamespaces: {
+                    eip155: {
+                        chains: this.chains.map(toCaipChainId),
+                        methods: [...this.methods],
+                        events: [...this.events],
+                        accounts: this.chains.flatMap((chainId) => accounts.map((account) => `${toCaipChainId(chainId)}:${account}`)),
+                    },
+                },
+            });
+        }
+        catch (error) {
+            await this.client
+                .reject({ id: proposal.id, reason: this.utils.getSdkError('UNSUPPORTED_CHAINS') })
+                .catch(() => undefined);
+            throw new Error("Could not satisfy the dapp's requested namespaces — pass the chains it needs in " +
+                `WalletConnectWalletOptions.chains. ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+        }
+        const { topic, acknowledged } = await this.client.approve({ id: proposal.id, namespaces });
+        const settled = await acknowledged();
+        const session = {
+            topic,
+            namespaces: settled?.namespaces ?? namespaces,
+            peerMetadata: proposal.params?.proposer?.metadata ??
+                { name: '', description: '', url: '', icons: [] },
+        };
+        this.sessionList.push(session);
+        return session;
+    }
+    /** Convenience: extract the URI from the dapp's modal, then pair(). */
+    async connect(page, options = {}) {
+        const uri = options.getUri ? await options.getUri(page) : await getWalletConnectUri(page, options);
+        return this.pair({ uri, timeoutMs: options.timeoutMs });
+    }
+    /** Wallet-initiated disconnect; all sessions when topic is omitted. */
+    async disconnect(topic) {
+        const targets = this.sessionList.filter((session) => !topic || session.topic === topic);
+        for (const session of targets) {
+            await this.client
+                .disconnect({ topic: session.topic, reason: this.utils.getSdkError('USER_DISCONNECTED') })
+                .catch(() => undefined);
+            this.deleteHandler({ topic: session.topic });
+        }
+    }
+    /**
+     * Best-effort teardown: disconnect sessions (5s cap), unsubscribe the
+     * controller listener, close the relay transport, stop the heartbeat.
+     * Always call in finally / fixture teardown.
+     */
+    async close() {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        await Promise.race([
+            this.disconnect(),
+            new Promise((resolve) => setTimeout(resolve, 5_000)),
+        ]).catch(() => undefined);
+        this.unsubscribeProviderEvents();
+        (this.client.off ?? this.client.removeListener)?.call(this.client, 'session_request', this.requestHandler);
+        (this.client.off ?? this.client.removeListener)?.call(this.client, 'session_delete', this.deleteHandler);
+        await this.client.core?.relayer?.transportClose?.().catch(() => undefined);
+        this.client.core?.heartbeat?.stop?.();
+    }
+    // Relay round-trips happen here, OFF the controller's await path — the
+    // onProviderEvent dispatch is fire-and-forget, so a dead relay can never
+    // hang wallet.switchNetwork()/disconnect().
+    async forwardProviderEvent(event, payload) {
+        for (const session of [...this.sessionList]) {
+            try {
+                if (event === 'chainChanged') {
+                    const chainId = payload;
+                    if (!this.chains.includes(chainId)) {
+                        // Extend the session namespace first (MetaMask-mobile behavior).
+                        this.chains = [...this.chains, chainId];
+                        const namespaces = session.namespaces;
+                        const eip155 = namespaces.eip155;
+                        if (eip155) {
+                            const caip = toCaipChainId(chainId);
+                            const extended = {
+                                ...namespaces,
+                                eip155: {
+                                    ...eip155,
+                                    chains: [...(eip155.chains ?? []), caip],
+                                    accounts: [
+                                        ...(eip155.accounts ?? []),
+                                        ...this.wallet.currentAccounts.map((account) => `${caip}:${account}`),
+                                    ],
+                                },
+                            };
+                            await this.client.update({ topic: session.topic, namespaces: extended });
+                            session.namespaces = extended;
+                        }
+                    }
+                    await this.client.emit({
+                        topic: session.topic,
+                        event: { name: 'chainChanged', data: Number(BigInt(chainId)) },
+                        chainId: toCaipChainId(chainId),
+                    });
+                }
+                else if (event === 'accountsChanged') {
+                    await this.client.emit({
+                        topic: session.topic,
+                        event: { name: 'accountsChanged', data: payload },
+                        chainId: toCaipChainId(this.wallet.currentChainId),
+                    });
+                }
+                else if (event === 'disconnect') {
+                    await this.client
+                        .disconnect({ topic: session.topic, reason: this.utils.getSdkError('USER_DISCONNECTED') })
+                        .catch(() => undefined);
+                    this.deleteHandler({ topic: session.topic });
+                }
+            }
+            catch {
+                // Relay errors must never break wallet state transitions.
+            }
+        }
+    }
+}
+//# sourceMappingURL=walletconnect.js.map

package/dist/walletconnect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walletconnect.js","sourceRoot":"","sources":["../src/walletconnect.ts"],"names":[],"mappings":"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"}

package/examples/live-sepolia.spec.ts

@@ -1,6 +1,9 @@
 import { expect, test } from '@marigoldlabs/web3-tester/live-fixtures';
 
-test.skip(!process.env.FJORD_PRIVATE_KEY, 'FJORD_PRIVATE_KEY is required for live Sepolia tests.');
+test.skip(
+  !process.env.WEB3_TESTER_PRIVATE_KEY,
+  'WEB3_TESTER_PRIVATE_KEY is required for live Sepolia tests.',
+);
 
 type EthereumProvider = {
   request: (args: { method: string; params?: unknown[] }) => Promise<unknown>;
@@ -19,3 +22,19 @@ test('loads a live Sepolia wallet', async ({ page, wallet }) => {
     )
     .toEqual([wallet.primaryAccount]);
 });
+
+test('signs only after the test arms the request (deny-by-default)', async ({ page, wallet }) => {
+  await page.goto('/');
+
+  // Live wallets refuse signing until armed; arm exactly one personal_sign.
+  wallet.approveNext('personal_sign');
+
+  const signature = await page.evaluate(async () =>
+    (window as typeof window & { ethereum: EthereumProvider }).ethereum.request({
+      method: 'personal_sign',
+      params: ['0x68656c6c6f', null],
+    }),
+  );
+
+  expect(String(signature)).toMatch(/^0x/);
+});