System Configuration

Generate an ECDSA wallet that will serve as the Node identity to the storage layer and network. On Node FE startup, this wallet will be used to access the appropriate database schema and to authenticate the Node FE to the River Chain during registration.

# generate a new wallet to console in json format
$ cast wallet n -j

# check if node is installed
$ node -v
# installs ethers.js
$ npm i ethers

var ethers = require('ethers');
var crypto = require('crypto');

var id = crypto.randomBytes(32).toString('hex');
var privateKey = "0x"+id;
console.log("SAVE BUT DO NOT SHARE THIS:", privateKey);

var wallet = new ethers.Wallet(privateKey);
console.log("Address: " + wallet.address);

During this step, configure your Node FE image or binary to run in your networked environment that has connectivity to the Node Storage instance and set your Node FE environment variables, such as RPC_URL’s, logging level, contract addresses.

Some of the required environment variables will be secrets as described in system requirements that will need to be stored and injected in your runtime securely. Choices around secret storage depend largely on the cloud or on-premise hosting environment for the Node FE, which is left up to the node operator.

Configure your Node FE with a publicly addressable, static IPv4 host, ensuring it can serve HTTP1.1 & HTTP2 requests. If behind a termination proxy, configure accordingly. Ensure your network does not proxy traffic through an ALB as this has been known to cause issues with client connectivity.

Configure DNS with a hostname and either an A record or CNAME record to your static IPv4 address.

Set up Node Storage (e.g., Postgres), ensuring your Node FE can connect within your hosting network.

Run network probes on the Node FE in info mode to ensure network connectivity, TLS termination, and that the node is publicly addressable over DNS.