Skip to content

README.md

Latest commit

 

History

History
122 lines (84 loc) · 4.92 KB

README.md

File metadata and controls

122 lines (84 loc) · 4.92 KB
Raw

Jito Bell

Build Status Release License PRs Welcome

Jito Bell

Overview

  • Track live Solana transactions
  • Send notification to several destination (Slack, Telegram, Discord)

How It Works

Jito Bell monitors Solana transactions in real-time, focusing on SPL Stake Pool and Jito Vault activities, and sends notifications when significant events occur.

Transaction Monitoring Flow

  1. Transaction Subscription
  • Jito Bell connects to a Solana RPC endpoint and subscribes to transaction stream
  • The system filters for transactions involving the SPL Stake Pool program (SPoo1Ku8WFXoNDMHPsrGSTSG1Y47rzgn41SLUNakuHy) and Jito Vault program (Vau1t6sLNxnzB7ZDsef8TLbPLfyZMYXH8WTNqUdm9g8)
  • Each transaction is captured as it occurs on the blockchain
  1. Transaction Processing
  • Raw transaction information is received from the RPC
  • The parser analyzes each transaction to identify specific types:
    • For SPL Stake Pool: IncreaseValidatorStake, DepositStake, WithdrawStake, DepositSol, WithdrawSol, DecreaseValidatorStakeWithReserve
    • For Jito Vault: MintTo, EnqueueWithdrawal
  • Transaction data is decoded to extract relevant information like amount, accounts involved
  1. Event Filtering
  • Configurable thresholds determine which transactions trigger notifications
  • Examples of noteworthy events:
    • Large deposits (e.g., over 1000 SOL)
    • Significant withdrawals
  1. Notification Dispatch
  • When a transaction meets notification criteria, alerts are sent to configured destinations
  • Support notification channels:
    • Slack
    • Discord
    • Telegram

Configuration

The system is highly configurable through the jito_bell_config.yaml file:

Set different notification thresholds for various transaction types Configure multiple notification destinations with different filtering rules Customize notification formats and information included Define which accounts and program instructions to monitor. Yellowstone transaction filters are read from the config filters section.

Programs

SPL Stake Pool

  • Program ID: SPoo1Ku8WFXoNDMHPsrGSTSG1Y47rzgn41SLUNakuHy
  • JitoSOL: J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn

Instructions

Jito Vault Program

  • Program ID: Vau1t6sLNxnzB7ZDsef8TLbPLfyZMYXH8WTNqUdm9g8

Instructions

Getting Started

Create Webhook URL

If you don't know how to create it, you can follow Webhook Integration Guide.

Create .env file

cp .env.example .env

Create jito_bell_config.yaml

cp jito_bell_config_example.yaml jito_bell_config.yaml

Build

docker build -t jito-bell .

Run

docker run jito-bell \
  -e "https://your-endpoint.com" \
  -x-token "your-token-here" \
  -config-file /etc/jito-bell/jito_bell_config.yaml

References

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.