Add wallet authentication documentation to scenario guides
Some checks failed
Cross-Node Transaction Testing / transaction-test (push) Waiting to run
Deploy to Testnet / deploy-testnet (push) Waiting to run
Documentation Validation / validate-docs (push) Failing after 17s
Documentation Validation / validate-policies-strict (push) Successful in 4s
Multi-Node Stress Testing / stress-test (push) Successful in 3s
Node Failover Simulation / failover-test (push) Successful in 3s

- Add wallet authentication section to scenarios 1, 2, 6, and 7
- Document three authentication methods: interactive prompt, password file, and environment variable
- Include security best practices for password handling
- Add code examples for each authentication method
- Recommend password files with restricted permissions for scripts
- Remove duplicate wallet balance requirement in scenario 7
This commit is contained in:
aitbc
2026-05-08 12:03:04 +02:00
parent 8bb2dcf558
commit f9d59f5da1
4 changed files with 86 additions and 0 deletions

View File

@@ -56,6 +56,31 @@ An hermes agent needs a wallet to:
- AITBC blockchain node running
- Keystore directory configured (`/etc/aitbc/keystore`)
### **Wallet Authentication**
The CLI supports multiple methods for wallet password authentication:
```bash
# Interactive prompt (default)
aitbc wallet create my-agent-wallet
# Password file (recommended for scripts)
aitbc wallet create my-agent-wallet --password-file /path/to/password.txt
# Direct password (not recommended for production)
aitbc wallet create my-agent-wallet --password mypassword
# Environment variable
export KEYSTORE_PASSWORD=mypassword
aitbc wallet create my-agent-wallet
```
**Security Best Practices:**
- Use password files with restricted permissions (chmod 600)
- Store password files outside the repository
- Avoid hardcoding passwords in scripts
- Use environment variables for CI/CD pipelines
- Never commit passwords to version control
---
## 🔧 **Step-by-Step Workflow**

View File

@@ -57,6 +57,26 @@ An hermes agent needs to send transactions to:
- Wallet created with sufficient balance
- Blockchain node running and accessible
### **Wallet Authentication**
For transaction signing, the CLI requires wallet authentication:
```bash
# Interactive prompt (default)
aitbc transaction send --from my-wallet --to <address> --amount 100
# Password file (recommended for scripts)
aitbc transaction send --from my-wallet --to <address> --amount 100 --password-file /path/to/password.txt
# Environment variable
export KEYSTORE_PASSWORD=mypassword
aitbc transaction send --from my-wallet --to <address> --amount 100
```
**Security Best Practices:**
- Use password files with restricted permissions (chmod 600)
- Store password files outside the repository
- Avoid hardcoding passwords in scripts
---
## 🔧 **Step-by-Step Workflow**

View File

@@ -59,6 +59,26 @@ An hermes agent needs trading to:
- Wallet with sufficient balance
- Network connectivity
### **Wallet Authentication**
For trading operations requiring wallet signing, use one of these methods:
```bash
# Interactive prompt (default)
aitbc trade buy --from my-wallet --pair AIT/BTC --amount 100
# Password file (recommended for scripts)
aitbc trade buy --from my-wallet --pair AIT/BTC --amount 100 --password-file /path/to/password.txt
# Environment variable
export KEYSTORE_PASSWORD=mypassword
aitbc trade buy --from my-wallet --pair AIT/BTC --amount 100
```
**Security Best Practices:**
- Use password files with restricted permissions (chmod 600)
- Store password files outside the repository
- Avoid hardcoding passwords in scripts
---
## 🔧 **Step-by-Step Workflow**

View File

@@ -58,6 +58,27 @@ An hermes agent needs to submit AI jobs to:
### **Setup Required**
- Coordinator API running
- GPU marketplace available
- Wallet with AIT tokens for payment
### **Wallet Authentication**
For AI job submission requiring wallet payments, use one of these methods:
```bash
# Interactive prompt (default)
aitbc ai submit --wallet my-wallet --model llama2 --prompt "Hello world"
# Password file (recommended for scripts)
aitbc ai submit --wallet my-wallet --model llama2 --prompt "Hello world" --password-file /path/to/password.txt
# Environment variable
export KEYSTORE_PASSWORD=mypassword
aitbc ai submit --wallet my-wallet --model llama2 --prompt "Hello world"
```
**Security Best Practices:**
- Use password files with restricted permissions (chmod 600)
- Store password files outside the repository
- Avoid hardcoding passwords in scripts
- Wallet with sufficient balance
---