@turnkey/core 1.0.0-beta.0

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

@@ -0,0 +1,137 @@
+import SignClient from '@walletconnect/sign-client';
+
+class WalletConnectClient {
+    constructor() {
+        // tracks the pending approval callback returned from `connect()`
+        this.pendingApproval = null;
+        // callbacks to run when the session is deleted
+        this.sessionDeleteHandlers = [];
+    }
+    /**
+     * Registers a callback that runs when the WalletConnect session is deleted.
+     *
+     * - Useful for clearing UI state or internal session data.
+     *
+     * @param fn - A callback function to invoke when the session is deleted.
+     */
+    onSessionDelete(fn) {
+        this.sessionDeleteHandlers.push(fn);
+    }
+    /**
+     * Initializes the WalletConnect SignClient with your project credentials.
+     *
+     * - Must be called before calling `pair()` or `request()`.
+     * - Configures metadata and optionally a custom relay server.
+     *
+     * @param opts.projectId - WalletConnect project ID.
+     * @param opts.metadata - Metadata about your app (name, URL, icons).
+     * @param opts.relayUrl - (Optional) Custom relay server URL.
+     * @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 } : {}),
+        });
+        // we listen for session deletion events and notify subscribers
+        this.client.on("session_delete", () => {
+            this.sessionDeleteHandlers.forEach((h) => h());
+        });
+    }
+    /**
+     * Initiates a pairing request and returns a URI to be scanned or deep-linked.
+     *
+     * - Must be followed by a call to `approve()` to complete the pairing.
+     * - Throws if a pairing is already in progress.
+     *
+     * @param namespaces - Namespaces to request for optional capabilities.
+     * @returns A WalletConnect URI for the wallet to connect with.
+     * @throws {Error} If a pairing is already in progress or URI is not returned.
+     */
+    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.
+     *
+     * - Must be called after `pair()` and after the wallet has scanned and approved the URI.
+     *
+     * @returns A promise that resolves to the established session.
+     * @throws {Error} If called before `pair()` or approval fails.
+     */
+    async approve() {
+        if (!this.pendingApproval) {
+            throw new Error("WalletConnect: call pair() before approve()");
+        }
+        try {
+            const session = await this.pendingApproval();
+            return session;
+        }
+        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() {
+        const sessions = this.client.session.getAll();
+        return sessions.length ? sessions[sessions.length - 1] : null;
+    }
+    /**
+     * Sends a JSON-RPC request over the active WalletConnect session.
+     *
+     * - The session must already be connected.
+     *
+     * @param chainId - Chain ID of the target blockchain (e.g. `eip155:1`).
+     * @param method - The RPC method name to call.
+     * @param params - The parameters to pass into the RPC method.
+     * @returns A promise that resolves with the RPC response.
+     * @throws {Error} If no active session is found.
+     */
+    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" },
+        });
+    }
+}
+
+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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"}

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

@@ -0,0 +1,41 @@
+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.
+     * Sets up native wallets and WalletConnect support.
+     *
+     * @param cfg - Wallet manager configuration including enabled chains and WalletConnect setup.
+     */
+    constructor(cfg: TWalletManagerConfig);
+    /**
+     * Initializes the wallet manager and all wallet connectors.
+     *
+     * @param cfg - Wallet manager configuration.
+     * @returns A promise that resolves once all wallet initializers have completed.
+     */
+    init(cfg: TWalletManagerConfig): Promise<void>;
+    /**
+     * Retrieves available wallet providers based on the configured chains.
+     *
+     * @param chain - Optional chain to filter providers by.
+     * @returns A promise that resolves to an array of wallet providers.
+     * @throws If no wallet interface is registered for the given chain.
+     */
+    getProviders(chain?: Chain): Promise<WalletProvider[]>;
+    /**
+     * Registers a wallet interface as supporting a specific blockchain chain.
+     *
+     * @param chain - The blockchain chain (e.g., Ethereum, Solana).
+     * @param iface - The wallet interface type (e.g., native, WalletConnect).
+     */
+    private addChainInterface;
+}
+//# 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,QAAQ,CAAC;AAIhB,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;;;;;OAKG;gBACS,GAAG,EAAE,oBAAoB;IAyDrC;;;;;OAKG;IACG,IAAI,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpD;;;;;;OAMG;IACG,YAAY,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IA4B5D;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB,CAGvB;CACH"}

