Skip to content

wallets.md

Latest commit

 

History

History
319 lines (257 loc) · 6.26 KB

wallets.md

File metadata and controls

319 lines (257 loc) · 6.26 KB

Wallets Package

The wallets package provides wallet management for EVM chains and Solana.

Installation

npm install @universal-crypto-mcp/wallet-evm
npm install @universal-crypto-mcp/wallet-solana

Supported Networks

EVM Chains

Chain Chain ID Status
Ethereum 1 ✅ Full support
BNB Smart Chain 56 ✅ Full support
Polygon 137 ✅ Full support
Arbitrum One 42161 ✅ Full support
Base 8453 ✅ Full support
Optimism 10 ✅ Full support
Avalanche C-Chain 43114 ✅ Full support
Fantom 250 ✅ Full support
zkSync Era 324 ✅ Full support
Linea 59144 ✅ Full support
Scroll 534352 ✅ Full support
Blast 81457 ✅ Full support

Solana

  • Mainnet Beta
  • Devnet
  • Testnet

Configuration

Environment Variables

# EVM Wallet
PRIVATE_KEY=0x...        # Private key
MNEMONIC="word1 word2..."  # Or mnemonic phrase

# Solana Wallet
SOLANA_PRIVATE_KEY=...   # Base58 encoded private key

Available Tools

Balance Tools

Tool Description
get_balance Get native token balance
get_token_balance Get ERC20/SPL token balance
get_portfolio Get multi-chain portfolio
get_nfts Get NFT holdings

Transaction Tools

Tool Description
send_transaction Send native tokens
send_token Send ERC20/SPL tokens
get_transaction Get transaction details
get_history Get transaction history
estimate_gas Estimate gas cost

Signing Tools

Tool Description
sign_message Sign a message
verify_signature Verify a signature
sign_typed_data Sign EIP-712 typed data

Account Tools

Tool Description
get_address Get wallet address
get_nonce Get account nonce
check_allowance Check token allowance
approve_token Approve token spending

Usage Examples

Create Wallet Instance

import { EVMWallet } from "@universal-crypto-mcp/wallet-evm";

const wallet = new EVMWallet({
  privateKey: process.env.PRIVATE_KEY,
  defaultChain: "ethereum",
});

console.log("Address:", wallet.address);

Check Balance

// AI command: "What's my ETH balance?"
// Tool called: get_balance
// Parameters:
{
  chain: "ethereum"
}

// Response:
{
  address: "0x1234...5678",
  balance: {
    raw: "1500000000000000000",
    formatted: "1.5",
    symbol: "ETH",
    decimals: 18
  },
  usdValue: 5185.17
}

Get Multi-Chain Portfolio

// AI command: "Show my portfolio across all chains"
// Tool called: get_portfolio
// Response:
{
  address: "0x1234...5678",
  totalValueUsd: 12500.00,
  chains: {
    ethereum: {
      native: { symbol: "ETH", balance: "0.5", valueUsd: 1728.39 },
      tokens: [
        { symbol: "USDC", balance: "1000.0", valueUsd: 1000.00 },
        { symbol: "LINK", balance: "50.0", valueUsd: 750.00 }
      ]
    },
    arbitrum: {
      native: { symbol: "ETH", balance: "0.2", valueUsd: 691.36 },
      tokens: [
        { symbol: "ARB", balance: "500.0", valueUsd: 850.00 }
      ]
    }
  }
}

Send Transaction

// AI command: "Send 0.1 ETH to 0xabc..."
// Tool called: send_transaction
// Parameters:
{
  to: "0xabc...",
  amount: "0.1",
  chain: "ethereum"
}

// Response:
{
  hash: "0xdef...",
  from: "0x1234...5678",
  to: "0xabc...",
  value: "0.1",
  status: "pending",
  gasUsed: "21000",
  gasPrice: "25000000000"
}

Send ERC20 Token

// AI command: "Send 100 USDC to 0xabc..."
// Tool called: send_token
// Parameters:
{
  to: "0xabc...",
  token: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",  // USDC
  amount: "100",
  chain: "ethereum"
}

Sign Message

// AI command: "Sign the message 'Hello World'"
// Tool called: sign_message
// Parameters:
{
  message: "Hello World"
}

// Response:
{
  message: "Hello World",
  signature: "0x...",
  address: "0x1234...5678"
}

Approve Token

// AI command: "Approve USDC spending on Uniswap"
// Tool called: approve_token
// Parameters:
{
  token: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  spender: "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",  // Uniswap Router
  amount: "1000000000000"  // Max approval
}

Solana Wallet

Create Solana Wallet

import { SolanaWallet } from "@universal-crypto-mcp/wallet-solana";

const wallet = new SolanaWallet({
  privateKey: process.env.SOLANA_PRIVATE_KEY,
  network: "mainnet-beta",
});

console.log("Address:", wallet.publicKey.toString());

Solana Balance

// AI command: "What's my SOL balance?"
// Tool called: get_balance
// Parameters:
{
  chain: "solana"
}

// Response:
{
  address: "ABC...XYZ",
  balance: {
    raw: "5000000000",
    formatted: "5.0",
    symbol: "SOL",
    decimals: 9
  },
  usdValue: 620.00
}

HD Wallet Support

Create HD Wallet

import { HDWallet } from "@universal-crypto-mcp/wallet-evm";

const hdWallet = new HDWallet({
  mnemonic: process.env.MNEMONIC,
  path: "m/44'/60'/0'/0",
});

// Derive addresses
const address0 = hdWallet.getAddress(0);
const address1 = hdWallet.getAddress(1);

Gas Management

Estimate Gas

// AI command: "How much will it cost to send 1 ETH?"
// Tool called: estimate_gas
// Parameters:
{
  to: "0xabc...",
  value: "1000000000000000000",
  chain: "ethereum"
}

// Response:
{
  gasLimit: 21000,
  gasPrice: {
    slow: "20000000000",    // 20 gwei
    standard: "25000000000", // 25 gwei
    fast: "35000000000"     // 35 gwei
  },
  estimatedCost: {
    slow: "0.00042 ETH ($1.45)",
    standard: "0.000525 ETH ($1.81)",
    fast: "0.000735 ETH ($2.54)"
  }
}

Security Best Practices

  1. Never share private keys: Store securely using environment variables
  2. Use hardware wallets: For production deployments
  3. Test on testnets: Verify transactions before mainnet
  4. Set spending limits: Limit transaction amounts
  5. Verify addresses: Always double-check recipient addresses

Related Packages