Proxyd

proxyd is an RPC proxy

• https://github.com/ethereum-optimism/infra/tree/main/proxyd

proxyd /etc/proxyd/proxyd.toml: ws_method_whitelist, response_timeout_seconds, out_of_service_seconds, max_latency_threshold

• Changelog: https://github.com/ethereum-optimism/infra/blob/main/proxyd/CHANGELOG.md
• Config: https://github.com/ethereum-optimism/infra/blob/main/proxyd/config.go
  • Proxyd config example: https://github.com/ethereum-optimism/infra/blob/main/proxyd/example.config.toml
• Releases: https://github.com/ethereum-optimism/infra/tags

Features:

• Whitelists RPC methods (ws_method_whitelist)
• Routes RPC methods to groups of backend services
• Round-robin Load balance requests across backend services
• Automatically retries failed backend requests
• Cache immutable responses from backends
• Provides metrics to measure request latency, error rates

Consensus related:

• Track backend consensus (latest, safe, finalized blocks), peer count and sync state
• Re-write requests and responses to enforce consensus

• Applies rate limiting (SenderRateLimitConfig) on a per-sender basis to avoid being bombarded with signed transactions causing a DOS (Denial of Service) of the sequencer (Optimism Censorship Bug Disclosure)

Errors examples

Failed sync attempt to a7eaa64c50083f1xxxxxfd96eaabffd1c8f: one or more objects failed to apply, reason: error when patching 
"/dev/shm/396xxxxx68": Deployment.apps "your-service" is invalid: spec.template.spec.containers[0].env[1].valueFrom: Invalid value: "": may not 
be specified when `value` is not empty (retried 1 times).

Logs

ERROR

• error forwarding request to backend
• Error forwarding RPC batch
• error serving requests
• error proxying websocket
• error writing clientConn message

WARN

• backend request failed, trying again
• backend banned - not healthy
• backend banned - unexpected block tags
• proxied requests' XFF header will not contain the proxyd ip address
• peer count responded with 200 and 0 peers
• failed request
• error updating backend
• backend broke consensus

INFO

• starting proxyd
• Updating CA certificates.
• Running CMD.
• INFO Forwarded RPC request
• INFO Received RPC request

Activities

• Read Optimism Censorship Bug Disclosure

Related

• Consensus
• Emerald Dshackle load balancer
• dRPC
• Total number of primary candidates
• RedisConfig
• Fallback

See also

• proxyd, proxyd logs, config, routing_strategy, consensus_aware (deprecated), SenderRateLimitConfig, Consensus awareness, ws_method_whitelist, backend healthy, Proxyd logs
• OP Stack: op-, op-geth, op-node, op-proposer, op-batcher, op-contracts, op-challenger, op-heartbeat, op-ufm, op-service, op-deployer, Snap Sync, op-conductor, op-dispute-mon