Relayer Metrics Exporter is a tool designed to monitor and analyze IBC relayer activity and performance. It connects to one or multiple Cosmos-SDK based chains, listens for new blocks, and captures relevant IBC messages to provide insights into relayer performance.
- Decodes and analyzes IBC messages from new blocks
- Tracks relayers, packets, sequences and execution (tx ordering)
- Identifies frontrun packets and affected signers
- Stores data in an in-memory SQLite database
- Provides metrics and logs for analysis
- Node.js (v12 or above)
- npm (Node Package Manager)
- RPC connection
- Clone the repository:
git clone https://github.com/clemensgg/relayer-metrics-exporter
npm installOpen the config.js file and update the configuration parameters. It accepts an array of chains for multi-chain config.
Start the relayer metrics exporter:
npm startThe exporter will establish a WebSocket connection, New blocks will be processed, and relevant IBC messages will be decoded and analyzed.
Metrics will be exposed on localhost:3000/metrics per default.
ibc_effected_packets{chain_id, src_channel, src_port, dst_channel, dst_port, signer}
ibc_uneffected_packets{chain_id, src_channel, src_port, dst_channel, dst_port, signer}
ibc_frontrun_counter{chain_id, src_channel, src_port, dst_channel, dst_port, signer, frontrunned_by}