Rex

Start with the docs to learn about Rex, or explore the ⁠online documentation.

Announcement on LinkedIn ↗️, X.

Install

cargo install --path crates/rex-cli

# update
cargo install --path crates/rex-cli --force

Usage

• Quickstart: Install Rex and inspect a local Reth dev node.
• Chain: Overview of the chain command set.
• Chain Head: Inspect latest, safe, and finalized heads.
• Chain Block: Inspect a block by number, hash, or tag.
• Chain Ancestry: Walk parent hashes from a starting block.
• Chain Canonical: Check whether a block hash is canonical.
• Execution: Simulate calls, replay transactions, and inspect block state diffs.
• Execution Simulate: Run eth_call and eth_estimateGas.
• Execution Replay Tx: Replay one transaction with the debug call tracer.
• Execution State Diff: Summarize account and storage changes for a block.
• Engine: Overview of the authenticated Engine API command set.
• Engine Capabilities: Inspect supported Engine API methods.
• Engine Payload Bodies: Fetch payload body summaries by execution block hash.
• Network: Overview of the node networking command set.
• Network Status: Inspect listening state, peer count, and network ID.
• Network Node: Inspect the local node's devp2p identity and ports.
• Network Peers: Inspect established peer sessions and capabilities.
• TxPool: Overview of the txpool command set.
• Inspect: Inspect the txpool of a running node.
• Sender: Inspect transactions for one sender.
• Nonce Gaps: Find sender nonce gaps.
• Replacement: Estimate replacement fee thresholds.
• Fees: Inspect txpool fees.
• Duplicates: Find duplicate sender nonces.
• Stats: Inspect txpool stats.
• Watch: Watch txpool changes.
• Database: Overview of read-only local Reth storage inspection.
• Database Info: Summarize MDBX tables, freelist pages, and static files.
• Database Tables: Inspect entry and page statistics for every Reth table.
• Database Version: Compare the on-disk schema with Rex's pinned Reth schema.

Test

./tests.sh

Install cargo-nextest as it's essentially a faster, more capable replacement for most cargo test runs.
Install using cargo: cargo install cargo-nextest --locked.
USAGE: cargo nextest run