b3b263cf70
Some checks failed
Cross-Node Transaction Testing / transaction-test (push) Successful in 2s
Deploy to Testnet / deploy-testnet (push) Successful in 1m9s
Documentation Validation / validate-docs (push) Failing after 8s
Documentation Validation / validate-policies-strict (push) Successful in 4s
Multi-Node Stress Testing / stress-test (push) Successful in 1s
Node Failover Simulation / failover-test (push) Successful in 2s
- Add YAML frontmatter to aitbc-wallet-management.md - All 8 skill files now have proper YAML frontmatter for Hermes agents to load
3.2 KiB
3.2 KiB
name, description, category
| name | description | category |
|---|---|---|
| aitbc-wallet-management | Wallet operations including creation, listing, balance checking, wallet information retrieval, import, export, and deletion | operations |
AITBC Wallet Management Skill
Trigger Conditions
Activate when user requests wallet operations: creation, listing, balance checking, wallet information retrieval, import, export, or deletion.
Purpose
Create, list, import, export, and manage AITBC blockchain wallets with deterministic validation.
Prerequisites
- AITBC CLI accessible at
/opt/aitbc/aitbc-cli - Python venv activated for CLI operations
- Keystore directory at
/var/lib/aitbc/keystore/ - SSH access to follower node (aitbc1) for cross-node operations
- Default wallet password: from
/var/lib/aitbc/keystore/.genesis_password
Operations
Create Wallet
./aitbc-cli create --name <wallet_name> --password <password>
Import Wallet
./aitbc-cli import --name <wallet_name> --private-key <hex_key> --password <password>
Export Wallet
./aitbc-cli export --name <wallet_name> --password <password>
List Wallets
./aitbc-cli list
# With JSON format
./aitbc-cli list --format json
Check Wallet Balance
./aitbc-cli balance --name <wallet_name>
Delete Wallet
./aitbc-cli delete --name <wallet_name>
Rename Wallet
./aitbc-cli rename --old <old_name> --new <new_name>
Get Transaction History
./aitbc-cli transactions --name <wallet_name> --limit <limit> --format [table|json]
Common Pitfalls
- Wallet Not Found: Check wallet name spelling, verify keystore directory at
/var/lib/aitbc/keystore/ - Invalid Password: Verify password, check password file at
/var/lib/aitbc/keystore/.genesis_password - Invalid Private Key: Ensure private key is valid hex string (64 hex characters for Ed25519)
- Wallet Already Exists: Choose a different wallet name or delete existing wallet first
- Insufficient Balance: Check wallet balance before sending transactions
- Keystore Encryption: CLI supports AES-256-GCM and Fernet encryption
- Cross-Node Issues: Verify SSH connectivity for operations on remote nodes
Verification Checklist
- Wallet created successfully and appears in list
- Wallet balance retrieved correctly
- Private key export works with correct password
- Import from private key creates valid wallet
- Wallet deletion removes wallet from list
- Transaction history shows past transactions
Wallet Naming Conventions
- Use alphanumeric characters, hyphens, and underscores only
- Avoid special characters and spaces
- Use descriptive names (e.g., "genesis", "hermes-trainee", "trading-wallet")
- Max length: 64 characters
Security Considerations
- Never share private keys
- Store passwords securely (use password file when possible)
- Backup keystore directory regularly
- Use strong passwords (minimum 12 characters)
- Enable encryption for sensitive wallets
CLI Tool Preference
- Primary CLI:
/opt/aitbc/aitbc-cliis the single CLI entry point - Keystore Location:
/var/lib/aitbc/keystore/ - Password File:
/var/lib/aitbc/keystore/.genesis_password