HalfLife

HalfLife is a Cosmos-based blockchain validator monitoring and alerting utility

Monitors and alerts for scenarios such as:

• Slashing period uptime
• Recent missed blocks (is the validator signing currently)
• Jailed status
• Tombstoned status
• Individual sentry nodes unreachable/out of sync
• Chain halted

Discord messages are created in the configured webhook channel for:

• Current validator status
• Detected alerts

Quick start

Copy config.yaml.example to config.yaml and populate with your discord and validator information. You can optionally provide the sentries array to also monitor the sentries via grpc. rpc-retries can optionally be provided to override the default of 5 RPC retries before alerting, useful for congested RPC servers.

See here for how to create a webhook for a discord channel.

Begin monitoring with:

half-life monitor

By default, half-life monitor will look for config.yaml in the current working directory. To specify a different config file path, use the --file/-f flag:

half-life monitor -f ~/config.yaml

When a validator is first added to config.yaml and halflife is started, a status message will be created in the discord channel and the ID of that message will be added to config.yaml. Pin this message so that the channel's pinned messages can act as a dashboard to see the realtime status of the validators.

Alerts will be posted when any error conditions are detected, and follow up messages will be posted when those errors are cleared.

For high and critical errors, the configured discord user IDs will be tagged