@turnkey/core 1.0.0-beta.0

package/dist/__wallet__/mobile/manager.mjs

@@ -0,0 +1,93 @@
+import { CrossPlatformWalletStamper } from '../stamper.mjs';
+import { CrossPlatformWalletConnector } from '../connector.mjs';
+import { WalletInterfaceType, Chain } from '../../__types__/base.mjs';
+import { WalletConnectClient } from '../wallet-connect/client.mjs';
+import { WalletConnectWallet } from '../wallet-connect/base.mjs';
+
+class MobileWalletManager {
+    /**
+     * Constructs a MobileWalletManager that only uses WalletConnect.
+     *
+     * @param cfg - Wallet manager configuration (uses only WalletConnect fields).
+     */
+    constructor(cfg) {
+        // queue of async initialization functions
+        this.initializers = [];
+        // mapping of wallet interface types to their wallet instances
+        this.wallets = {};
+        // maps a blockchain chain to its corresponding wallet interface types
+        this.chainToInterfaces = {};
+        /**
+         * Registers a wallet interface as supporting a specific blockchain chain.
+         */
+        this.addChainInterface = (chain, iface) => {
+            if (!this.chainToInterfaces[chain])
+                this.chainToInterfaces[chain] = [];
+            this.chainToInterfaces[chain].push(iface);
+        };
+        const ethereumNamespaces = cfg.chains.ethereum?.walletConnectNamespaces ?? [];
+        const solanaNamespaces = cfg.chains.solana?.walletConnectNamespaces ?? [];
+        const enableWalletConnectEvm = ethereumNamespaces.length > 0;
+        const enableWalletConnectSol = solanaNamespaces.length > 0;
+        const enableWalletConnect = enableWalletConnectEvm || enableWalletConnectSol;
+        if (cfg.walletConnect && enableWalletConnect) {
+            this.wcClient = new WalletConnectClient();
+            const wcUnified = new WalletConnectWallet(this.wcClient);
+            this.wallets[WalletInterfaceType.WalletConnect] = wcUnified;
+            // add async init step to the initializer queue
+            this.initializers.push(() => wcUnified.init({ ethereumNamespaces, solanaNamespaces }));
+            // register WalletConnect as a wallet interface for each enabled chain
+            if (enableWalletConnectEvm) {
+                this.addChainInterface(Chain.Ethereum, WalletInterfaceType.WalletConnect);
+            }
+            if (enableWalletConnectSol) {
+                this.addChainInterface(Chain.Solana, WalletInterfaceType.WalletConnect);
+            }
+        }
+        if (cfg.features?.auth) {
+            this.stamper = new CrossPlatformWalletStamper(this.wallets);
+        }
+        if (cfg.features?.connecting) {
+            this.connector = new CrossPlatformWalletConnector(this.wallets);
+        }
+    }
+    /**
+     * Initializes the wallet manager and WalletConnect client.
+     *
+     * @param cfg - Wallet manager configuration.
+     */
+    async init(cfg) {
+        if (this.wcClient) {
+            await this.wcClient.init(cfg.walletConnect);
+        }
+        await Promise.all(this.initializers.map((fn) => fn()));
+        await this.stamper?.init();
+    }
+    /**
+     * Retrieves available wallet providers, optionally filtered by chain.
+     *
+     * @param chain - Optional chain to filter providers by.
+     * @throws If no wallet interface is registered for the given chain.
+     */
+    async getProviders(chain) {
+        if (chain) {
+            const ifaceTypes = this.chainToInterfaces[chain];
+            if (!ifaceTypes || ifaceTypes.length === 0) {
+                throw new Error(`No wallet supports chain: ${chain}`);
+            }
+            const walletsToQuery = ifaceTypes
+                .map((iface) => this.wallets[iface])
+                .filter(Boolean);
+            const providersArrays = await Promise.all(walletsToQuery.map((wallet) => wallet.getProviders()));
+            // we still need to filter by chain because WalletConnect can return providers for multiple chains
+            return providersArrays
+                .flat()
+                .filter((p) => p.chainInfo.namespace === chain);
+        }
+        const providersArrays = await Promise.all(Object.values(this.wallets).map((wallet) => wallet.getProviders()));
+        return providersArrays.flat();
+    }
+}
+
+export { MobileWalletManager };
+//# sourceMappingURL=manager.mjs.map

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

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

