Validators & Full-Nodes
Running a Validator

Running a Validator

💡Note: failure to set up below configurations on a validator node may compromise chain functionality.

Ethereum RPC Endpoint

For the chain to process bridge transactions from Ethereum, Ethereum testnet, or other chain that supports the eth_getLogs RPC method, the bridge daemon queries an RPC endpoint for logs emitted by the bridge contract. By default, a node will use a public testnet endpoint that may have rate-limiting, low reliability, or other restricted functionality.

For your node to successfully ingest bridge transactions from the relevant blockchain, you are required to specify your own private RPC endpoint with flag --bridge-daemon-eth-rpc-endpoint <YOUR_PRIVATE_RPC_ENDPOINT> in the command you run when starting the node.

The RPC endpoint you choose MUST satisfy the following requirements

  • supports eth_chainId method
  • supports eth_getLogs method
  • supports "finalized" as an input to toBlock parameter (Erigon is currently the only major Ethereum node software that does not support this.)
DeploymentChain IDOrigination ChainExample Bridge Endpoint (--bridge-daemon-eth-rpc-endpoint)
DYDX token holdersdydx-mainnet-1Ethereumhttps://eth-mainnet.g.alchemy.com/v2/demo (opens in a new tab)
Testnetdydx-testnet-4Sepolia Testnethttps://eth-sepolia.g.alchemy.com/v2/demo (opens in a new tab)

Note: example endpoints will work out of the box, but will be quickly rate limited and will not be useable over long periods of blocks.

Connect Sidecar

Starting in v5.0.0, running a validating full node requires a Skip Protocol's Connect Sidecar to be run in order to fetch Oracle prices. The sidecar should be started before upgrading from v4 to v5. Instructions to start Connect Sidecar can be found here (opens in a new tab).

Support issues with Skip's Sidecar should be directed here (opens in a new tab).

You can find the required version of the Connect sidecar listed in the dYdX Blockchain section here (opens in a new tab).

Instructions on upgrading sidecar can be found here.