c43ae7faf7
Some checks failed
Cross-Node Transaction Testing / transaction-test (push) Has been cancelled
Deploy to Testnet / deploy-testnet (push) Has been cancelled
Documentation Validation / validate-docs (push) Has been cancelled
Documentation Validation / validate-policies-strict (push) Has been cancelled
Multi-Node Stress Testing / stress-test (push) Has been cancelled
Node Failover Simulation / failover-test (push) Has been cancelled
- Removed legacy Coordinator API reference from README.md - Removed deprecated Wallet Fund entry from GLOSSARY.md - Updated shell scripts deprecation notice in ENVIRONMENT_SETUP.md - Removed deprecated faucet setup section from WALLET_FUNDING.md - Removed legacy human support section from AGENT_INDEX.md
154 lines
3.6 KiB
Markdown
154 lines
3.6 KiB
Markdown
# Wallet Funding Guide
|
|
|
|
This guide explains how to fund wallets for AITBC training and testing.
|
|
|
|
## Genesis Wallet
|
|
|
|
The genesis wallet is pre-funded with 997,999,290 AIT and serves as the primary funding source for training wallets.
|
|
|
|
**Genesis Wallet Details:**
|
|
- Name: `genesis`
|
|
- Address: `ait175406af70445617b0cd7eb8ff384d81b15c26b45`
|
|
- Balance: 997,999,290 AIT
|
|
- Password file: `/var/lib/aitbc/keystore/.genesis_password`
|
|
|
|
## Quick Funding Script
|
|
|
|
Use the provided script to fund wallets from genesis:
|
|
|
|
```bash
|
|
./scripts/training/fund_wallet.sh <wallet_name> [amount]
|
|
```
|
|
|
|
**Examples:**
|
|
```bash
|
|
# Fund hermes-trainee with default amount (1000 AIT)
|
|
./scripts/training/fund_wallet.sh hermes-trainee
|
|
|
|
# Fund a specific wallet with custom amount
|
|
./scripts/training/fund_wallet.sh training-wallet 5000
|
|
```
|
|
|
|
## Manual Funding
|
|
|
|
To manually fund a wallet using the AITBC CLI:
|
|
|
|
```bash
|
|
# Read genesis password
|
|
GENESIS_PASSWORD=$(cat /var/lib/aitbc/keystore/.genesis_password)
|
|
|
|
# Send funds from genesis to target wallet
|
|
./aitbc-cli wallet send genesis <target_wallet> <amount> "$GENESIS_PASSWORD"
|
|
```
|
|
|
|
**Example:**
|
|
```bash
|
|
./aitbc-cli wallet send genesis hermes-trainee 100 "EzE4d8cLJo20E9FlquSXq7hqy-e6p4M7Q1ZkM5eLpmY"
|
|
```
|
|
|
|
## Checking Wallet Balances
|
|
|
|
```bash
|
|
# Check specific wallet balance
|
|
./aitbc-cli wallet balance <wallet_name>
|
|
|
|
# List all wallets
|
|
./aitbc-cli wallet list
|
|
```
|
|
|
|
## Faucet Service
|
|
|
|
The AITBC system includes a faucet service for automated wallet funding.
|
|
|
|
### Faucet Setup
|
|
|
|
Use the Python-based setup system for faucet configuration:
|
|
|
|
```bash
|
|
python3 -m aitbc.training_setup.cli setup
|
|
```
|
|
|
|
This will:
|
|
1. Check prerequisites
|
|
2. Setup genesis wallet as funding source
|
|
3. Fund training wallets
|
|
4. Configure messaging authentication
|
|
|
|
### Faucet API
|
|
|
|
If the faucet service is running, you can fund wallets via HTTP API:
|
|
|
|
```bash
|
|
curl -X POST http://localhost:8080/fund \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"address": "ait1..."}'
|
|
```
|
|
|
|
**Default faucet configuration:**
|
|
- Port: 8080
|
|
- Funding amount: 1000 AIT per request
|
|
- Rate limit: 10 requests per hour per IP
|
|
|
|
## Common Training Wallets
|
|
|
|
**Default training wallets:**
|
|
- `hermes-trainee` - Primary training wallet
|
|
- `training-wallet` - General training operations
|
|
- `exam-wallet` - Exam and testing
|
|
- `faucet` - Faucet service wallet (if configured)
|
|
|
|
**Test wallets:**
|
|
- `test-agent` - Agent testing
|
|
- `scenario_user` - Scenario testing
|
|
- `openclaw-trainee` - OpenClaw training
|
|
|
|
## Troubleshooting
|
|
|
|
### Genesis Password Not Found
|
|
|
|
If the genesis password file is missing or empty:
|
|
|
|
```bash
|
|
# Check if file exists
|
|
ls -la /var/lib/aitbc/keystore/.genesis_password
|
|
|
|
# If missing, the genesis wallet may need to be reconfigured
|
|
# Contact your system administrator
|
|
```
|
|
|
|
### Insufficient Genesis Balance
|
|
|
|
If the genesis wallet has insufficient funds:
|
|
|
|
```bash
|
|
# Check genesis balance
|
|
./aitbc-cli wallet balance genesis
|
|
|
|
# If balance is low, you may need to mine new blocks
|
|
# or regenerate the genesis block
|
|
```
|
|
|
|
### Transaction Failed
|
|
|
|
If funding transactions fail:
|
|
|
|
1. Verify the target wallet exists
|
|
2. Check blockchain node status
|
|
3. Ensure services are running:
|
|
```bash
|
|
systemctl status aitbc-blockchain-node.service
|
|
```
|
|
|
|
## Security Notes
|
|
|
|
- The genesis password is stored in `/var/lib/aitbc/keystore/.genesis_password` with 0600 permissions
|
|
- Never share the genesis password
|
|
- Backup the genesis wallet file and password
|
|
- For production, consider using a separate faucet wallet instead of genesis
|
|
|
|
## Related Documentation
|
|
|
|
- [Training Environment Setup](ENVIRONMENT_SETUP.md)
|
|
- [Genesis Generation](/opt/aitbc/docs/infrastructure/genesis_generation.md)
|
|
- [Training Playground](/opt/aitbc/scripts/training/README.md)
|