MCP Crypto Wallet EVM

Instructions

Implementation Reference

• src/handlers/wallet.ts:22-59 (handler)

  The core handler function that implements the wallet_create_random tool logic using ethers.Wallet.createRandom() to generate a new random wallet, optionally encrypt it, and return wallet details.
  export const createWalletHandler = async (input: any): Promise<ToolResultSchema> => { try { const options: any = {}; if (input.path) { options.path = input.path; } if (input.locale) { options.locale = input.locale; } const wallet = ethers.Wallet.createRandom(options); let result: any = { address: wallet.address, mnemonic: wallet.mnemonic?.phrase, privateKey: wallet.privateKey, publicKey: wallet.publicKey }; if (input.password) { // If a password is provided, encrypt the wallet const encryptedWallet = await wallet.encrypt(input.password); result.encryptedWallet = encryptedWallet; } return createSuccessResponse(`Wallet created successfully: Address: ${wallet.address} Private Key: ${wallet.privateKey} Public Key: ${wallet.publicKey} Mnemonic: ${wallet.mnemonic?.phrase} Encrypted Wallet: ${result.encryptedWallet ? "Yes" : "No"} `); } catch (error) { return createErrorResponse(`Failed to create wallet: ${(error as Error).message}`); } };
• src/tools.ts:52-64 (schema)

  The input schema definition for the wallet_create_random tool, specifying optional parameters for password, HD path, and locale.
  { name: "wallet_create_random", description: "Create a new wallet with a random private key", inputSchema: { type: "object", properties: { password: { type: "string", description: "Optional password to encrypt the wallet" }, path: { type: "string", description: "Optional HD path" }, locale: { type: "string", description: "Optional locale for the wordlist" } }, required: [] } },
• src/tools.ts:560-560 (registration)

  Registration of the wallet_create_random tool name to its handler function createWalletHandler in the handlers dictionary.
  "wallet_create_random": createWalletHandler,
• src/tools.ts:39-552 (registration)

  The tools array registration including the schema and name for wallet_create_random.
  export const tools = [ { name: "wallet_provider_set", description: "Set the provider URL. By default, the provider URL is set to the ETH mainnet or the URL set in the PROVIDER_URL environment variable.", inputSchema: { type: "object", properties: { providerURL: { type: "string", description: "The provider RPC URL" } }, required: ["providerURL"] } }, // Wallet Creation and Management { name: "wallet_create_random", description: "Create a new wallet with a random private key", inputSchema: { type: "object", properties: { password: { type: "string", description: "Optional password to encrypt the wallet" }, path: { type: "string", description: "Optional HD path" }, locale: { type: "string", description: "Optional locale for the wordlist" } }, required: [] } }, { name: "wallet_from_private_key", description: "Create a wallet from a private key", inputSchema: { type: "object", properties: { privateKey: { type: "string", description: "The private key" } }, required: ["privateKey"] } }, { name: "wallet_create_mnemonic_phrase", description: "Create a mnemonic phrase", inputSchema: { type: "object", properties: { length: { type: "number", description: "The length of the mnemonic phrase", enum: [12, 15, 18, 21, 24] }, locale: { type: "string", description: "Optional locale for the wordlist" } }, required: ["length"] } }, { name: "wallet_from_mnemonic", description: "Create a wallet from a mnemonic phrase", inputSchema: { type: "object", properties: { mnemonic: { type: "string", description: "The mnemonic phrase" }, path: { type: "string", description: "Optional HD path" }, locale: { type: "string", description: "Optional locale for the wordlist" } }, required: ["mnemonic"] } }, { name: "wallet_from_encrypted_json", description: "Create a wallet by decrypting an encrypted JSON wallet", inputSchema: { type: "object", properties: { json: { type: "string", description: "The encrypted JSON wallet" }, password: { type: "string", description: "The password to decrypt the wallet" } }, required: ["json", "password"] } }, { name: "wallet_encrypt", description: "Encrypt a wallet with a password", inputSchema: { type: "object", properties: { wallet: { type: "string", description: "The wallet to encrypt (private key, mnemonic, or JSON)" }, password: { type: "string", description: "The password to encrypt the wallet" }, options: { type: "object", description: "Optional encryption options", properties: { scrypt: { type: "object", properties: { N: { type: "number" }, r: { type: "number" }, p: { type: "number" } } } } } }, required: ["wallet", "password"] } }, // Wallet Properties { name: "wallet_get_address", description: "Get the wallet address", inputSchema: { type: "object", properties: { wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." } }, required: [] } }, { name: "wallet_get_public_key", description: "Get the wallet public key", inputSchema: { type: "object", properties: { wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." } }, required: [] } }, { name: "wallet_get_private_key", description: "Get the wallet private key (with appropriate security warnings)", inputSchema: { type: "object", properties: { wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." }, password: { type: "string", description: "The password to decrypt the wallet if it's encrypted" } }, required: [] } }, // Blockchain Methods { name: "wallet_get_balance", description: "Get the balance of the wallet", inputSchema: { type: "object", properties: { wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." }, blockTag: { type: "string", description: "Optional block tag (latest, pending, etc.)" } }, required: [] } }, { name: "wallet_get_chain_id", description: "Get the chain ID the wallet is connected to", inputSchema: { type: "object", properties: { wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." } }, required: [] } }, { name: "wallet_get_gas_price", description: "Get the current gas price", inputSchema: { type: "object", properties: { wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." } }, required: [] } }, { name: "wallet_get_transaction_count", description: "Get the number of transactions sent from this account (nonce)", inputSchema: { type: "object", properties: { wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." }, blockTag: { type: "string", description: "Optional block tag (latest, pending, etc.)" } }, required: [] } }, { name: "wallet_call", description: "Call a contract method without sending a transaction", inputSchema: { type: "object", properties: { wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." }, transaction: { type: "object", description: "The transaction to call", properties: { to: { type: "string" }, from: { type: "string" }, data: { type: "string" }, value: { type: "string" }, gasLimit: { type: "string" }, gasPrice: { type: "string" } }, required: ["to"] }, blockTag: { type: "string", description: "Optional block tag (latest, pending, etc.)" } }, required: ["transaction"] } }, // Transaction Methods { name: "wallet_send_transaction", description: "Send a transaction", inputSchema: { type: "object", properties: { wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." }, transaction: { type: "object", description: "The transaction to send", properties: { to: { type: "string" }, from: { type: "string" }, data: { type: "string" }, value: { type: "string" }, gasLimit: { type: "string" }, gasPrice: { type: "string" }, nonce: { type: "number" }, type: { type: "number" }, maxFeePerGas: { type: "string" }, maxPriorityFeePerGas: { type: "string" } }, required: ["to"] } }, required: ["transaction"] } }, { name: "wallet_sign_transaction", description: "Sign a transaction without sending it", inputSchema: { type: "object", properties: { wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." }, transaction: { type: "object", description: "The transaction to sign", properties: { to: { type: "string" }, from: { type: "string" }, data: { type: "string" }, value: { type: "string" }, gasLimit: { type: "string" }, gasPrice: { type: "string" }, nonce: { type: "number" }, type: { type: "number" }, maxFeePerGas: { type: "string" }, maxPriorityFeePerGas: { type: "string" } }, required: ["to"] } }, required: ["transaction"] } }, { name: "wallet_populate_transaction", description: "Populate a transaction with missing fields", inputSchema: { type: "object", properties: { wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." }, transaction: { type: "object", description: "The transaction to populate", properties: { to: { type: "string" }, from: { type: "string" }, data: { type: "string" }, value: { type: "string" }, gasLimit: { type: "string" }, gasPrice: { type: "string" }, nonce: { type: "number" }, type: { type: "number" }, maxFeePerGas: { type: "string" }, maxPriorityFeePerGas: { type: "string" } }, required: ["to"] } }, required: ["transaction"] } }, // Signing Methods { name: "wallet_sign_message", description: "Sign a message", inputSchema: { type: "object", properties: { wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." }, message: { type: "string", description: "The message to sign" } }, required: ["message"] } }, { name: "wallet_sign_typed_data", description: "Sign typed data (EIP-712)", inputSchema: { type: "object", properties: { wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." }, domain: { type: "object", description: "The domain data" }, types: { type: "object", description: "The type definitions" }, value: { type: "object", description: "The value to sign" } }, required: ["domain", "types", "value"] } }, { name: "wallet_verify_message", description: "Verify a signed message", inputSchema: { type: "object", properties: { message: { type: "string", description: "The original message" }, signature: { type: "string", description: "The signature to verify" }, address: { type: "string", description: "The address that supposedly signed the message" } }, required: ["message", "signature", "address"] } }, { name: "wallet_verify_typed_data", description: "Verify signed typed data", inputSchema: { type: "object", properties: { domain: { type: "object", description: "The domain data" }, types: { type: "object", description: "The type definitions" }, value: { type: "object", description: "The value that was signed" }, signature: { type: "string", description: "The signature to verify" }, address: { type: "string", description: "The address that supposedly signed the data" } }, required: ["domain", "types", "value", "signature", "address"] } }, // Provider Methods { name: "provider_get_block", description: "Get a block by number or hash", inputSchema: { type: "object", properties: { blockHashOrBlockTag: { type: "string", description: "Block hash or block tag (latest, pending, etc.)" }, includeTransactions: { type: "boolean", description: "Whether to include full transactions or just hashes" } }, required: ["blockHashOrBlockTag"] } }, { name: "provider_get_transaction", description: "Get a transaction by hash", inputSchema: { type: "object", properties: { transactionHash: { type: "string", description: "The transaction hash" } }, required: ["transactionHash"] } }, { name: "provider_get_transaction_receipt", description: "Get a transaction receipt", inputSchema: { type: "object", properties: { transactionHash: { type: "string", description: "The transaction hash" } }, required: ["transactionHash"] } }, { name: "provider_get_code", description: "Get the code at an address", inputSchema: { type: "object", properties: { address: { type: "string", description: "The address to get code from" }, blockTag: { type: "string", description: "Optional block tag (latest, pending, etc.)" } }, required: ["address"] } }, { name: "provider_get_storage_at", description: "Get the storage at a position for an address", inputSchema: { type: "object", properties: { address: { type: "string", description: "The address to get storage from" }, position: { type: "string", description: "The storage position" }, blockTag: { type: "string", description: "Optional block tag (latest, pending, etc.)" } }, required: ["address", "position"] } }, { name: "provider_estimate_gas", description: "Estimate the gas required for a transaction", inputSchema: { type: "object", properties: { transaction: { type: "object", description: "The transaction to estimate gas for", properties: { to: { type: "string" }, from: { type: "string" }, data: { type: "string" }, value: { type: "string" } } } }, required: ["transaction"] } }, { name: "provider_get_logs", description: "Get logs that match a filter", inputSchema: { type: "object", properties: { filter: { type: "object", description: "The filter to apply", properties: { address: { type: "string" }, topics: { type: "array", items: { type: "string" } }, fromBlock: { type: "string" }, toBlock: { type: "string" } } } }, required: ["filter"] } }, { name: "provider_get_ens_resolver", description: "Get the ENS resolver for a name", inputSchema: { type: "object", properties: { name: { type: "string", description: "The ENS name" } }, required: ["name"] } }, { name: "provider_lookup_address", description: "Lookup the ENS name for an address", inputSchema: { type: "object", properties: { address: { type: "string", description: "The address to lookup" } }, required: ["address"] } }, { name: "provider_resolve_name", description: "Resolve an ENS name to an address", inputSchema: { type: "object", properties: { name: { type: "string", description: "The ENS name to resolve" } }, required: ["name"] } }, // Network Methods { name: "network_get_network", description: "Get the current network information", inputSchema: { type: "object", properties: {}, required: [] } }, { name: "network_get_block_number", description: "Get the current block number", inputSchema: { type: "object", properties: {}, required: [] } }, { name: "network_get_fee_data", description: "Get the current fee data (base fee, max priority fee, etc.)", inputSchema: { type: "object", properties: {}, required: [] } } ];