@coinbase/agentkit 0.1.1 → 0.2.0

package/dist/wallet-providers/privyWalletProvider.js

@@ -0,0 +1,139 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _PrivyWalletProvider_walletId, _PrivyWalletProvider_authorizationPrivateKey;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrivyWalletProvider = void 0;
+const server_auth_1 = require("@privy-io/server-auth");
+const viem_1 = require("@privy-io/server-auth/viem");
+const viemWalletProvider_1 = require("./viemWalletProvider");
+const viem_2 = require("viem");
+const network_1 = require("../network/network");
+/**
+ * A wallet provider that uses Privy's server wallet API.
+ * This provider extends the ViemWalletProvider to provide Privy-specific wallet functionality
+ * while maintaining compatibility with the base wallet provider interface.
+ */
+class PrivyWalletProvider extends viemWalletProvider_1.ViemWalletProvider {
+    /**
+     * Private constructor to enforce use of factory method.
+     *
+     * @param walletClient - The Viem wallet client instance
+     * @param config - The configuration options for the Privy wallet
+     */
+    constructor(walletClient, config) {
+        super(walletClient);
+        _PrivyWalletProvider_walletId.set(this, void 0);
+        _PrivyWalletProvider_authorizationPrivateKey.set(this, void 0);
+        __classPrivateFieldSet(this, _PrivyWalletProvider_walletId, config.walletId, "f"); // Now guaranteed to exist
+        __classPrivateFieldSet(this, _PrivyWalletProvider_authorizationPrivateKey, config.authorizationPrivateKey, "f");
+    }
+    /**
+     * Creates and configures a new PrivyWalletProvider instance.
+     *
+     * @param config - The configuration options for the Privy wallet
+     * @returns A configured PrivyWalletProvider instance
+     *
+     * @example
+     * ```typescript
+     * const provider = await PrivyWalletProvider.configureWithWallet({
+     *   appId: "your-app-id",
+     *   appSecret: "your-app-secret",
+     *   walletId: "wallet-id",
+     *   chainId: "84532"
+     * });
+     * ```
+     */
+    static async configureWithWallet(config) {
+        const privy = new server_auth_1.PrivyClient(config.appId, config.appSecret, {
+            walletApi: config.authorizationPrivateKey
+                ? {
+                    authorizationPrivateKey: config.authorizationPrivateKey,
+                }
+                : undefined,
+        });
+        let walletId;
+        let address;
+        if (!config.walletId) {
+            if (config.authorizationPrivateKey && !config.authorizationKeyId) {
+                throw new Error("authorizationKeyId is required when creating a new wallet with an authorization key, this can be found in your Privy Dashboard");
+            }
+            if (config.authorizationKeyId && !config.authorizationPrivateKey) {
+                throw new Error("authorizationPrivateKey is required when creating a new wallet with an authorizationKeyId. " +
+                    "If you don't have it, you can create a new one in your Privy Dashboard, or delete the authorization key.");
+            }
+            try {
+                const wallet = await privy.walletApi.create({
+                    chainType: "ethereum",
+                    authorizationKeyIds: config.authorizationKeyId ? [config.authorizationKeyId] : undefined,
+                });
+                walletId = wallet.id;
+                address = wallet.address;
+            }
+            catch (error) {
+                console.error(error);
+                if (error instanceof Error &&
+                    error.message.includes("Missing `privy-authorization-signature` header")) {
+                    // Providing a more informative error message, see context: https://github.com/coinbase/agentkit/pull/242#discussion_r1956428617
+                    throw new Error("Privy error: you have an authorization key on your account which can create and modify wallets, please delete this key or pass it to the PrivyWalletProvider to create a new wallet");
+                }
+                throw new Error("Failed to create wallet");
+            }
+        }
+        else {
+            walletId = config.walletId;
+            const wallet = await privy.walletApi.getWallet({ id: walletId });
+            if (!wallet) {
+                throw new Error(`Wallet with ID ${walletId} not found`);
+            }
+            address = wallet.address;
+        }
+        const account = await (0, viem_1.createViemAccount)({
+            walletId,
+            address,
+            privy,
+        });
+        const chainId = config.chainId || "84532";
+        const chain = (0, network_1.getChain)(chainId);
+        if (!chain) {
+            throw new Error(`Chain with ID ${chainId} not found`);
+        }
+        const walletClient = (0, viem_2.createWalletClient)({
+            account,
+            chain,
+            transport: (0, viem_2.http)(),
+        });
+        return new PrivyWalletProvider(walletClient, { ...config, walletId });
+    }
+    /**
+     * Gets the name of the wallet provider.
+     *
+     * @returns The string identifier for this wallet provider
+     */
+    getName() {
+        return "privy_wallet_provider";
+    }
+    /**
+     * Exports the wallet data.
+     *
+     * @returns The wallet data
+     */
+    exportWallet() {
+        return {
+            walletId: __classPrivateFieldGet(this, _PrivyWalletProvider_walletId, "f"),
+            authorizationPrivateKey: __classPrivateFieldGet(this, _PrivyWalletProvider_authorizationPrivateKey, "f"),
+            chainId: this.getNetwork().chainId,
+        };
+    }
+}
+exports.PrivyWalletProvider = PrivyWalletProvider;
+_PrivyWalletProvider_walletId = new WeakMap(), _PrivyWalletProvider_authorizationPrivateKey = new WeakMap();

