Skip to main content

Wallet Guide

This guide covers wallet management, transactions, and cycles in AgentVault.

Overview​

AgentVault supports multi-chain wallets:

  • ICP (Internet Computer) - Primary wallet for canister operations
  • Polkadot - For cross-chain transactions
  • Solana - For DeFi and DApp interactions

Wallet Types​

Local Wallet​

Encrypted wallet stored locally on disk:

# Create local wallet
agentvault wallet create

# Features:
# - Encrypted storage (AES-256)
# - Hardware wallet compatibility
# - Multiple accounts support

Hardware Wallet​

Connect hardware wallet (Ledger, etc.):

# Connect hardware wallet
agentvault wallet connect --hardware

# Features:
# - Private key never leaves device
# - Transaction signing on device
# - Firmware updates required

Creating Wallets​

ICP Wallet​

# Create new ICP wallet
agentvault wallet create --network icp

# Output: Wallet ID and principal

Importing Wallet​

Import existing wallet from mnemonic or private key:

# Import from mnemonic
agentvault wallet import --mnemonic

# Import from private key
agentvault wallet import --private-key

Wallet Commands​

List Wallets​

View all connected wallets:

agentvault wallet list

Wallet Balance​

Check wallet balance:

# Check all wallets
agentvault wallet balance

# Check specific wallet
agentvault wallet balance <wallet-id>

Sign Transaction​

Sign a transaction with wallet:

# Sign transaction
agentvault wallet sign <wallet-id> --transaction <tx-payload>

# Options:
# --hardware     - Use hardware wallet
# --broadcast   - Broadcast after signing

Transaction History​

View transaction history:

# View all transactions
agentvault wallet history

# View wallet-specific
agentvault wallet history <wallet-id>

# Filter by type
agentvault wallet history --type send
agentvault wallet history --type receive

Export Wallet​

Export wallet keys for backup:

# Export to JSON
agentvault wallet export <wallet-id> --format json

# Export to mnemonic (use with caution)
agentvault wallet export <wallet-id> --format mnemonic --show

Cycles Management​

Top-up Cycles​

Add cycles to wallet:

# Top-up canister
agentvault wallet top-up <canister-id> --amount 1000000000000

# Options:
# --network icp      - Target network
# --auto-refill     - Enable auto-refill

Transfer Cycles​

Transfer cycles between wallets:

# Transfer cycles
agentvault wallet transfer --from <wallet-id> --to <wallet-id> --amount 1000000000000

Multi-send​

Send cycles to multiple recipients:

# Batch transfer
agentvault wallet multi-send --input transfers.json

# Input format:
# {
#   "transfers": [
#     { "to": "recipient-1", "amount": 1000000000000 },
#     { "to": "recipient-2", "amount": 5000000000000 }
#   ]
# }

Process Queue​

View and process pending transaction queue:

# View queue
agentvault wallet queue

# Process queue
agentvault wallet queue --process

# Clear failed transactions
agentvault wallet queue --clear-failed

Cross-Chain Operations​

Polkadot​

# Create Polkadot wallet
agentvault wallet create --chain polkadot

# Check balance
agentvault wallet balance <wallet-id> --chain polkadot

# Transfer tokens
agentvault wallet transfer --chain polkadot --to <address> --amount 1000

Solana​

# Create Solana wallet
agentvault wallet create --chain solana

# Check balance
agentvault wallet balance <wallet-id> --chain solana

# Transfer SOL
agentvault wallet transfer --chain solana --to <address> --amount 1.5

Security Best Practices​

Key Management​

  • Never share mnemonics - Store securely, never transmit
  • Use hardware wallets - For large holdings
  • Regular backups - Export wallet to secure location
  • Verify addresses - Double-check before sending
  • Use test transactions - Small amounts first

Transaction Safety​

  • Verify recipient address - Copy-paste carefully
  • Confirm amounts - Large transactions, double-check
  • Review transaction details - Before broadcasting
  • Monitor confirmations - Check on-chain status
  • Keep records - Save transaction IDs for reference

Recovery​

Lost mnemonic?

# Can only recover with mnemonic
agentvault wallet restore --mnemonic "word1 word2 word3 ..."

# No way to recover without mnemonic

Lost private key?

# Cannot recover
# Generate new wallet with remaining funds

Troubleshooting​

Wallet Not Found​

# List all wallets
agentvault wallet list

# Verify wallet ID
agentvault wallet info <wallet-id>

Insufficient Balance​

# Check balance
agentvault wallet balance

# Request from faucet (testnet only)
agentvault wallet faucet

# Purchase cycles
agentvault wallet purchase --amount 1000000000000

Transaction Failed​

# Check transaction queue
agentvault wallet queue

# Retry failed transaction
agentwallet wallet retry <tx-id>

# View error details
agentvault wallet history <tx-id> --details

Hardware Wallet Issues​

# Reconnect hardware wallet
agentvault wallet reconnect --hardware

# Check firmware
agentvault wallet check --hardware

# Reset connection
agentvault wallet disconnect --hardware

Advanced Features​

Multi-Signature Wallets​

Configure multi-sig for enhanced security:

# Create multi-sig wallet
agentvault wallet create --multisig --signers 3 --threshold 2

# Sign transaction
agentvault wallet sign <wallet-id> --multisig --signers-required 2

Derivation Paths​

Standard derivation paths for BIP-39/44:

# View derivation path
agentvault wallet info <wallet-id> --show-derivation

# Change derivation path
agentvault wallet set-derivation <wallet-id> --path "m/44'/223'/0'/0"

Custom Networks​

Add custom blockchain networks:

# Add network
agentvault network add --name custom --rpc https://custom-rpc.com

# Use network
agentvault deploy --network custom

Integration​

ICP Canister Funding​

# Top-up canister from wallet
agentvault wallet top-up <canister-id> --wallet <wallet-id>

# Auto-refill configuration
agentvault wallet configure <wallet-id> --auto-refill --threshold 100T

DApp Integration​

Connect wallet to Web3 DApps:

# Inject wallet into browser
agentvault wallet inject --browser chrome

# Use with DApp
agentvault wallet dapp-sign <url>

Next Steps​