@aztec-labs/wallet-sdk 6.0.0-nightly.20260829

package/dest/manager/types.d.ts

@@ -0,0 +1,168 @@
+import type { ChainInfo } from '@aztec-labs/aztec.js/account';
+import type { Wallet } from '@aztec-labs/aztec.js/wallet';
+/**
+ * A pending connection that requires user verification before finalizing.
+ *
+ * After key exchange, both dApp and wallet compute a verification hash independently.
+ * The dApp should display this hash (typically as emojis) and let the user confirm
+ * it matches what's shown in their wallet before calling `confirm()`.
+ *
+ * This protects the dApp from connecting to a malicious wallet that might be
+ * intercepting the connection (MITM attack).
+ */
+export interface PendingConnection {
+    /**
+     * The verification hash computed from the shared secret.
+     * Use `hashToEmoji()` to convert to a visual representation for user verification.
+     * The user should confirm this matches what their wallet displays.
+     */
+    verificationHash: string;
+    /**
+     * Confirms the connection after user verifies the emojis match.
+     * @returns The connected wallet instance
+     */
+    confirm(): Promise<Wallet>;
+    /**
+     * Cancels the pending connection.
+     * Call this if the user indicates the emojis don't match.
+     */
+    cancel(): void;
+}
+/**
+ * Configuration for extension wallets
+ */
+export interface ExtensionWalletConfig {
+    /** Whether extension wallets are enabled */
+    enabled: boolean;
+    /** Optional list of allowed extension IDs (whitelist) */
+    allowList?: string[];
+    /** Optional list of blocked extension IDs (blacklist) */
+    blockList?: string[];
+}
+/**
+ * Configuration for web wallets
+ */
+export interface WebWalletConfig {
+    /** URLs of web wallet services */
+    urls: string[];
+}
+/**
+ * Configuration for the WalletManager
+ */
+export interface WalletManagerConfig {
+    /** Extension wallet configuration */
+    extensions?: ExtensionWalletConfig;
+    /** Web wallet configuration */
+    webWallets?: WebWalletConfig;
+}
+/**
+ * Type of wallet provider
+ */
+export type WalletProviderType = 'extension' | 'web';
+/**
+ * Callback type for wallet disconnect events at the provider level.
+ */
+export type ProviderDisconnectionCallback = () => void;
+/**
+ * A wallet provider that can connect to create a wallet instance.
+ * Chain information is already baked in from the discovery process.
+ */
+export interface WalletProvider {
+    /** Unique identifier for the provider */
+    id: string;
+    /** Type of wallet provider */
+    type: WalletProviderType;
+    /** Display name */
+    name: string;
+    /** Icon URL */
+    icon?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+    /**
+     * Establishes a secure channel with this wallet provider.
+     *
+     * This performs the ECDH key exchange and returns a pending connection with the
+     * verification hash. The channel is encrypted but NOT yet verified - the dApp
+     * should display the hash (as emojis) to the user and let them confirm it
+     * matches their wallet before calling `confirm()`.
+     *
+     * @param appId - Application identifier for the requesting dapp
+     * @param options - Optional provider-specific options (e.g. container element for iframe wallets)
+     * @returns A pending connection with verification hash and confirm/cancel methods
+     *
+     * @example
+     * ```typescript
+     * const pending = await provider.establishSecureChannel('my-app');
+     *
+     * // Show emojis to user for verification
+     * const emojis = hashToEmoji(pending.verificationHash);
+     * showDialog(`Verify these match your wallet: ${emojis}`);
+     *
+     * // User confirms emojis match
+     * const wallet = await pending.confirm();
+     * ```
+     */
+    establishSecureChannel(appId: string, options?: Record<string, unknown>): Promise<PendingConnection>;
+    /**
+     * Disconnects the current wallet and cleans up resources.
+     * After calling this, the wallet returned from confirm() should no longer be used.
+     * @returns A promise that resolves when disconnection is complete
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Registers a callback to be invoked when the wallet disconnects unexpectedly.
+     * @param callback - Function to call when wallet disconnects
+     * @returns A function to unregister the callback
+     */
+    onDisconnect(callback: ProviderDisconnectionCallback): () => void;
+    /**
+     * Returns whether the provider's wallet connection has been disconnected.
+     * @returns true if the wallet is no longer connected
+     */
+    isDisconnected(): boolean;
+}
+/**
+ * Options for discovering wallets
+ */
+export interface DiscoverWalletsOptions {
+    /** Chain information to filter by */
+    chainInfo: ChainInfo;
+    /** Application ID making the request */
+    appId: string;
+    /** Discovery timeout in milliseconds. Default: 60000 (60s) */
+    timeout?: number;
+    /**
+     * Callback invoked when a wallet provider is discovered.
+     * Use this to show wallets to users as they approve them, rather than
+     * waiting for the full timeout.
+     */
+    onWalletDiscovered?: (provider: WalletProvider) => void;
+}
+/**
+ * A cancellable discovery session.
+ *
+ * Returned by `WalletManager.getAvailableWallets()` to allow consumers to
+ * cancel discovery when no longer needed (e.g., network changes, user navigates away).
+ *
+ * @example
+ * ```typescript
+ * const discovery = WalletManager.configure({...}).getAvailableWallets({...});
+ *
+ * // Iterate over discovered wallets
+ * for await (const wallet of discovery.wallets) {
+ *   console.log(`Found: ${wallet.name}`);
+ * }
+ *
+ * // Cancel discovery when no longer needed
+ * discovery.cancel();
+ * ```
+ */
+export interface DiscoverySession {
+    /** Async iterator that yields wallet providers as they're discovered */
+    wallets: AsyncIterable<WalletProvider>;
+    /** Promise that resolves when discovery completes or is cancelled */
+    done: Promise<void>;
+    /** Cancel discovery immediately and clean up resources */
+    cancel: () => void;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9tYW5hZ2VyL3R5cGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLFNBQVMsRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBQzlELE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBRTFEOzs7Ozs7Ozs7R0FTRztBQUNILE1BQU0sV0FBVyxpQkFBaUI7SUFDaEM7Ozs7T0FJRztJQUNILGdCQUFnQixFQUFFLE1BQU0sQ0FBQztJQUV6Qjs7O09BR0c7SUFDSCxPQUFPLElBQUksT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBRTNCOzs7T0FHRztJQUNILE1BQU0sSUFBSSxJQUFJLENBQUM7Q0FDaEI7QUFFRDs7R0FFRztBQUNILE1BQU0sV0FBVyxxQkFBcUI7SUFDcEMsNENBQTRDO0lBQzVDLE9BQU8sRUFBRSxPQUFPLENBQUM7SUFDakIseURBQXlEO0lBQ3pELFNBQVMsQ0FBQyxFQUFFLE1BQU0sRUFBRSxDQUFDO0lBQ3JCLHlEQUF5RDtJQUN6RCxTQUFTLENBQUMsRUFBRSxNQUFNLEVBQUUsQ0FBQztDQUN0QjtBQUVEOztHQUVHO0FBQ0gsTUFBTSxXQUFXLGVBQWU7SUFDOUIsa0NBQWtDO0lBQ2xDLElBQUksRUFBRSxNQUFNLEVBQUUsQ0FBQztDQUNoQjtBQUVEOztHQUVHO0FBQ0gsTUFBTSxXQUFXLG1CQUFtQjtJQUNsQyxxQ0FBcUM7SUFDckMsVUFBVSxDQUFDLEVBQUUscUJBQXFCLENBQUM7SUFDbkMsK0JBQStCO0lBQy9CLFVBQVUsQ0FBQyxFQUFFLGVBQWUsQ0FBQztDQUM5QjtBQUVEOztHQUVHO0FBQ0gsTUFBTSxNQUFNLGtCQUFrQixHQUFHLFdBQVcsR0FBRyxLQUFLLENBQUM7QUFFckQ7O0dBRUc7QUFDSCxNQUFNLE1BQU0sNkJBQTZCLEdBQUcsTUFBTSxJQUFJLENBQUM7QUFFdkQ7OztHQUdHO0FBQ0gsTUFBTSxXQUFXLGNBQWM7SUFDN0IseUNBQXlDO0lBQ3pDLEVBQUUsRUFBRSxNQUFNLENBQUM7SUFDWCw4QkFBOEI7SUFDOUIsSUFBSSxFQUFFLGtCQUFrQixDQUFDO0lBQ3pCLG1CQUFtQjtJQUNuQixJQUFJLEVBQUUsTUFBTSxDQUFDO0lBQ2IsZUFBZTtJQUNmLElBQUksQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUNkLDBCQUEwQjtJQUMxQixRQUFRLENBQUMsRUFBRSxNQUFNLENBQUMsTUFBTSxFQUFFLE9BQU8sQ0FBQyxDQUFDO0lBQ25DOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztPQXVCRztJQUNILHNCQUFzQixDQUFDLEtBQUssRUFBRSxNQUFNLEVBQUUsT0FBTyxDQUFDLEVBQUUsTUFBTSxDQUFDLE1BQU0sRUFBRSxPQUFPLENBQUMsR0FBRyxPQUFPLENBQUMsaUJBQWlCLENBQUMsQ0FBQztJQUNyRzs7OztPQUlHO0lBQ0gsVUFBVSxJQUFJLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUM1Qjs7OztPQUlHO0lBQ0gsWUFBWSxDQUFDLFFBQVEsRUFBRSw2QkFBNkIsR0FBRyxNQUFNLElBQUksQ0FBQztJQUNsRTs7O09BR0c7SUFDSCxjQUFjLElBQUksT0FBTyxDQUFDO0NBQzNCO0FBRUQ7O0dBRUc7QUFDSCxNQUFNLFdBQVcsc0JBQXNCO0lBQ3JDLHFDQUFxQztJQUNyQyxTQUFTLEVBQUUsU0FBUyxDQUFDO0lBQ3JCLHdDQUF3QztJQUN4QyxLQUFLLEVBQUUsTUFBTSxDQUFDO0lBQ2QsOERBQThEO0lBQzlELE9BQU8sQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUNqQjs7OztPQUlHO0lBQ0gsa0JBQWtCLENBQUMsRUFBRSxDQUFDLFFBQVEsRUFBRSxjQUFjLEtBQUssSUFBSSxDQUFDO0NBQ3pEO0FBRUQ7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQWtCRztBQUNILE1BQU0sV0FBVyxnQkFBZ0I7SUFDL0Isd0VBQXdFO0lBQ3hFLE9BQU8sRUFBRSxhQUFhLENBQUMsY0FBYyxDQUFDLENBQUM7SUFDdkMscUVBQXFFO0lBQ3JFLElBQUksRUFBRSxPQUFPLENBQUMsSUFBSSxDQUFDLENBQUM7SUFDcEIsMERBQTBEO0lBQzFELE1BQU0sRUFBRSxNQUFNLElBQUksQ0FBQztDQUNwQiJ9

package/dest/manager/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/manager/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAE1D;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE3B;;;OAGG;IACH,MAAM,IAAI,IAAI,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,+BAA+B;IAC/B,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,KAAK,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,MAAM,IAAI,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,IAAI,EAAE,kBAAkB,CAAC;IACzB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACrG;;;;OAIG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B;;;;OAIG;IACH,YAAY,CAAC,QAAQ,EAAE,6BAA6B,GAAG,MAAM,IAAI,CAAC;IAClE;;;OAGG;IACH,cAAc,IAAI,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,qCAAqC;IACrC,SAAS,EAAE,SAAS,CAAC;IACrB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;CACzD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,OAAO,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IACvC,qEAAqE;IACrE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB"}

package/dest/manager/types.js

@@ -0,0 +1,19 @@
+/**
+ * A cancellable discovery session.
+ *
+ * Returned by `WalletManager.getAvailableWallets()` to allow consumers to
+ * cancel discovery when no longer needed (e.g., network changes, user navigates away).
+ *
+ * @example
+ * ```typescript
+ * const discovery = WalletManager.configure({...}).getAvailableWallets({...});
+ *
+ * // Iterate over discovered wallets
+ * for await (const wallet of discovery.wallets) {
+ *   console.log(`Found: ${wallet.name}`);
+ * }
+ *
+ * // Cancel discovery when no longer needed
+ * discovery.cancel();
+ * ```
+ */ export { };

package/dest/manager/wallet_manager.d.ts

@@ -0,0 +1,70 @@
+import type { DiscoverWalletsOptions, DiscoverySession, WalletManagerConfig } from './types.js';
+/**
+ * Manager for wallet discovery, configuration, and connection.
+ *
+ * This is the main entry point for dApps to discover and connect to wallets.
+ *
+ * @example Basic usage with async iterator
+ * ```typescript
+ * const discovery = WalletManager.configure({ extensions: { enabled: true } })
+ *   .getAvailableWallets({ chainInfo, appId: 'my-app' });
+ *
+ * // Iterate over discovered wallets
+ * for await (const provider of discovery.wallets) {
+ *   console.log(`Found wallet: ${provider.name}`);
+ * }
+ *
+ * // Or cancel early when done
+ * discovery.cancel();
+ * ```
+ *
+ * @example With callback for discovered wallets
+ * ```typescript
+ * const discovery = manager.getAvailableWallets({
+ *   chainInfo,
+ *   appId: 'my-app',
+ *   onWalletDiscovered: (provider) => console.log(`Found: ${provider.name}`),
+ * });
+ *
+ * // Wait for discovery to complete or cancel it
+ * await discovery.done;
+ * ```
+ */
+export declare class WalletManager {
+    private config;
+    private constructor();
+    /**
+     * Configures the WalletManager with provider settings
+     * @param config - Configuration options for wallet providers
+     */
+    static configure(config: WalletManagerConfig): WalletManager;
+    /**
+     * Discovers all available wallets for a given chain and version.
+     *
+     * Returns a `DiscoverySession` with:
+     * - `wallets`: AsyncIterable to iterate over discovered wallets
+     * - `done`: Promise that resolves when discovery completes or is cancelled
+     * - `cancel()`: Function to stop discovery immediately
+     *
+     * If `onWalletDiscovered` callback is provided, wallets are also streamed via callback.
+     *
+     * @param options - Discovery options including chain info, appId, and timeout
+     * @returns A cancellable discovery session
+     */
+    getAvailableWallets(options: DiscoverWalletsOptions): DiscoverySession;
+    /**
+     * Creates a WalletProvider from a discovered wallet.
+     * Returns null if the wallet is not allowed by config.
+     * @param discoveredWallet - The discovered wallet from extension discovery.
+     * @param chainInfo - Network information.
+     * @param extensionConfig - Extension wallet configuration.
+     */
+    private createProviderFromDiscoveredWallet;
+    /**
+     * Checks if an extension is allowed based on allow/block lists
+     * @param extensionId - The extension ID to check
+     * @param config - Extension wallet configuration containing allow/block lists
+     */
+    private isExtensionAllowed;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid2FsbGV0X21hbmFnZXIuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9tYW5hZ2VyL3dhbGxldF9tYW5hZ2VyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQU1BLE9BQU8sS0FBSyxFQUNWLHNCQUFzQixFQUN0QixnQkFBZ0IsRUFJaEIsbUJBQW1CLEVBRXBCLE1BQU0sWUFBWSxDQUFDO0FBRXBCOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0E4Qkc7QUFDSCxxQkFBYSxhQUFhO0lBQ3hCLE9BQU8sQ0FBQyxNQUFNLENBR1o7SUFFRixPQUFPLGVBQWlCO0lBRXhCOzs7T0FHRztJQUNILE1BQU0sQ0FBQyxTQUFTLENBQUMsTUFBTSxFQUFFLG1CQUFtQixHQUFHLGFBQWEsQ0FPM0Q7SUFFRDs7Ozs7Ozs7Ozs7O09BWUc7SUFDSCxtQkFBbUIsQ0FBQyxPQUFPLEVBQUUsc0JBQXNCLEdBQUcsZ0JBQWdCLENBOEdyRTtJQUVEOzs7Ozs7T0FNRztJQUNILE9BQU8sQ0FBQyxrQ0FBa0M7SUEwRTFDOzs7O09BSUc7SUFDSCxPQUFPLENBQUMsa0JBQWtCO0NBVzNCIn0=

package/dest/manager/wallet_manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet_manager.d.ts","sourceRoot":"","sources":["../../src/manager/wallet_manager.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,sBAAsB,EACtB,gBAAgB,EAIhB,mBAAmB,EAEpB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAGZ;IAEF,OAAO,eAAiB;IAExB;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CAO3D;IAED;;;;;;;;;;;;OAYG;IACH,mBAAmB,CAAC,OAAO,EAAE,sBAAsB,GAAG,gBAAgB,CA8GrE;IAED;;;;;;OAMG;IACH,OAAO,CAAC,kCAAkC;IA0E1C;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;CAW3B"}

package/dest/manager/wallet_manager.js

@@ -0,0 +1,256 @@
+import { promiseWithResolvers } from '@aztec-labs/foundation/promise';
+import { ExtensionProvider, ExtensionWallet } from '../extension/provider/index.js';
+import { discoverWebWallets } from '../iframe/provider/iframe_discovery.js';
+import { WalletMessageType } from '../types.js';
+/**
+ * Manager for wallet discovery, configuration, and connection.
+ *
+ * This is the main entry point for dApps to discover and connect to wallets.
+ *
+ * @example Basic usage with async iterator
+ * ```typescript
+ * const discovery = WalletManager.configure({ extensions: { enabled: true } })
+ *   .getAvailableWallets({ chainInfo, appId: 'my-app' });
+ *
+ * // Iterate over discovered wallets
+ * for await (const provider of discovery.wallets) {
+ *   console.log(`Found wallet: ${provider.name}`);
+ * }
+ *
+ * // Or cancel early when done
+ * discovery.cancel();
+ * ```
+ *
+ * @example With callback for discovered wallets
+ * ```typescript
+ * const discovery = manager.getAvailableWallets({
+ *   chainInfo,
+ *   appId: 'my-app',
+ *   onWalletDiscovered: (provider) => console.log(`Found: ${provider.name}`),
+ * });
+ *
+ * // Wait for discovery to complete or cancel it
+ * await discovery.done;
+ * ```
+ */ export class WalletManager {
+    config = {
+        extensions: {
+            enabled: true
+        },
+        webWallets: {
+            urls: []
+        }
+    };
+    constructor(){}
+    /**
+   * Configures the WalletManager with provider settings
+   * @param config - Configuration options for wallet providers
+   */ static configure(config) {
+        const instance = new WalletManager();
+        instance.config = {
+            extensions: config.extensions ?? {
+                enabled: true
+            },
+            webWallets: config.webWallets ?? {
+                urls: []
+            }
+        };
+        return instance;
+    }
+    /**
+   * Discovers all available wallets for a given chain and version.
+   *
+   * Returns a `DiscoverySession` with:
+   * - `wallets`: AsyncIterable to iterate over discovered wallets
+   * - `done`: Promise that resolves when discovery completes or is cancelled
+   * - `cancel()`: Function to stop discovery immediately
+   *
+   * If `onWalletDiscovered` callback is provided, wallets are also streamed via callback.
+   *
+   * @param options - Discovery options including chain info, appId, and timeout
+   * @returns A cancellable discovery session
+   */ getAvailableWallets(options) {
+        const { chainInfo, appId } = options;
+        const abortController = new AbortController();
+        const pendingProviders = [];
+        let pendingResolve = null;
+        let completed = false;
+        const { promise: donePromise, resolve: resolveDone } = promiseWithResolvers();
+        const pendingSources = new Set();
+        const emit = (provider)=>{
+            options.onWalletDiscovered?.(provider);
+            if (pendingResolve) {
+                const resolve = pendingResolve;
+                pendingResolve = null;
+                resolve({
+                    value: provider,
+                    done: false
+                });
+            } else {
+                pendingProviders.push(provider);
+            }
+        };
+        const markComplete = ()=>{
+            completed = true;
+            resolveDone();
+            if (pendingResolve) {
+                const resolve = pendingResolve;
+                pendingResolve = null;
+                resolve({
+                    value: undefined,
+                    done: true
+                });
+            }
+        };
+        const sourceComplete = (source)=>{
+            pendingSources.delete(source);
+            if (pendingSources.size === 0) {
+                markComplete();
+            }
+        };
+        if (this.config.extensions?.enabled) {
+            pendingSources.add('extensions');
+            const extensionConfig = this.config.extensions;
+            void ExtensionProvider.discoverWallets(chainInfo, {
+                appId,
+                timeout: options.timeout,
+                signal: abortController.signal,
+                onWalletDiscovered: (discoveredWallet)=>{
+                    const provider = this.createProviderFromDiscoveredWallet(discoveredWallet, chainInfo, extensionConfig);
+                    if (provider) {
+                        emit(provider);
+                    }
+                }
+            }).then(()=>sourceComplete('extensions'));
+        }
+        if (this.config.webWallets?.urls && this.config.webWallets.urls.length > 0) {
+            pendingSources.add('webWallets');
+            const webSession = discoverWebWallets(this.config.webWallets.urls, chainInfo);
+            // Forward discovered web wallets into the shared iterator
+            void (async ()=>{
+                try {
+                    for await (const provider of webSession.wallets){
+                        if (abortController.signal.aborted) {
+                            break;
+                        }
+                        emit(provider);
+                    }
+                } finally{
+                    sourceComplete('webWallets');
+                }
+            })();
+            abortController.signal.addEventListener('abort', ()=>webSession.cancel(), {
+                once: true
+            });
+        }
+        if (pendingSources.size === 0) {
+            markComplete();
+        }
+        const wallets = {
+            // eslint-disable-next-line jsdoc/require-jsdoc
+            [Symbol.asyncIterator] () {
+                return {
+                    // eslint-disable-next-line jsdoc/require-jsdoc
+                    next () {
+                        if (pendingProviders.length > 0) {
+                            return Promise.resolve({
+                                value: pendingProviders.shift(),
+                                done: false
+                            });
+                        }
+                        if (completed) {
+                            return Promise.resolve({
+                                value: undefined,
+                                done: true
+                            });
+                        }
+                        return new Promise((resolve)=>{
+                            pendingResolve = resolve;
+                        });
+                    }
+                };
+            }
+        };
+        return {
+            wallets,
+            done: donePromise,
+            cancel: ()=>abortController.abort()
+        };
+    }
+    /**
+   * Creates a WalletProvider from a discovered wallet.
+   * Returns null if the wallet is not allowed by config.
+   * @param discoveredWallet - The discovered wallet from extension discovery.
+   * @param chainInfo - Network information.
+   * @param extensionConfig - Extension wallet configuration.
+   */ createProviderFromDiscoveredWallet(discoveredWallet, chainInfo, extensionConfig) {
+        const { info } = discoveredWallet;
+        if (!this.isExtensionAllowed(info.id, extensionConfig)) {
+            return null;
+        }
+        let extensionWallet = null;
+        const provider = {
+            id: info.id,
+            type: 'extension',
+            name: info.name,
+            icon: info.icon,
+            metadata: {
+                version: info.version
+            },
+            establishSecureChannel: async (connectAppId)=>{
+                const connection = await discoveredWallet.establishSecureChannel();
+                provider.metadata = {
+                    ...provider.metadata,
+                    verificationHash: connection.info.verificationHash
+                };
+                return {
+                    verificationHash: connection.info.verificationHash,
+                    confirm: ()=>{
+                        extensionWallet = ExtensionWallet.create(connection.info.id, connection.port, connection.sharedKey, chainInfo, connectAppId);
+                        return Promise.resolve(extensionWallet.asWallet());
+                    },
+                    cancel: ()=>{
+                        // Send disconnect to terminate the session on the extension side
+                        // but keep the port open so we can retry key exchange
+                        connection.port.postMessage({
+                            type: WalletMessageType.DISCONNECT,
+                            requestId: discoveredWallet.requestId
+                        });
+                    }
+                };
+            },
+            disconnect: async ()=>{
+                if (extensionWallet) {
+                    await extensionWallet.disconnect();
+                    extensionWallet = null;
+                }
+            },
+            onDisconnect: (callback)=>{
+                if (extensionWallet) {
+                    return extensionWallet.onDisconnect(callback);
+                }
+                return ()=>{};
+            },
+            isDisconnected: ()=>{
+                if (extensionWallet) {
+                    return extensionWallet.isDisconnected();
+                }
+                return true;
+            }
+        };
+        return provider;
+    }
+    /**
+   * Checks if an extension is allowed based on allow/block lists
+   * @param extensionId - The extension ID to check
+   * @param config - Extension wallet configuration containing allow/block lists
+   */ isExtensionAllowed(extensionId, config) {
+        if (config.blockList && config.blockList.includes(extensionId)) {
+            return false;
+        }
+        if (config.allowList && config.allowList.length > 0) {
+            return config.allowList.includes(extensionId);
+        }
+        return true;
+    }
+}