@@ -0,0 +1,19 @@
+import { type WalletInterface, type TStamp, type TStamper, type WalletProvider, WalletInterfaceType } from "@types";
+export declare class CrossPlatformWalletStamper implements TStamper {
+    private readonly ctx;
+    private activeInterfaceType?;
+    constructor(wallets: Partial<Record<WalletInterfaceType, WalletInterface>>);
+    init(): Promise<void>;
+    stamp(payload: string, interfaceType?: WalletInterfaceType, provider?: WalletProvider): Promise<TStamp>;
+    getPublicKey(interfaceType: WalletInterfaceType | undefined, provider: WalletProvider): Promise<string>;
+    setProvider(interfaceType: WalletInterfaceType, provider: WalletProvider): void;
+    getWalletInterface(interfaceType?: WalletInterfaceType): WalletInterface;
+    private defaultInterface;
+    private getCtx;
+}
+export declare class WalletStamper {
+    private readonly wallet;
+    constructor(wallet: WalletInterface);
+    stamp(payload: string, provider: WalletProvider): Promise<TStamp>;
+}
+//# sourceMappingURL=stamper.d.ts.map

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

@@ -0,0 +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"}

package/dist/__wallet__/stamper.js

@@ -0,0 +1,116 @@
+'use strict';
+
+var base = require('../__types__/base.js');
+var encoding = require('@turnkey/encoding');
+var utils = require('../utils.js');
+
+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 {
+    constructor(wallets) {
+        this.ctx = {};
+        for (const [interfaceType, wallet] of Object.entries(wallets)) {
+            const typedInterface = interfaceType;
+            this.ctx[typedInterface] = {
+                wallet,
+                stamper: new WalletStamper(wallet),
+            };
+        }
+    }
+    async init() {
+        if (!Object.keys(this.ctx).length) {
+            throw new Error("No interfaces initialized in WalletStamper");
+        }
+    }
+    async stamp(payload, interfaceType = this.defaultInterface(), provider) {
+        const ctx = this.getCtx(interfaceType);
+        const selectedProvider = provider ?? ctx.provider;
+        if (!selectedProvider) {
+            throw new Error(`Could not find a provider for interface '${interfaceType}'.`);
+        }
+        return ctx.stamper.stamp(payload, selectedProvider);
+    }
+    async getPublicKey(interfaceType = this.defaultInterface(), provider) {
+        return this.getCtx(interfaceType).wallet.getPublicKey(provider);
+    }
+    setProvider(interfaceType, provider) {
+        this.getCtx(interfaceType).provider = provider;
+        this.activeInterfaceType = interfaceType;
+    }
+    getWalletInterface(interfaceType = this.defaultInterface()) {
+        return this.getCtx(interfaceType).wallet;
+    }
+    defaultInterface() {
+        if (this.activeInterfaceType) {
+            return this.activeInterfaceType;
+        }
+        const initializedInterfaces = Object.keys(this.ctx);
+        if (initializedInterfaces.includes(base.WalletInterfaceType.Ethereum)) {
+            return base.WalletInterfaceType.Ethereum;
+        }
+        if (initializedInterfaces.includes(base.WalletInterfaceType.Solana)) {
+            return base.WalletInterfaceType.Solana;
+        }
+        if (initializedInterfaces.includes(base.WalletInterfaceType.WalletConnect)) {
+            return base.WalletInterfaceType.WalletConnect;
+        }
+        throw new Error("No interfaces initialized");
+    }
+    getCtx(interfaceType) {
+        const ctx = this.ctx[interfaceType];
+        if (!ctx) {
+            throw new Error(`Interface '${interfaceType}' not initialised`);
+        }
+        return ctx;
+    }
+}
+class WalletStamper {
+    constructor(wallet) {
+        this.wallet = wallet;
+    }
+    async stamp(payload, provider) {
+        let signature;
+        let publicKey;
+        try {
+            signature = await this.wallet.sign(payload, provider, base.SignIntent.SignMessage);
+        }
+        catch (error) {
+            throw new Error(`Failed to sign the message: ${error}`);
+        }
+        const scheme = utils.isSolanaWallet(provider)
+            ? SIGNATURE_SCHEME_TK_API_ED25519
+            : SIGNATURE_SCHEME_TK_API_SECP256K1_EIP191;
+        try {
+            if (utils.isEthereumWallet(provider)) {
+                const { recoverPublicKey, hashMessage } = await import('viem');
+                const { compressRawPublicKey, toDerSignature } = await import('@turnkey/crypto');
+                const rawPublicKey = await recoverPublicKey({
+                    hash: hashMessage(payload),
+                    signature: signature,
+                });
+                const publicKeyHex = rawPublicKey.startsWith("0x")
+                    ? rawPublicKey.slice(2)
+                    : rawPublicKey;
+                const publicKeyBytes = encoding.uint8ArrayFromHexString(publicKeyHex);
+                const publicKeyBytesCompressed = compressRawPublicKey(publicKeyBytes);
+                publicKey = encoding.uint8ArrayToHexString(publicKeyBytesCompressed);
+                signature = toDerSignature(signature.replace("0x", ""));
+            }
+            else {
+                publicKey = await this.wallet.getPublicKey(provider);
+            }
+        }
+        catch (error) {
+            throw new Error(`Failed to recover public key: ${error}`);
+        }
+        return {
+            stampHeaderName: STAMP_HEADER_NAME,
+            stampHeaderValue: encoding.stringToBase64urlString(JSON.stringify({ publicKey, scheme, signature })),
+        };
+    }
+}
+
+exports.CrossPlatformWalletStamper = CrossPlatformWalletStamper;
+exports.WalletStamper = WalletStamper;
+//# sourceMappingURL=stamper.js.map

