AWS EC2 archive node setup with OpenEthereum (formerly Parity)

The following provides an example node setup. Performance related parameters will vary per chain.

See the OpenEthereum Documentation for complete instructions for any chain setup

Any chain requires an amount of storage capable of storing all archive data. For best performance choose the best available storage device (ie NVMe SSD).

  1. Setup an EC2 instance and choose the best available storage (ie NVMe SSD).

    https://aws.amazon.com/ec2/getting-started/

    • During setup you will configure Security Groups. For security purposes, you should limit the inbound traffic to RPC and WebSocket interfaces (default ports are 8545 and 8546). Limit connection to these ports to the BlockScout application server's IP address if setting up BlockScout (find in the details section of your created instance) or to your local network. You can also set limit port connections later through the EC2 -> Security Groups panel.

  2. Connect to your instance using SSH Specify the private key ( .pem ) file, the user name for your AMI, and the public DNS name for your instance. For example, if you used Amazon Linux 2 or the Amazon Linux AMI, the user name is ec2-user. If ubuntu, the user name is ubuntu. Find info about your instance

    Example: ssh -i /path/my-key-pair.pem ec2-user@ec2-198-51-100-1.compute-1.amazonaws.com

  3. Install OpenEthereum from GitHub releases page for the corresponding platform

  4. Create a config file called node.toml (see below for config file specs including xDai archive node specs) and edit accordingly vim node.toml

  5. Connect and Sync an archive node using the config file. parity --config node.toml

  6. Find your EC2 url to connect with BlockScout: Go to EC2 Dashboard -> Instances -> corresponding archive node instance and record the ip address. When configuring BlockScout you will use this address along with port 8545 to connect via the EthereumJsonRPCHttpURL parameter.

    For example: 192.0.2.1:8545

Additional Resources

Node.toml file general instructions

Below we provide a general example file as well as the settings we use for our xDai node config. In general:

  • Parity should run in "fatdb+archive+traces" mode with pruning="archive", fatdb="on", tracing="on".

  • Both RPC and WebSockets interfaces should be opened and allow calls to "web3","eth","net","parity","pubsub","traces" APIs.

  • A full list of configuration options is available at: https://wiki.parity.io/Configuring-Parity-Ethereum

Configuration file example

The following example file outlines general parameters - Performance-related parameters like processing_threads, server_threads or cache_size_db will vary based on the chain size, available hardware, parity version, general traffic load etc. Often these are adjusted through a trial-and-error process. See below for xDai Archive Node Specs.

General Specs

[parity]
chain = "CHAIN NAME or PATH TO SPEC.JSON"

[network]
nat="ext:<PUBLIC IP>"
warp = false

[rpc]
apis = ["web3","eth","net","parity","traces"]
processing_threads = 8
server_threads = 16
interface = "0.0.0.0"
cors=["all"]

[websockets]
port = 8546
interface = "0.0.0.0"
max_connections = 1000
apis = ["web3","eth","net","parity","pubsub","traces"]
origins = ["all"]
hosts = ["all"]

[ui]
disable = true

[snapshots]
disable_periodic = true

[footprint]
tracing = "on"
pruning = "archive"
fat_db = "on"
cache_size_db = 12000

xDai archive node configuration

These are the settings we use to run the xDai archive node.

[parity]
chain = "xdai"

[network]
nat="ext:<PUBLIC IP>"

[rpc]
apis = ["web3","eth","net", "parity", "traces"]
processing_threads = 50
server_threads = 100
interface = "0.0.0.0"
cors=["all"]

[footprint]
tracing = "on"
pruning = "archive"
fat_db = "on"

[websockets]
max_connections = 1000
interface = "0.0.0.0"
apis = ["web3","eth","net","parity", "pubsub", "traces"]
origins = ["all"]
hosts = ["all"]

[ui]
disable = true

[snapshots]
disable_periodic = true

[mining]
min_gas_price = 1000000000

Last updated

Logo

Copyright © Blockscout Limited 2023-2024