/kuutamod

A supervisor for neard that implements failover for NEAR validators

Primary LanguageNixApache License 2.0Apache-2.0

kuutamod

kuutamod is a distributed supervisor for neard that implements failover for NEAR validators. NEAR is an application platform built on top of the NEAR protocol blockchain. Validator nodes, run by the community, provide computational resources to the NEAR network and collect monetary rewards at regular intervals, based on the volume of work (blocks and chunks produced). Validators who do not complete the work assigned to them receive fewer rewards and may be excluded from the group of validators who are allowed to validate for some time.

kuutamod allows multiple NEAR validators to operate in an active-passive setup. The active validator node is started with the validator keys, while the other nodes stay synchronised with the blockchain ready to take over if needed. In the event of a failure, i.e. a neard crash, network split or hardware failure, a passive instance can be promoted to an active validator by restarting it with the validator keys. To avoid having two active validators running at the same time, kuutamod uses consul by acquiring a distributed lock and relies on systemd or other supervisor to terminate neard in the event of a failure of kuutamod as neard is started as a child process.

Status: beta

kuutamod is continously tested and also used in production for validators. However kuutamod's interface is still under active development and might change significantly.

Docs


kuutamolabs
GitHub | Matrix