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

package/dist/__wallet__/mobile/manager.mjs

@@ -8,7 +8,12 @@ class MobileWalletManager {
     /**
      * Constructs a MobileWalletManager that only uses WalletConnect.
      *
-     * @param cfg - Wallet manager configuration (uses only WalletConnect fields).
+     * - Determines enabled chains based on provided namespaces for Ethereum and Solana.
+     * - Initializes WalletConnect wallet interface and maps it to supported chains.
+     * - Optionally enables stamping and connecting flows based on feature flags that live in the cfg.
+     * - Sets up `CrossPlatformWalletStamper` and `CrossPlatformWalletConnector` if auth or connecting features are enabled.
+     *
+     * @param cfg - Wallet manager configuration (we only use WalletConnect fields).
      */
     constructor(cfg) {
         // queue of async initialization functions
@@ -18,12 +23,15 @@ class MobileWalletManager {
         // 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 - 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 ethereumNamespaces = cfg.chains.ethereum?.walletConnectNamespaces ?? [];
         const solanaNamespaces = cfg.chains.solana?.walletConnectNamespaces ?? [];
@@ -52,30 +60,39 @@ class MobileWalletManager {
         }
     }
     /**
-     * Initializes the wallet manager and WalletConnect client.
+     * Initializes WalletConnect components and any registered wallet interfaces.
+     *
+     * - First initializes the low-level WalletConnect client with the provided config.
+     * - Then initializes higher-level wallet interface `WalletConnectWallet` using registered async initializers.
      *
-     * @param cfg - Wallet manager configuration.
+     * @param cfg - Wallet manager configuration used for initializing the WalletConnect client.
      */
     async init(cfg) {
         if (this.wcClient) {
             await this.wcClient.init(cfg.walletConnect);
         }
+        // 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, optionally filtered by chain.
      *
+     * - If a chain is specified, filters wallet interfaces that support that chain.
+     * - Aggregates providers across all registered wallet interfaces.
+     * - Filters WalletConnect results to match the specified chain.
+     *
      * @param chain - Optional chain to filter providers by.
-     * @throws If no wallet interface is registered for the given chain.
+     * @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 interfaceType = this.chainToInterfaces[chain];
+            if (!interfaceType || interfaceType.length === 0) {
                 throw new Error(`No wallet supports chain: ${chain}`);
             }
-            const walletsToQuery = ifaceTypes
+            const walletsToQuery = interfaceType
                 .map((iface) => this.wallets[iface])
                 .filter(Boolean);
             const providersArrays = await Promise.all(walletsToQuery.map((wallet) => wallet.getProviders()));

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

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

package/dist/__wallet__/stamper.d.ts

@@ -2,18 +2,89 @@ import { type WalletInterface, type TStamp, type TStamper, type WalletProvider,
 export declare class CrossPlatformWalletStamper implements TStamper {
     private readonly ctx;
     private activeInterfaceType?;
+    /**
+     * 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: Partial<Record<WalletInterfaceType, WalletInterface>>);
-    init(): Promise<void>;
+    /**
+     * 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.
+     */
     stamp(payload: string, interfaceType?: WalletInterfaceType, provider?: WalletProvider): Promise<TStamp>;
+    /**
+     * 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.
+     */
     getPublicKey(interfaceType: WalletInterfaceType | undefined, provider: WalletProvider): Promise<string>;
+    /**
+     * 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: WalletInterfaceType, provider: WalletProvider): void;
-    getWalletInterface(interfaceType?: WalletInterfaceType): WalletInterface;
+    /**
+     * 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.
+     */
     private defaultInterface;
+    /**
+     * 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.
+     */
     private getCtx;
 }
 export declare class WalletStamper {
     private readonly wallet;
+    /**
+     * Constructs a WalletStamper bound to a single wallet interface.
+     *
+     * @param wallet - The wallet interface used for signing.
+     */
     constructor(wallet: WalletInterface);
+    /**
+     * 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.
+     */
     stamp(payload: string, provider: WalletProvider): Promise<TStamp>;
 }
 //# sourceMappingURL=stamper.d.ts.map

package/dist/__wallet__/stamper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stamper.d.ts","sourceRoot":"","sources":["../../src/__wallet__/stamper.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,mBAAmB,EACpB,MAAM,QAAQ,CAAC;AAsBhB,qBAAa,0BAA2B,YAAW,QAAQ;IACzD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;IACtC,OAAO,CAAC,mBAAmB,CAAC,CAAsB;gBAEtC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC;IAUpE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrB,KAAK,CACT,OAAO,EAAE,MAAM,EACf,aAAa,GAAE,mBAA6C,EAC5D,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,MAAM,CAAC;IAaZ,YAAY,CAChB,aAAa,iCAA+C,EAC5D,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC;IAIlB,WAAW,CACT,aAAa,EAAE,mBAAmB,EAClC,QAAQ,EAAE,cAAc,GACvB,IAAI;IAKP,kBAAkB,CAChB,aAAa,GAAE,mBAA6C,GAC3D,eAAe;IAIlB,OAAO,CAAC,gBAAgB;IAwBxB,OAAO,CAAC,MAAM;CASf;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAE9C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;CAqDxE"}
+{"version":3,"file":"stamper.d.ts","sourceRoot":"","sources":["../../src/__wallet__/stamper.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,mBAAmB,EACpB,MAAM,QAAQ,CAAC;AAsBhB,qBAAa,0BAA2B,YAAW,QAAQ;IACzD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;IACtC,OAAO,CAAC,mBAAmB,CAAC,CAAsB;IAElD;;;;;;;;;OASG;gBACS,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC;IAiB1E;;;;;;;;;;;OAWG;IACG,KAAK,CACT,OAAO,EAAE,MAAM,EACf,aAAa,GAAE,mBAA6C,EAC5D,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,MAAM,CAAC;IAalB;;;;;;OAMG;IACG,YAAY,CAChB,aAAa,iCAA+C,EAC5D,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC;IAIlB;;;;;;;OAOG;IACH,WAAW,CACT,aAAa,EAAE,mBAAmB,EAClC,QAAQ,EAAE,cAAc,GACvB,IAAI;IAKP;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;;;;;OAMG;IACH,OAAO,CAAC,MAAM;CASf;AAED,qBAAa,aAAa;IAMZ,OAAO,CAAC,QAAQ,CAAC,MAAM;IALnC;;;;OAIG;gBAC0B,MAAM,EAAE,eAAe;IAEpD;;;;;;;;;;;;;;;OAeG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;CAqDxE"}

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;
@@ -78,11 +144,11 @@ class WalletStamper {
         catch (error) {
             throw new Error(`Failed to sign the message: ${error}`);
         }
-        const scheme = utils.isSolanaWallet(provider)
+        const scheme = utils.isSolanaProvider(provider)
             ? SIGNATURE_SCHEME_TK_API_ED25519
             : SIGNATURE_SCHEME_TK_API_SECP256K1_EIP191;
         try {
-            if (utils.isEthereumWallet(provider)) {
+            if (utils.isEthereumProvider(provider)) {
                 const { recoverPublicKey, hashMessage } = await import('viem');
                 const { compressRawPublicKey, toDerSignature } = await import('@turnkey/crypto');
                 const rawPublicKey = await recoverPublicKey({

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":"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"}
+{"version":3,"file":"stamper.js","sources":["../../src/__wallet__/stamper.ts"],"sourcesContent":[null],"names":["WalletInterfaceType","SignIntent","isSolanaProvider","isEthereumProvider","uint8ArrayFromHexString","uint8ArrayToHexString","stringToBase64urlString"],"mappings":"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"}

package/dist/__wallet__/stamper.mjs

@@ -1,26 +1,44 @@
 import { WalletInterfaceType, SignIntent } from '../__types__/base.mjs';
 import { uint8ArrayFromHexString, uint8ArrayToHexString, stringToBase64urlString } from '@turnkey/encoding';
-import { isSolanaWallet, isEthereumWallet } from '../utils.mjs';
+import { isSolanaProvider, isEthereumProvider } from '../utils.mjs';
 
 const SIGNATURE_SCHEME_TK_API_SECP256K1_EIP191 = "SIGNATURE_SCHEME_TK_API_SECP256K1_EIP191";
 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;
@@ -76,11 +142,11 @@ class WalletStamper {
         catch (error) {
             throw new Error(`Failed to sign the message: ${error}`);
         }
-        const scheme = isSolanaWallet(provider)
+        const scheme = isSolanaProvider(provider)
             ? SIGNATURE_SCHEME_TK_API_ED25519
             : SIGNATURE_SCHEME_TK_API_SECP256K1_EIP191;
         try {
-            if (isEthereumWallet(provider)) {
+            if (isEthereumProvider(provider)) {
                 const { recoverPublicKey, hashMessage } = await import('viem');
                 const { compressRawPublicKey, toDerSignature } = await import('@turnkey/crypto');
                 const rawPublicKey = await recoverPublicKey({

package/dist/__wallet__/stamper.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"stamper.mjs","sources":["../../src/__wallet__/stamper.ts"],"sourcesContent":[null],"names":[],"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,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE;YAChE,OAAO,mBAAmB,CAAC,QAAQ;;QAGrC,IAAI,qBAAqB,CAAC,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE;YAC9D,OAAO,mBAAmB,CAAC,MAAM;;QAGnC,IAAI,qBAAqB,CAAC,QAAQ,CAAC,mBAAmB,CAAC,aAAa,CAAC,EAAE;YACrE,OAAO,mBAAmB,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,EACR,UAAU,CAAC,WAAW,CACvB;;QACD,OAAO,KAAK,EAAE;AACd,YAAA,MAAM,IAAI,KAAK,CAAC,+BAA+B,KAAK,CAAA,CAAE,CAAC;;AAGzD,QAAA,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ;AACpC,cAAE;cACA,wCAAwC;AAE5C,QAAA,IAAI;AACF,YAAA,IAAI,gBAAgB,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,GAAG,uBAAuB,CAAC,YAAY,CAAC;AAC5D,gBAAA,MAAM,wBAAwB,GAAG,oBAAoB,CAAC,cAAc,CAAC;AAErE,gBAAA,SAAS,GAAG,qBAAqB,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,EAAE,uBAAuB,CACvC,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CACjD;SACF;;AAEJ;;;;"}
+{"version":3,"file":"stamper.mjs","sources":["../../src/__wallet__/stamper.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}