package/dist/__wallet__/stamper.js.map

@@ -0,0 +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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"}

package/dist/__wallet__/stamper.mjs

@@ -0,0 +1,113 @@
+import { WalletInterfaceType, SignIntent } from '../__types__/base.mjs';
+import { uint8ArrayFromHexString, uint8ArrayToHexString, stringToBase64urlString } from '@turnkey/encoding';
+import { isSolanaWallet, isEthereumWallet } 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 {
+    constructor(wallets) {
+        this.ctx = {};
+        for (const [interfaceType, wallet] of Object.entries(wallets)) {
+            const typedInterface = interfaceType;
+            this.ctx[typedInterface] = {
+                wallet,
+                stamper: new WalletStamper(wallet),
+            };
+        }
+    }
+    async init() {
+        if (!Object.keys(this.ctx).length) {
+            throw new Error("No interfaces initialized in WalletStamper");
+        }
+    }
+    async stamp(payload, interfaceType = this.defaultInterface(), provider) {
+        const ctx = this.getCtx(interfaceType);
+        const selectedProvider = provider ?? ctx.provider;
+        if (!selectedProvider) {
+            throw new Error(`Could not find a provider for interface '${interfaceType}'.`);
+        }
+        return ctx.stamper.stamp(payload, selectedProvider);
+    }
+    async getPublicKey(interfaceType = this.defaultInterface(), provider) {
+        return this.getCtx(interfaceType).wallet.getPublicKey(provider);
+    }
+    setProvider(interfaceType, provider) {
+        this.getCtx(interfaceType).provider = provider;
+        this.activeInterfaceType = interfaceType;
+    }
+    getWalletInterface(interfaceType = this.defaultInterface()) {
+        return this.getCtx(interfaceType).wallet;
+    }
+    defaultInterface() {
+        if (this.activeInterfaceType) {
+            return this.activeInterfaceType;
+        }
+        const initializedInterfaces = Object.keys(this.ctx);
+        if (initializedInterfaces.includes(WalletInterfaceType.Ethereum)) {
+            return WalletInterfaceType.Ethereum;
+        }
+        if (initializedInterfaces.includes(WalletInterfaceType.Solana)) {
+            return WalletInterfaceType.Solana;
+        }
+        if (initializedInterfaces.includes(WalletInterfaceType.WalletConnect)) {
+            return WalletInterfaceType.WalletConnect;
+        }
+        throw new Error("No interfaces initialized");
+    }
+    getCtx(interfaceType) {
+        const ctx = this.ctx[interfaceType];
+        if (!ctx) {
+            throw new Error(`Interface '${interfaceType}' not initialised`);
+        }
+        return ctx;
+    }
+}
+class WalletStamper {
+    constructor(wallet) {
+        this.wallet = wallet;
+    }
+    async stamp(payload, provider) {
+        let signature;
+        let publicKey;
+        try {
+            signature = await this.wallet.sign(payload, provider, SignIntent.SignMessage);
+        }
+        catch (error) {
+            throw new Error(`Failed to sign the message: ${error}`);
+        }
+        const scheme = isSolanaWallet(provider)
+            ? SIGNATURE_SCHEME_TK_API_ED25519
+            : SIGNATURE_SCHEME_TK_API_SECP256K1_EIP191;
+        try {
+            if (isEthereumWallet(provider)) {
+                const { recoverPublicKey, hashMessage } = await import('viem');
+                const { compressRawPublicKey, toDerSignature } = await import('@turnkey/crypto');
+                const rawPublicKey = await recoverPublicKey({
+                    hash: hashMessage(payload),
+                    signature: signature,
+                });
+                const publicKeyHex = rawPublicKey.startsWith("0x")
+                    ? rawPublicKey.slice(2)
+                    : rawPublicKey;
+                const publicKeyBytes = uint8ArrayFromHexString(publicKeyHex);
+                const publicKeyBytesCompressed = compressRawPublicKey(publicKeyBytes);
+                publicKey = uint8ArrayToHexString(publicKeyBytesCompressed);
+                signature = toDerSignature(signature.replace("0x", ""));
+            }
+            else {
+                publicKey = await this.wallet.getPublicKey(provider);
+            }
+        }
+        catch (error) {
+            throw new Error(`Failed to recover public key: ${error}`);
+        }
+        return {
+            stampHeaderName: STAMP_HEADER_NAME,
+            stampHeaderValue: stringToBase64urlString(JSON.stringify({ publicKey, scheme, signature })),
+        };
+    }
+}
+
+export { CrossPlatformWalletStamper, WalletStamper };
+//# sourceMappingURL=stamper.mjs.map

