Run a node

Prerequisites

Go 1.21 or newer
Git, make, a C toolchain
Roughly 20 GB of free disk for a testnet full node

Build

git clone https://github.com/kronexnetwork/kronex.git
cd kronex
make krnxd

The binary lands in build/bin/krnxd. Prebuilt krnxd binaries for Linux, macOS and Windows are attached to every release.

Initialize

A Kronex node is initialized from a genesis file, not from a network ID. The repository ships the testnet genesis and a matching node config:

krnxd --datadir ./data-krnx-test init configs/krnx-testnet/genesis.json

--networkid overrides only the p2p network identifier. It does not select a genesis. Two nodes with the same --networkid and different genesis files will find each other and then refuse to sync.

Run

krnxd --datadir ./data-krnx-test --config configs/krnx-testnet/node.toml console

To expose RPC, add the HTTP flags and include krnx in the API list:

krnxd --datadir ./data-krnx-test \
  --config configs/krnx-testnet/node.toml \
  --http --http.addr 127.0.0.1 --http.port 8545 \
  --http.api eth,net,web3,krnx

Bind to 127.0.0.1 unless the node sits behind a proxy you control. The krnx namespace contains submit methods, and krnxadmin should never be reachable from outside the host.

Verify

curl -s -X POST http://127.0.0.1:8545 \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":1,"method":"krnx_getBuildInfo","params":[]}' | jq

Then check that merged mining is arriving:

curl -s -X POST http://127.0.0.1:8545 \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":1,"method":"krnx_getAuxPowStatus","params":["latest"]}' | jq

A null result means the head block carries no AuxPoW extension yet.

Private network

For an isolated network, write your own genesis and give every node the same one:

krnxd --datadir ./data-krnx-private init ./genesis.json
krnxd --datadir ./data-krnx-private \
  --networkid 42071 \
  --bootnodes "enode://...@10.10.0.11:30303" \
  --http --http.addr 0.0.0.0 --http.port 8545 --http.api eth,net,web3,krnx

Pick a network ID that is not 5769 or 5768 so a misconfigured node cannot half-join a real network.

Node

Mining

Build

Prerequisites

Build

Initialize

Run

Verify

Private network

​Prerequisites

​Build

​Initialize

​Run

​Verify

​Private network

Prerequisites

Build

Initialize

Run

Verify

Private network