Running the Keeper Node

# Start the keeper node
docker run -d \
--name randproof-keeper \
--restart unless-stopped \
--env-file .env \
-v $(pwd)/keys:/app/keys \
-v $(pwd)/data:/app/data \
-p 127.0.0.1:3000:3000 \
-p 4001:4001 \
-p 9090:9090 \
randproof/randproofkeeper:latest
# Verify it started correctly
docker logs -f randproof-keeper
# Expected output:
# [RandProof Keeper v1.0.0] Starting...
# [Chain: Base] ✓ Connected (wss://base-mainnet...)
# [Chain: Optimism] ✓ Connected
# [Chain: Arbitrum] ✓ Connected
# [DRAND] ✓ Round 1234567 verified
# [NIST Beacon] ✓ Pulse 1234 verified
# [BLS] ✓ Key loaded: 0x1a2b3c...
# [Keeper] ✓ Registered on 3 chains
# [Keeper] ACTIVE — watching for PoFR events

version: "3.8"
services:
keeper:
image: randproof/randproofkeeper:latest
container_name: randproof-keeper
restart: unless-stopped
env_file: .env
volumes:
- ./keys:/app/keys:ro
- ./data:/app/data
ports:
- "127.0.0.1:3000:3000" # health API (localhost only, AV-35)
- "4001:4001" # P2P gossip
- "9090:9090" # Prometheus
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
interval: 30s
timeout: 10s
retries: 3
start_period: 60s
logging:
driver: "json-file"
options:
max-size: "100m"
max-file: "5"
# Optional: Local Prometheus + Grafana monitoring stack
prometheus:
image: prom/prometheus:latest
container_name: randproof-prometheus
volumes:
- ./monitoring/prometheus.yml:/etc/prometheus/prometheus.yml
ports:
- "9091:9090"
restart: unless-stopped
grafana:
image: grafana/grafana:latest
container_name: randproof-grafana
ports:
- "3001:3000"
environment:
- GF_SECURITY_ADMIN_PASSWORD=YOUR_GENERATED_PASSWORD
volumes:
- grafana-data:/var/lib/grafana
restart: unless-stopped
volumes:
grafana-data:
# Start full stack
docker compose up -d
# Check all containers are healthy
docker compose ps
# Follow keeper logs
docker compose logs -f keeper
# Stop gracefully
docker compose down

cd randproofkeeper
npm install
npm run build
# Run in production mode
NODE_ENV=production npm start
# Or with PM2 for process management
npm install -g pm2
pm2 start dist/index.js --name randproof-keeper
pm2 save
pm2 startup # auto-restart on reboot