Wallet Operations

Master the fundamental operations of WalletAgent. These are the building blocks for all Web3 interactions.

Wallet Information

Get Current Status

Check your current wallet configuration and status:

Get wallet info

Example Output:

Current wallet configuration:
- Type: mock
- Available addresses: 3
  - 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266
  - 0x70997970C51812dc3A010C7d01b50e0d17dc79C8
  - 0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC

This command shows:

  • Wallet Type: Mock (safe) or Real (testnet/mainnet)

  • Available Accounts: Number of wallets you can connect to

  • Current Chain: Which blockchain network you're using

  • Native Currency: The main token of the current chain (ETH, POL, etc.)

List Available Accounts

See all wallets available for connection:

Example Output:

Wallet Connection

Connect to a Specific Wallet

Connect to one of the available test wallets:

Example Output:

Connect Using Short Address

You can use just the first few characters:

WalletAgent will find the matching address automatically.

Get Current Account

Check which wallet is currently connected:

Example Output:

Balance Checking

Check ETH/Native Token Balance

Get your balance on the current chain:

Example Output:

Check Specific Address Balance

Check the balance of any address:

Example Output:

Disconnecting Wallets

Disconnect Current Wallet

Safely disconnect from the current wallet:

Example Output:

After disconnecting:

  • No wallet is connected

  • You can't send transactions until reconnecting

  • All session data is cleared for security

Mock Wallets

Mock wallets provide safe testing with pre-funded accounts (10,000 ETH) and test tokens (USDC, USDT, WETH, DAI). Use for development, testing, and contract interactions without risk.

Beta Software: Use only on testnets or local development environments.

Common Operations

Quick Status Check

Get a complete overview of your current state:

Example Output:

Switch Between Wallets

Easily switch to a different wallet:

Or:

Example Output:

Error Handling

Common Issues and Solutions

"No wallet connected"

Solution: Connect to any available wallet first.

"Invalid address format"

Solution: Use proper Ethereum address format or short references.

"Chain not supported"

Solution: Use supported chain names from the built-in networks.

Best Practices

1. Always Start with Status Check

Before performing operations, check your status:

This ensures you understand:

  • Which wallet is connected

  • What chain you're on

  • Available balance

2. Use Descriptive Commands

Instead of:

Use:

3. Verify Before Important Operations

Before sending transactions or making changes:

4. Use Short Addresses When Possible

Instead of typing full addresses:

WalletAgent will find the match automatically.

5. Understand Your Mode

Always know whether you're in Mock or Real mode:

  • Mock Mode: Safe for all experimentation

  • Real Mode: Only for testnet operations

Troubleshooting

Connection Issues

Problem: "MCP server not responding" Solution:

  1. Restart your AI agent

  2. Check that WalletAgent is properly installed

  3. Try: "Get wallet info" to test connection

Problem: "WalletAgent not found" Solution:

  1. Check that WalletAgent is properly configured in your AI agent

  2. Restart your AI agent

  3. Check MCP configuration

Address Issues

Problem: "Address not found" Solution:

  1. Use "Get accounts" to see available addresses

  2. Check address format (0x + 40 hex characters)

  3. Try short address format (first 6+ characters)

Problem: "Invalid address" Solution:

  1. Verify address starts with "0x"

  2. Check for typos in hex characters

  3. Ensure exactly 42 characters total

Balance Issues

Problem: "Balance shows 0" Solution:

  1. Confirm wallet is connected: "Get current account"

  2. Check you're on the right chain: "Get wallet info"

  3. Mock wallets should have 10,000 ETH by default

Next Steps

Now that you understand basic operations, you're ready for more advanced features:

Continue Learning

👉 Transactions → - Learn to send ETH and manage gas 👉 Token Operations → - Work with ERC-20 tokens 👉 Chain Management → - Switch between networks

Practice Scenarios

Try these practice exercises:

  1. Wallet Management

    • Connect to each test wallet

    • Check balances of all wallets

    • Switch between wallets multiple times

  2. Information Gathering

    • Get current status regularly

    • Practice using short addresses

    • Check balances of different addresses

  3. Error Recovery

    • Try invalid commands to see error messages

    • Practice reconnecting after disconnection

    • Use help commands when stuck

You now know the fundamentals of WalletAgent. These basic operations are the foundation for all Web3 interactions.

PreviousOverviewNextTransactions

Last updated