proxmox/rpc-translator-138/QUICK_START.md

Quick Start Guide - RPC Translator Service

Date: 2026-01-04
Status: ✅ Ready for Deployment

---

Overview

This guide provides the fastest path to deploy the RPC Translator service and its supporting infrastructure.

---

Step 1: Deploy Supporting Services (LXC Containers)

On Proxmox Host (r630-01)

# 1. Navigate to project directory
cd /path/to/proxmox/rpc-translator-138

# 2. Verify node is ready
./verify-node-ready.sh r630-01

# 3. Deploy all supporting services
./deploy-supporting-services.sh r630-01

# 4. Start containers
pct start 106  # Redis
pct start 107  # Web3Signer
pct start 108  # Vault

Configure Services

Redis (VMID 106):

pct enter 106
apt-get update
apt-get install -y redis-server
nano /etc/redis/redis.conf  # Configure as needed
systemctl enable redis-server
systemctl restart redis-server

Web3Signer (VMID 107):

pct enter 107
apt-get update
apt-get install -y openjdk-17-jre-headless wget
cd /opt
wget https://artifacts.consensys.net/web3signer/web3signer-23.10.0/web3signer-23.10.0.tar.gz
tar -xzf web3signer-23.10.0.tar.gz
# Configure Web3Signer (see DEPLOYMENT.md)

Vault (VMID 108):

pct enter 108
apt-get update
apt-get install -y unzip wget
wget https://releases.hashicorp.com/vault/1.15.0/vault_1.15.0_linux_amd64.zip
unzip vault_1.15.0_linux_amd64.zip
mv vault /usr/local/bin/
# Configure Vault (see DEPLOYMENT.md)

---

Step 2: Verify Supporting Services

# Test Redis
redis-cli -h 192.168.11.110 ping

# Test Web3Signer
curl http://192.168.11.111:9000/upcheck

# Test Vault
curl http://192.168.11.112:8200/v1/sys/health

---

Step 3: Deploy Translator Service

On Each Translator VMID (2400, 2401, 2402)

# 1. SSH to VMID
ssh root@192.168.11.240  # or .241, .242

# 2. Install Node.js
curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
apt-get install -y nodejs
npm install -g pnpm

# 3. Deploy application
cd /opt
git clone <repository> rpc-translator-138
cd rpc-translator-138
pnpm install --prod
pnpm run build

# 4. Configure environment
cp env.template .env
nano .env  # Update with actual IPs and credentials

# 5. Install systemd service
cp systemd/rpc-translator-138.service /etc/systemd/system/
systemctl daemon-reload
systemctl enable rpc-translator-138.service
systemctl start rpc-translator-138.service

---

Step 4: Verify Translator Service

# Check service status
systemctl status rpc-translator-138.service

# Test HTTP endpoint
curl http://localhost:9545 -X POST -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'

# Test WebSocket (if available)
# Use a WebSocket client to connect to ws://localhost:9546

---

Container Specifications

Service	VMID	IP	Port	RAM	Disk
Redis	106	192.168.11.110	6379	512MB	10GB
Web3Signer	107	192.168.11.111	9000	2048MB	20GB
Vault	108	192.168.11.112	8200	2048MB	20GB

---

Environment Configuration

Update .env file on each translator VMID:

# Supporting Services
WEB3SIGNER_URL=http://192.168.11.111:9000
REDIS_HOST=192.168.11.110
VAULT_ADDR=http://192.168.11.112:8200

# Besu Upstream (local)
BESU_HTTP_URLS=http://127.0.0.1:8545
BESU_WS_URLS=ws://127.0.0.1:8546
CHAIN_ID=138

# Translator Service
HTTP_PORT=9545
WS_PORT=9546

---

Troubleshooting

Container won't start:

• Check logs: journalctl -u pve-container@106
• Verify storage: pvesh get /nodes/r630-01/storage
• Check resources: pvesh get /nodes/r630-01/status

Service won't connect:

• Verify firewall rules allow connections
• Check service is running: systemctl status <service>
• Test connectivity: ping <ip> and curl <url>

For detailed troubleshooting, see:

• DEPLOYMENT.md - Troubleshooting section
• LXC_DEPLOYMENT.md - Container-specific troubleshooting

---

Full Documentation

• Complete Guide: DEPLOYMENT.md
• Checklist: DEPLOYMENT_CHECKLIST.md
• LXC Guide: LXC_DEPLOYMENT.md
• VMID Allocation: VMID_ALLOCATION.md
• Status: DEPLOYMENT_STATUS.md

---

Support

For issues or questions:

1. Check troubleshooting sections in documentation
2. Review deployment logs
3. Verify all prerequisites are met
4. Consult detailed guides for step-by-step instructions