debug-validator-checkpoint-inconsistency

Diagnose validator checkpoint inconsistencies across chains using Prometheus metrics and multisigIsm.ts configurations.

72|602|Updated Dec 13, 2021
One-click install
npx skills add https://github.com/hyperlane-xyz/hyperlane-monorepo --skill debug-validator-checkpoint-inconsistency
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-validator-checkpoint-inconsistency
Source: https://github.com/hyperlane-xyz/hyperlane-monorepo/tree/main/.claude/skills/alert-validator-checkpoints-inconsistent
Command: npx skills add https://github.com/hyperlane-xyz/hyperlane-monorepo --skill debug-validator-checkpoint-inconsistency

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps engineers diagnose and resolve inconsistencies in validator checkpoints across chains, triggered by alerts about behind validators or mismatched latest checkpoints.

Core Features & Use Cases

  • Diagnostic Analysis: Compare origin and destination validator sets against multisigIsm.ts to identify stalled or misenrolled validators.
  • Quorum & Risk Assessment: Assess whether the current healthy validators meet the required threshold and indicate high-priority risks when quorum is compromised.
  • Use Case Example: When an alert signals checkpoint inconsistency, run the diagnostic to surface stall status, alias mappings, and the difference between latest signed checkpoints.

Quick Start

Run the diagnostic for a given origin_chain and optional app_context to surface validator checkpoint inconsistencies.

Frequently Asked Questions about debug-validator-checkpoint-inconsistency

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose validator checkpoint inconsistencies across chains?

To diagnose validator checkpoint inconsistencies, compare origin and destination validator sets against multisigIsm.ts configurations to identify stalled or misenrolled validators and report stall status.

Why does my validator checkpoint alert show mismatched latest checkpoints?

Mismatched latest checkpoints occur when validators stall or fall behind. The diagnostic surfaces the difference between latest signed checkpoints and checks alias mappings to pinpoint the inconsistent validator.

How do I check if quorum is compromised during a checkpoint inconsistency?

To check quorum health during a checkpoint inconsistency, assess whether current healthy validators meet the required threshold and identify high-priority risks when quorum is compromised.

Can I use Prometheus metrics to investigate validator stalls and ISM configurations?

Yes, you can leverage Prometheus metrics and multisigIsm.ts configurations to investigate validator stalls, report stall status, verify alias mappings, and assess quorum health across origin-destination pairs.

How do I filter checkpoint diagnostics for a specific app_context and environment?

You can filter checkpoint diagnostics by providing a specific origin_chain with optional app_context and environment filters to narrow the investigation of validator stalls and checkpoint mismatches.

What is the best way to resolve behind validator alerts using Grafana and multisigIsm data?

The best way to resolve behind validator alerts is to run a diagnostic that compares validator sets against multisigIsm.ts, assesses quorum thresholds, and outputs a structured diagnostic report for remediation.