package/dist/wallet-providers/solanaKeypairWalletProvider.d.ts

@@ -0,0 +1,143 @@
+import { SvmWalletProvider } from "./svmWalletProvider";
+import { Network } from "../network";
+import { Connection, PublicKey, VersionedTransaction, RpcResponseAndContext, SignatureResult, SignatureStatus, SignatureStatusConfig } from "@solana/web3.js";
+import { SOLANA_CLUSTER, SOLANA_NETWORK_ID } from "../network/svm";
+/**
+ * SolanaKeypairWalletProvider is a wallet provider that uses a local Solana keypair.
+ *
+ * @augments SvmWalletProvider
+ */
+export declare class SolanaKeypairWalletProvider extends SvmWalletProvider {
+    #private;
+    /**
+     * Creates a new SolanaKeypairWalletProvider
+     *
+     * @param args - Configuration arguments
+     * @param args.keypair - Either a Uint8Array or a base58 encoded string representing a 32-byte secret key
+     * @param args.rpcUrl - URL of the Solana RPC endpoint
+     * @param args.genesisHash - The genesis hash of the network
+     */
+    constructor({ keypair, rpcUrl, genesisHash, }: {
+        keypair: Uint8Array | string;
+        rpcUrl: string;
+        genesisHash: string;
+    });
+    /**
+     * Get the default RPC URL for a Solana cluster
+     *
+     * @param cluster - The cluster to get the RPC URL for
+     * @returns The RPC URL for the cluster
+     */
+    static urlForCluster(cluster: SOLANA_CLUSTER): string;
+    /**
+     * Create a new SolanaKeypairWalletProvider from an SVM networkId and a keypair
+     *
+     * @param networkId - The SVM networkId
+     * @param keypair - Either a Uint8Array or a base58 encoded string representing a 32-byte secret key
+     * @returns The new SolanaKeypairWalletProvider
+     */
+    static fromNetwork<T extends SolanaKeypairWalletProvider>(networkId: SOLANA_NETWORK_ID, keypair: Uint8Array | string): Promise<T>;
+    /**
+     * Create a new SolanaKeypairWalletProvider from an RPC URL and a keypair
+     *
+     * @param rpcUrl - The URL of the Solana RPC endpoint
+     * @param keypair - Either a Uint8Array or a base58 encoded string representing a 32-byte secret key
+     * @returns The new SolanaKeypairWalletProvider
+     */
+    static fromRpcUrl<T extends SolanaKeypairWalletProvider>(rpcUrl: string, keypair: Uint8Array | string): Promise<T>;
+    /**
+     * Create a new SolanaKeypairWalletProvider from a Connection and a keypair
+     *
+     * @param connection - The Connection to use
+     * @param keypair - Either a Uint8Array or a base58 encoded string representing a 32-byte secret key
+     * @returns The new SolanaKeypairWalletProvider
+     */
+    static fromConnection<T extends SolanaKeypairWalletProvider>(connection: Connection, keypair: Uint8Array | string): Promise<T>;
+    /**
+     * Get the connection instance
+     *
+     * @returns The Solana connection instance
+     */
+    getConnection(): Connection;
+    /**
+     * Get the public key of the wallet
+     *
+     * @returns The wallet's public key
+     */
+    getPublicKey(): PublicKey;
+    /**
+     * Get the address of the wallet
+     *
+     * @returns The base58 encoded address of the wallet
+     */
+    getAddress(): string;
+    /**
+     * Get the network
+     *
+     * @returns The network
+     */
+    getNetwork(): Network;
+    /**
+     * Sign a transaction
+     *
+     * @param transaction - The transaction to sign
+     * @returns The signed transaction
+     */
+    signTransaction(transaction: VersionedTransaction): Promise<VersionedTransaction>;
+    /**
+     * Send a transaction
+     *
+     * @param transaction - The transaction to send
+     * @returns The signature
+     */
+    sendTransaction(transaction: VersionedTransaction): Promise<string>;
+    /**
+     * Sign and send a transaction
+     *
+     * @param transaction - The transaction to sign and send
+     * @returns The signature
+     */
+    signAndSendTransaction(transaction: VersionedTransaction): Promise<string>;
+    /**
+     * Get the status of a transaction
+     *
+     * @param signature - The signature
+     * @param options - The options for the status
+     * @returns The status
+     */
+    getSignatureStatus(signature: string, options?: SignatureStatusConfig): Promise<RpcResponseAndContext<SignatureStatus | null>>;
+    /**
+     * Wait for signature receipt
+     *
+     * @param signature - The signature
+     * @returns The confirmation response
+     */
+    waitForSignatureResult(signature: string): Promise<RpcResponseAndContext<SignatureResult>>;
+    /**
+     * Get the name of the wallet provider
+     *
+     * @returns The name of the wallet provider
+     */
+    getName(): string;
+    /**
+     * Get the balance of the wallet
+     *
+     * @returns The balance of the wallet
+     */
+    getBalance(): Promise<bigint>;
+    /**
+     * Transfer SOL from the wallet to another address
+     *
+     * @param to - The base58 encoded address to transfer the SOL to
+     * @param value - The amount of SOL to transfer (as a decimal string, e.g. "0.0001")
+     * @returns The signature
+     */
+    nativeTransfer(to: string, value: string): Promise<string>;
+    /**
+     * Request SOL tokens from the Solana faucet. This method only works on devnet and testnet networks.
+     *
+     * @param lamports - The amount of lamports (1 SOL = 1,000,000,000 lamports) to request from the faucet
+     * @returns A Promise that resolves to the signature of the airdrop
+     */
+    requestAirdrop(lamports: number): Promise<string>;
+}

