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

package/dist/__wallet__/web/native/ethereum.js

@@ -10,15 +10,18 @@ var encoding = require('@turnkey/encoding');
  * 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
  */
 class BaseEthereumWallet {
     constructor() {
         this.interfaceType = base.WalletInterfaceType.Ethereum;
         /**
-         * 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).
@@ -31,6 +34,11 @@ class BaseEthereumWallet {
         /**
          * 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.
          */
         this.getProviders = async () => {
@@ -75,20 +83,28 @@ class BaseEthereumWallet {
             return discovered;
         };
         /**
-         * 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.
          */
         this.connectWalletAccount = async (provider) => {
             const wallet = asEip1193(provider);
             await getAccount(wallet);
         };
         /**
-         * 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).
          */
         this.disconnectWalletAccount = async (provider) => {
             const wallet = asEip1193(provider);
@@ -98,6 +114,18 @@ class BaseEthereumWallet {
             });
         };
     }
+    /**
+     * 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.
+     */
     async switchChain(provider, chainOrId) {
         if (provider.chainInfo.namespace !== base.Chain.Ethereum) {
             throw new Error("Only EVM wallets can switch chains");
@@ -158,22 +186,28 @@ 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.
          */
-        this.sign = async (message, provider, intent) => {
+        this.sign = async (payload, provider, intent) => {
             const selectedProvider = asEip1193(provider);
             const account = await getAccount(selectedProvider);
             switch (intent) {
                 case base.SignIntent.SignMessage:
                     return await selectedProvider.request({
                         method: "personal_sign",
-                        params: [message, account],
+                        params: [payload, account],
                     });
                 case base.SignIntent.SignAndSendTransaction:
-                    const tx = ethers.Transaction.from(message);
+                    const tx = ethers.Transaction.from(payload);
                     const txParams = {
                         from: account,
                         to: tx.to?.toString(),
@@ -198,9 +232,11 @@ class EthereumWallet extends BaseEthereumWallet {
 /**
  * Retrieves the active Ethereum account from a provider.
  *
+ * - Calls `eth_requestAccounts` (usually no prompt).
+ *
  * @param provider - EIP-1193 compliant provider.
  * @returns A promise resolving to the connected Ethereum address.
- * @throws If no connected account is found.
+ * @throws {Error} If no connected account is found.
  */
 const getAccount = async (provider) => {
     const [connectedAccount] = await provider.request({
@@ -213,6 +249,9 @@ const getAccount = async (provider) => {
 /**
  * Recovers and compresses the public key from a signed message.
  *
+ * - Recovers the secp256k1 public key from an EIP-191 signature and compresses it.
+ * - Returns a hex string with no 0x prefix.
+ *
  * @param signature - The signature as a hex string.
  * @param message - The original signed message.
  * @returns A promise resolving to the compressed public key (hex-encoded).
@@ -230,11 +269,13 @@ const getCompressedPublicKey = async (signature, message) => {
     return encoding.uint8ArrayToHexString(publicKeyBytesCompressed);
 };
 /**
- * Validates and casts a WalletRpcProvider to an EIP-1193 provider.
+ * Validates and casts a `WalletProvider` to an EIP-1193 provider.
+ *
+ * - Expects `provider.request` to be a function.
  *
- * @param p - The wallet RPC provider.
- * @returns A valid EIP1193 provider.
- * @throws If the provider does not implement the request() method.
+ * @param p - The wallet provider to validate.
+ * @returns An EIP-1193 provider.
+ * @throws {Error} If the provider does not implement `request()`.
  */
 const asEip1193 = (p) => {
     if (p.provider && typeof p.provider.request === "function") {

package/dist/__wallet__/web/native/ethereum.js.map

@@ -1 +1 @@
-{"version":3,"file":"ethereum.js","sources":["../../../../src/__wallet__/web/native/ethereum.ts"],"sourcesContent":[null],"names":["WalletInterfaceType","SignIntent","Chain","Transaction","toHex","recoverPublicKey","hashMessage","uint8ArrayFromHexString","compressRawPublicKey","uint8ArrayToHexString"],"mappings":"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"}
+{"version":3,"file":"ethereum.js","sources":["../../../../src/__wallet__/web/native/ethereum.ts"],"sourcesContent":[null],"names":["WalletInterfaceType","SignIntent","Chain","Transaction","toHex","recoverPublicKey","hashMessage","uint8ArrayFromHexString","compressRawPublicKey","uint8ArrayToHexString"],"mappings":"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"}

package/dist/__wallet__/web/native/ethereum.mjs

@@ -8,15 +8,18 @@ import { uint8ArrayFromHexString, uint8ArrayToHexString } from '@turnkey/encodin
  * 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
  */
 class BaseEthereumWallet {
     constructor() {
         this.interfaceType = WalletInterfaceType.Ethereum;
         /**
-         * 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,6 +32,11 @@ class BaseEthereumWallet {
         /**
          * 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.
          */
         this.getProviders = async () => {
@@ -73,20 +81,28 @@ class BaseEthereumWallet {
             return discovered;
         };
         /**
-         * 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.
          */
         this.connectWalletAccount = async (provider) => {
             const wallet = asEip1193(provider);
             await getAccount(wallet);
         };
         /**
-         * 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).
          */
         this.disconnectWalletAccount = async (provider) => {
             const wallet = asEip1193(provider);
@@ -96,6 +112,18 @@ class BaseEthereumWallet {
             });
         };
     }
+    /**
+     * 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.
+     */
     async switchChain(provider, chainOrId) {
         if (provider.chainInfo.namespace !== Chain.Ethereum) {
             throw new Error("Only EVM wallets can switch chains");
@@ -156,22 +184,28 @@ 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.
          */
-        this.sign = async (message, provider, intent) => {
+        this.sign = async (payload, provider, intent) => {
             const selectedProvider = asEip1193(provider);
             const account = await getAccount(selectedProvider);
             switch (intent) {
                 case SignIntent.SignMessage:
                     return await selectedProvider.request({
                         method: "personal_sign",
-                        params: [message, account],
+                        params: [payload, account],
                     });
                 case SignIntent.SignAndSendTransaction:
-                    const tx = Transaction.from(message);
+                    const tx = Transaction.from(payload);
                     const txParams = {
                         from: account,
                         to: tx.to?.toString(),
@@ -196,9 +230,11 @@ class EthereumWallet extends BaseEthereumWallet {
 /**
  * Retrieves the active Ethereum account from a provider.
  *
+ * - Calls `eth_requestAccounts` (usually no prompt).
+ *
  * @param provider - EIP-1193 compliant provider.
  * @returns A promise resolving to the connected Ethereum address.
- * @throws If no connected account is found.
+ * @throws {Error} If no connected account is found.
  */
 const getAccount = async (provider) => {
     const [connectedAccount] = await provider.request({
@@ -211,6 +247,9 @@ const getAccount = async (provider) => {
 /**
  * Recovers and compresses the public key from a signed message.
  *
+ * - Recovers the secp256k1 public key from an EIP-191 signature and compresses it.
+ * - Returns a hex string with no 0x prefix.
+ *
  * @param signature - The signature as a hex string.
  * @param message - The original signed message.
  * @returns A promise resolving to the compressed public key (hex-encoded).
@@ -228,11 +267,13 @@ const getCompressedPublicKey = async (signature, message) => {
     return uint8ArrayToHexString(publicKeyBytesCompressed);
 };
 /**
- * Validates and casts a WalletRpcProvider to an EIP-1193 provider.
+ * Validates and casts a `WalletProvider` to an EIP-1193 provider.
+ *
+ * - Expects `provider.request` to be a function.
  *
- * @param p - The wallet RPC provider.
- * @returns A valid EIP1193 provider.
- * @throws If the provider does not implement the request() method.
+ * @param p - The wallet provider to validate.
+ * @returns An EIP-1193 provider.
+ * @throws {Error} If the provider does not implement `request()`.
  */
 const asEip1193 = (p) => {
     if (p.provider && typeof p.provider.request === "function") {

package/dist/__wallet__/web/native/ethereum.mjs.map

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

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

@@ -1,19 +1,72 @@
 import { SignIntent, SolanaWalletInterface, WalletInterfaceType, WalletProvider } from "@types";
 /**
- * Abstract class representing a base Solana wallet.
+ * Abstract base class for Solana wallet implementations using Wallet Standard.
+ *
+ * Provides shared logic for:
+ * - Provider discovery via `@wallet-standard/app` (`getWallets()`).
+ * - Connecting via `standard:connect` and disconnecting via `standard:disconnect`.
+ * - Public key retrieval from the wallet's account address (base58 → hex).
  */
 export declare abstract class BaseSolanaWallet implements SolanaWalletInterface {
     readonly interfaceType = WalletInterfaceType.Solana;
     abstract sign(message: string | Uint8Array, provider: WalletProvider, intent: SignIntent): Promise<string>;
+    /**
+     * Retrieves the ed25519 public key for the active account as hex (no 0x prefix).
+     *
+     * - Ensures the wallet is connected (calls `standard:connect` if needed).
+     * - Decodes the Wallet Standard account address (base58) to raw bytes.
+     *
+     * @param provider - The wallet provider to use.
+     * @returns Hex-encoded ed25519 public key (no 0x prefix).
+     * @throws {Error} If no account is available.
+     */
     getPublicKey: (provider: WalletProvider) => Promise<string>;
+    /**
+     * Discovers Solana-capable Wallet Standard providers.
+     *
+     * - Uses `getWallets().get()` and filters wallets with at least one `chains` entry
+     *   starting with `"solana:"`.
+     * - For each wallet, collects branding info and any currently connected addresses.
+     *
+     * @returns A list of discovered Solana `WalletProvider`s (may be empty).
+     */
     getProviders: () => Promise<WalletProvider[]>;
+    /**
+     * Connects the wallet account, prompting the user if necessary.
+     *
+     * - Calls `standard:connect` only if no accounts are present. This will prompt the user to connect their wallet.
+     *
+     * @param provider - The wallet provider to connect.
+     * @returns A promise that resolves once the wallet has ≥ 1 account.
+     * @throws {Error} If the wallet does not implement `standard:connect`.
+     */
     connectWalletAccount: (provider: WalletProvider) => Promise<void>;
+    /**
+     * Disconnects the wallet account using Wallet Standard.
+     *
+     * - Calls `standard:disconnect` if implemented.
+     * - Throws if the wallet does not implement `standard:disconnect`.
+     *
+     * @param provider - The wallet provider to disconnect.
+     * @returns A promise that resolves once the wallet disconnects.
+     * @throws {Error} If `standard:disconnect` is not supported by the wallet.
+     */
     disconnectWalletAccount: (provider: WalletProvider) => Promise<void>;
 }
 /**
- * SolanaWallet class implementing signing logic for Solana wallets.
+ * Signs a message or transaction with the connected Solana wallet.
+ *
+ * - Ensures the wallet is connected (may prompt via `standard:connect` if its not).
+ * - `SignMessage` → `solana:signMessage` (returns hex signature).
+ * - `SignTransaction` → `solana:signTransaction` (returns hex signature).
+ *
+ * @param payload - UTF-8 string (for message) or hex string (for transaction bytes).
+ * @param provider - The wallet provider to use.
+ * @param intent - The signing intent.
+ * @returns Hex-encoded signature (no 0x prefix).
+ * @throws {Error} If the provider lacks required features or intent is unsupported.
  */
 export declare class SolanaWallet extends BaseSolanaWallet {
-    sign: (message: string, provider: WalletProvider, intent: SignIntent) => Promise<string>;
+    sign: (payload: string, provider: WalletProvider, intent: SignIntent) => Promise<string>;
 }
 //# sourceMappingURL=solana.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"solana.d.ts","sourceRoot":"","sources":["../../../../src/__wallet__/web/native/solana.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,UAAU,EACV,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EAEf,MAAM,QAAQ,CAAC;AA4ChB;;GAEG;AACH,8BAAsB,gBAAiB,YAAW,qBAAqB;IACrE,QAAQ,CAAC,aAAa,8BAA8B;IAEpD,QAAQ,CAAC,IAAI,CACX,OAAO,EAAE,MAAM,GAAG,UAAU,EAC5B,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,MAAM,CAAC;IAElB,YAAY,aAAoB,cAAc,KAAG,QAAQ,MAAM,CAAC,CAS9D;IAEF,YAAY,QAAa,QAAQ,cAAc,EAAE,CAAC,CA8BhD;IAEF,oBAAoB,aAAoB,cAAc,KAAG,QAAQ,IAAI,CAAC,CAGpE;IAEF,uBAAuB,aAAoB,cAAc,KAAG,QAAQ,IAAI,CAAC,CAUvE;CACH;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,gBAAgB;IAChD,IAAI,YACO,MAAM,YACL,cAAc,UAChB,UAAU,KACjB,QAAQ,MAAM,CAAC,CA8DhB;CACH"}
+{"version":3,"file":"solana.d.ts","sourceRoot":"","sources":["../../../../src/__wallet__/web/native/solana.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,UAAU,EACV,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EAEf,MAAM,QAAQ,CAAC;AAEhB;;;;;;;GAOG;AACH,8BAAsB,gBAAiB,YAAW,qBAAqB;IACrE,QAAQ,CAAC,aAAa,8BAA8B;IAEpD,QAAQ,CAAC,IAAI,CACX,OAAO,EAAE,MAAM,GAAG,UAAU,EAC5B,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,MAAM,CAAC;IAElB;;;;;;;;;OASG;IACH,YAAY,aAAoB,cAAc,KAAG,QAAQ,MAAM,CAAC,CAS9D;IAEF;;;;;;;;OAQG;IACH,YAAY,QAAa,QAAQ,cAAc,EAAE,CAAC,CA8BhD;IAEF;;;;;;;;OAQG;IACH,oBAAoB,aAAoB,cAAc,KAAG,QAAQ,IAAI,CAAC,CAGpE;IAEF;;;;;;;;;OASG;IACH,uBAAuB,aAAoB,cAAc,KAAG,QAAQ,IAAI,CAAC,CAUvE;CACH;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAa,SAAQ,gBAAgB;IAChD,IAAI,YACO,MAAM,YACL,cAAc,UAChB,UAAU,KACjB,QAAQ,MAAM,CAAC,CA8DhB;CACH"}

package/dist/__wallet__/web/native/solana.js

@@ -6,43 +6,26 @@ var encoding = require('@turnkey/encoding');
 var base = require('../../../__types__/base.js');
 
 /**
- * Casts a WalletRpcProvider to a Wallet Standard Solana provider.
+ * Abstract base class for Solana wallet implementations using Wallet Standard.
  *
- * @param p - The wallet provider to cast.
- * @returns The casted Wallet Standard wallet.
- * @throws If the provider is not a Wallet Standard Solana wallet.
- */
-const asSolana = (p) => {
-    if (p.provider &&
-        "features" in p.provider &&
-        "solana:signMessage" in p.provider.features) {
-        return p.provider;
-    }
-    throw new Error("Expected a Wallet-Standard provider (Solana wallet)");
-};
-/**
- * Connects the given Solana wallet account.
- *
- * @param w - The wallet to connect.
- * @returns A promise that resolves once the wallet is connected.
- * @throws If the wallet does not support standard:connect.
- */
-const connectAccount = async (w) => {
-    if (w.accounts.length)
-        return;
-    const stdConnect = w.features["standard:connect"];
-    if (stdConnect) {
-        await stdConnect.connect();
-        return;
-    }
-    throw new Error("Wallet is not connected and does not implement standard:connect");
-};
-/**
- * Abstract class representing a base Solana wallet.
+ * Provides shared logic for:
+ * - Provider discovery via `@wallet-standard/app` (`getWallets()`).
+ * - Connecting via `standard:connect` and disconnecting via `standard:disconnect`.
+ * - Public key retrieval from the wallet's account address (base58 → hex).
  */
 class BaseSolanaWallet {
     constructor() {
         this.interfaceType = base.WalletInterfaceType.Solana;
+        /**
+         * Retrieves the ed25519 public key for the active account as hex (no 0x prefix).
+         *
+         * - Ensures the wallet is connected (calls `standard:connect` if needed).
+         * - Decodes the Wallet Standard account address (base58) to raw bytes.
+         *
+         * @param provider - The wallet provider to use.
+         * @returns Hex-encoded ed25519 public key (no 0x prefix).
+         * @throws {Error} If no account is available.
+         */
         this.getPublicKey = async (provider) => {
             const wallet = asSolana(provider);
             await connectAccount(wallet);
@@ -53,6 +36,15 @@ class BaseSolanaWallet {
             const rawBytes = bs58.decode(account.address);
             return encoding.uint8ArrayToHexString(rawBytes);
         };
+        /**
+         * Discovers Solana-capable Wallet Standard providers.
+         *
+         * - Uses `getWallets().get()` and filters wallets with at least one `chains` entry
+         *   starting with `"solana:"`.
+         * - For each wallet, collects branding info and any currently connected addresses.
+         *
+         * @returns A list of discovered Solana `WalletProvider`s (may be empty).
+         */
         this.getProviders = async () => {
             const discovered = [];
             const walletsApi = app.getWallets();
@@ -80,10 +72,29 @@ class BaseSolanaWallet {
             }));
             return discovered;
         };
+        /**
+         * Connects the wallet account, prompting the user if necessary.
+         *
+         * - Calls `standard:connect` only if no accounts are present. This will prompt the user to connect their wallet.
+         *
+         * @param provider - The wallet provider to connect.
+         * @returns A promise that resolves once the wallet has ≥ 1 account.
+         * @throws {Error} If the wallet does not implement `standard:connect`.
+         */
         this.connectWalletAccount = async (provider) => {
             const wallet = asSolana(provider);
             await connectAccount(wallet);
         };
+        /**
+         * Disconnects the wallet account using Wallet Standard.
+         *
+         * - Calls `standard:disconnect` if implemented.
+         * - Throws if the wallet does not implement `standard:disconnect`.
+         *
+         * @param provider - The wallet provider to disconnect.
+         * @returns A promise that resolves once the wallet disconnects.
+         * @throws {Error} If `standard:disconnect` is not supported by the wallet.
+         */
         this.disconnectWalletAccount = async (provider) => {
             const wallet = asSolana(provider);
             const disconnectFeature = wallet.features["standard:disconnect"];
@@ -97,12 +108,22 @@ class BaseSolanaWallet {
     }
 }
 /**
- * SolanaWallet class implementing signing logic for Solana wallets.
+ * Signs a message or transaction with the connected Solana wallet.
+ *
+ * - Ensures the wallet is connected (may prompt via `standard:connect` if its not).
+ * - `SignMessage` → `solana:signMessage` (returns hex signature).
+ * - `SignTransaction` → `solana:signTransaction` (returns hex signature).
+ *
+ * @param payload - UTF-8 string (for message) or hex string (for transaction bytes).
+ * @param provider - The wallet provider to use.
+ * @param intent - The signing intent.
+ * @returns Hex-encoded signature (no 0x prefix).
+ * @throws {Error} If the provider lacks required features or intent is unsupported.
  */
 class SolanaWallet extends BaseSolanaWallet {
     constructor() {
         super(...arguments);
-        this.sign = async (message, provider, intent) => {
+        this.sign = async (payload, provider, intent) => {
             const wallet = asSolana(provider);
             await connectAccount(wallet);
             const account = wallet.accounts[0];
@@ -113,7 +134,7 @@ class SolanaWallet extends BaseSolanaWallet {
                     const signFeature = wallet.features["solana:signMessage"];
                     if (!signFeature)
                         throw new Error("Provider does not support solana:signMessage");
-                    const data = new TextEncoder().encode(message);
+                    const data = new TextEncoder().encode(payload);
                     const results = await signFeature.signMessage({
                         account,
                         message: data,
@@ -127,7 +148,7 @@ class SolanaWallet extends BaseSolanaWallet {
                     const signFeature = wallet.features["solana:signTransaction"];
                     if (!signFeature)
                         throw new Error("Provider does not support solana:signTransaction");
-                    const data = encoding.uint8ArrayFromHexString(message);
+                    const data = encoding.uint8ArrayFromHexString(payload);
                     const results = await signFeature.signTransaction({
                         account,
                         transaction: data,
@@ -143,6 +164,44 @@ class SolanaWallet extends BaseSolanaWallet {
         };
     }
 }
+/**
+ * Casts a WalletRpcProvider to a Wallet Standard Solana wallet.
+ *
+ * - Validates presence of the Wallet Standard `features` map and `solana:signMessage`.
+ * - Use this before calling Solana-specific features (signMessage, signTransaction, etc.).
+ *
+ * @param provider - The wallet provider to cast.
+ * @returns The Wallet Standard wallet object.
+ * @throws {Error} If the provider is not a Wallet Standard Solana wallet.
+ */
+const asSolana = (provider) => {
+    if (provider.provider &&
+        "features" in provider.provider &&
+        "solana:signMessage" in provider.provider.features) {
+        return provider.provider;
+    }
+    throw new Error("Expected a Wallet-Standard provider (Solana wallet)");
+};
+/**
+ * Ensures the given Wallet Standard wallet has at least one connected account.
+ *
+ * - If accounts already exist, resolves immediately.
+ * - If not, attempts `standard:connect`, which may prompt the user.
+ *
+ * @param wallet - The Wallet Standard wallet to connect.
+ * @returns A promise that resolves once the wallet has ≥ 1 account.
+ * @throws {Error} If the wallet does not implement `standard:connect`.
+ */
+const connectAccount = async (wallet) => {
+    if (wallet.accounts.length)
+        return;
+    const stdConnect = wallet.features["standard:connect"];
+    if (stdConnect) {
+        await stdConnect.connect();
+        return;
+    }
+    throw new Error("Wallet is not connected and does not implement standard:connect");
+};
 
 exports.BaseSolanaWallet = BaseSolanaWallet;
 exports.SolanaWallet = SolanaWallet;