Erigon Rpcdaemon Run

Erigon RpcDaemon Run

Overview

The rpcdaemon command runs standalone RpcDaemon on an existing Erigon datadir.

Command Syntax

cd <erigon_home> && ./build/bin/rpcdaemon --datadir=<path> --http.api admin,debug,eth,parity,erigon,trace,web3,txpool,ots,net --ws [other-flags]

Required Flags

• --datadir: Path to the Erigon datadir (required)

Usage Patterns

Change HTTP port

cd <erigon_home_path> && ./build/bin/rpcdaemon --datadir=<datadir_path> --http.port=8546

WebSocket support

cd <erigon_home_path> && ./build/bin/rpcdaemon --datadir=<datadir_path> --ws

GraphQL support

cd <erigon_home_path> && ./build/bin/rpcdaemon --datadir=<datadir_path> --graphql

Important Considerations

Before Running

1. Ask for Erigon home: Ask the user which Erigon home folder to use if not already provided
2. Stop Erigon and RpcDaemon: Ensure Erigon and/or RpcDaemon are not running on the target datadir
3. Ensure RpcDaemon binary is built: run make rpcdaemon to build it

After Running

1. Wait until the HTTP port (value provided with --http.port or default 8545) is reachable

Workflow

When the user wants to run Erigon RpcDaemon:

1. Confirm parameters

   • Ask for Erigon home path to use if not provided or know in context
   • Ask for target datadir path

2. Safety checks

   • Verify Erigon home exists
   • Verify datadir exists
   • Check if Erigon and/or RpcDaemon are running (should not be)

Error Handling

Common issues:

• "datadir not found": Verify the path is correct
• "database locked": Stop Erigon process first

Examples

Example 1: All API namespaces and WebSocket enabled

cd ../erigon_devel && ./build/bin/rpcdaemon --datadir=~/Library/erigon-eth-mainnet --http.api admin,debug,eth,parity,erigon,trace,web3,txpool,ots,net --ws

Tips

• If building from source, use make rpcdaemon within to build the binary at build/bin/rpcdaemon