@turnkey/core 1.0.0-beta.0

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

@@ -0,0 +1,248 @@
+'use strict';
+
+var viem = require('viem');
+var ethers = require('ethers');
+var crypto = require('@turnkey/crypto');
+var base = require('../../../__types__/base.js');
+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
+ */
+class BaseEthereumWallet {
+    constructor() {
+        this.interfaceType = base.WalletInterfaceType.Ethereum;
+        /**
+         * Retrieves the compressed public key by signing a known message.
+         *
+         * @param provider - The wallet provider to use.
+         * @returns A promise that resolves to the compressed public key (hex-encoded).
+         */
+        this.getPublicKey = async (provider) => {
+            const message = "GET_PUBLIC_KEY";
+            const signature = await this.sign(message, provider, base.SignIntent.SignMessage);
+            return getCompressedPublicKey(signature, message);
+        };
+        /**
+         * Discovers EIP-1193 providers using the EIP-6963 standard.
+         *
+         * @returns A promise that resolves to a list of available wallet providers.
+         */
+        this.getProviders = async () => {
+            const discovered = [];
+            const providerPromises = [];
+            const handler = (ev) => {
+                const { provider, info } = ev.detail;
+                const promise = (async () => {
+                    let connectedAddresses = [];
+                    // we default to Ethereum mainnet
+                    let chainId = "0x1";
+                    try {
+                        const accounts = await provider.request?.({
+                            method: "eth_accounts",
+                        });
+                        if (Array.isArray(accounts))
+                            connectedAddresses = accounts;
+                        chainId = await provider.request({
+                            method: "eth_chainId",
+                        });
+                    }
+                    catch {
+                        // fail silently
+                    }
+                    discovered.push({
+                        interfaceType: base.WalletInterfaceType.Ethereum,
+                        chainInfo: {
+                            namespace: base.Chain.Ethereum,
+                            chainId,
+                        },
+                        info,
+                        provider,
+                        connectedAddresses,
+                    });
+                })();
+                providerPromises.push(promise);
+            };
+            window.addEventListener("eip6963:announceProvider", handler);
+            window.dispatchEvent(new Event("eip6963:requestProvider"));
+            window.removeEventListener("eip6963:announceProvider", handler);
+            await Promise.all(providerPromises);
+            return discovered;
+        };
+        /**
+         * Ensures the wallet account is connected.
+         *
+         * @param provider - The wallet provider to use.
+         * @returns A promise that resolves once the account is connected.
+         */
+        this.connectWalletAccount = async (provider) => {
+            const wallet = asEip1193(provider);
+            await getAccount(wallet);
+        };
+        /**
+         * Disconnects the wallet account by revoking permissions.
+         *
+         * @param provider - The wallet provider to disconnect.
+         * @returns A promise that resolves once the permissions are revoked.
+         */
+        this.disconnectWalletAccount = async (provider) => {
+            const wallet = asEip1193(provider);
+            await wallet.request({
+                method: "wallet_revokePermissions",
+                params: [{ eth_accounts: {} }],
+            });
+        };
+    }
+    async switchChain(provider, chainOrId) {
+        if (provider.chainInfo.namespace !== base.Chain.Ethereum) {
+            throw new Error("Only EVM wallets can switch chains");
+        }
+        const wallet = asEip1193(provider);
+        const chainId = typeof chainOrId === "string" ? chainOrId : chainOrId.id;
+        try {
+            // first we just try switching
+            await wallet.request({
+                method: "wallet_switchEthereumChain",
+                params: [{ chainId }],
+            });
+        }
+        catch (err) {
+            // if the error is not “chain not found”
+            // we just re-throw it
+            if (err.code !== 4902) {
+                throw err;
+            }
+            // no metadata was provided so we throw an error
+            // telling them to pass it in
+            if (typeof chainOrId === "string") {
+                throw new Error(`Chain ${chainId} not recognized. ` +
+                    `If you want to add it, call switchChain with a SwitchableChain object.`);
+            }
+            // we have full metadata and can add the chain and switch
+            const { name, rpcUrls, blockExplorerUrls, iconUrls, nativeCurrency } = chainOrId;
+            // add the chain
+            await wallet.request({
+                method: "wallet_addEthereumChain",
+                params: [
+                    {
+                        chainId,
+                        chainName: name,
+                        rpcUrls,
+                        blockExplorerUrls,
+                        iconUrls,
+                        nativeCurrency,
+                    },
+                ],
+            });
+            // then switch again
+            await wallet.request({
+                method: "wallet_switchEthereumChain",
+                params: [{ chainId }],
+            });
+        }
+    }
+}
+/**
+ * EthereumWallet implementation using EIP-1193 compatible providers.
+ *
+ * Handles message signing and transaction submission.
+ */
+class EthereumWallet extends BaseEthereumWallet {
+    constructor() {
+        super(...arguments);
+        /**
+         * Signs a message or sends a transaction depending on intent.
+         *
+         * @param message - The message or raw transaction to be signed.
+         * @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).
+         */
+        this.sign = async (message, 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],
+                    });
+                case base.SignIntent.SignAndSendTransaction:
+                    const tx = ethers.Transaction.from(message);
+                    const txParams = {
+                        from: account,
+                        to: tx.to?.toString(),
+                        value: viem.toHex(tx.value),
+                        gas: viem.toHex(tx.gasLimit),
+                        maxFeePerGas: viem.toHex(tx.maxFeePerGas ?? 0n),
+                        maxPriorityFeePerGas: viem.toHex(tx.maxPriorityFeePerGas ?? 0n),
+                        nonce: viem.toHex(tx.nonce),
+                        chainId: viem.toHex(tx.chainId),
+                        data: tx.data?.toString() ?? "0x",
+                    };
+                    return await selectedProvider.request({
+                        method: "eth_sendTransaction",
+                        params: [txParams],
+                    });
+                default:
+                    throw new Error(`Unsupported sign intent: ${intent}`);
+            }
+        };
+    }
+}
+/**
+ * Retrieves the active Ethereum account from a provider.
+ *
+ * @param provider - EIP-1193 compliant provider.
+ * @returns A promise resolving to the connected Ethereum address.
+ * @throws If no connected account is found.
+ */
+const getAccount = async (provider) => {
+    const [connectedAccount] = await provider.request({
+        method: "eth_requestAccounts",
+    });
+    if (!connectedAccount)
+        throw new Error("No connected account found");
+    return connectedAccount;
+};
+/**
+ * Recovers and compresses the public key from a signed message.
+ *
+ * @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).
+ */
+const getCompressedPublicKey = async (signature, message) => {
+    const secp256k1PublicKey = await viem.recoverPublicKey({
+        hash: viem.hashMessage(message),
+        signature: signature,
+    });
+    const publicKeyHex = secp256k1PublicKey.startsWith("0x")
+        ? secp256k1PublicKey.slice(2)
+        : secp256k1PublicKey;
+    const publicKeyBytes = encoding.uint8ArrayFromHexString(publicKeyHex);
+    const publicKeyBytesCompressed = crypto.compressRawPublicKey(publicKeyBytes);
+    return encoding.uint8ArrayToHexString(publicKeyBytesCompressed);
+};
+/**
+ * Validates and casts a WalletRpcProvider to an EIP-1193 provider.
+ *
+ * @param p - The wallet RPC provider.
+ * @returns A valid EIP1193 provider.
+ * @throws If the provider does not implement the request() method.
+ */
+const asEip1193 = (p) => {
+    if (p.provider && typeof p.provider.request === "function") {
+        return p.provider;
+    }
+    throw new Error("Expected an EIP-1193 provider (Ethereum wallet)");
+};
+
+exports.BaseEthereumWallet = BaseEthereumWallet;
+exports.EthereumWallet = EthereumWallet;
+//# sourceMappingURL=ethereum.js.map

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

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

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

