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

package/dist/__wallet__/stamper.js

@@ -8,21 +8,39 @@ const SIGNATURE_SCHEME_TK_API_SECP256K1_EIP191 = "SIGNATURE_SCHEME_TK_API_SECP25
 const SIGNATURE_SCHEME_TK_API_ED25519 = "SIGNATURE_SCHEME_TK_API_ED25519";
 const STAMP_HEADER_NAME = "X-Stamp";
 class CrossPlatformWalletStamper {
+    /**
+     * Constructs a CrossPlatformWalletStamper.
+     *
+     * - Validates that at least one wallet interface is provided.
+     * - For each wallet interface, creates an internal `WalletStamper` bound to it.
+     * - Ensures the stamper instance is always initialized in a usable state.
+     *
+     * @param wallets - A partial mapping of wallet interfaces by type.
+     * @throws {Error} If no wallet interfaces are provided.
+     */
     constructor(wallets) {
         this.ctx = {};
-        for (const [interfaceType, wallet] of Object.entries(wallets)) {
-            const typedInterface = interfaceType;
-            this.ctx[typedInterface] = {
-                wallet,
-                stamper: new WalletStamper(wallet),
-            };
+        const walletEntries = Object.entries(wallets).filter(([, w]) => Boolean(w));
+        if (walletEntries.length === 0) {
+            throw new Error("Cannot create WalletStamper: no wallet interfaces provided");
         }
-    }
-    async init() {
-        if (!Object.keys(this.ctx).length) {
-            throw new Error("No interfaces initialized in WalletStamper");
+        for (const [interfaceType, wallet] of walletEntries) {
+            const typed = interfaceType;
+            this.ctx[typed] = { wallet, stamper: new WalletStamper(wallet) };
         }
     }
+    /**
+     * Stamps a payload using the specified wallet interface and provider.
+     *
+     * - Uses the explicitly provided interface and provider if given.
+     * - Falls back to the default interface and stored provider otherwise.
+     *
+     * @param payload - The string payload to sign.
+     * @param interfaceType - Optional wallet interface type (defaults to the active or first available).
+     * @param provider - Optional provider (defaults to the one set via `setProvider`).
+     * @returns A `TStamp` object containing the stamp header name and encoded value.
+     * @throws {Error} If no provider is available for the selected interface.
+     */
     async stamp(payload, interfaceType = this.defaultInterface(), provider) {
         const ctx = this.getCtx(interfaceType);
         const selectedProvider = provider ?? ctx.provider;
@@ -31,16 +49,36 @@ class CrossPlatformWalletStamper {
         }
         return ctx.stamper.stamp(payload, selectedProvider);
     }
+    /**
+     * Retrieves the public key for the given provider.
+     *
+     * @param interfaceType - Optional wallet interface type (defaults to the active or first available).
+     * @param provider - Wallet provider for which to fetch the public key.
+     * @returns A promise resolving to the public key in hex format.
+     */
     async getPublicKey(interfaceType = this.defaultInterface(), provider) {
         return this.getCtx(interfaceType).wallet.getPublicKey(provider);
     }
+    /**
+     * Sets the active provider for a given wallet interface.
+     *
+     * - The active provider is used as a fallback in `stamp` if none is passed explicitly.
+     *
+     * @param interfaceType - Wallet interface type.
+     * @param provider - Provider instance to associate with the interface.
+     */
     setProvider(interfaceType, provider) {
         this.getCtx(interfaceType).provider = provider;
         this.activeInterfaceType = interfaceType;
     }
-    getWalletInterface(interfaceType = this.defaultInterface()) {
-        return this.getCtx(interfaceType).wallet;
-    }
+    /**
+     * Determines the default wallet interface to use when none is specified.
+     *
+     * - Preference order: Active provider > Ethereum > Solana > WalletConnect.
+     *
+     * @returns The default wallet interface type.
+     * @throws {Error} If no wallet interfaces are initialized.
+     */
     defaultInterface() {
         if (this.activeInterfaceType) {
             return this.activeInterfaceType;
@@ -57,6 +95,13 @@ class CrossPlatformWalletStamper {
         }
         throw new Error("No interfaces initialized");
     }
+    /**
+     * Retrieves the internal context for a given wallet interface.
+     *
+     * @param interfaceType - Wallet interface type.
+     * @returns The context including wallet, stamper, and optional provider.
+     * @throws {Error} If the interface is not initialized.
+     */
     getCtx(interfaceType) {
         const ctx = this.ctx[interfaceType];
         if (!ctx) {
@@ -66,9 +111,30 @@ class CrossPlatformWalletStamper {
     }
 }
 class WalletStamper {
+    /**
+     * Constructs a WalletStamper bound to a single wallet interface.
+     *
+     * @param wallet - The wallet interface used for signing.
+     */
     constructor(wallet) {
         this.wallet = wallet;
     }
+    /**
+     * Signs a payload and returns a standardized stamp header.
+     *
+     * - For Ethereum:
+     *   - Signs using EIP-191.
+     *   - Recovers and compresses the public key.
+     *   - Converts the signature into DER format.
+     * - For Solana:
+     *   - Signs using Ed25519.
+     *   - Fetches the public key directly from the wallet.
+     *
+     * @param payload - The payload to sign.
+     * @param provider - The wallet provider used for signing.
+     * @returns A `TStamp` containing the header name and base64url-encoded JSON value.
+     * @throws {Error} If signing or public key recovery fails.
+     */
     async stamp(payload, provider) {
         let signature;
         let publicKey;

package/dist/__wallet__/stamper.js.map

@@ -1 +1 @@
-{"version":3,"file":"stamper.js","sources":["../../src/__wallet__/stamper.ts"],"sourcesContent":[null],"names":["WalletInterfaceType","SignIntent","isSolanaWallet","isEthereumWallet","uint8ArrayFromHexString","uint8ArrayToHexString","stringToBase64urlString"],"mappings":";;;;;;AAgBA,MAAM,wCAAwC,GAC5C,0CAA0C;AAC5C,MAAM,+BAA+B,GAAG,iCAAiC;AACzE,MAAM,iBAAiB,GAAG,SAAS;MAUtB,0BAA0B,CAAA;AAIrC,IAAA,WAAA,CAAY,OAA8D,EAAA;QAHzD,IAAG,CAAA,GAAA,GAAe,EAAE;AAInC,QAAA,KAAK,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YAC7D,MAAM,cAAc,GAAG,aAAoC;AAC3D,YAAA,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG;gBACzB,MAAM;AACN,gBAAA,OAAO,EAAE,IAAI,aAAa,CAAC,MAAM,CAAC;aACnC;;;AAIL,IAAA,MAAM,IAAI,GAAA;AACR,QAAA,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE;AACjC,YAAA,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC;;;IAIjE,MAAM,KAAK,CACT,OAAe,EACf,aAAqC,GAAA,IAAI,CAAC,gBAAgB,EAAE,EAC5D,QAAyB,EAAA;QAEzB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;AACtC,QAAA,MAAM,gBAAgB,GAAG,QAAQ,IAAI,GAAG,CAAC,QAAQ;QAEjD,IAAI,CAAC,gBAAgB,EAAE;AACrB,YAAA,MAAM,IAAI,KAAK,CACb,4CAA4C,aAAa,CAAA,EAAA,CAAI,CAC9D;;QAGH,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC;;IAGrD,MAAM,YAAY,CAChB,aAAA,GAAqC,IAAI,CAAC,gBAAgB,EAAE,EAC5D,QAAwB,EAAA;AAExB,QAAA,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC;;IAGjE,WAAW,CACT,aAAkC,EAClC,QAAwB,EAAA;QAExB,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,QAAQ,GAAG,QAAQ;AAC9C,QAAA,IAAI,CAAC,mBAAmB,GAAG,aAAa;;AAG1C,IAAA,kBAAkB,CAChB,aAAA,GAAqC,IAAI,CAAC,gBAAgB,EAAE,EAAA;QAE5D,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,MAAM;;IAGlC,gBAAgB,GAAA;AACtB,QAAA,IAAI,IAAI,CAAC,mBAAmB,EAAE;YAC5B,OAAO,IAAI,CAAC,mBAAmB;;QAGjC,MAAM,qBAAqB,GAAG,MAAM,CAAC,IAAI,CACvC,IAAI,CAAC,GAAG,CACgB;QAE1B,IAAI,qBAAqB,CAAC,QAAQ,CAACA,wBAAmB,CAAC,QAAQ,CAAC,EAAE;YAChE,OAAOA,wBAAmB,CAAC,QAAQ;;QAGrC,IAAI,qBAAqB,CAAC,QAAQ,CAACA,wBAAmB,CAAC,MAAM,CAAC,EAAE;YAC9D,OAAOA,wBAAmB,CAAC,MAAM;;QAGnC,IAAI,qBAAqB,CAAC,QAAQ,CAACA,wBAAmB,CAAC,aAAa,CAAC,EAAE;YACrE,OAAOA,wBAAmB,CAAC,aAAa;;AAG1C,QAAA,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC;;AAGtC,IAAA,MAAM,CAAC,aAAkC,EAAA;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC;QAEnC,IAAI,CAAC,GAAG,EAAE;AACR,YAAA,MAAM,IAAI,KAAK,CAAC,cAAc,aAAa,CAAA,iBAAA,CAAmB,CAAC;;AAGjE,QAAA,OAAO,GAAG;;AAEb;MAEY,aAAa,CAAA;AACxB,IAAA,WAAA,CAA6B,MAAuB,EAAA;QAAvB,IAAM,CAAA,MAAA,GAAN,MAAM;;AAEnC,IAAA,MAAM,KAAK,CAAC,OAAe,EAAE,QAAwB,EAAA;AACnD,QAAA,IAAI,SAAiB;AACrB,QAAA,IAAI,SAAiB;AAErB,QAAA,IAAI;AACF,YAAA,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAChC,OAAO,EACP,QAAQ,EACRC,eAAU,CAAC,WAAW,CACvB;;QACD,OAAO,KAAK,EAAE;AACd,YAAA,MAAM,IAAI,KAAK,CAAC,+BAA+B,KAAK,CAAA,CAAE,CAAC;;AAGzD,QAAA,MAAM,MAAM,GAAGC,oBAAc,CAAC,QAAQ;AACpC,cAAE;cACA,wCAAwC;AAE5C,QAAA,IAAI;AACF,YAAA,IAAIC,sBAAgB,CAAC,QAAQ,CAAC,EAAE;gBAC9B,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,GAAG,MAAM,OAAO,MAAM,CAAC;gBAC9D,MAAM,EAAE,oBAAoB,EAAE,cAAc,EAAE,GAAG,MAAM,OACrD,iBAAiB,CAClB;AAED,gBAAA,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC;AAC1C,oBAAA,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC;AAC1B,oBAAA,SAAS,EAAE,SAAgB;AAC5B,iBAAA,CAAC;AAEF,gBAAA,MAAM,YAAY,GAAG,YAAY,CAAC,UAAU,CAAC,IAAI;AAC/C,sBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;sBACpB,YAAY;AAEhB,gBAAA,MAAM,cAAc,GAAGC,gCAAuB,CAAC,YAAY,CAAC;AAC5D,gBAAA,MAAM,wBAAwB,GAAG,oBAAoB,CAAC,cAAc,CAAC;AAErE,gBAAA,SAAS,GAAGC,8BAAqB,CAAC,wBAAwB,CAAC;AAC3D,gBAAA,SAAS,GAAG,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;;iBAClD;gBACL,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC;;;QAEtD,OAAO,KAAK,EAAE;AACd,YAAA,MAAM,IAAI,KAAK,CAAC,iCAAiC,KAAK,CAAA,CAAE,CAAC;;QAG3D,OAAO;AACL,YAAA,eAAe,EAAE,iBAAiB;AAClC,YAAA,gBAAgB,EAAEC,gCAAuB,CACvC,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CACjD;SACF;;AAEJ;;;;;"}
+{"version":3,"file":"stamper.js","sources":["../../src/__wallet__/stamper.ts"],"sourcesContent":[null],"names":["WalletInterfaceType","SignIntent","isSolanaWallet","isEthereumWallet","uint8ArrayFromHexString","uint8ArrayToHexString","stringToBase64urlString"],"mappings":"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"}

package/dist/__wallet__/stamper.mjs

@@ -6,21 +6,39 @@ const SIGNATURE_SCHEME_TK_API_SECP256K1_EIP191 = "SIGNATURE_SCHEME_TK_API_SECP25
 const SIGNATURE_SCHEME_TK_API_ED25519 = "SIGNATURE_SCHEME_TK_API_ED25519";
 const STAMP_HEADER_NAME = "X-Stamp";
 class CrossPlatformWalletStamper {
+    /**
+     * Constructs a CrossPlatformWalletStamper.
+     *
+     * - Validates that at least one wallet interface is provided.
+     * - For each wallet interface, creates an internal `WalletStamper` bound to it.
+     * - Ensures the stamper instance is always initialized in a usable state.
+     *
+     * @param wallets - A partial mapping of wallet interfaces by type.
+     * @throws {Error} If no wallet interfaces are provided.
+     */
     constructor(wallets) {
         this.ctx = {};
-        for (const [interfaceType, wallet] of Object.entries(wallets)) {
-            const typedInterface = interfaceType;
-            this.ctx[typedInterface] = {
-                wallet,
-                stamper: new WalletStamper(wallet),
-            };
+        const walletEntries = Object.entries(wallets).filter(([, w]) => Boolean(w));
+        if (walletEntries.length === 0) {
+            throw new Error("Cannot create WalletStamper: no wallet interfaces provided");
         }
-    }
-    async init() {
-        if (!Object.keys(this.ctx).length) {
-            throw new Error("No interfaces initialized in WalletStamper");
+        for (const [interfaceType, wallet] of walletEntries) {
+            const typed = interfaceType;
+            this.ctx[typed] = { wallet, stamper: new WalletStamper(wallet) };
         }
     }
+    /**
+     * Stamps a payload using the specified wallet interface and provider.
+     *
+     * - Uses the explicitly provided interface and provider if given.
+     * - Falls back to the default interface and stored provider otherwise.
+     *
+     * @param payload - The string payload to sign.
+     * @param interfaceType - Optional wallet interface type (defaults to the active or first available).
+     * @param provider - Optional provider (defaults to the one set via `setProvider`).
+     * @returns A `TStamp` object containing the stamp header name and encoded value.
+     * @throws {Error} If no provider is available for the selected interface.
+     */
     async stamp(payload, interfaceType = this.defaultInterface(), provider) {
         const ctx = this.getCtx(interfaceType);
         const selectedProvider = provider ?? ctx.provider;
@@ -29,16 +47,36 @@ class CrossPlatformWalletStamper {
         }
         return ctx.stamper.stamp(payload, selectedProvider);
     }
+    /**
+     * Retrieves the public key for the given provider.
+     *
+     * @param interfaceType - Optional wallet interface type (defaults to the active or first available).
+     * @param provider - Wallet provider for which to fetch the public key.
+     * @returns A promise resolving to the public key in hex format.
+     */
     async getPublicKey(interfaceType = this.defaultInterface(), provider) {
         return this.getCtx(interfaceType).wallet.getPublicKey(provider);
     }
+    /**
+     * Sets the active provider for a given wallet interface.
+     *
+     * - The active provider is used as a fallback in `stamp` if none is passed explicitly.
+     *
+     * @param interfaceType - Wallet interface type.
+     * @param provider - Provider instance to associate with the interface.
+     */
     setProvider(interfaceType, provider) {
         this.getCtx(interfaceType).provider = provider;
         this.activeInterfaceType = interfaceType;
     }
-    getWalletInterface(interfaceType = this.defaultInterface()) {
-        return this.getCtx(interfaceType).wallet;
-    }
+    /**
+     * Determines the default wallet interface to use when none is specified.
+     *
+     * - Preference order: Active provider > Ethereum > Solana > WalletConnect.
+     *
+     * @returns The default wallet interface type.
+     * @throws {Error} If no wallet interfaces are initialized.
+     */
     defaultInterface() {
         if (this.activeInterfaceType) {
             return this.activeInterfaceType;
@@ -55,6 +93,13 @@ class CrossPlatformWalletStamper {
         }
         throw new Error("No interfaces initialized");
     }
+    /**
+     * Retrieves the internal context for a given wallet interface.
+     *
+     * @param interfaceType - Wallet interface type.
+     * @returns The context including wallet, stamper, and optional provider.
+     * @throws {Error} If the interface is not initialized.
+     */
     getCtx(interfaceType) {
         const ctx = this.ctx[interfaceType];
         if (!ctx) {
@@ -64,9 +109,30 @@ class CrossPlatformWalletStamper {
     }
 }
 class WalletStamper {
+    /**
+     * Constructs a WalletStamper bound to a single wallet interface.
+     *
+     * @param wallet - The wallet interface used for signing.
+     */
     constructor(wallet) {
         this.wallet = wallet;
     }
+    /**
+     * Signs a payload and returns a standardized stamp header.
+     *
+     * - For Ethereum:
+     *   - Signs using EIP-191.
+     *   - Recovers and compresses the public key.
+     *   - Converts the signature into DER format.
+     * - For Solana:
+     *   - Signs using Ed25519.
+     *   - Fetches the public key directly from the wallet.
+     *
+     * @param payload - The payload to sign.
+     * @param provider - The wallet provider used for signing.
+     * @returns A `TStamp` containing the header name and base64url-encoded JSON value.
+     * @throws {Error} If signing or public key recovery fails.
+     */
     async stamp(payload, provider) {
         let signature;
         let publicKey;

package/dist/__wallet__/stamper.mjs.map

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

package/dist/__wallet__/wallet-connect/base.d.ts

@@ -8,14 +8,25 @@ export declare class WalletConnectWallet implements WalletConnectInterface {
     private ethChain;
     private solChain;
     private uri?;
+    /**
+     * Constructs a WalletConnectWallet bound to a WalletConnect client.
+     *
+     * - Subscribes to session deletions and automatically re-initiates pairing,
+     *   updating `this.uri` so the UI can present a fresh QR/deeplink.
+     *
+     * @param client - The low-level WalletConnect client used for session/RPC.
+     */
     constructor(client: WalletConnectClient);
     /**
-     * Initializes WalletConnect pairing flow with the specified chains.
-     * If an active session already exists, pairing is skipped.
+     * Initializes WalletConnect pairing flow with the specified namespaces.
+     *
+     * - Saves the requested chain namespaces (e.g., `["eip155:1", "eip155:137", "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]`).
+     * - If an active session already has connected accounts, pairing is skipped.
+     * - Otherwise initiates a pairing and stores the resulting URI.
      *
-     * @param opts.ethereum - Whether to enable Ethereum pairing
-     * @param opts.solana - Whether to enable Solana pairing
-     * @throws {Error} If no chains are enabled
+     * @param opts.ethereumNamespaces - List of EVM CAIP IDs (e.g., "eip155:1").
+     * @param opts.solanaNamespaces - List of Solana CAIP IDs (e.g., "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp").
+     * @throws {Error} If no namespaces are provided for either chain.
      */
     init(opts: {
         ethereumNamespaces: string[];
@@ -23,61 +34,130 @@ export declare class WalletConnectWallet implements WalletConnectInterface {
     }): Promise<void>;
     /**
      * Returns WalletConnect providers with associated chain/account metadata.
+     *
+     * - Builds an EVM provider (if Ethereum namespaces are enabled).
+     * - Builds a Solana provider (if Solana namespaces are enabled).
+     *
+     * @returns A promise resolving to an array of WalletProvider objects.
      */
     getProviders(): Promise<WalletProvider[]>;
     /**
      * Approves the session if needed and ensures at least one account is available.
+     *
+     * - Calls `approve()` on the underlying client when pairing is pending.
+     * - Throws if the approved session contains no connected accounts.
+     *
+     * @param _provider - Unused (present for interface compatibility).
+     * @throws {Error} If the session contains no accounts.
      */
     connectWalletAccount(_provider: WalletProvider): Promise<void>;
     /**
-     * Switch the user’s WalletConnect session to a new EVM chain.
+     * Switches the user’s WalletConnect session to a new EVM chain.
      *
-     * @param provider   – the WalletProvider returned by getProviders()
-     * @param chainOrId  – either:
-     *                     • a CAIP string ("eip155:1", "eip155:137", …)
-     *                     • a SwitchableChain object carrying full metadata
+     * - Ethereum-only: only supported for providers on the Ethereum namespace.
+     * - No add-then-switch: WalletConnect cannot add chains mid-session. The target chain
+     *   must be present in `ethereumNamespaces` negotiated at pairing time. To support a new chain,
+     *   you must include it in the walletConfig.
+     * - Accepts a hex chain ID (e.g., "0x1"). If a `SwitchableChain` is passed, only its `id`
+     *   (hex chain ID) is used; metadata is ignored for WalletConnect.
+     *
+     * @param provider - The WalletProvider returned by `getProviders()`.
+     * @param chainOrId - Hex chain ID (e.g., "0x1") or a `SwitchableChain` (its `id` is used).
+     * @returns A promise that resolves when the switch completes.
+     * @throws {Error} If no active session, provider is non-EVM, the chain is not in `ethereumNamespaces`,
+     *                 or the switch RPC fails.
      */
     switchChain(provider: WalletProvider, chainOrId: string | SwitchableChain): Promise<void>;
     /**
-     * Signs a message or transaction using the specified provider and intent.
+     * Signs a message or transaction using the specified wallet provider and intent.
+     *
+     * - Ensures an active WalletConnect session:
+     *   - If a pairing is in progress (URI shown but not yet approved), this call will
+     *     wait for the user to approve the session and may appear stuck until they do.
+     *   - If no pairing is in progress, this will throw (e.g., "call pair() before approve()").
+     * - Ethereum:
+     *   - `SignMessage` → `personal_sign` (returns hex signature).
+     *   - `SignAndSendTransaction` → `eth_sendTransaction` (returns tx hash).
+     * - Solana:
+     *   - `SignMessage` → `solana_signMessage` (returns hex signature).
+     *   - `SignTransaction` → `solana_signTransaction` (returns hex signature).
+     *   - `SignAndSendTransaction` → `solana_sendTransaction` (returns hex signature of the submitted tx).
      *
-     * @param message - The message or serialized transaction to sign.
+     * @param payload - Payload or serialized transaction to sign.
      * @param provider - The WalletProvider to use.
-     * @param intent - The type of signing intent (message, tx, send).
+     * @param intent - The signing intent.
+     * @returns A hex string (signature or transaction hash, depending on intent).
+     * @throws {Error} If no account is available, no pairing is in progress, or the intent is unsupported.
      */
-    sign(message: string, provider: WalletProvider, intent: SignIntent): Promise<string>;
+    sign(payload: string, provider: WalletProvider, intent: SignIntent): Promise<string>;
     /**
      * Retrieves the public key of the connected wallet.
      *
+     * - Ethereum: signs a fixed challenge and recovers the compressed secp256k1 public key.
+     * - Solana: decodes the base58-encoded address to raw bytes.
+     *
      * @param provider - The WalletProvider to fetch the key from.
-     * @returns Compressed public key as a hex string.
+     * @returns A compressed public key as a hex string.
+     * @throws {Error} If no account is available or the namespace is unsupported.
      */
     getPublicKey(provider: WalletProvider): Promise<string>;
     /**
      * Disconnects the current session and re-initiates a fresh pairing URI.
+     *
+     * - Calls `disconnect()` on the client, then `pair()` with current namespaces.
+     * - Updates `this.uri` so the UI can present a new QR/deeplink.
      */
     disconnectWalletAccount(_provider: WalletProvider): Promise<void>;
     /**
      * Builds a lightweight provider interface for the given chain.
      *
-     * @param chainId - The namespace chain ID (e.g., eip155:1)
-     * @returns A WalletConnect-compatible provider implementation
+     * @param chainId - Namespace chain ID (e.g., "eip155:1" or "solana:101").
+     * @returns A WalletConnect-compatible provider that proxies JSON-RPC via WC.
      */
     private makeProvider;
     /**
      * Ensures there is an active WalletConnect session, initiating approval if necessary.
      *
-     * @returns The current WalletConnect session
-     * @throws {Error} If approval fails or session is not established
+     * - If a session exists, returns it immediately.
+     * - If no session exists but a pairing is in progress, awaits `approve()` —
+     *   this will block until the user approves (or rejects) in their wallet.
+     * - If no session exists and no pairing is in progress, throws; the caller
+     *   must have initiated pairing via `pair()` elsewhere.
+     *
+     * @returns The active WalletConnect session.
+     * @throws {Error} If approval is rejected, completes without establishing a session,
+     *                 or no pairing is in progress.
      */
     private ensureSession;
     /**
      * Builds a WalletProvider descriptor for an EVM chain.
+     *
+     * - Extracts the connected address (if any) and current chain ID.
+     * - Includes the pairing `uri` if available.
+     *
+     * @param session - Current WalletConnect session (or null).
+     * @param info - Provider branding info (name, icon).
+     * @returns A WalletProvider object for Ethereum.
      */
     private buildEthProvider;
     /**
      * Builds a WalletProvider descriptor for Solana.
+     *
+     * - Extracts the connected address (if any).
+     * - Includes the fresh pairing `uri` if available.
+     *
+     * @param session - Current WalletConnect session (or null).
+     * @param info - Provider branding info (name, icon).
+     * @returns A WalletProvider object for Solana.
      */
     private buildSolProvider;
+    /**
+     * Builds the requested WalletConnect namespaces from the current config.
+     *
+     * - Includes methods and events for Ethereum and/or Solana based on enabled namespaces.
+     *
+     * @returns A namespaces object suitable for `WalletConnectClient.pair()`.
+     */
+    private buildNamespaces;
 }
 //# sourceMappingURL=base.d.ts.map

package/dist/__wallet__/wallet-connect/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/__wallet__/wallet-connect/base.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,mBAAmB,EACnB,cAAc,EAEd,UAAU,EAEV,sBAAsB,EACtB,eAAe,EAChB,MAAM,QAAQ,CAAC;AAChB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAIpD,qBAAa,mBAAoB,YAAW,sBAAsB;IAWpD,OAAO,CAAC,MAAM;IAV1B,QAAQ,CAAC,aAAa,qCAAqC;IAE3D,OAAO,CAAC,kBAAkB,CAAgB;IAC1C,OAAO,CAAC,gBAAgB,CAAgB;IAExC,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,QAAQ,CAAU;IAE1B,OAAO,CAAC,GAAG,CAAC,CAAS;gBAED,MAAM,EAAE,mBAAmB;IAI/C;;;;;;;OAOG;IACG,IAAI,CAAC,IAAI,EAAE;QACf,kBAAkB,EAAE,MAAM,EAAE,CAAC;QAC7B,gBAAgB,EAAE,MAAM,EAAE,CAAC;KAC5B,GAAG,OAAO,CAAC,IAAI,CAAC;IAwDjB;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAqB/C;;OAEG;IACG,oBAAoB,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpE;;;;;;;OAOG;IACG,WAAW,CACf,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,MAAM,GAAG,eAAe,GAClC,OAAO,CAAC,IAAI,CAAC;IAmChB;;;;;;OAMG;IACG,IAAI,CACR,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,MAAM,CAAC;IAuGlB;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAyC7D;;OAEG;IACG,uBAAuB,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCvE;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAQpB;;;;;OAKG;YACW,aAAa;IAU3B;;OAEG;YACW,gBAAgB;IAwB9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAgBzB"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/__wallet__/wallet-connect/base.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,mBAAmB,EACnB,cAAc,EAEd,UAAU,EAEV,sBAAsB,EACtB,eAAe,EAChB,MAAM,QAAQ,CAAC;AAChB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAIpD,qBAAa,mBAAoB,YAAW,sBAAsB;IAmBpD,OAAO,CAAC,MAAM;IAlB1B,QAAQ,CAAC,aAAa,qCAAqC;IAE3D,OAAO,CAAC,kBAAkB,CAAgB;IAC1C,OAAO,CAAC,gBAAgB,CAAgB;IAExC,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,QAAQ,CAAU;IAE1B,OAAO,CAAC,GAAG,CAAC,CAAS;IAErB;;;;;;;OAOG;gBACiB,MAAM,EAAE,mBAAmB;IAa/C;;;;;;;;;;OAUG;IACG,IAAI,CAAC,IAAI,EAAE;QACf,kBAAkB,EAAE,MAAM,EAAE,CAAC;QAC7B,gBAAgB,EAAE,MAAM,EAAE,CAAC;KAC5B,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCjB;;;;;;;OAOG;IACG,YAAY,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAqB/C;;;;;;;;OAQG;IACG,oBAAoB,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpE;;;;;;;;;;;;;;;OAeG;IACG,WAAW,CACf,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,MAAM,GAAG,eAAe,GAClC,OAAO,CAAC,IAAI,CAAC;IAmChB;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,IAAI,CACR,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,MAAM,CAAC;IAuGlB;;;;;;;;;OASG;IACG,YAAY,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAyC7D;;;;;OAKG;IACG,uBAAuB,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvE;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAQpB;;;;;;;;;;;;OAYG;YACW,aAAa;IAU3B;;;;;;;;;OASG;YACW,gBAAgB;IAwB9B;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB;IAiBxB;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;CA+BxB"}