package/dist/__wallet__/web/manager.js

@@ -0,0 +1,115 @@
+'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 base = require('../../__types__/base.js');
+var client = require('../wallet-connect/client.js');
+var base$1 = require('../wallet-connect/base.js');
+
+class WebWalletManager {
+    /**
+     * Constructs a WebWalletManager instance based on the provided configuration.
+     * Sets up native wallets and WalletConnect support.
+     *
+     * @param cfg - Wallet manager configuration including enabled chains and WalletConnect setup.
+     */
+    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 as supporting a specific blockchain chain.
+         *
+         * @param chain - The blockchain chain (e.g., Ethereum, Solana).
+         * @param iface - The wallet interface type (e.g., native, WalletConnect).
+         */
+        this.addChainInterface = (chain, iface) => {
+            if (!this.chainToInterfaces[chain])
+                this.chainToInterfaces[chain] = [];
+            this.chainToInterfaces[chain].push(iface);
+        };
+        const enableNativeEvm = cfg.chains.ethereum ?? false;
+        const enableNativeSol = cfg.chains.solana ?? 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[base.WalletInterfaceType.Ethereum] = new ethereum.EthereumWallet();
+            this.addChainInterface(base.Chain.Ethereum, base.WalletInterfaceType.Ethereum);
+        }
+        // set up native Solana wallet support
+        if (enableNativeSol) {
+            this.wallets[base.WalletInterfaceType.Solana] = new solana.SolanaWallet();
+            this.addChainInterface(base.Chain.Solana, base.WalletInterfaceType.Solana);
+        }
+        // if WalletConnect is configured, set it up
+        if (cfg.walletConnect && enableWalletConnect) {
+            this.wcClient = new client.WalletConnectClient();
+            const wcUnified = new base$1.WalletConnectWallet(this.wcClient);
+            this.wallets[base.WalletInterfaceType.WalletConnect] = wcUnified;
+            // add async init step to the initializer queue
+            this.initializers.push(() => wcUnified.init({ ethereumNamespaces, solanaNamespaces }));
+            // register WalletConnect as a wallet interface for each enabled chain
+            if (enableWalletConnectEvm)
+                this.addChainInterface(base.Chain.Ethereum, base.WalletInterfaceType.WalletConnect);
+            if (enableWalletConnectSol)
+                this.addChainInterface(base.Chain.Solana, base.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 the wallet manager and all wallet connectors.
+     *
+     * @param cfg - Wallet manager configuration.
+     * @returns A promise that resolves once all wallet initializers have completed.
+     */
+    async init(cfg) {
+        if (this.wcClient) {
+            await this.wcClient.init(cfg.walletConnect);
+        }
+        // Run all wallet-specific initializers
+        await Promise.all(this.initializers.map((fn) => fn()));
+        await this.stamper?.init();
+    }
+    /**
+     * Retrieves available wallet providers based on the configured chains.
+     *
+     * @param chain - Optional chain to filter providers by.
+     * @returns A promise that resolves to an array of wallet providers.
+     * @throws If no wallet interface is registered for the given chain.
+     */
+    async getProviders(chain) {
+        if (chain) {
+            const ifaceTypes = this.chainToInterfaces[chain];
+            if (!ifaceTypes || ifaceTypes.length === 0)
+                throw new Error(`No wallet supports chain: ${chain}`);
+            const walletsToQuery = ifaceTypes
+                .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();
+    }
+}
+
+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","CrossPlatformWalletStamper","CrossPlatformWalletConnector"],"mappings":"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"}

package/dist/__wallet__/web/manager.mjs

@@ -0,0 +1,113 @@
+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__/base.mjs';
+import { WalletConnectClient } from '../wallet-connect/client.mjs';
+import { WalletConnectWallet } from '../wallet-connect/base.mjs';
+
+class WebWalletManager {
+    /**
+     * Constructs a WebWalletManager instance based on the provided configuration.
+     * Sets up native wallets and WalletConnect support.
+     *
+     * @param cfg - Wallet manager configuration including enabled chains and WalletConnect setup.
+     */
+    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 as supporting a specific blockchain chain.
+         *
+         * @param chain - The blockchain chain (e.g., Ethereum, Solana).
+         * @param iface - The wallet interface type (e.g., native, WalletConnect).
+         */
+        this.addChainInterface = (chain, iface) => {
+            if (!this.chainToInterfaces[chain])
+                this.chainToInterfaces[chain] = [];
+            this.chainToInterfaces[chain].push(iface);
+        };
+        const enableNativeEvm = cfg.chains.ethereum ?? false;
+        const enableNativeSol = cfg.chains.solana ?? 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.wallets[WalletInterfaceType.WalletConnect] = wcUnified;
+            // add async init step to the initializer queue
+            this.initializers.push(() => wcUnified.init({ ethereumNamespaces, solanaNamespaces }));
+            // 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 the wallet manager and all wallet connectors.
+     *
+     * @param cfg - Wallet manager configuration.
+     * @returns A promise that resolves once all wallet initializers have completed.
+     */
+    async init(cfg) {
+        if (this.wcClient) {
+            await this.wcClient.init(cfg.walletConnect);
+        }
+        // Run all wallet-specific initializers
+        await Promise.all(this.initializers.map((fn) => fn()));
+        await this.stamper?.init();
+    }
+    /**
+     * Retrieves available wallet providers based on the configured chains.
+     *
+     * @param chain - Optional chain to filter providers by.
+     * @returns A promise that resolves to an array of wallet providers.
+     * @throws If no wallet interface is registered for the given chain.
+     */
+    async getProviders(chain) {
+        if (chain) {
+            const ifaceTypes = this.chainToInterfaces[chain];
+            if (!ifaceTypes || ifaceTypes.length === 0)
+                throw new Error(`No wallet supports chain: ${chain}`);
+            const walletsToQuery = ifaceTypes
+                .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();
+    }
+}
+
+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":";;;;;;;;MAca,gBAAgB,CAAA;AAmB3B;;;;;AAKG;AACH,IAAA,WAAA,CAAY,GAAyB,EAAA;;QAvB7B,IAAY,CAAA,YAAA,GAA+B,EAAE;;QAM5C,IAAO,CAAA,OAAA,GAA0D,EAAE;;QAGpE,IAAiB,CAAA,iBAAA,GAAkD,EAAE;AA0H7E;;;;;AAKG;AACK,QAAA,IAAA,CAAA,iBAAiB,GAAG,CAAC,KAAY,EAAE,KAA0B,KAAI;AACvE,YAAA,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC;AAAE,gBAAA,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,GAAG,EAAE;YACtE,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAE,CAAC,IAAI,CAAC,KAAK,CAAC;AAC5C,SAAC;QApHC,MAAM,eAAe,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,KAAK;QACpD,MAAM,eAAe,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,KAAK;QAElD,MAAM,kBAAkB,GACtB,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,uBAAuB,IAAI,EAAE;QACpD,MAAM,gBAAgB,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,uBAAuB,IAAI,EAAE;AAEzE,QAAA,MAAM,sBAAsB,GAAG,kBAAkB,CAAC,MAAM,GAAG,CAAC;AAC5D,QAAA,MAAM,sBAAsB,GAAG,gBAAgB,CAAC,MAAM,GAAG,CAAC;AAE1D,QAAA,MAAM,mBAAmB,GACvB,sBAAsB,IAAI,sBAAsB;;QAGlD,IAAI,eAAe,EAAE;YACnB,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,GAAG,IAAI,cAAc,EAAE;YACjE,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,QAAQ,EAAE,mBAAmB,CAAC,QAAQ,CAAC;;;QAItE,IAAI,eAAe,EAAE;YACnB,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,MAAM,CAAC,GAAG,IAAI,YAAY,EAAE;YAC7D,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAAC;;;AAIlE,QAAA,IAAI,GAAG,CAAC,aAAa,IAAI,mBAAmB,EAAE;AAC5C,YAAA,IAAI,CAAC,QAAQ,GAAG,IAAI,mBAAmB,EAAE;YACzC,MAAM,SAAS,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC;YAExD,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,aAAa,CAAC,GAAG,SAAS;;AAG3D,YAAA,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MACrB,SAAS,CAAC,IAAI,CAAC,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,CAAC,CACzD;;AAGD,YAAA,IAAI,sBAAsB;gBACxB,IAAI,CAAC,iBAAiB,CACpB,KAAK,CAAC,QAAQ,EACd,mBAAmB,CAAC,aAAa,CAClC;AACH,YAAA,IAAI,sBAAsB;gBACxB,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,MAAM,EAAE,mBAAmB,CAAC,aAAa,CAAC;;AAG3E,QAAA,IAAI,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE;YACtB,IAAI,CAAC,OAAO,GAAG,IAAI,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC;;AAG7D,QAAA,IAAI,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE;YAC5B,IAAI,CAAC,SAAS,GAAG,IAAI,4BAA4B,CAAC,IAAI,CAAC,OAAO,CAAC;;;AAInE;;;;;AAKG;IACH,MAAM,IAAI,CAAC,GAAyB,EAAA;AAClC,QAAA,IAAI,IAAI,CAAC,QAAQ,EAAE;YACjB,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,aAAc,CAAC;;;AAI9C,QAAA,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;AACtD,QAAA,MAAM,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE;;AAG5B;;;;;;AAMG;IACH,MAAM,YAAY,CAAC,KAAa,EAAA;QAC9B,IAAI,KAAK,EAAE;YACT,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC;AAChD,YAAA,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;AACxC,gBAAA,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,CAAA,CAAE,CAAC;YAEvD,MAAM,cAAc,GAAG;AACpB,iBAAA,GAAG,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;iBAClC,MAAM,CAAC,OAAO,CAAsB;YAEvC,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,GAAG,CACvC,cAAc,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,YAAY,EAAE,CAAC,CACtD;;AAGD,YAAA,OAAO;AACJ,iBAAA,IAAI;AACJ,iBAAA,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,SAAS,KAAK,KAAK,CAAC;;;AAInD,QAAA,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,GAAG,CACvC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,YAAY,EAAE,CAAC,CACnE;AAED,QAAA,OAAO,eAAe,CAAC,IAAI,EAAE;;AAahC;;;;"}

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

@@ -0,0 +1,67 @@
+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
+ * - Connecting and disconnecting wallets
+ * - Recovering compressed public keys
+ */
+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(message: string | Hex, provider: WalletProvider, intent: SignIntent): Promise<Hex>;
+    /**
+     * Retrieves the compressed public key by signing a known message.
+     *
+     * @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.
+     *
+     * @returns A promise that resolves to a list of available wallet providers.
+     */
+    getProviders: () => Promise<WalletProvider[]>;
+    /**
+     * Ensures the wallet account is connected.
+     *
+     * @param provider - The wallet provider to use.
+     * @returns A promise that resolves once the account is connected.
+     */
+    connectWalletAccount: (provider: WalletProvider) => Promise<void>;
+    /**
+     * Disconnects the wallet account by revoking permissions.
+     *
+     * @param provider - The wallet provider to disconnect.
+     * @returns A promise that resolves once the permissions are revoked.
+     */
+    disconnectWalletAccount: (provider: WalletProvider) => Promise<void>;
+    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.
+     *
+     * @param message - The message or raw transaction to be signed.
+     * @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).
+     */
+    sign: (message: 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,EAEL,uBAAuB,EACvB,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,cAAc,EAGf,MAAM,QAAQ,CAAC;AAMhB;;;;;;;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;;;;;OAKG;IACH,YAAY,aAAoB,cAAc,KAAG,QAAQ,MAAM,CAAC,CAQ9D;IAEF;;;;OAIG;IACH,YAAY,QAAa,QAAQ,cAAc,EAAE,CAAC,CA2DhD;IAEF;;;;;OAKG;IACH,oBAAoB,aAAoB,cAAc,KAAG,QAAQ,IAAI,CAAC,CAGpE;IAEF;;;;;OAKG;IACH,uBAAuB,aAAoB,cAAc,KAAG,QAAQ,IAAI,CAAC,CAMvE;IAEI,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;;;;;;;OAOG;IACH,IAAI,YACO,MAAM,YACL,cAAc,UAChB,UAAU,KACjB,QAAQ,GAAG,CAAC,CAiCb;CACH"}