fix-merkle-root-mismatch

Official

Fix relayer merkle root mismatches safely.

Authorhyperlane-xyz
Version1.0.0
Installs0

System Documentation

What problem does it solve?

The skill fixes merkle root mismatches in the relayer database after investigation, ensuring the relayer's in-memory state aligns with canonical sources and preventing inconsistencies across the system.

Core Features & Use Cases

  • Safe patch workflow to apply merkle root corrections using merkle_tree_insertions.
  • Requires prior investigation with /investigate-merkle-root-mismatch and explicit user confirmation before modifications.
  • Suitable for post-investigation remediation on relayer deployments, including cross-chain domains and environment scopes (mainnet3, testnet4).

Quick Start

To start, supply origin, domain_id, environment (default mainnet3), and the merkle_tree_insertions payload including leaf_index, insertion_block_number, and message_id. The system will prompt for explicit confirmation before applying changes. After applying, restart the relayer if needed using the provided workflow.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: fix-merkle-root-mismatch
Download link: https://github.com/hyperlane-xyz/hyperlane-monorepo/archive/main.zip#fix-merkle-root-mismatch

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.