package/dist/wallet-providers/solanaKeypairWalletProvider.js

@@ -0,0 +1,280 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var _SolanaKeypairWalletProvider_keypair, _SolanaKeypairWalletProvider_connection, _SolanaKeypairWalletProvider_genesisHash;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SolanaKeypairWalletProvider = void 0;
+const svmWalletProvider_1 = require("./svmWalletProvider");
+const web3_js_1 = require("@solana/web3.js");
+const bs58_1 = __importDefault(require("bs58"));
+const svm_1 = require("../network/svm");
+/**
+ * SolanaKeypairWalletProvider is a wallet provider that uses a local Solana keypair.
+ *
+ * @augments SvmWalletProvider
+ */
+class SolanaKeypairWalletProvider extends svmWalletProvider_1.SvmWalletProvider {
+    /**
+     * Creates a new SolanaKeypairWalletProvider
+     *
+     * @param args - Configuration arguments
+     * @param args.keypair - Either a Uint8Array or a base58 encoded string representing a 32-byte secret key
+     * @param args.rpcUrl - URL of the Solana RPC endpoint
+     * @param args.genesisHash - The genesis hash of the network
+     */
+    constructor({ keypair, rpcUrl, genesisHash, }) {
+        super();
+        _SolanaKeypairWalletProvider_keypair.set(this, void 0);
+        _SolanaKeypairWalletProvider_connection.set(this, void 0);
+        _SolanaKeypairWalletProvider_genesisHash.set(this, void 0);
+        __classPrivateFieldSet(this, _SolanaKeypairWalletProvider_keypair, typeof keypair === "string"
+            ? web3_js_1.Keypair.fromSecretKey(bs58_1.default.decode(keypair))
+            : web3_js_1.Keypair.fromSecretKey(keypair), "f");
+        __classPrivateFieldSet(this, _SolanaKeypairWalletProvider_connection, new web3_js_1.Connection(rpcUrl), "f");
+        if (genesisHash in svm_1.SOLANA_NETWORKS) {
+            __classPrivateFieldSet(this, _SolanaKeypairWalletProvider_genesisHash, genesisHash, "f");
+        }
+        else {
+            throw new Error(`Unknown network with genesis hash: ${genesisHash}`);
+        }
+    }
+    /**
+     * Get the default RPC URL for a Solana cluster
+     *
+     * @param cluster - The cluster to get the RPC URL for
+     * @returns The RPC URL for the cluster
+     */
+    static urlForCluster(cluster) {
+        if (cluster in svm_1.SOLANA_NETWORKS) {
+            switch (cluster) {
+                case svm_1.SOLANA_MAINNET_GENESIS_BLOCK_HASH:
+                    return (0, web3_js_1.clusterApiUrl)("mainnet-beta");
+                case svm_1.SOLANA_TESTNET_GENESIS_BLOCK_HASH:
+                    return (0, web3_js_1.clusterApiUrl)("testnet");
+                case svm_1.SOLANA_DEVNET_GENESIS_BLOCK_HASH:
+                    return (0, web3_js_1.clusterApiUrl)("devnet");
+                default:
+                    throw new Error(`Unknown cluster: ${cluster}`);
+            }
+        }
+        else {
+            throw new Error(`Unknown cluster: ${cluster}`);
+        }
+    }
+    /**
+     * Create a new SolanaKeypairWalletProvider from an SVM networkId and a keypair
+     *
+     * @param networkId - The SVM networkId
+     * @param keypair - Either a Uint8Array or a base58 encoded string representing a 32-byte secret key
+     * @returns The new SolanaKeypairWalletProvider
+     */
+    static async fromNetwork(networkId, keypair) {
+        let genesisHash;
+        switch (networkId) {
+            case svm_1.SOLANA_MAINNET_NETWORK_ID:
+                genesisHash = svm_1.SOLANA_MAINNET_GENESIS_BLOCK_HASH;
+                break;
+            case svm_1.SOLANA_DEVNET_NETWORK_ID:
+                genesisHash = svm_1.SOLANA_DEVNET_GENESIS_BLOCK_HASH;
+                break;
+            case svm_1.SOLANA_TESTNET_NETWORK_ID:
+                genesisHash = svm_1.SOLANA_TESTNET_GENESIS_BLOCK_HASH;
+                break;
+            default:
+                throw new Error(`${networkId} is not a valid SVM networkId`);
+        }
+        const rpcUrl = this.urlForCluster(genesisHash);
+        return await this.fromRpcUrl(rpcUrl, keypair);
+    }
+    /**
+     * Create a new SolanaKeypairWalletProvider from an RPC URL and a keypair
+     *
+     * @param rpcUrl - The URL of the Solana RPC endpoint
+     * @param keypair - Either a Uint8Array or a base58 encoded string representing a 32-byte secret key
+     * @returns The new SolanaKeypairWalletProvider
+     */
+    static async fromRpcUrl(rpcUrl, keypair) {
+        const connection = new web3_js_1.Connection(rpcUrl);
+        return await this.fromConnection(connection, keypair);
+    }
+    /**
+     * Create a new SolanaKeypairWalletProvider from a Connection and a keypair
+     *
+     * @param connection - The Connection to use
+     * @param keypair - Either a Uint8Array or a base58 encoded string representing a 32-byte secret key
+     * @returns The new SolanaKeypairWalletProvider
+     */
+    static async fromConnection(connection, keypair) {
+        const genesisHash = await connection.getGenesisHash();
+        return new SolanaKeypairWalletProvider({
+            keypair,
+            rpcUrl: connection.rpcEndpoint,
+            genesisHash: genesisHash,
+        });
+    }
+    /**
+     * Get the connection instance
+     *
+     * @returns The Solana connection instance
+     */
+    getConnection() {
+        return __classPrivateFieldGet(this, _SolanaKeypairWalletProvider_connection, "f");
+    }
+    /**
+     * Get the public key of the wallet
+     *
+     * @returns The wallet's public key
+     */
+    getPublicKey() {
+        return __classPrivateFieldGet(this, _SolanaKeypairWalletProvider_keypair, "f").publicKey;
+    }
+    /**
+     * Get the address of the wallet
+     *
+     * @returns The base58 encoded address of the wallet
+     */
+    getAddress() {
+        return __classPrivateFieldGet(this, _SolanaKeypairWalletProvider_keypair, "f").publicKey.toBase58();
+    }
+    /**
+     * Get the network
+     *
+     * @returns The network
+     */
+    getNetwork() {
+        return svm_1.SOLANA_NETWORKS[__classPrivateFieldGet(this, _SolanaKeypairWalletProvider_genesisHash, "f")];
+    }
+    /**
+     * Sign a transaction
+     *
+     * @param transaction - The transaction to sign
+     * @returns The signed transaction
+     */
+    async signTransaction(transaction) {
+        transaction.sign([__classPrivateFieldGet(this, _SolanaKeypairWalletProvider_keypair, "f")]);
+        return transaction;
+    }
+    /**
+     * Send a transaction
+     *
+     * @param transaction - The transaction to send
+     * @returns The signature
+     */
+    async sendTransaction(transaction) {
+        const signature = await __classPrivateFieldGet(this, _SolanaKeypairWalletProvider_connection, "f").sendTransaction(transaction);
+        await this.waitForSignatureResult(signature);
+        return signature;
+    }
+    /**
+     * Sign and send a transaction
+     *
+     * @param transaction - The transaction to sign and send
+     * @returns The signature
+     */
+    async signAndSendTransaction(transaction) {
+        const signedTransaction = await this.signTransaction(transaction);
+        return this.sendTransaction(signedTransaction);
+    }
+    /**
+     * Get the status of a transaction
+     *
+     * @param signature - The signature
+     * @param options - The options for the status
+     * @returns The status
+     */
+    async getSignatureStatus(signature, options) {
+        return __classPrivateFieldGet(this, _SolanaKeypairWalletProvider_connection, "f").getSignatureStatus(signature, options);
+    }
+    /**
+     * Wait for signature receipt
+     *
+     * @param signature - The signature
+     * @returns The confirmation response
+     */
+    async waitForSignatureResult(signature) {
+        const { blockhash, lastValidBlockHeight } = await __classPrivateFieldGet(this, _SolanaKeypairWalletProvider_connection, "f").getLatestBlockhash();
+        return __classPrivateFieldGet(this, _SolanaKeypairWalletProvider_connection, "f").confirmTransaction({
+            signature: signature,
+            lastValidBlockHeight,
+            blockhash,
+        });
+    }
+    /**
+     * Get the name of the wallet provider
+     *
+     * @returns The name of the wallet provider
+     */
+    getName() {
+        return "solana_keypair_wallet_provider";
+    }
+    /**
+     * Get the balance of the wallet
+     *
+     * @returns The balance of the wallet
+     */
+    getBalance() {
+        return __classPrivateFieldGet(this, _SolanaKeypairWalletProvider_connection, "f").getBalance(__classPrivateFieldGet(this, _SolanaKeypairWalletProvider_keypair, "f").publicKey).then(balance => BigInt(balance));
+    }
+    /**
+     * Transfer SOL from the wallet to another address
+     *
+     * @param to - The base58 encoded address to transfer the SOL to
+     * @param value - The amount of SOL to transfer (as a decimal string, e.g. "0.0001")
+     * @returns The signature
+     */
+    async nativeTransfer(to, value) {
+        const initialBalance = await this.getBalance();
+        const solAmount = parseFloat(value);
+        const lamports = BigInt(Math.floor(solAmount * web3_js_1.LAMPORTS_PER_SOL));
+        // Check if we have enough balance (including estimated fees)
+        if (initialBalance < lamports + BigInt(5000)) {
+            throw new Error(`Insufficient balance. Have ${Number(initialBalance) / web3_js_1.LAMPORTS_PER_SOL} SOL, need ${solAmount + 0.000005} SOL (including fees)`);
+        }
+        const toPubkey = new web3_js_1.PublicKey(to);
+        const instructions = [
+            web3_js_1.ComputeBudgetProgram.setComputeUnitPrice({
+                microLamports: 10000,
+            }),
+            web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({
+                units: 2000,
+            }),
+            web3_js_1.SystemProgram.transfer({
+                fromPubkey: __classPrivateFieldGet(this, _SolanaKeypairWalletProvider_keypair, "f").publicKey,
+                toPubkey: toPubkey,
+                lamports: lamports,
+            }),
+        ];
+        const tx = new web3_js_1.VersionedTransaction(web3_js_1.MessageV0.compile({
+            payerKey: __classPrivateFieldGet(this, _SolanaKeypairWalletProvider_keypair, "f").publicKey,
+            instructions: instructions,
+            recentBlockhash: (await __classPrivateFieldGet(this, _SolanaKeypairWalletProvider_connection, "f").getLatestBlockhash()).blockhash,
+        }));
+        tx.sign([__classPrivateFieldGet(this, _SolanaKeypairWalletProvider_keypair, "f")]);
+        const signature = await __classPrivateFieldGet(this, _SolanaKeypairWalletProvider_connection, "f").sendTransaction(tx);
+        await this.waitForSignatureResult(signature);
+        return signature;
+    }
+    /**
+     * Request SOL tokens from the Solana faucet. This method only works on devnet and testnet networks.
+     *
+     * @param lamports - The amount of lamports (1 SOL = 1,000,000,000 lamports) to request from the faucet
+     * @returns A Promise that resolves to the signature of the airdrop
+     */
+    async requestAirdrop(lamports) {
+        return await __classPrivateFieldGet(this, _SolanaKeypairWalletProvider_connection, "f").requestAirdrop(__classPrivateFieldGet(this, _SolanaKeypairWalletProvider_keypair, "f").publicKey, lamports);
+    }
+}
+exports.SolanaKeypairWalletProvider = SolanaKeypairWalletProvider;
+_SolanaKeypairWalletProvider_keypair = new WeakMap(), _SolanaKeypairWalletProvider_connection = new WeakMap(), _SolanaKeypairWalletProvider_genesisHash = new WeakMap();