package/dist/__wallet__/stamper.mjs.map

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

@@ -0,0 +1,83 @@
+import { WalletInterfaceType, WalletProvider, SignIntent, WalletConnectInterface, SwitchableChain } from "@types";
+import type { WalletConnectClient } from "./client";
+export declare class WalletConnectWallet implements WalletConnectInterface {
+    private client;
+    readonly interfaceType = WalletInterfaceType.WalletConnect;
+    private ethereumNamespaces;
+    private solanaNamespaces;
+    private ethChain;
+    private solChain;
+    private uri?;
+    constructor(client: WalletConnectClient);
+    /**
+     * Initializes WalletConnect pairing flow with the specified chains.
+     * If an active session already exists, pairing is skipped.
+     *
+     * @param opts.ethereum - Whether to enable Ethereum pairing
+     * @param opts.solana - Whether to enable Solana pairing
+     * @throws {Error} If no chains are enabled
+     */
+    init(opts: {
+        ethereumNamespaces: string[];
+        solanaNamespaces: string[];
+    }): Promise<void>;
+    /**
+     * Returns WalletConnect providers with associated chain/account metadata.
+     */
+    getProviders(): Promise<WalletProvider[]>;
+    /**
+     * Approves the session if needed and ensures at least one account is available.
+     */
+    connectWalletAccount(_provider: WalletProvider): Promise<void>;
+    /**
+     * Switch 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
+     */
+    switchChain(provider: WalletProvider, chainOrId: string | SwitchableChain): Promise<void>;
+    /**
+     * Signs a message or transaction using the specified provider and intent.
+     *
+     * @param message - The message or serialized transaction to sign.
+     * @param provider - The WalletProvider to use.
+     * @param intent - The type of signing intent (message, tx, send).
+     */
+    sign(message: string, provider: WalletProvider, intent: SignIntent): Promise<string>;
+    /**
+     * Retrieves the public key of the connected wallet.
+     *
+     * @param provider - The WalletProvider to fetch the key from.
+     * @returns Compressed public key as a hex string.
+     */
+    getPublicKey(provider: WalletProvider): Promise<string>;
+    /**
+     * Disconnects the current session and re-initiates a fresh pairing URI.
+     */
+    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
+     */
+    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
+     */
+    private ensureSession;
+    /**
+     * Builds a WalletProvider descriptor for an EVM chain.
+     */
+    private buildEthProvider;
+    /**
+     * Builds a WalletProvider descriptor for Solana.
+     */
+    private buildSolProvider;
+}
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +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"}