superchain-trace

Cross-chain message debugger for the OP Superchain. Trace, debug, and simulate interop messages across OP Stack chains.

Why this exists

The OP Superchain enables cross-chain messaging between Optimism, Base, Zora, Mode, and other OP Stack chains via the interop system. But when a cross-chain message fails or gets stuck, there's no developer-facing tool to trace what happened. This tool fills that gap.

Install

cargo install --git https://github.com/kcolbchain/superchain-trace

Or build from source:

git clone https://github.com/kcolbchain/superchain-trace
cd superchain-trace
cargo build --release

Commands

# Trace a cross-chain message by its initiating tx hash
superchain-trace trace 0xabc123... --chain op

# Check message status and safety level
superchain-trace status 0xdef456... --chain base

# List supported Superchain networks
superchain-trace chains

Message lifecycle

Source chain: tx submitted
    ↓
OP-Supervisor: log indexed
    ↓
Safety level: unsafe → safe → finalized
    ↓
Destination chain: message relayed and executed

This tool shows you exactly where your message is in this lifecycle and why it might be stuck.

Supported chains

• OP Mainnet (chain ID 10)
• Base (8453)
• Zora (7777777)
• Mode (34443)
• Fraxtal (252)

Architecture

CLI (clap)
  ↓
Tracer — fetches tx receipt, identifies L2ToL2CrossDomainMessenger events
  ↓
Supervisor client — queries OP-Supervisor for safety level
  ↓
Display — pretty terminal output with lifecycle visualization

Built for the OP Foundation Interop Mission.