Skip to content

cryptocrew-validators/relayer-metrics-exporter

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}

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published