Investigate Merkle Root Mismatch

When to Use

1. Alert-based triggers:

   • Alert mentions "merkle root mismatch"
   • GCP logs show: "checkpoint root does not match canonical root from merkle proof"
   • The hyperlane_merkle_root_mismatch metric is firing

2. User request triggers:

   • "Debug merkle tree issues for [chain]"
   • "Investigate the merkle root mismatch on [chain]"
   • "Why is the relayer's merkle tree wrong for [chain]?"

Input Parameters