cb47cce074
- Organized 252 files across project - Root directory: 187 → 2 files (98.9% reduction) - Moved configuration guides to docs/04-configuration/ - Moved troubleshooting guides to docs/09-troubleshooting/ - Moved quick start guides to docs/01-getting-started/ - Moved reports to reports/ directory - Archived temporary files - Generated comprehensive reports and documentation - Created maintenance scripts and guides All files organized according to established standards.
3.0 KiB
3.0 KiB
Quick Setup Guide - Optional User Actions
This guide helps you complete the optional user actions for the RPC Translator 138.
Option 1: Automated Complete Setup (Recommended)
Run the complete setup script to generate keys and configure allowlist automatically:
cd /home/intlc/projects/proxmox/rpc-translator-138
./scripts/setup-complete.sh [key-count] [password]
Example:
# Generate 3 test keys with password "mypassword"
./scripts/setup-complete.sh 3 mypassword
This will:
- ✅ Generate test keystore files
- ✅ Copy keys to Web3Signer
- ✅ Get public keys (addresses)
- ✅ Configure wallet allowlist on all translators
Option 2: Step-by-Step Manual Setup
Step 1: Generate Test Keys
./scripts/generate-test-keys.sh [count] [password]
Example:
./scripts/generate-test-keys.sh 3 mypassword
Step 2: Setup Web3Signer Keys
./scripts/setup-web3signer-keys.sh [keystore-directory]
Example:
./scripts/setup-web3signer-keys.sh ./keystores
Step 3: Get Public Keys
./scripts/get-web3signer-public-keys.sh
This will show you the addresses (public keys) that you can use in the allowlist.
Step 4: Configure Wallet Allowlist
./scripts/configure-wallet-allowlist.sh "address1,address2,..."
Example:
./scripts/configure-wallet-allowlist.sh "0x1234...,0xabcd..."
Available Scripts
| Script | Purpose |
|---|---|
scripts/setup-complete.sh |
Complete automated setup |
scripts/generate-test-keys.sh |
Generate test keystore files |
scripts/setup-web3signer-keys.sh |
Copy keys to Web3Signer |
scripts/get-web3signer-public-keys.sh |
Get public keys from Web3Signer |
scripts/configure-wallet-allowlist.sh |
Configure wallet allowlist |
Current Status
Check current configuration:
# Check Web3Signer keys
./scripts/get-web3signer-public-keys.sh
# Check wallet allowlist
./scripts/configure-wallet-allowlist.sh
Security Notes
⚠️ Important Security Considerations:
- Test Keys: The generated keys are for testing only
- Password: Change default passwords for production
- Backup: Always backup keys securely (encrypted)
- Allowlist: Always configure allowlist in production
- Keys: Store production keys securely
Documentation
- WEB3SIGNER_KEY_SETUP.md: Detailed Web3Signer key setup guide
- WALLET_ALLOWLIST_CONFIG.md: Detailed wallet allowlist configuration guide
Troubleshooting
Keys Not Loading
# Check Web3Signer status
curl http://192.168.11.111:9000/upcheck
# Check Web3Signer logs
ssh -i ~/.ssh/proxmox_translator root@192.168.11.111 "journalctl -u web3signer -n 50"
Allowlist Not Working
# Check translator logs
ssh -i ~/.ssh/proxmox_translator root@192.168.11.240 "journalctl -u rpc-translator-138.service -n 50 | grep -i allowlist"
# Verify .env file
ssh -i ~/.ssh/proxmox_translator root@192.168.11.240 "grep WALLET_ALLOWLIST /opt/rpc-translator-138/.env"