fbda1b4beb
- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands - CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround - CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check - NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere - MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates - LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference Co-authored-by: Cursor <cursoragent@cursor.com>
3.7 KiB
RPC Translator Port Migration - Complete
Last Updated: 2026-01-31
Document Version: 1.0
Status: Active Documentation
Date: 2025-01-18
Status: ✅ MIGRATION COMPLETE
Overview
Successfully migrated RPC Translator ports from 9545/9546 to 9645/9646 to resolve port conflict with Besu metrics (9545).
Changes Applied
Port Changes
| Component | Old Port | New Port | Status |
|---|---|---|---|
| RPC Translator HTTP | 9545 | 9645 | ✅ Updated |
| RPC Translator WebSocket | 9546 | 9646 | ✅ Updated |
| Besu Metrics | 9545 | 9545 | ✅ No change |
Files Modified
1. Translator .env Files (VMIDs 2400, 2401, 2402)
Location: /opt/rpc-translator-138/.env
Changes:
HTTP_PORT=9545→HTTP_PORT=9645WS_PORT=9546→WS_PORT=9646
Backups Created: .env.backup.* (timestamped)
2. Nginx Configuration (VMID 2400)
Location: /etc/nginx/sites-available/rpc-thirdweb
Changes:
- Proxy pass updated to
127.0.0.1:9645(HTTP) - Proxy pass updated to
127.0.0.1:9646(WebSocket)
Backup Created: rpc-thirdweb.backup.* (timestamped)
3. Template File
Location: rpc-translator-138/env.template
Changes: Updated default ports for future deployments
Services Status
VMID 2400
- ✅ RPC Translator service: Active
- ✅ Listening on: 9645 (HTTP), 9646 (WS)
- ✅ Nginx: Reloaded and routing to translator
VMID 2401
- ✅ RPC Translator service: Active
- ✅ Listening on: 9645 (HTTP), 9646 (WS)
VMID 2402
- ✅ RPC Translator service: Active
- ✅ Listening on: 9645 (HTTP), 9646 (WS)
Port Conflict Resolution
Before Migration
Conflict:
- Besu Metrics: 9545
- RPC Translator HTTP: 9545 ⚠️ CONFLICT
Result: Nginx could not route to translator, bypassing translator features
After Migration
No Conflict:
- Besu Metrics: 9545 ✅
- RPC Translator HTTP: 9645 ✅
- RPC Translator WS: 9646 ✅
Result: Nginx can now route to translator, enabling ThirdWeb compatibility features
Verification
Service Status
# Check translator services
for vmid in 2400 2401 2402; do
ssh root@192.168.11.10 "pct exec $vmid -- systemctl status rpc-translator-138"
done
Port Listening
# Verify ports
for vmid in 2400 2401 2402; do
ssh root@192.168.11.10 "pct exec $vmid -- ss -tlnp | grep -E ':(9645|9646)'"
done
Nginx Routing
# Check Nginx config (VMID 2400)
ssh root@192.168.11.10 "pct exec 2400 -- grep -A 3 'proxy_pass' /etc/nginx/sites-enabled/rpc-thirdweb"
Next Steps Completed
✅ Port migration executed ✅ Services restarted ✅ Nginx configuration updated ✅ Configuration verified ✅ Documentation updated
Impact
Enabled Features
- ✅ Nginx routing to RPC Translator on VMID 2400
- ✅ ThirdWeb compatibility features now accessible
- ✅ No port conflicts with Besu metrics
No Impact
- ✅ Besu metrics continue on 9545
- ✅ Existing RPC endpoints unchanged (8545/8546)
- ✅ No breaking changes to client configurations
Rollback (If Needed)
If rollback is required:
# Restore .env backups
for vmid in 2400 2401 2402; do
ssh root@192.168.11.10 "pct exec $vmid -- cd /opt/rpc-translator-138 && cp .env.backup.* .env"
ssh root@192.168.11.10 "pct exec $vmid -- systemctl restart rpc-translator-138"
done
# Restore Nginx config (VMID 2400)
ssh root@192.168.11.10 "pct exec 2400 -- cp /etc/nginx/sites-available/rpc-thirdweb.backup.* /etc/nginx/sites-available/rpc-thirdweb"
ssh root@192.168.11.10 "pct exec 2400 -- nginx -t && systemctl reload nginx"
Status: ✅ MIGRATION COMPLETE AND VERIFIED
All services operational on new ports. Port conflict resolved.