Quick Start
Let's get hands-on with WalletAgent! This guide will walk you through your first Web3 operations using prompts.
Your First 10 Minutes with WalletAgent
Follow along with these examples to understand how WalletAgent works. All commands use safe mock wallets - no real funds involved!
Step 1: Check Your Setup
First, let's verify WalletAgent is working:
Get wallet infoExpected Output:
Current wallet configuration:
- Type: mock
- Available addresses: 3
- 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266
- 0x70997970C51812dc3A010C7d01b50e0d17dc79C8
- 0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BCStep 2: Connect to a Wallet
Connect to one of the pre-configured test wallets:
Expected Output:
What just happened?
You connected to a mock wallet with 10,000 test ETH
The wallet is on the Anvil local testnet (Chain ID 31337)
You're ready to send transactions!
Step 3: Check Your Balance
Verify your wallet balance:
Expected Output:
Step 4: Send Your First Transaction
Send some test ETH to another address:
Expected Output:
Congratulations. You just sent your first Web3 transaction using prompts.
Step 5: Switch Chains
WalletAgent supports multiple blockchain networks. Let's switch to Polygon:
Expected Output:
Key Features
Natural Language Interface: Use prompts instead of function calls
State Management: Maintains wallet, chain, and contract context
Comprehensive Feedback: Transaction details, gas costs, and error diagnostics
Next step suggestions
Exploring Token Operations
Let's try some token operations. First, switch back to Anvil which has pre-configured test tokens:
Check Token Balance
Expected Output:
Transfer Tokens
Expected Output:
Smart Contract Interaction
One of WalletAgent's most powerful features is contract interaction. Let's explore:
Load Contract Configuration
If you have contract configuration files:
Simulate Contract Calls
Test contract functions without spending gas:
Expected Output:
This is very useful for development - you can test any contract function without spending gas or affecting blockchain state.
Step 7: Hyperliquid Support (Optional)
For users interested in decentralized trading, WalletAgent includes Hyperliquid integration for perpetual futures:
Expected Output:
Try Some Trading Commands:
What You've Learned
In just 10 minutes, you've learned to:
✅ Connect to wallets using prompts
✅ Send transactions between addresses
✅ Switch between different blockchain networks
✅ Transfer tokens with simple commands
✅ Simulate smart contract calls
Essential Command Patterns
Here are the key patterns you'll use constantly:
Wallet Management
Transactions
Contract Operations
Information & Analysis
Mock vs Real Wallets
You've been using mock wallets - completely safe test accounts. When you're ready for testnet development, you can switch to real wallets:
Only use testnets! Never use real wallets with mainnet funds. WalletAgent is beta software.
Mock Wallets (Current)
✅ Completely safe for learning
✅ Pre-funded with test tokens
✅ No setup required
❌ Can't interact with real testnets
Real Wallets (Advanced)
✅ Works with testnets like Sepolia
✅ Real blockchain interactions
✅ Enterprise-grade encrypted private key storage
⚠️ Requires testnet ETH for gas
Quick Encrypted Key Setup
For maximum security, use WalletAgent's encrypted keystore:
1. Create Encrypted Keystore:
2. Import Your Testnet Private Key:
3. Switch to Encrypted Mode:
4. Verify Setup:
Now you can perform real blockchain operations with maximum security!
Next Steps
You now have the basics! Here's where to go next:
For Users
👉 User Guide - Learn all wallet operations in detail
For Developers
👉 Developer Guide - Smart contract development and testing
For Advanced Users
👉 Advanced Topics - Real wallets, private keys, and advanced features
Quick Reference
Test Wallet Addresses
Supported Chains
Essential Commands
Congratulations. You've completed the WalletAgent quick start. You're now ready to explore the full capabilities of Web3 development with WalletAgent.
Last updated