package/dist/wallet-providers/solanaKeypairWalletProvider.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/wallet-providers/solanaKeypairWalletProvider.test.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const web3_js_1 = require("@solana/web3.js");
+const solanaKeypairWalletProvider_1 = require("./solanaKeypairWalletProvider");
+const svm_1 = require("../network/svm");
+describe("Solana Keypair Wallet", () => {
+    it("should initialize correctly via convenience getters", async () => {
+        const keypair = web3_js_1.Keypair.generate();
+        let wallet = await solanaKeypairWalletProvider_1.SolanaKeypairWalletProvider.fromRpcUrl((0, web3_js_1.clusterApiUrl)("devnet"), keypair.secretKey);
+        expect(wallet.getNetwork()).toEqual(svm_1.SOLANA_NETWORKS[svm_1.SOLANA_DEVNET_GENESIS_BLOCK_HASH]);
+        wallet = await solanaKeypairWalletProvider_1.SolanaKeypairWalletProvider.fromRpcUrl((0, web3_js_1.clusterApiUrl)("testnet"), keypair.secretKey);
+        expect(wallet.getNetwork()).toEqual(svm_1.SOLANA_NETWORKS[svm_1.SOLANA_TESTNET_GENESIS_BLOCK_HASH]);
+        wallet = await solanaKeypairWalletProvider_1.SolanaKeypairWalletProvider.fromRpcUrl((0, web3_js_1.clusterApiUrl)("mainnet-beta"), keypair.secretKey);
+        expect(wallet.getNetwork()).toEqual(svm_1.SOLANA_NETWORKS[svm_1.SOLANA_MAINNET_GENESIS_BLOCK_HASH]);
+        expect(wallet.getAddress()).toEqual(keypair.publicKey.toBase58());
+    });
+    it("should error when the network genesis hash is unknown", async () => {
+        expect(() => new solanaKeypairWalletProvider_1.SolanaKeypairWalletProvider({
+            keypair: web3_js_1.Keypair.generate().secretKey,
+            rpcUrl: (0, web3_js_1.clusterApiUrl)("mainnet-beta"),
+            genesisHash: "0x123",
+        })).toThrowError("Unknown network with genesis hash");
+    });
+});

