pi-agent-id Wallet Extension

A comprehensive Ethereum wallet management tool for the pi agent system.

Overview

pi-agent-id provides full wallet creation, management, and transaction capabilities as a single binary. It supports HD wallets (BIP39/BIP44), secure key storage, and Ethereum transaction signing.

Installation

# Build from source
cd ~/.pi/agent/skills/pi-agent-id
go build -o bin/pi-agent-id cmd/main.go

# Or install via pi
pi skill install pi-agent-id

Usage

Create a New Wallet

# Create simple wallet
/pi-agent-id create --name mywallet

# Create HD wallet with mnemonic
/pi-agent-id create --name myhdwallet --hd --password "secure-pass"

# Output shows address and mnemonic (if HD)

Import Existing Wallet

# Import from private key
/pi-agent-id import --key 0xabc123... --name imported

# Import from mnemonic
/pi-agent-id import --mnemonic "word1 word2 ... word12" --name recovered

# Import from keystore file
/pi-agent-id import --keystore /path/to/keystore --password "pass" --name keystore

List Wallets

/pi-agent-id list
# Shows all wallets with addresses and names

Sign Messages

/pi-agent-id sign --address 0x123... --message "Hello World"
# Returns signature

Check Balance

/pi-agent-id balance --address 0x123... --rpc https://mainnet.infura.io/v3/YOUR_KEY
# Shows ETH balance

Send Transactions

/pi-agent-id send --from 0x123... --to 0x456... --amount 1.5 \
  --rpc https://mainnet.infura.io/v3/YOUR_KEY \
  --password "wallet-password"
# Signs and broadcasts transaction

Export Wallet

# Export private key
/pi-agent-id export --address 0x123... --password "pass" --private-key

# Export mnemonic (HD wallets only)
/pi-agent-id export --address 0x123... --password "pass" --mnemonic

Security

• All private keys are encrypted at rest using AES-256-GCM
• Password required for all sensitive operations
• Mnemonics are never stored in plain text
• Keystore files follow Ethereum standard (UTC--*)

Storage Location

Wallets are stored in:

• Linux/macOS: ~/.config/pi-agent-id/wallets/
• Windows: %USERPROFILE%\.config\pi-agent-id\wallets\

Commands Reference

Command	Description
create	Generate new wallet
import	Import from key/mnemonic/keystore
list	Show all wallets
sign	Sign a message
send	Send ETH transaction
balance	Check ETH balance
export	Export private key or mnemonic
delete	Remove a wallet
recover	Recover from mnemonic

Requirements

• Go 1.21+ (for building)
• No runtime dependencies for binary

License

MIT