Skip to content

cryptocrew-validators/relayer-metrics-exporter

Folders and files

NameName
Last commit message
Last commit date
May 14, 2023
May 14, 2023
Jan 31, 2024
May 28, 2023
May 11, 2023
Jan 31, 2024
Jan 31, 2024
Jan 31, 2024
May 16, 2023
May 14, 2023
Jan 31, 2024
May 14, 2023
Jan 31, 2024
May 14, 2023
Jan 31, 2024

Repository files navigation

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.

Features

  • 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

Requirements

  • Node.js (v12 or above)
  • npm (Node Package Manager)
  • RPC connection

Installation

  1. Clone the repository:
git clone https://github.com/clemensgg/relayer-metrics-exporter
npm install

Configuration

Open the config.js file and update the configuration parameters. It accepts an array of chains for multi-chain config.

Usage

Start the relayer metrics exporter:

npm start

The 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.

Metrics Exposed

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}