@@ -0,0 +1,245 @@
+import { toHex, recoverPublicKey, hashMessage } from 'viem';
+import { Transaction } from 'ethers';
+import { compressRawPublicKey } from '@turnkey/crypto';
+import { SignIntent, WalletInterfaceType, Chain } from '../../../__types__/base.mjs';
+import { uint8ArrayFromHexString, uint8ArrayToHexString } from '@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
+ */
+class BaseEthereumWallet {
+    constructor() {
+        this.interfaceType = WalletInterfaceType.Ethereum;
+        /**
+         * Retrieves the compressed public key by signing a known message.
+         *
+         * @param provider - The wallet provider to use.
+         * @returns A promise that resolves to the compressed public key (hex-encoded).
+         */
+        this.getPublicKey = async (provider) => {
+            const message = "GET_PUBLIC_KEY";
+            const signature = await this.sign(message, provider, SignIntent.SignMessage);
+            return getCompressedPublicKey(signature, message);
+        };
+        /**
+         * Discovers EIP-1193 providers using the EIP-6963 standard.
+         *
+         * @returns A promise that resolves to a list of available wallet providers.
+         */
+        this.getProviders = async () => {
+            const discovered = [];
+            const providerPromises = [];
+            const handler = (ev) => {
+                const { provider, info } = ev.detail;
+                const promise = (async () => {
+                    let connectedAddresses = [];
+                    // we default to Ethereum mainnet
+                    let chainId = "0x1";
+                    try {
+                        const accounts = await provider.request?.({
+                            method: "eth_accounts",
+                        });
+                        if (Array.isArray(accounts))
+                            connectedAddresses = accounts;
+                        chainId = await provider.request({
+                            method: "eth_chainId",
+                        });
+                    }
+                    catch {
+                        // fail silently
+                    }
+                    discovered.push({
+                        interfaceType: WalletInterfaceType.Ethereum,
+                        chainInfo: {
+                            namespace: Chain.Ethereum,
+                            chainId,
+                        },
+                        info,
+                        provider,
+                        connectedAddresses,
+                    });
+                })();
+                providerPromises.push(promise);
+            };
+            window.addEventListener("eip6963:announceProvider", handler);
+            window.dispatchEvent(new Event("eip6963:requestProvider"));
+            window.removeEventListener("eip6963:announceProvider", handler);
+            await Promise.all(providerPromises);
+            return discovered;
+        };
+        /**
+         * Ensures the wallet account is connected.
+         *
+         * @param provider - The wallet provider to use.
+         * @returns A promise that resolves once the account is connected.
+         */
+        this.connectWalletAccount = async (provider) => {
+            const wallet = asEip1193(provider);
+            await getAccount(wallet);
+        };
+        /**
+         * Disconnects the wallet account by revoking permissions.
+         *
+         * @param provider - The wallet provider to disconnect.
+         * @returns A promise that resolves once the permissions are revoked.
+         */
+        this.disconnectWalletAccount = async (provider) => {
+            const wallet = asEip1193(provider);
+            await wallet.request({
+                method: "wallet_revokePermissions",
+                params: [{ eth_accounts: {} }],
+            });
+        };
+    }
+    async switchChain(provider, chainOrId) {
+        if (provider.chainInfo.namespace !== Chain.Ethereum) {
+            throw new Error("Only EVM wallets can switch chains");
+        }
+        const wallet = asEip1193(provider);
+        const chainId = typeof chainOrId === "string" ? chainOrId : chainOrId.id;
+        try {
+            // first we just try switching
+            await wallet.request({
+                method: "wallet_switchEthereumChain",
+                params: [{ chainId }],
+            });
+        }
+        catch (err) {
+            // if the error is not “chain not found”
+            // we just re-throw it
+            if (err.code !== 4902) {
+                throw err;
+            }
+            // no metadata was provided so we throw an error
+            // telling them to pass it in
+            if (typeof chainOrId === "string") {
+                throw new Error(`Chain ${chainId} not recognized. ` +
+                    `If you want to add it, call switchChain with a SwitchableChain object.`);
+            }
+            // we have full metadata and can add the chain and switch
+            const { name, rpcUrls, blockExplorerUrls, iconUrls, nativeCurrency } = chainOrId;
+            // add the chain
+            await wallet.request({
+                method: "wallet_addEthereumChain",
+                params: [
+                    {
+                        chainId,
+                        chainName: name,
+                        rpcUrls,
+                        blockExplorerUrls,
+                        iconUrls,
+                        nativeCurrency,
+                    },
+                ],
+            });
+            // then switch again
+            await wallet.request({
+                method: "wallet_switchEthereumChain",
+                params: [{ chainId }],
+            });
+        }
+    }
+}
+/**
+ * EthereumWallet implementation using EIP-1193 compatible providers.
+ *
+ * Handles message signing and transaction submission.
+ */
+class EthereumWallet extends BaseEthereumWallet {
+    constructor() {
+        super(...arguments);
+        /**
+         * Signs a message or sends a transaction depending on intent.
+         *
+         * @param message - The message or raw transaction to be signed.
+         * @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).
+         */
+        this.sign = async (message, 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],
+                    });
+                case SignIntent.SignAndSendTransaction:
+                    const tx = Transaction.from(message);
+                    const txParams = {
+                        from: account,
+                        to: tx.to?.toString(),
+                        value: toHex(tx.value),
+                        gas: toHex(tx.gasLimit),
+                        maxFeePerGas: toHex(tx.maxFeePerGas ?? 0n),
+                        maxPriorityFeePerGas: toHex(tx.maxPriorityFeePerGas ?? 0n),
+                        nonce: toHex(tx.nonce),
+                        chainId: toHex(tx.chainId),
+                        data: tx.data?.toString() ?? "0x",
+                    };
+                    return await selectedProvider.request({
+                        method: "eth_sendTransaction",
+                        params: [txParams],
+                    });
+                default:
+                    throw new Error(`Unsupported sign intent: ${intent}`);
+            }
+        };
+    }
+}
+/**
+ * Retrieves the active Ethereum account from a provider.
+ *
+ * @param provider - EIP-1193 compliant provider.
+ * @returns A promise resolving to the connected Ethereum address.
+ * @throws If no connected account is found.
+ */
+const getAccount = async (provider) => {
+    const [connectedAccount] = await provider.request({
+        method: "eth_requestAccounts",
+    });
+    if (!connectedAccount)
+        throw new Error("No connected account found");
+    return connectedAccount;
+};
+/**
+ * Recovers and compresses the public key from a signed message.
+ *
+ * @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).
+ */
+const getCompressedPublicKey = async (signature, message) => {
+    const secp256k1PublicKey = await recoverPublicKey({
+        hash: hashMessage(message),
+        signature: signature,
+    });
+    const publicKeyHex = secp256k1PublicKey.startsWith("0x")
+        ? secp256k1PublicKey.slice(2)
+        : secp256k1PublicKey;
+    const publicKeyBytes = uint8ArrayFromHexString(publicKeyHex);
+    const publicKeyBytesCompressed = compressRawPublicKey(publicKeyBytes);
+    return uint8ArrayToHexString(publicKeyBytesCompressed);
+};
+/**
+ * Validates and casts a WalletRpcProvider to an EIP-1193 provider.
+ *
+ * @param p - The wallet RPC provider.
+ * @returns A valid EIP1193 provider.
+ * @throws If the provider does not implement the request() method.
+ */
+const asEip1193 = (p) => {
+    if (p.provider && typeof p.provider.request === "function") {
+        return p.provider;
+    }
+    throw new Error("Expected an EIP-1193 provider (Ethereum wallet)");
+};
+
+export { BaseEthereumWallet, EthereumWallet };
+//# sourceMappingURL=ethereum.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ethereum.mjs","sources":["../../../../src/__wallet__/web/native/ethereum.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;AAyBA;;;;;;;AAOG;MACmB,kBAAkB,CAAA;AAAxC,IAAA,WAAA,GAAA;AACW,QAAA,IAAA,CAAA,aAAa,GAAG,mBAAmB,CAAC,QAAQ;AAgBrD;;;;;AAKG;AACH,QAAA,IAAA,CAAA,YAAY,GAAG,OAAO,QAAwB,KAAqB;YACjE,MAAM,OAAO,GAAG,gBAAgB;AAChC,YAAA,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,IAAI,CAC/B,OAAO,EACP,QAAQ,EACR,UAAU,CAAC,WAAW,CACvB;AACD,YAAA,OAAO,sBAAsB,CAAC,SAAS,EAAE,OAAO,CAAC;AACnD,SAAC;AAED;;;;AAIG;QACH,IAAY,CAAA,YAAA,GAAG,YAAsC;YACnD,MAAM,UAAU,GAAqB,EAAE;YAOvC,MAAM,gBAAgB,GAAoB,EAAE;AAE5C,YAAA,MAAM,OAAO,GAAG,CAAC,EAAiB,KAAU;gBAC1C,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM;AAEpC,gBAAA,MAAM,OAAO,GAAG,CAAC,YAAW;oBAC1B,IAAI,kBAAkB,GAAa,EAAE;;oBAGrC,IAAI,OAAO,GAAG,KAAK;AAEnB,oBAAA,IAAI;AACF,wBAAA,MAAM,QAAQ,GAAG,MAAO,QAAgB,CAAC,OAAO,GAAG;AACjD,4BAAA,MAAM,EAAE,cAAc;AACvB,yBAAA,CAAC;AACF,wBAAA,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;4BAAE,kBAAkB,GAAG,QAAQ;AAE1D,wBAAA,OAAO,GAAG,MAAO,QAAgB,CAAC,OAAO,CAAC;AACxC,4BAAA,MAAM,EAAE,aAAa;AACtB,yBAAA,CAAC;;AACF,oBAAA,MAAM;;;oBAIR,UAAU,CAAC,IAAI,CAAC;wBACd,aAAa,EAAE,mBAAmB,CAAC,QAAQ;AAC3C,wBAAA,SAAS,EAAE;4BACT,SAAS,EAAE,KAAK,CAAC,QAAQ;4BACzB,OAAO;AACR,yBAAA;wBACD,IAAI;wBACJ,QAAQ;wBACR,kBAAkB;AACnB,qBAAA,CAAC;iBACH,GAAG;AAEJ,gBAAA,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC;AAChC,aAAC;AAED,YAAA,MAAM,CAAC,gBAAgB,CACrB,0BAA0B,EAC1B,OAAwB,CACzB;YACD,MAAM,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;AAC1D,YAAA,MAAM,CAAC,mBAAmB,CACxB,0BAA0B,EAC1B,OAAwB,CACzB;AAED,YAAA,MAAM,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;AACnC,YAAA,OAAO,UAAU;AACnB,SAAC;AAED;;;;;AAKG;AACH,QAAA,IAAA,CAAA,oBAAoB,GAAG,OAAO,QAAwB,KAAmB;AACvE,YAAA,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC;AAClC,YAAA,MAAM,UAAU,CAAC,MAAM,CAAC;AAC1B,SAAC;AAED;;;;;AAKG;AACH,QAAA,IAAA,CAAA,uBAAuB,GAAG,OAAO,QAAwB,KAAmB;AAC1E,YAAA,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC;YAClC,MAAM,MAAM,CAAC,OAAO,CAAC;AACnB,gBAAA,MAAM,EAAE,0BAA0B;AAClC,gBAAA,MAAM,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;AAC/B,aAAA,CAAC;AACJ,SAAC;;AAED,IAAA,MAAM,WAAW,CACf,QAAwB,EACxB,SAAmC,EAAA;QAEnC,IAAI,QAAQ,CAAC,SAAS,CAAC,SAAS,KAAK,KAAK,CAAC,QAAQ,EAAE;AACnD,YAAA,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC;;AAGvD,QAAA,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC;AAClC,QAAA,MAAM,OAAO,GAAG,OAAO,SAAS,KAAK,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC,EAAE;AAExE,QAAA,IAAI;;YAEF,MAAM,MAAM,CAAC,OAAO,CAAC;AACnB,gBAAA,MAAM,EAAE,4BAA4B;AACpC,gBAAA,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;AACtB,aAAA,CAAC;;QACF,OAAO,GAAQ,EAAE;;;AAGjB,YAAA,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,EAAE;AACrB,gBAAA,MAAM,GAAG;;;;AAKX,YAAA,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE;AACjC,gBAAA,MAAM,IAAI,KAAK,CACb,CAAA,MAAA,EAAS,OAAO,CAAmB,iBAAA,CAAA;AACjC,oBAAA,CAAA,sEAAA,CAAwE,CAC3E;;;AAIH,YAAA,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,cAAc,EAAE,GAClE,SAAS;;YAGX,MAAM,MAAM,CAAC,OAAO,CAAC;AACnB,gBAAA,MAAM,EAAE,yBAAyB;AACjC,gBAAA,MAAM,EAAE;AACN,oBAAA;wBACE,OAAO;AACP,wBAAA,SAAS,EAAE,IAAI;wBACf,OAAO;wBACP,iBAAiB;wBACjB,QAAQ;wBACR,cAAc;AACf,qBAAA;AACF,iBAAA;AACF,aAAA,CAAC;;YAGF,MAAM,MAAM,CAAC,OAAO,CAAC;AACnB,gBAAA,MAAM,EAAE,4BAA4B;AACpC,gBAAA,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;AACtB,aAAA,CAAC;;;AAGP;AAED;;;;AAIG;AACG,MAAO,cAAe,SAAQ,kBAAkB,CAAA;AAAtD,IAAA,WAAA,GAAA;;AACE;;;;;;;AAOG;QACH,IAAI,CAAA,IAAA,GAAG,OACL,OAAe,EACf,QAAwB,EACxB,MAAkB,KACF;AAChB,YAAA,MAAM,gBAAgB,GAAG,SAAS,CAAC,QAAQ,CAAC;AAC5C,YAAA,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,gBAAgB,CAAC;YAElD,QAAQ,MAAM;gBACZ,KAAK,UAAU,CAAC,WAAW;AACzB,oBAAA,OAAO,MAAM,gBAAgB,CAAC,OAAO,CAAC;AACpC,wBAAA,MAAM,EAAE,eAAe;AACvB,wBAAA,MAAM,EAAE,CAAC,OAAc,EAAE,OAAO,CAAC;AAClC,qBAAA,CAAC;gBAEJ,KAAK,UAAU,CAAC,sBAAsB;oBACpC,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC;AACpC,oBAAA,MAAM,QAAQ,GAAG;AACf,wBAAA,IAAI,EAAE,OAAO;AACb,wBAAA,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAS;AAC5B,wBAAA,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC;AACtB,wBAAA,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC;wBACvB,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,IAAI,EAAE,CAAC;wBAC1C,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,IAAI,EAAE,CAAC;AAC1D,wBAAA,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC;AACtB,wBAAA,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC;wBAC1B,IAAI,EAAG,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAU,IAAI,IAAI;qBAC3C;AAED,oBAAA,OAAO,MAAM,gBAAgB,CAAC,OAAO,CAAC;AACpC,wBAAA,MAAM,EAAE,qBAAqB;wBAC7B,MAAM,EAAE,CAAC,QAAQ,CAAC;AACnB,qBAAA,CAAC;AAEJ,gBAAA;AACE,oBAAA,MAAM,IAAI,KAAK,CAAC,4BAA4B,MAAM,CAAA,CAAE,CAAC;;AAE3D,SAAC;;AACF;AAED;;;;;;AAMG;AACH,MAAM,UAAU,GAAG,OAAO,QAAyB,KAAsB;IACvE,MAAM,CAAC,gBAAgB,CAAC,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC;AAChD,QAAA,MAAM,EAAE,qBAAqB;AAC9B,KAAA,CAAC;AACF,IAAA,IAAI,CAAC,gBAAgB;AAAE,QAAA,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC;AACpE,IAAA,OAAO,gBAAgB;AACzB,CAAC;AAED;;;;;;AAMG;AACH,MAAM,sBAAsB,GAAG,OAC7B,SAAiB,EACjB,OAAe,KACI;AACnB,IAAA,MAAM,kBAAkB,GAAG,MAAM,gBAAgB,CAAC;AAChD,QAAA,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC;AAC1B,QAAA,SAAS,EAAE,SAAgB;AAC5B,KAAA,CAAC;AACF,IAAA,MAAM,YAAY,GAAG,kBAAkB,CAAC,UAAU,CAAC,IAAI;AACrD,UAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC;UAC1B,kBAAkB;AAEtB,IAAA,MAAM,cAAc,GAAG,uBAAuB,CAAC,YAAY,CAAC;AAC5D,IAAA,MAAM,wBAAwB,GAAG,oBAAoB,CAAC,cAAc,CAAC;AAErE,IAAA,OAAO,qBAAqB,CAAC,wBAAwB,CAAC;AACxD,CAAC;AAED;;;;;;AAMG;AACH,MAAM,SAAS,GAAG,CAAC,CAAiB,KAAqB;AACvD,IAAA,IAAI,CAAC,CAAC,QAAQ,IAAI,OAAQ,CAAC,CAAC,QAAgB,CAAC,OAAO,KAAK,UAAU,EAAE;QACnE,OAAO,CAAC,CAAC,QAA2B;;AAEtC,IAAA,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC;AACpE,CAAC;;;;"}

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

@@ -0,0 +1,19 @@
+import { SignIntent, SolanaWalletInterface, WalletInterfaceType, WalletProvider } from "@types";
+/**
+ * Abstract class representing a base Solana wallet.
+ */
+export declare abstract class BaseSolanaWallet implements SolanaWalletInterface {
+    readonly interfaceType = WalletInterfaceType.Solana;
+    abstract sign(message: string | Uint8Array, provider: WalletProvider, intent: SignIntent): Promise<string>;
+    getPublicKey: (provider: WalletProvider) => Promise<string>;
+    getProviders: () => Promise<WalletProvider[]>;
+    connectWalletAccount: (provider: WalletProvider) => Promise<void>;
+    disconnectWalletAccount: (provider: WalletProvider) => Promise<void>;
+}
+/**
+ * SolanaWallet class implementing signing logic for Solana wallets.
+ */
+export declare class SolanaWallet extends BaseSolanaWallet {
+    sign: (message: string, provider: WalletProvider, intent: SignIntent) => Promise<string>;
+}
+//# sourceMappingURL=solana.d.ts.map

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

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