@0xkey-io/core 0.1.0

package/dist/__wallet__/web/manager.d.ts

@@ -0,0 +1,70 @@
+import { CrossPlatformWalletStamper } from "../stamper";
+import { CrossPlatformWalletConnector } from "../connector";
+import { TWalletManagerConfig, WalletInterface, WalletProvider, WalletInterfaceType, Chain } from "../../__types__";
+export declare class WebWalletManager {
+    private initializers;
+    private wcClient?;
+    readonly wallets: Partial<Record<WalletInterfaceType, WalletInterface>>;
+    private chainToInterfaces;
+    readonly stamper?: CrossPlatformWalletStamper;
+    readonly connector?: CrossPlatformWalletConnector;
+    /**
+     * Constructs a WebWalletManager instance based on the provided configuration.
+     *
+     * - Enables native Ethereum and/or Solana wallet support if configured.
+     * - Enables WalletConnect support for Ethereum and/or Solana chains if namespaces are provided.
+     * - Sets up `CrossPlatformWalletStamper` and `CrossPlatformWalletConnector` if auth or connecting features are enabled.
+     *
+     * @param cfg - Wallet manager configuration.
+     */
+    constructor(cfg: TWalletManagerConfig);
+    private wcInitPromise?;
+    /**
+     * Initializes WalletConnect components and any registered wallet interfaces.
+     *
+     * - Initializes the low-level WalletConnect client with the provided config.
+     * - Runs any registered async wallet initializers (currently only `WalletConnectWallet`).
+     * - WalletConnect initialization happens in the background and does not block this method.
+     *
+     * @param cfg - Wallet manager configuration used for initializing the WalletConnect client.
+     */
+    init(cfg: TWalletManagerConfig): Promise<void>;
+    /**
+     * Ensures WalletConnect is fully initialized before proceeding.
+     * This should be called before any WalletConnect operations.
+     *
+     * @returns A promise that resolves when WalletConnect is ready.
+     */
+    ensureWalletConnectReady(): Promise<void>;
+    /**
+     * Retrieves available wallet providers, optionally filtered by chain.
+     *
+     * - If a chain is specified, filters wallet interfaces that support that chain.
+     * - Aggregates providers across all wallet interfaces and filters WalletConnect results accordingly.
+     * - Returns native wallet providers immediately without waiting for WalletConnect.
+     * - WalletConnect providers will only be included if WalletConnect has already initialized.
+     *
+     * @param chain - Optional chain to filter providers by (e.g., Ethereum, Solana).
+     * @returns A promise that resolves to an array of `WalletProvider` objects.
+     * @throws {Error} If no wallet interface is registered for the given chain.
+     */
+    getProviders(chain?: Chain): Promise<WalletProvider[]>;
+    /**
+     * Registers a wallet interface type as supporting a specific blockchain chain.
+     *
+     * @param chain - Chain (e.g., Ethereum, Solana).
+     * @param interfaceType - Wallet interface type to associate with the chain.
+     */
+    private addChainInterface;
+    /**
+     * Removes a wallet interface from the manager.
+     *
+     * - Deletes the wallet instance from the wallets map.
+     * - Cleans up references to the wallet interface in chainToInterfaces.
+     * - Removes the chain entry entirely if no interfaces remain.
+     *
+     * @param type - The WalletInterfaceType to remove.
+     */
+    private removeWalletInterface;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/__wallet__/web/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/__wallet__/web/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAG5D,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,KAAK,EACN,MAAM,iBAAiB,CAAC;AAKzB,qBAAa,gBAAgB;IAE3B,OAAO,CAAC,YAAY,CAAkC;IAGtD,OAAO,CAAC,QAAQ,CAAC,CAAsB;IAGvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC,CAAM;IAG7E,OAAO,CAAC,iBAAiB,CAAqD;IAG9E,QAAQ,CAAC,OAAO,CAAC,EAAE,0BAA0B,CAAC;IAG9C,QAAQ,CAAC,SAAS,CAAC,EAAE,4BAA4B,CAAC;IAElD;;;;;;;;OAQG;gBACS,GAAG,EAAE,oBAAoB;IAsErC,OAAO,CAAC,aAAa,CAAC,CAAgB;IAEtC;;;;;;;;OAQG;IACG,IAAI,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBpD;;;;;OAKG;IACG,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;IAM/C;;;;;;;;;;;OAWG;IACG,YAAY,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IA4B5D;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB,CAMvB;IAEF;;;;;;;;OAQG;IACH,OAAO,CAAC,qBAAqB;CAe9B"}

package/dist/__wallet__/web/manager.js

@@ -0,0 +1,177 @@
+'use strict';
+
+var stamper = require('../stamper.js');
+var connector = require('../connector.js');
+var ethereum = require('./native/ethereum.js');
+var solana = require('./native/solana.js');
+var enums = require('../../__types__/enums.js');
+var client = require('../wallet-connect/client.js');
+var base = require('../wallet-connect/base.js');
+var utils = require('../../utils.js');
+
+class WebWalletManager {
+    /**
+     * Constructs a WebWalletManager instance based on the provided configuration.
+     *
+     * - Enables native Ethereum and/or Solana wallet support if configured.
+     * - Enables WalletConnect support for Ethereum and/or Solana chains if namespaces are provided.
+     * - Sets up `CrossPlatformWalletStamper` and `CrossPlatformWalletConnector` if auth or connecting features are enabled.
+     *
+     * @param cfg - Wallet manager configuration.
+     */
+    constructor(cfg) {
+        // queue of async initialization functions
+        this.initializers = [];
+        // mapping of wallet interface types to their wallet instances
+        this.wallets = {};
+        // maps a blockchain chain to its corresponding wallet interface types
+        this.chainToInterfaces = {};
+        /**
+         * Registers a wallet interface type as supporting a specific blockchain chain.
+         *
+         * @param chain - Chain (e.g., Ethereum, Solana).
+         * @param interfaceType - Wallet interface type to associate with the chain.
+         */
+        this.addChainInterface = (chain, interfaceType) => {
+            if (!this.chainToInterfaces[chain])
+                this.chainToInterfaces[chain] = [];
+            this.chainToInterfaces[chain].push(interfaceType);
+        };
+        const enableNativeEvm = cfg.chains.ethereum?.native ?? false;
+        const enableNativeSol = cfg.chains.solana?.native ?? false;
+        const ethereumNamespaces = cfg.chains.ethereum?.walletConnectNamespaces ?? [];
+        const solanaNamespaces = cfg.chains.solana?.walletConnectNamespaces ?? [];
+        const enableWalletConnectEvm = ethereumNamespaces.length > 0;
+        const enableWalletConnectSol = solanaNamespaces.length > 0;
+        const enableWalletConnect = enableWalletConnectEvm || enableWalletConnectSol;
+        // set up native Ethereum wallet support
+        if (enableNativeEvm) {
+            this.wallets[enums.WalletInterfaceType.Ethereum] = new ethereum.EthereumWallet();
+            this.addChainInterface(enums.Chain.Ethereum, enums.WalletInterfaceType.Ethereum);
+        }
+        // set up native Solana wallet support
+        if (enableNativeSol) {
+            this.wallets[enums.WalletInterfaceType.Solana] = new solana.SolanaWallet();
+            this.addChainInterface(enums.Chain.Solana, enums.WalletInterfaceType.Solana);
+        }
+        // if WalletConnect is configured, set it up
+        if (cfg.walletConnect && enableWalletConnect) {
+            this.wcClient = new client.WalletConnectClient();
+            const wcUnified = new base.WalletConnectWallet(this.wcClient, () => this.ensureWalletConnectReady(), { ethereumNamespaces, solanaNamespaces });
+            this.wallets[enums.WalletInterfaceType.WalletConnect] = wcUnified;
+            // add async init step to the initializer queue
+            this.initializers.push(() => utils.withTimeout(wcUnified.init(), 15000, "WalletConnect wallet").catch((err) => {
+                // WalletConnect can be a bit unreliable, we don't want to load forever
+                // so we limit the initialization time to 15 seconds. After that we emit a
+                // failure event and remove WalletConnect from the available wallets
+                wcUnified.abortInit(err);
+                this.removeWalletInterface(enums.WalletInterfaceType.WalletConnect);
+            }));
+            // register WalletConnect as a wallet interface for each enabled chain
+            if (enableWalletConnectEvm)
+                this.addChainInterface(enums.Chain.Ethereum, enums.WalletInterfaceType.WalletConnect);
+            if (enableWalletConnectSol)
+                this.addChainInterface(enums.Chain.Solana, enums.WalletInterfaceType.WalletConnect);
+        }
+        if (cfg.features?.auth) {
+            this.stamper = new stamper.CrossPlatformWalletStamper(this.wallets);
+        }
+        if (cfg.features?.connecting) {
+            this.connector = new connector.CrossPlatformWalletConnector(this.wallets);
+        }
+    }
+    /**
+     * Initializes WalletConnect components and any registered wallet interfaces.
+     *
+     * - Initializes the low-level WalletConnect client with the provided config.
+     * - Runs any registered async wallet initializers (currently only `WalletConnectWallet`).
+     * - WalletConnect initialization happens in the background and does not block this method.
+     *
+     * @param cfg - Wallet manager configuration used for initializing the WalletConnect client.
+     */
+    async init(cfg) {
+        if (this.wcClient) {
+            // we start WalletConnect initialization in the background (this is non-blocking)
+            this.wcInitPromise = (async () => {
+                try {
+                    await this.wcClient.init(cfg.walletConnect);
+                    // initialize the high-level WalletConnectWallet after client is ready
+                    await Promise.all(this.initializers.map((fn) => fn()));
+                }
+                catch (error) {
+                    // WalletConnect can be a bit unreliable, so instead of throwing an error
+                    // we handle failures silently to avoid blocking the rest of the client
+                    // from initializing. If setup fails, we also remove WalletConnect
+                    // from the available wallets list
+                    console.error("Failed to initialize WalletConnect", error);
+                    this.removeWalletInterface(enums.WalletInterfaceType.WalletConnect);
+                }
+            })();
+        }
+    }
+    /**
+     * Ensures WalletConnect is fully initialized before proceeding.
+     * This should be called before any WalletConnect operations.
+     *
+     * @returns A promise that resolves when WalletConnect is ready.
+     */
+    async ensureWalletConnectReady() {
+        if (this.wcInitPromise) {
+            await this.wcInitPromise;
+        }
+    }
+    /**
+     * Retrieves available wallet providers, optionally filtered by chain.
+     *
+     * - If a chain is specified, filters wallet interfaces that support that chain.
+     * - Aggregates providers across all wallet interfaces and filters WalletConnect results accordingly.
+     * - Returns native wallet providers immediately without waiting for WalletConnect.
+     * - WalletConnect providers will only be included if WalletConnect has already initialized.
+     *
+     * @param chain - Optional chain to filter providers by (e.g., Ethereum, Solana).
+     * @returns A promise that resolves to an array of `WalletProvider` objects.
+     * @throws {Error} If no wallet interface is registered for the given chain.
+     */
+    async getProviders(chain) {
+        if (chain) {
+            const interfaceTypes = this.chainToInterfaces[chain];
+            if (!interfaceTypes || interfaceTypes.length === 0)
+                throw new Error(`No wallet supports chain: ${chain}`);
+            const walletsToQuery = interfaceTypes
+                .map((iface) => this.wallets[iface])
+                .filter(Boolean);
+            const providersArrays = await Promise.all(walletsToQuery.map((wallet) => wallet.getProviders()));
+            // we still need to filter by chain because WalletConnect can return providers for multiple chains
+            return providersArrays
+                .flat()
+                .filter((p) => p.chainInfo.namespace === chain);
+        }
+        // collect all providers from all initialized wallets
+        const providersArrays = await Promise.all(Object.values(this.wallets).map((wallet) => wallet.getProviders()));
+        return providersArrays.flat();
+    }
+    /**
+     * Removes a wallet interface from the manager.
+     *
+     * - Deletes the wallet instance from the wallets map.
+     * - Cleans up references to the wallet interface in chainToInterfaces.
+     * - Removes the chain entry entirely if no interfaces remain.
+     *
+     * @param type - The WalletInterfaceType to remove.
+     */
+    removeWalletInterface(type) {
+        delete this.wallets[type];
+        for (const chain of Object.keys(this.chainToInterfaces)) {
+            const filtered = (this.chainToInterfaces[chain] ?? []).filter((interfaceType) => interfaceType !== type);
+            if (filtered.length > 0) {
+                this.chainToInterfaces[chain] = filtered;
+            }
+            else {
+                delete this.chainToInterfaces[chain];
+            }
+        }
+    }
+}
+
+exports.WebWalletManager = WebWalletManager;
+//# sourceMappingURL=manager.js.map

package/dist/__wallet__/web/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sources":["../../../src/__wallet__/web/manager.ts"],"sourcesContent":[null],"names":["WalletInterfaceType","EthereumWallet","Chain","SolanaWallet","WalletConnectClient","WalletConnectWallet","withTimeout","CrossPlatformWalletStamper","CrossPlatformWalletConnector"],"mappings":"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"}

package/dist/__wallet__/web/manager.mjs

@@ -0,0 +1,175 @@
+import { CrossPlatformWalletStamper } from '../stamper.mjs';
+import { CrossPlatformWalletConnector } from '../connector.mjs';
+import { EthereumWallet } from './native/ethereum.mjs';
+import { SolanaWallet } from './native/solana.mjs';
+import { WalletInterfaceType, Chain } from '../../__types__/enums.mjs';
+import { WalletConnectClient } from '../wallet-connect/client.mjs';
+import { WalletConnectWallet } from '../wallet-connect/base.mjs';
+import { withTimeout } from '../../utils.mjs';
+
+class WebWalletManager {
+    /**
+     * Constructs a WebWalletManager instance based on the provided configuration.
+     *
+     * - Enables native Ethereum and/or Solana wallet support if configured.
+     * - Enables WalletConnect support for Ethereum and/or Solana chains if namespaces are provided.
+     * - Sets up `CrossPlatformWalletStamper` and `CrossPlatformWalletConnector` if auth or connecting features are enabled.
+     *
+     * @param cfg - Wallet manager configuration.
+     */
+    constructor(cfg) {
+        // queue of async initialization functions
+        this.initializers = [];
+        // mapping of wallet interface types to their wallet instances
+        this.wallets = {};
+        // maps a blockchain chain to its corresponding wallet interface types
+        this.chainToInterfaces = {};
+        /**
+         * Registers a wallet interface type as supporting a specific blockchain chain.
+         *
+         * @param chain - Chain (e.g., Ethereum, Solana).
+         * @param interfaceType - Wallet interface type to associate with the chain.
+         */
+        this.addChainInterface = (chain, interfaceType) => {
+            if (!this.chainToInterfaces[chain])
+                this.chainToInterfaces[chain] = [];
+            this.chainToInterfaces[chain].push(interfaceType);
+        };
+        const enableNativeEvm = cfg.chains.ethereum?.native ?? false;
+        const enableNativeSol = cfg.chains.solana?.native ?? false;
+        const ethereumNamespaces = cfg.chains.ethereum?.walletConnectNamespaces ?? [];
+        const solanaNamespaces = cfg.chains.solana?.walletConnectNamespaces ?? [];
+        const enableWalletConnectEvm = ethereumNamespaces.length > 0;
+        const enableWalletConnectSol = solanaNamespaces.length > 0;
+        const enableWalletConnect = enableWalletConnectEvm || enableWalletConnectSol;
+        // set up native Ethereum wallet support
+        if (enableNativeEvm) {
+            this.wallets[WalletInterfaceType.Ethereum] = new EthereumWallet();
+            this.addChainInterface(Chain.Ethereum, WalletInterfaceType.Ethereum);
+        }
+        // set up native Solana wallet support
+        if (enableNativeSol) {
+            this.wallets[WalletInterfaceType.Solana] = new SolanaWallet();
+            this.addChainInterface(Chain.Solana, WalletInterfaceType.Solana);
+        }
+        // if WalletConnect is configured, set it up
+        if (cfg.walletConnect && enableWalletConnect) {
+            this.wcClient = new WalletConnectClient();
+            const wcUnified = new WalletConnectWallet(this.wcClient, () => this.ensureWalletConnectReady(), { ethereumNamespaces, solanaNamespaces });
+            this.wallets[WalletInterfaceType.WalletConnect] = wcUnified;
+            // add async init step to the initializer queue
+            this.initializers.push(() => withTimeout(wcUnified.init(), 15000, "WalletConnect wallet").catch((err) => {
+                // WalletConnect can be a bit unreliable, we don't want to load forever
+                // so we limit the initialization time to 15 seconds. After that we emit a
+                // failure event and remove WalletConnect from the available wallets
+                wcUnified.abortInit(err);
+                this.removeWalletInterface(WalletInterfaceType.WalletConnect);
+            }));
+            // register WalletConnect as a wallet interface for each enabled chain
+            if (enableWalletConnectEvm)
+                this.addChainInterface(Chain.Ethereum, WalletInterfaceType.WalletConnect);
+            if (enableWalletConnectSol)
+                this.addChainInterface(Chain.Solana, WalletInterfaceType.WalletConnect);
+        }
+        if (cfg.features?.auth) {
+            this.stamper = new CrossPlatformWalletStamper(this.wallets);
+        }
+        if (cfg.features?.connecting) {
+            this.connector = new CrossPlatformWalletConnector(this.wallets);
+        }
+    }
+    /**
+     * Initializes WalletConnect components and any registered wallet interfaces.
+     *
+     * - Initializes the low-level WalletConnect client with the provided config.
+     * - Runs any registered async wallet initializers (currently only `WalletConnectWallet`).
+     * - WalletConnect initialization happens in the background and does not block this method.
+     *
+     * @param cfg - Wallet manager configuration used for initializing the WalletConnect client.
+     */
+    async init(cfg) {
+        if (this.wcClient) {
+            // we start WalletConnect initialization in the background (this is non-blocking)
+            this.wcInitPromise = (async () => {
+                try {
+                    await this.wcClient.init(cfg.walletConnect);
+                    // initialize the high-level WalletConnectWallet after client is ready
+                    await Promise.all(this.initializers.map((fn) => fn()));
+                }
+                catch (error) {
+                    // WalletConnect can be a bit unreliable, so instead of throwing an error
+                    // we handle failures silently to avoid blocking the rest of the client
+                    // from initializing. If setup fails, we also remove WalletConnect
+                    // from the available wallets list
+                    console.error("Failed to initialize WalletConnect", error);
+                    this.removeWalletInterface(WalletInterfaceType.WalletConnect);
+                }
+            })();
+        }
+    }
+    /**
+     * Ensures WalletConnect is fully initialized before proceeding.
+     * This should be called before any WalletConnect operations.
+     *
+     * @returns A promise that resolves when WalletConnect is ready.
+     */
+    async ensureWalletConnectReady() {
+        if (this.wcInitPromise) {
+            await this.wcInitPromise;
+        }
+    }
+    /**
+     * Retrieves available wallet providers, optionally filtered by chain.
+     *
+     * - If a chain is specified, filters wallet interfaces that support that chain.
+     * - Aggregates providers across all wallet interfaces and filters WalletConnect results accordingly.
+     * - Returns native wallet providers immediately without waiting for WalletConnect.
+     * - WalletConnect providers will only be included if WalletConnect has already initialized.
+     *
+     * @param chain - Optional chain to filter providers by (e.g., Ethereum, Solana).
+     * @returns A promise that resolves to an array of `WalletProvider` objects.
+     * @throws {Error} If no wallet interface is registered for the given chain.
+     */
+    async getProviders(chain) {
+        if (chain) {
+            const interfaceTypes = this.chainToInterfaces[chain];
+            if (!interfaceTypes || interfaceTypes.length === 0)
+                throw new Error(`No wallet supports chain: ${chain}`);
+            const walletsToQuery = interfaceTypes
+                .map((iface) => this.wallets[iface])
+                .filter(Boolean);
+            const providersArrays = await Promise.all(walletsToQuery.map((wallet) => wallet.getProviders()));
+            // we still need to filter by chain because WalletConnect can return providers for multiple chains
+            return providersArrays
+                .flat()
+                .filter((p) => p.chainInfo.namespace === chain);
+        }
+        // collect all providers from all initialized wallets
+        const providersArrays = await Promise.all(Object.values(this.wallets).map((wallet) => wallet.getProviders()));
+        return providersArrays.flat();
+    }
+    /**
+     * Removes a wallet interface from the manager.
+     *
+     * - Deletes the wallet instance from the wallets map.
+     * - Cleans up references to the wallet interface in chainToInterfaces.
+     * - Removes the chain entry entirely if no interfaces remain.
+     *
+     * @param type - The WalletInterfaceType to remove.
+     */
+    removeWalletInterface(type) {
+        delete this.wallets[type];
+        for (const chain of Object.keys(this.chainToInterfaces)) {
+            const filtered = (this.chainToInterfaces[chain] ?? []).filter((interfaceType) => interfaceType !== type);
+            if (filtered.length > 0) {
+                this.chainToInterfaces[chain] = filtered;
+            }
+            else {
+                delete this.chainToInterfaces[chain];
+            }
+        }
+    }
+}
+
+export { WebWalletManager };
+//# sourceMappingURL=manager.mjs.map

package/dist/__wallet__/web/manager.mjs.map

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

package/dist/__wallet__/web/native/ethereum.d.ts

@@ -0,0 +1,101 @@
+import { Hex } from "viem";
+import { EthereumWalletInterface, SignIntent, SwitchableChain, WalletInterfaceType, WalletProvider } from "../../../__types__";
+/**
+ * Abstract base class for Ethereum wallet implementations.
+ *
+ * Provides shared logic for:
+ * - Provider discovery via EIP-6963 (request/announce events)
+ * - Connecting/disconnecting via EIP-1193
+ * - Recovering compressed secp256k1 public keys from EIP-191 signatures
+ */
+export declare abstract class BaseEthereumWallet implements EthereumWalletInterface {
+    readonly interfaceType = WalletInterfaceType.Ethereum;
+    /**
+     * Signs a message using the specified wallet provider.
+     *
+     * @param message - The message to be signed, as a string or hex.
+     * @param provider - The wallet provider to use for signing.
+     * @param intent - The intent of the signature (e.g. message signing or transaction sending).
+     * @returns A promise resolving to a hex-encoded signature string.
+     */
+    abstract sign(payload: string | Hex, provider: WalletProvider, intent: SignIntent): Promise<Hex>;
+    /**
+     * Retrieves the compressed secp256k1 public key by signing a known message.
+     *
+     * - Signs the fixed string "GET_PUBLIC_KEY" (EIP-191) and recovers the key.
+     * - Returns the compressed public key as a hex string (no 0x prefix).
+     *
+     * @param provider - The wallet provider to use.
+     * @returns A promise that resolves to the compressed public key (hex-encoded).
+     */
+    getPublicKey: (provider: WalletProvider) => Promise<string>;
+    /**
+     * Discovers EIP-1193 providers using the EIP-6963 standard.
+     *
+     * - Dispatches "eip6963:requestProvider" and listens for "eip6963:announceProvider".
+     * - For each discovered provider, attempts to read `eth_accounts` and `eth_chainId`
+     *   (silently ignored if unavailable), defaulting to chainId "0x1".
+     * - Returns providers discovered during this discovery cycle; may be empty.
+     *
+     * @returns A promise that resolves to a list of available wallet providers.
+     */
+    getProviders: () => Promise<WalletProvider[]>;
+    /**
+     * Requests or verifies account connection via `eth_requestAccounts`.
+     *
+     * - If the wallet is already connected, resolves immediately (no prompt).
+     * - If not connected, the wallet will typically prompt the user to authorize.
+     *
+     * @param provider - The wallet provider to use.
+     * @returns A promise that resolves with the connected wallet's address.
+     * @throws {Error} If the wallet returns no accounts after the request.
+     */
+    connectWalletAccount: (provider: WalletProvider) => Promise<string>;
+    /**
+     * Attempts to disconnect the wallet by revoking `eth_accounts` permission.
+     *
+     * - Calls `wallet_revokePermissions` with `{ eth_accounts: {} }`.
+     * - Provider behavior is wallet-specific: some implement it, some ignore it,
+     *   and others (e.g., Phantom) throw “method not supported”.
+     *
+     * @param provider - The wallet provider to disconnect.
+     * @returns A promise that resolves once the request completes (or rejects if the provider errors).
+     */
+    disconnectWalletAccount: (provider: WalletProvider) => Promise<void>;
+    /**
+     * Switches to a new EVM chain, with add-then-switch fallback.
+     *
+     * - Tries `wallet_switchEthereumChain` first.
+     * - If the wallet returns error code 4902 (unknown chain):
+     *   - If `chainOrId` is a string (hex chainId), throws and asks the caller to pass metadata.
+     *   - If `chainOrId` is a `SwitchableChain`, calls `wallet_addEthereumChain` and then retries the switch.
+     *
+     * @param provider - The wallet provider to use.
+     * @param chainOrId - Hex chain ID string or full `SwitchableChain` metadata.
+     * @throws {Error} If provider is non-EVM, adding/switching fails, or metadata is missing.
+     */
+    switchChain(provider: WalletProvider, chainOrId: string | SwitchableChain): Promise<void>;
+}
+/**
+ * EthereumWallet implementation using EIP-1193 compatible providers.
+ *
+ * Handles message signing and transaction submission.
+ */
+export declare class EthereumWallet extends BaseEthereumWallet {
+    /**
+     * Signs a message or sends a transaction depending on intent.
+     *
+     * - `SignMessage` → `personal_sign` (hex signature).
+     * - `SignAndSendTransaction` → `eth_sendTransaction` (tx hash).
+     * - For transactions, `message` must be a raw tx that `Transaction.from(...)` can parse.
+     * - May prompt the user (account access, signing, or send).
+     *
+     * @param payload - The payload or raw transaction to be signed/sent.
+     * @param provider - The wallet provider to use.
+     * @param intent - Signing intent (SignMessage or SignAndSendTransaction).
+     * @returns A promise that resolves to a hex string (signature or tx hash).
+     * @throws {Error} If the intent is unsupported or the wallet rejects the request.
+     */
+    sign: (payload: string, provider: WalletProvider, intent: SignIntent) => Promise<Hex>;
+}
+//# sourceMappingURL=ethereum.d.ts.map

package/dist/__wallet__/web/native/ethereum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ethereum.d.ts","sourceRoot":"","sources":["../../../../src/__wallet__/web/native/ethereum.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,GAAG,EAIJ,MAAM,MAAM,CAAC;AAGd,OAAO,EAIL,uBAAuB,EACvB,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,cAAc,EAGf,MAAM,oBAAoB,CAAC;AAO5B;;;;;;;GAOG;AACH,8BAAsB,kBAAmB,YAAW,uBAAuB;IACzE,QAAQ,CAAC,aAAa,gCAAgC;IAEtD;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,CACX,OAAO,EAAE,MAAM,GAAG,GAAG,EACrB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,GAAG,CAAC;IAEf;;;;;;;;OAQG;IACH,YAAY,aAAoB,cAAc,KAAG,QAAQ,MAAM,CAAC,CAQ9D;IAEF;;;;;;;;;OASG;IACH,YAAY,QAAa,QAAQ,cAAc,EAAE,CAAC,CA4FhD;IAEF;;;;;;;;;OASG;IACH,oBAAoB,aAAoB,cAAc,KAAG,QAAQ,MAAM,CAAC,CAGtE;IAEF;;;;;;;;;OASG;IACH,uBAAuB,aAAoB,cAAc,KAAG,QAAQ,IAAI,CAAC,CAMvE;IAEF;;;;;;;;;;;OAWG;IACG,WAAW,CACf,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,MAAM,GAAG,eAAe,GAClC,OAAO,CAAC,IAAI,CAAC;CAwDjB;AAED;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,kBAAkB;IACpD;;;;;;;;;;;;;OAaG;IACH,IAAI,YACO,MAAM,YACL,cAAc,UAChB,UAAU,KACjB,QAAQ,GAAG,CAAC,CA+Db;CACH"}