// Section 14.5 · Operate
The Config File
One JSON file. Written by init. Read on every command.
// 14.5 · the config file · ~/.parallelix/config.json
Key claim
The CLI validates the file on every command. verify adds key permissions, driver presence, coordinator reachability, and ollama + model presence.
The full config
// json · annotated · written by init
{
"version": "1.2.1",
"nodeAddress": "0x…", // derived from the node key
"nodeKeyHash": "0x…", // register this on-chain
"pubKey": "0x…",
"stakingWallet": "0x1f3a…", // recorded for reference only
"tier": 3,
"coordinator": "https://parallelix.io/api",
"ollama": "http://127.0.0.1:11434",
"contracts": {
"staking": "0x706851273c3f5892e2d68ff48dd80bea02a382b6",
"rewards": "0x266939a8baa29344c7687ce2b5074af6dec984e3",
"prlx": "0x93FF39f65cC1D21067939961993ADF3f36BBF893"
}
}Per-section breakdown
// what each section binds · what the validator checks
nodeAddress / nodeKeyHash / pubKey
Node identity
Derived from the secp256k1 node key (keccak-256 over the public key). The nodeKeyHash is what you register on-chain.
- The node key is separate from and never the staking wallet's key.
- It signs liveness heartbeats and results only.
- init --force regenerates it and orphans the old node.
stakingWallet
Staking wallet (reference)
The wallet that registered the node on-chain. Recorded for reference; the CLI never signs with it.
- Optional; pass it with init --wallet.
- Staking, claiming, and unstaking happen in the Console, not the CLI.
tier
Hardware tier
The tier probe mapped this machine to (1 CPU, 2/3/4 GPU by VRAM).
- Must match the tier you registered on-chain.
- A node that cannot serve at its declared tier earns nothing.
coordinator
Coordinator endpoint
The coordinator base URL the daemon heartbeats and polls. Defaults to https://parallelix.io/api.
- Override with --coordinator-url or PARALLELIX_API_URL.
- verify pings it for reachability.
ollama
Ollama runtime
The local Ollama endpoint the daemon runs inference against. Defaults to http://127.0.0.1:11434.
- Override with --ollama-url or OLLAMA_HOST.
- Ollama must be running with a model installed for start to serve.
contracts
On-chain references
The live mainnet addresses: NodeRegistryLocker (staking), OperatorStakeRewardsV2 (rewards), and the $PRLX token.
- Written by init; for reference and tooling.
- All three are verified on Etherscan.
The verify checks
// runtime checks the verify command runs
Node version. Node 18+ is required; verify warns if older.
Key file permissions. ~/.parallelix/node.key must be mode 0600. verify warns if relaxed.
Ollama + model. Ollama must be running and at least one model installed, or the node cannot serve.
Coordinator reachability. verify checks the configured coordinator responds (status < 500).