Skip to content

Node Operations

Operational reference for running Igra Orchestra nodes.

  • Worker Configuration - Worker pairs, profiles, and scaling
  • Wallet Management - Balance checking, address sync, and wallet balance API
  • Health Check Integration - Monitoring, Slack alerts, and health check configuration
  • ATAN-Only Mode - Run kaspad saving finality periods without the full IGRA stack
  • ATAN Verification - Verify stored post-KIP-21 finality-period archives with the offline kaspa-atan-verify tool
  • Environment Reference - All operational environment variables
  • Galleon → testnet-10 Migration - One-shot upgrade for existing Galleon operators on NETWORK=testnet to the uniform NETWORK=testnet-10 schema (preserves IBD state)
  • Reth Upgrade: 1.9.3 → 2.5.1 - Drop the execution-layer database and resync when RETH_VERSION moves to the 2.5.1-igra.1 line; kaspad data is preserved (12+ hours, L2 RPC offline)
  • Migrate keys to directory mounts - One-time per-node move of flat keys.kaswallet-N.json files into per-worker directories, required by the kaswallet 3.0.3 atomic keys.json save (avoids the single-file-mount EBUSY crash-loop)
  • Running a CPU Miner - Optionally produce Kaspa L1 blocks for an isolated local network with an external CPU miner