ethereum-rpc-docker/bsc/reth/bsc-chapel-reth-archive-trace.yml

---
x-logging-defaults: &logging-defaults
  driver: json-file
  options:
    max-size: "10m"
    max-file: "3"
# This node is built from source with architecture-specific optimizations
# Build command: docker compose build --build-arg ARCH_TARGET=${ARCH_TARGET:-native} bsc-chapel-reth
#
# IMPORTANT: Cache optimization considerations

# If running multiple nodes on the same machine, be aware that:
# - L3 cache is shared across all cores, causing cache contention
# - Multiple nodes compete for cache space, reducing optimization effectiveness

# - Consider CPU pinning to minimize cache conflicts:
#   docker run --cpuset-cpus="0-7" bsc-chapel-reth  # Pin to specific cores
# - For AMD X3D CPUs, CCD0 (cores 0-7) has the 3D V-Cache
# - For multi-node setups, generic builds may perform better than cache-optimized ones

# 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:bsc/reth/bsc-chapel-reth-archive-trace.yml
#
# docker compose up -d
#
# curl -X POST https://${IP}.traefik.me/bsc-chapel-reth \
#   -H "Content-Type: application/json" \
#   --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

services:
  bsc-chapel-reth:
    build:
      context: ./
      dockerfile: reth.Dockerfile
      args:
        LLVM_IMAGE: ${LLVM_IMAGE:-snowstep/llvm}
        LLVM_VERSION: ${LLVM_VERSION:-20250912105042}
        RETH_VERSION: ${BSC_CHAPEL_RETH_VERSION:-v0.0.6-beta}
        RETH_REPO: ${BSC_CHAPEL_RETH_REPO:-https://github.com/bnb-chain/reth-bsc.git}
        ARCH_TARGET: ${ARCH_TARGET:-native}
        PROFILE: ${RETH_BUILD_PROFILE:-maxperf}
        BUILD_BSC_RETH: true
    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)
      memlock: -1        # Disable memory locking limits (for in-memory DBs like MDBX)
    user: root
    ports:
      - 13115:13115
      - 13115:13115/udp
    expose:
      - 8545
      - 9001
    entrypoint: [reth, node]
    command:
      - --chain=bsc-testnet
      - --datadir=/root/.local/share/reth
      - --discovery.port=13115
      - --engine.cross-block-cache-size=${BSC_CHAPEL_RETH_STATE_CACHE:-4096}
      - --engine.memory-block-buffer-target=128
      - --engine.parallel-sparse-trie
      - --gpo.maxprice=1000000
      - --http
      - --http.addr=0.0.0.0
      - --http.api=admin,debug,eth,net,trace,txpool,web3,rpc,reth,ots,flashbots,mev
      - --http.corsdomain=*
      - --http.port=8545
      - --max-inbound-peers=50
      - --max-outbound-peers=50
      - --metrics=0.0.0.0:9001
      - --nat=extip:${IP}
      - --pooled-tx-response-soft-limit=20971520
      - --port=13115
      - --rpc-cache.max-blocks=10000
      - --rpc-cache.max-concurrent-db-requests=2048
      - --rpc.gascap=600000000
      - --rpc.max-blocks-per-filter=0
      - --rpc.max-connections=50000
      - --rpc.max-logs-per-response=0
      - --ws
      - --ws.addr=0.0.0.0
      - --ws.api=admin,debug,eth,net,trace,txpool,web3,rpc,reth,ots,flashbots,mev
      - --ws.origins=*
      - --ws.port=8545
    restart: unless-stopped
    stop_grace_period: 5m
    networks:
      - chains
    volumes:
      - ${BSC_CHAPEL_RETH_ARCHIVE_TRACE_DATA:-bsc-chapel-reth-archive-trace}:/root/.local/share/reth
      - ./bsc/chapel:/config
      - /slowdisk:/slowdisk
    logging: *logging-defaults
    labels:
      - prometheus-scrape.enabled=true
      - prometheus-scrape.port=9001
      - prometheus-scrape.path=/metrics
      - traefik.enable=true
      - traefik.http.middlewares.bsc-chapel-reth-archive-trace-stripprefix.stripprefix.prefixes=/bsc-chapel-reth
      - traefik.http.services.bsc-chapel-reth-archive-trace.loadbalancer.server.port=8545
      - ${NO_SSL:-traefik.http.routers.bsc-chapel-reth-archive-trace.entrypoints=websecure}
      - ${NO_SSL:-traefik.http.routers.bsc-chapel-reth-archive-trace.tls.certresolver=myresolver}
      - ${NO_SSL:-traefik.http.routers.bsc-chapel-reth-archive-trace.rule=Host(`$DOMAIN`) && (Path(`/bsc-chapel-reth`) || Path(`/bsc-chapel-reth/`))}
      - ${NO_SSL:+traefik.http.routers.bsc-chapel-reth-archive-trace.rule=Path(`/bsc-chapel-reth`) || Path(`/bsc-chapel-reth/`)}
      - traefik.http.routers.bsc-chapel-reth-archive-trace.middlewares=bsc-chapel-reth-archive-trace-stripprefix, ipallowlist
    shm_size: 2gb

volumes:
  bsc-chapel-reth-archive-trace:

x-upstreams:
  - id: $${ID}
    labels:
      provider: $${PROVIDER}
    connection:
      generic:
        rpc:
          url: $${RPC_URL}
        ws:
          frameSize: 20Mb
          msgSize: 50Mb
          url: $${WS_URL}
    chain: bsc-testnet
    method-groups:
      enabled:
        - debug
        - filter
        - trace
    methods:
      disabled:
      enabled:
        - name: txpool_content # TODO: should be disabled for rollup nodes
...