erigon-rpcdaemon-run

name	erigon-rpcdaemon-run
description	Use to run standalone Erigon RpcDaemon on an existing datadir. Use when the user wants to exercise the `rpc-tests` binaries (`rpc_int`, `rpc_perf`) against real server.
allowed-tools	Bash, Read, Glob

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 <erigon_home_path> exists
   • Verify datadir <datadir_path> 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 <erigon_home_path> to build the binary at build/bin/rpcdaemon