Overview
Guild Operators is a community-maintained suite of tools and documentation designed to simplify Cardano stake pool operations. Developed under the cardano-community GitHub organization by experienced stake pool operators, it consolidates essential SPO workflows into a single, well-documented resource. The project provides scripts for building cardano-node from source, deploying nodes as systemd services, and managing the full lifecycle of a stake pool from key generation through ongoing monitoring.1 Guild Operators is recognized on the Cardano Developer Portal as a recommended tooling suite for operators and is listed among official entities building on Cardano.2
The project follows an open-source, rolling-release development model with its primary branch named alpha, reflecting continuous iteration. Its documentation site, built with MkDocs Material and hosted on GitHub Pages, serves as both a reference manual and an onboarding guide. Guild Operators assumes professional-level competence in systems administration and security operations, positioning itself as a productivity multiplier rather than a beginner tutorial. The suite supports mainnet, public testnets (preview, preprod), and a dedicated Guild Network with short epoch cycles for sandbox experimentation.
Key Features
The flagship tool, CNTools, functions as a menu-driven Bash CLI for wallet creation, ADA transfers, token minting, and pool registration. CNTools supports multiple operational modes: online (using a local node or the Koios API), offline (for air-gapped signing), hybrid (for generating unsigned transactions on an online node and signing them offline), and a light mode that eliminates the need for a local node entirely. Hardware wallet integration covers both Ledger and Trezor devices.1
gLiveView provides a real-time terminal dashboard for monitoring node health. It displays epoch progress, block height, memory usage, peer connections, block propagation latency, and KES key expiration for block producers. The tool auto-detects whether a node runs as a relay or core and adjusts its display accordingly. Peer analysis functionality measures round-trip latency to connected nodes, helping operators optimize their network topology.
Additional components include Topology Updater for automated relay peer discovery, CNCLI integration for leader schedule calculation and block validation, Mithril signer and client tooling, log monitoring with Telegram alert integration, and Docker deployment guides. The suite also provides build instructions for cardano-db-sync and the Koios gRest query layer.
What to Expect
The Guild Operators documentation site is structured around three main areas: Build (compiling and deploying node components), Scripts (the SPO tooling suite), and supplementary resources covering Mithril, Docker, and appendices. Operators can install prerequisite dependencies, download scripts, and configure their environment using a single guild-deploy.sh bootstrap script.
The site addresses both common and advanced workflows. Standard operations such as pool registration, KES key rotation, and fund delegation are covered alongside specialized tasks like offline transaction signing, multi-asset management, and block performance tracking. Support is available through a shared Telegram channel, with bug reports handled via GitHub Issues. The project has received multiple rounds of Project Catalyst funding, reflecting sustained community investment in its development.2
