@turnkey/core 1.0.0-beta.2 → 1.0.0-beta.4

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

@@ -1,5 +1,12 @@
 import SignClient from '@walletconnect/sign-client';
 
+/**
+ * WalletConnectClient is a low-level wrapper around the WalletConnect SignClient.
+ *
+ * - Used internally by `WalletConnectWallet` to manage connections and sessions.
+ * - Handles pairing, approval, session tracking, RPC requests, and disconnects.
+ * - Exposes a minimal API for lifecycle control; higher-level logic lives in `WalletConnectWallet`.
+ */
 class WalletConnectClient {
     constructor() {
         // tracks the pending approval callback returned from `connect()`
@@ -20,12 +27,12 @@ class WalletConnectClient {
     /**
      * Initializes the WalletConnect SignClient with your project credentials.
      *
-     * - Must be called before calling `pair()` or `request()`.
-     * - Configures metadata and optionally a custom relay server.
+     * - Must be called before `pair()`, `approve()`, or `request()`.
+     * - Configures app metadata and an optional custom relay server.
      *
      * @param opts.projectId - WalletConnect project ID.
-     * @param opts.metadata - Metadata about your app (name, URL, icons).
-     * @param opts.relayUrl - (Optional) Custom relay server URL.
+     * @param opts.appMetadata - Metadata about your app (name, URL, icons).
+     * @param opts.relayUrl - (Optional) custom relay server URL.
      * @returns A promise that resolves once the client is initialized.
      */
     async init(opts) {
@@ -42,12 +49,13 @@ class WalletConnectClient {
     /**
      * 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.
+     * - Requires `init()` to have been called.
+     * - Must be followed by `approve()` after the wallet approves.
      * - Throws if a pairing is already in progress.
      *
-     * @param namespaces - Namespaces to request for optional capabilities.
+     * @param namespaces - Optional namespaces requesting capabilities.
      * @returns A WalletConnect URI for the wallet to connect with.
-     * @throws {Error} If a pairing is already in progress or URI is not returned.
+     * @throws {Error} If a pairing is already in progress or no URI is returned.
      */
     async pair(namespaces) {
         if (this.pendingApproval) {
@@ -65,10 +73,10 @@ class WalletConnectClient {
     /**
      * 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.
+     * - Requires `init()` and a pending pairing started via `pair()`.
      *
      * @returns A promise that resolves to the established session.
-     * @throws {Error} If called before `pair()` or approval fails.
+     * @throws {Error} If called before `pair()` or if approval fails.
      */
     async approve() {
         if (!this.pendingApproval) {
@@ -95,13 +103,13 @@ class WalletConnectClient {
     /**
      * Sends a JSON-RPC request over the active WalletConnect session.
      *
-     * - The session must already be connected.
+     * - Requires `init()` and an active session.
      *
-     * @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.
+     * @param chainId - Target chain ID (e.g. `eip155:1`).
+     * @param method - RPC method name.
+     * @param params - Parameters for the RPC method.
      * @returns A promise that resolves with the RPC response.
-     * @throws {Error} If no active session is found.
+     * @throws {Error} If no active session exists.
      */
     async request(chainId, method, params) {
         const session = this.getSession();

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

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

@@ -10,31 +10,39 @@ export declare class WebWalletManager {
     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.
+     * - 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);
     /**
-     * Initializes the wallet manager and all wallet connectors.
+     * Initializes WalletConnect components and any registered wallet interfaces.
      *
-     * @param cfg - Wallet manager configuration.
-     * @returns A promise that resolves once all wallet initializers have completed.
+     * - Initializes the low-level WalletConnect client with the provided config.
+     * - Runs any registered async wallet initializers (currently only `WalletConnectWallet`).
+     *
+     * @param cfg - Wallet manager configuration used for initializing the WalletConnect client.
      */
     init(cfg: TWalletManagerConfig): Promise<void>;
     /**
-     * Retrieves available wallet providers based on the configured chains.
+     * 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.
      *
-     * @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.
+     * @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 as supporting a specific blockchain chain.
+     * Registers a wallet interface type 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).
+     * @param chain - Chain (e.g., Ethereum, Solana).
+     * @param interfaceType - Wallet interface type to associate with the chain.
      */
     private addChainInterface;
 }

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

@@ -1 +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"}
+{"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;;;;;;;;OAQG;gBACS,GAAG,EAAE,oBAAoB;IAyDrC;;;;;;;OAOG;IACG,IAAI,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpD;;;;;;;;;OASG;IACG,YAAY,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IA4B5D;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB,CAMvB;CACH"}

package/dist/__wallet__/web/manager.js

@@ -11,9 +11,12 @@ 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.
+     * - 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
@@ -23,18 +26,18 @@ class WebWalletManager {
         // maps a blockchain chain to its corresponding wallet interface types
         this.chainToInterfaces = {};
         /**
-         * Registers a wallet interface as supporting a specific blockchain chain.
+         * Registers a wallet interface type 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).
+         * @param chain - Chain (e.g., Ethereum, Solana).
+         * @param interfaceType - Wallet interface type to associate with the chain.
          */
-        this.addChainInterface = (chain, iface) => {
+        this.addChainInterface = (chain, interfaceType) => {
             if (!this.chainToInterfaces[chain])
                 this.chainToInterfaces[chain] = [];
-            this.chainToInterfaces[chain].push(iface);
+            this.chainToInterfaces[chain].push(interfaceType);
         };
-        const enableNativeEvm = cfg.chains.ethereum ?? false;
-        const enableNativeSol = cfg.chains.solana ?? false;
+        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;
@@ -71,32 +74,37 @@ class WebWalletManager {
         }
     }
     /**
-     * Initializes the wallet manager and all wallet connectors.
+     * Initializes WalletConnect components and any registered wallet interfaces.
      *
-     * @param cfg - Wallet manager configuration.
-     * @returns A promise that resolves once all wallet initializers have completed.
+     * - Initializes the low-level WalletConnect client with the provided config.
+     * - Runs any registered async wallet initializers (currently only `WalletConnectWallet`).
+     *
+     * @param cfg - Wallet manager configuration used for initializing the WalletConnect client.
      */
     async init(cfg) {
         if (this.wcClient) {
             await this.wcClient.init(cfg.walletConnect);
         }
-        // Run all wallet-specific initializers
+        // we initialize the high-level WalletConnectWallet
+        // we do this because we can't init this inside the constructor since it's async
         await Promise.all(this.initializers.map((fn) => fn()));
-        await this.stamper?.init();
     }
     /**
-     * Retrieves available wallet providers based on the configured chains.
+     * 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.
      *
-     * @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.
+     * @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 ifaceTypes = this.chainToInterfaces[chain];
-            if (!ifaceTypes || ifaceTypes.length === 0)
+            const interfaceTypes = this.chainToInterfaces[chain];
+            if (!interfaceTypes || interfaceTypes.length === 0)
                 throw new Error(`No wallet supports chain: ${chain}`);
-            const walletsToQuery = ifaceTypes
+            const walletsToQuery = interfaceTypes
                 .map((iface) => this.wallets[iface])
                 .filter(Boolean);
             const providersArrays = await Promise.all(walletsToQuery.map((wallet) => wallet.getProviders()));

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

@@ -1 +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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"}
+{"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

@@ -9,9 +9,12 @@ 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.
+     * - 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
@@ -21,18 +24,18 @@ class WebWalletManager {
         // maps a blockchain chain to its corresponding wallet interface types
         this.chainToInterfaces = {};
         /**
-         * Registers a wallet interface as supporting a specific blockchain chain.
+         * Registers a wallet interface type 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).
+         * @param chain - Chain (e.g., Ethereum, Solana).
+         * @param interfaceType - Wallet interface type to associate with the chain.
          */
-        this.addChainInterface = (chain, iface) => {
+        this.addChainInterface = (chain, interfaceType) => {
             if (!this.chainToInterfaces[chain])
                 this.chainToInterfaces[chain] = [];
-            this.chainToInterfaces[chain].push(iface);
+            this.chainToInterfaces[chain].push(interfaceType);
         };
-        const enableNativeEvm = cfg.chains.ethereum ?? false;
-        const enableNativeSol = cfg.chains.solana ?? false;
+        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;
@@ -69,32 +72,37 @@ class WebWalletManager {
         }
     }
     /**
-     * Initializes the wallet manager and all wallet connectors.
+     * Initializes WalletConnect components and any registered wallet interfaces.
      *
-     * @param cfg - Wallet manager configuration.
-     * @returns A promise that resolves once all wallet initializers have completed.
+     * - Initializes the low-level WalletConnect client with the provided config.
+     * - Runs any registered async wallet initializers (currently only `WalletConnectWallet`).
+     *
+     * @param cfg - Wallet manager configuration used for initializing the WalletConnect client.
      */
     async init(cfg) {
         if (this.wcClient) {
             await this.wcClient.init(cfg.walletConnect);
         }
-        // Run all wallet-specific initializers
+        // we initialize the high-level WalletConnectWallet
+        // we do this because we can't init this inside the constructor since it's async
         await Promise.all(this.initializers.map((fn) => fn()));
-        await this.stamper?.init();
     }
     /**
-     * Retrieves available wallet providers based on the configured chains.
+     * 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.
      *
-     * @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.
+     * @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 ifaceTypes = this.chainToInterfaces[chain];
-            if (!ifaceTypes || ifaceTypes.length === 0)
+            const interfaceTypes = this.chainToInterfaces[chain];
+            if (!interfaceTypes || interfaceTypes.length === 0)
                 throw new Error(`No wallet supports chain: ${chain}`);
-            const walletsToQuery = ifaceTypes
+            const walletsToQuery = interfaceTypes
                 .map((iface) => this.wallets[iface])
                 .filter(Boolean);
             const providersArrays = await Promise.all(walletsToQuery.map((wallet) => wallet.getProviders()));

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

@@ -1 +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;;;;"}
+{"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

@@ -4,9 +4,9 @@ import { EthereumWalletInterface, SignIntent, SwitchableChain, WalletInterfaceTy
  * Abstract base class for Ethereum wallet implementations.
  *
  * Provides shared logic for:
- * - Provider discovery via EIP-6963
- * - Connecting and disconnecting wallets
- * - Recovering compressed public keys
+ * - 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;
@@ -18,9 +18,12 @@ export declare abstract class BaseEthereumWallet implements EthereumWalletInterf
      * @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>;
+    abstract sign(payload: string | Hex, provider: WalletProvider, intent: SignIntent): Promise<Hex>;
     /**
-     * Retrieves the compressed public key by signing a known message.
+     * 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).
@@ -29,23 +32,48 @@ export declare abstract class BaseEthereumWallet implements EthereumWalletInterf
     /**
      * 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[]>;
     /**
-     * Ensures the wallet account is connected.
+     * 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 once the account is connected.
+     * @returns A promise that resolves once at least one account is connected.
+     * @throws {Error} If the wallet returns no accounts after the request.
      */
     connectWalletAccount: (provider: WalletProvider) => Promise<void>;
     /**
-     * Disconnects the wallet account by revoking permissions.
+     * 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 permissions are revoked.
+     * @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>;
 }
 /**
@@ -57,11 +85,17 @@ 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.
+     * - `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: (message: string, provider: WalletProvider, intent: SignIntent) => Promise<Hex>;
+    sign: (payload: string, provider: WalletProvider, intent: SignIntent) => Promise<Hex>;
 }
 //# sourceMappingURL=ethereum.d.ts.map

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

@@ -1 +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"}
+{"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;;;;;;;;OAQG;IACH,YAAY,aAAoB,cAAc,KAAG,QAAQ,MAAM,CAAC,CAQ9D;IAEF;;;;;;;;;OASG;IACH,YAAY,QAAa,QAAQ,cAAc,EAAE,CAAC,CA2DhD;IAEF;;;;;;;;;OASG;IACH,oBAAoB,aAAoB,cAAc,KAAG,QAAQ,IAAI,CAAC,CAGpE;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,CAiCb;CACH"}