Files
ethereum-rpc-docker/op/geth/hemi-sepolia-op-geth-pruned-leveldb-hash.yml
rob c7b29693e2 op-node fleet-wide: OP_NODE_L2_SKIP_SYNC_START_CHECK=true (trust unsafe head on restart)
The false default forced every op-node restart to walk back to the finalized head
before driving the EL. On nodes whose derivation lags days behind their serving
gossip head (hashkey us-40: 510k blocks / 12 days), that froze the EL for hours
while dRPC de-routed the sole US provider. true resumes at the unsafe head in
minutes; safe/finalized still verify and catch up in the background. ronin
already ran true per-chain (same lesson); xlayer keeps its deliberate false pin.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-21 04:01:02 +00:00

250 lines
10 KiB
YAML

---
x-logging-defaults: &logging-defaults
driver: json-file
options:
max-size: "512m"
max-file: "2"
# Usage:
#
# mkdir rpc && cd rpc
#
# git init
# git remote add origin https://github.com/StakeSquid/ethereum-rpc-docker.git
# git fetch origin vibe
# git checkout origin/vibe
#
# docker run --rm alpine sh -c "printf '0x'; head -c32 /dev/urandom | xxd -p -c 64" > .jwtsecret
#
# env
# ...
# IP=$(curl ipinfo.io/ip)
# DOMAIN=${IP}.traefik.me
# COMPOSE_FILE=base.yml:rpc.yml:op/geth/hemi-sepolia-op-geth-pruned-leveldb-hash.yml
#
# docker compose up -d
#
# curl -X POST https://${IP}.traefik.me/hemi-sepolia \
# -H "Content-Type: application/json" \
# --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
services:
hemi-sepolia:
image: ${HEMI_GETH_IMAGE:-ghcr.io/hemilabs/op-geth}:${HEMI_SEPOLIA_GETH_VERSION:-7cfc394@sha256:26189e56be781c44b4db8cba8b02fb76651f68b7221f204e3f8a3b6933e7a4ee}
sysctls:
# TCP Performance
net.ipv4.tcp_slow_start_after_idle: 0 # Disable slow start after idle
net.ipv4.tcp_no_metrics_save: 1 # Disable metrics cache
net.ipv4.tcp_rmem: 4096 87380 16777216 # Increase TCP read buffers
net.ipv4.tcp_wmem: 4096 87380 16777216 # Increase TCP write buffers
net.core.somaxconn: 32768 # Higher connection queue
# Memory/Connection Management
# net.core.netdev_max_backlog: 50000 # Increase network buffer
net.ipv4.tcp_max_syn_backlog: 30000 # More SYN requests
net.ipv4.tcp_max_tw_buckets: 2000000 # Allow more TIME_WAIT sockets
ulimits:
nofile: 1048576 # Max open files (for RPC/WS connections)
user: root
ports:
- 13754:13754
- 13754:13754/udp
expose:
- 8545
- 6060
- 8551
environment:
- GETH_OVERRIDE_CANCUN=1715865630
- GETH_OVERRIDE_CANYON=1715865630
- GETH_OVERRIDE_ECOTONE=1715865630
- GETH_OVERRIDE_FJORD=1748963425
- GETH_OVERRIDE_GRANITE=1748963425
- GETH_OVERRIDE_HOLOCENE=1748963425
- GETH_OVERRIDE_HVM0=1733930401
- GETH_OVERRIDE_ISTHMUS=1748963425
- GETH_ROLLUP_DISABLETXPOOLGOSSIP=true
- GETH_ROLLUP_SEQUENCERHTTP=https://testnet.rpc.hemi.network/rpc
- OP_GETH_L2_READINESS_RPC=http://localhost:8545
entrypoint: /bin/sh -c '[ -f /config/genesis.json ] && geth --db.engine=leveldb --gcmode=full --datadir /data init --state.scheme=hash /config/genesis.json; [ -f /config/static-nodes.json ] && cp -f /config/static-nodes.json /data/static-nodes.json; exec geth "$@"' --
command:
- --bootnodes=enode://545da2b44f197091c0ca9283c9c1dd5ffc8562a3cd4a37709a7cd83ca725ecacdb4571dacd916a1455e9dd9f2260e5bc5dddf9fd40ba4601a71b401adbaeec21@34.147.95.117:30303
- --datadir=/data
- --db.engine=leveldb
- --gcmode=full
- --hvm.genesisheader=00c05732cdc3e0d654efe86351f0cbfc6c79325e9f9fa7886a39b552f5c4d90700000000dae4079485e26f1f77425b84a13760038a352d07a0fef92b5188bd04c2999162afca58679121011962b9d0a5
- --hvm.genesisheight=3522419
- --hvm.headerdatadir=/data/tbc/headers
- --maxpeers=50
- --metrics
- --metrics.addr=0.0.0.0
- --metrics.port=6060
- --nat=extip:${IP}
- --networkid=743111
- --port=13754
- --rpc.gascap=600000000
- --rpc.txfeecap=0
- --state.scheme=hash
- --syncmode=snap
- --tbc.leveldbhome=/data/tbc/data
- --tbc.network=testnet3
- --http
- --http.addr=0.0.0.0
- --http.api=eth,net,web3,debug,admin,txpool,engine
- --http.port=8545
- --http.vhosts=*
- --ws
- --ws.addr=0.0.0.0
- --ws.api=eth,net,web3,debug,admin,txpool,engine
- --ws.origins=*
- --ws.port=8545
- --authrpc.addr=0.0.0.0
- --authrpc.jwtsecret=/jwtsecret
- --authrpc.vhosts=*
restart: unless-stopped
stop_grace_period: 5m
networks:
- chains
volumes:
- ${HEMI_SEPOLIA_OP_GETH_PRUNED_LEVELDB_HASH_DATA:-hemi-sepolia-op-geth-pruned-leveldb-hash}:/data
- ./op/hemi/sepolia:/config
- .jwtsecret:/jwtsecret:ro
- /slowdisk:/slowdisk
logging: *logging-defaults
labels:
- prometheus-scrape.enabled=true
- prometheus-scrape.port=6060
- prometheus-scrape.path=/debug/metrics/prometheus
- traefik.enable=true
- traefik.http.middlewares.hemi-sepolia-op-geth-pruned-leveldb-hash-stripprefix.stripprefix.prefixes=/hemi-sepolia
- traefik.http.services.hemi-sepolia-op-geth-pruned-leveldb-hash.loadbalancer.server.port=8545
- ${NO_SSL:-traefik.http.routers.hemi-sepolia-op-geth-pruned-leveldb-hash.entrypoints=websecure}
- ${NO_SSL:-traefik.http.routers.hemi-sepolia-op-geth-pruned-leveldb-hash.tls.certresolver=myresolver}
- ${NO_SSL:-traefik.http.routers.hemi-sepolia-op-geth-pruned-leveldb-hash.rule=Host(`$DOMAIN`) && (Path(`/hemi-sepolia`) || Path(`/hemi-sepolia/`))}
- ${NO_SSL:+traefik.http.routers.hemi-sepolia-op-geth-pruned-leveldb-hash.rule=Path(`/hemi-sepolia`) || Path(`/hemi-sepolia/`)}
- traefik.http.routers.hemi-sepolia-op-geth-pruned-leveldb-hash.middlewares=hemi-sepolia-op-geth-pruned-leveldb-hash-stripprefix, ipallowlist
hemi-sepolia-node:
image: ${HEMI_NODE_IMAGE:-ghcr.io/hemilabs/op-node}:${HEMI_SEPOLIA_NODE_VERSION:-7c70d2d@sha256:7db35d5798615e572d80823a3238a8111b14a90aade876a34b6a2936b17cbd87}
ports:
- 18754:18754
- 18754:18754/udp
environment:
- OP_NODE_BSS_WS=http://hemi-sepolia-relay:8081/v1/ws
- OP_NODE_L1_BEACON=${ETHEREUM_SEPOLIA_BEACON_REST}
- OP_NODE_L1_BEACON_ARCHIVER=${ETHEREUM_SEPOLIA_BEACON_ARCHIVER}
- OP_NODE_L1_ETH_RPC=${HEMI_SEPOLIA_L1_EXECUTION_RPC:-${ETHEREUM_SEPOLIA_EXECUTION_RPC}}
- OP_NODE_L1_RPC_KIND=${ETHEREUM_SEPOLIA_EXECUTION_KIND:-standard}
- OP_NODE_L1_TRUST_RPC=${ETHEREUM_SEPOLIA_EXECUTION_TRUST:-false}
- OP_NODE_L2_ENGINE_AUTH=/jwtsecret
- OP_NODE_L2_ENGINE_RPC=http://hemi-sepolia:8551
- OP_NODE_L2_ENGINE_RPC_TIMEOUT=120s
- OP_NODE_L2_SKIP_SYNC_START_CHECK=true
- OP_NODE_LOG_LEVEL=info
- OP_NODE_METRICS_ADDR=0.0.0.0
- OP_NODE_METRICS_ENABLED=true
- OP_NODE_METRICS_PORT=7300
- OP_NODE_OVERRIDE_CANYON=1715865630
- OP_NODE_OVERRIDE_DELTA=1715865630
- OP_NODE_OVERRIDE_ECOTONE=1715865630
- OP_NODE_OVERRIDE_FJORD=1748963425
- OP_NODE_OVERRIDE_GRANITE=1748963425
- OP_NODE_OVERRIDE_HOLOCENE=1748963425
- OP_NODE_OVERRIDE_ISTHMUS=1748963425
- OP_NODE_OVERRIDE_PECTRABLOBSCHEDULE=1742486400
- OP_NODE_P2P_ADVERTISE_IP=${IP}
- OP_NODE_P2P_LISTEN_IP=0.0.0.0
- OP_NODE_P2P_LISTEN_TCP_PORT=18754
- OP_NODE_P2P_LISTEN_UDP_PORT=18754
- OP_NODE_P2P_STATIC=/ip4/34.147.95.117/tcp/9003/p2p/16Uiu2HAmFtpk79F9M1TdC2cnq8c1pJy59yrb5AWeM1qH6d13Fbi2,/ip4/34.90.95.68/tcp/9003/p2p/16Uiu2HAmEDnT7hSbpD5x7TEyywofqtMw6CBCn1Yasn8Ut8CefBi3,/ip4/34.34.97.92/tcp/9003/p2p/16Uiu2HAm9SXFzfB1Mx5aJ6j9QKSs44jA4MNiDVBbGF2JPWs4h8eU
- OP_NODE_ROLLUP_CONFIG=/config/rollup.json
- OP_NODE_ROLLUP_LOAD_PROTOCOL_VERSIONS=true
- OP_NODE_RPC_ADDR=0.0.0.0
- OP_NODE_RPC_PORT=9545
- OP_NODE_SNAPSHOT_LOG=/tmp/op-node-snapshot-log
- OP_NODE_SYNCMODE=execution-layer
- OP_NODE_VERIFIER_L1_CONFS=0
entrypoint: [op-node]
restart: unless-stopped
depends_on:
hemi-sepolia:
condition: service_started
restart: true
hemi-sepolia-relay:
condition: service_started
networks:
- chains
volumes:
- ./op/hemi/sepolia:/config
- .jwtsecret:/jwtsecret:ro
logging: *logging-defaults
labels:
- prometheus-scrape.enabled=true
- prometheus-scrape.port=7300
- prometheus-scrape.path=/metrics
- traefik.enable=true
- traefik.http.middlewares.hemi-sepolia-op-geth-pruned-leveldb-hash-node-stripprefix.stripprefix.prefixes=/hemi-sepolia/node
- traefik.http.services.hemi-sepolia-op-geth-pruned-leveldb-hash-node.loadbalancer.server.port=9545
- ${NO_SSL:-traefik.http.routers.hemi-sepolia-op-geth-pruned-leveldb-hash-node.entrypoints=websecure}
- ${NO_SSL:-traefik.http.routers.hemi-sepolia-op-geth-pruned-leveldb-hash-node.tls.certresolver=myresolver}
- ${NO_SSL:-traefik.http.routers.hemi-sepolia-op-geth-pruned-leveldb-hash-node.rule=Host(`$DOMAIN`) && PathPrefix(`/hemi-sepolia/node`)}
- ${NO_SSL:+traefik.http.routers.hemi-sepolia-op-geth-pruned-leveldb-hash-node.rule=PathPrefix(`/hemi-sepolia/node`)}
- traefik.http.routers.hemi-sepolia-op-geth-pruned-leveldb-hash-node.middlewares=hemi-sepolia-op-geth-pruned-leveldb-hash-node-stripprefix, ipallowlist
hemi-sepolia-relay:
image: ${HEMI_BSS_IMAGE:-hemilabs/bssd}:${HEMI_SEPOLIA_BSS_VERSION:-1.6.3}
ports:
- 23754:23754
- 23754:23754/udp
expose:
- 8081
environment:
- BSS_ADDRESS=:8081
restart: unless-stopped
networks:
- chains
volumes:
- ./op/hemi/sepolia:/config
logging: *logging-defaults
labels:
- prometheus-scrape.enabled=false
volumes:
hemi-sepolia-op-geth-pruned-leveldb-hash:
x-upstreams:
- id: $${ID}
labels:
provider: $${PROVIDER}
connection:
generic:
rpc:
url: $${RPC_URL}
ws:
frameSize: 20Mb
msgSize: 50Mb
url: $${WS_URL}
chain: hemi-testnet
method-groups:
enabled:
- debug
- filter
methods:
disabled:
enabled:
- name: txpool_content # TODO: should be disabled for rollup nodes
# standard geth only
- name: debug_getRawBlock
- name: debug_getRawTransaction
- name: debug_getRawReceipts
- name: debug_getRawHeader
- name: debug_getBadBlocks
# non standard geth only slightly dangerous
- name: debug_intermediateRoots
- name: debug_dumpBlock
# standard geth and erigon
- name: debug_accountRange
- name: debug_getModifiedAccountsByNumber
- name: debug_getModifiedAccountsByHash
# non standard geth and erigon
- name: eth_getRawTransactionByHash
- name: eth_getRawTransactionByBlockHashAndIndex
...