package/dist/wallet-providers/svmWalletProvider.d.ts

@@ -0,0 +1,56 @@
+import { WalletProvider } from "./walletProvider";
+import { Connection, PublicKey, RpcResponseAndContext, SignatureStatus, SignatureStatusConfig, VersionedTransaction, SignatureResult } from "@solana/web3.js";
+/**
+ * SvmWalletProvider is the abstract base class for all Solana wallet providers (non browsers).
+ *
+ * @abstract
+ */
+export declare abstract class SvmWalletProvider extends WalletProvider {
+    /**
+     * Get the connection instance.
+     *
+     * @returns The Solana connection instance.
+     */
+    abstract getConnection(): Connection;
+    /**
+     * Get the public key of the wallet.
+     *
+     * @returns The wallet's public key.
+     */
+    abstract getPublicKey(): PublicKey;
+    /**
+     * Sign a transaction.
+     *
+     * @param transaction - The transaction to sign.
+     * @returns The signed transaction.
+     */
+    abstract signTransaction(transaction: VersionedTransaction): Promise<VersionedTransaction>;
+    /**
+     * Send a transaction.
+     *
+     * @param transaction - The transaction to send.
+     * @returns The signature.
+     */
+    abstract sendTransaction(transaction: VersionedTransaction): Promise<string>;
+    /**
+     * Sign and send a transaction.
+     *
+     * @param transaction - The transaction to sign and send.
+     * @returns The signature.
+     */
+    abstract signAndSendTransaction(transaction: VersionedTransaction): Promise<string>;
+    /**
+     * Get the status of a transaction.
+     *
+     * @param signature - The signature.
+     * @returns The status.
+     */
+    abstract getSignatureStatus(signature: string, options?: SignatureStatusConfig): Promise<RpcResponseAndContext<SignatureStatus | null>>;
+    /**
+     * Wait for signature receipt.
+     *
+     * @param signature - The signature
+     * @returns The confirmation response
+     */
+    abstract waitForSignatureResult(signature: string): Promise<RpcResponseAndContext<SignatureResult>>;
+}

package/dist/wallet-providers/svmWalletProvider.js

@@ -0,0 +1,13 @@
+"use strict";
+/* eslint-disable @typescript-eslint/no-explicit-any */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SvmWalletProvider = void 0;
+const walletProvider_1 = require("./walletProvider");
+/**
+ * SvmWalletProvider is the abstract base class for all Solana wallet providers (non browsers).
+ *
+ * @abstract
+ */
+class SvmWalletProvider extends walletProvider_1.WalletProvider {
+}
+exports.SvmWalletProvider = SvmWalletProvider;