openrelay/blockmonitorng

OpenRelay第二代区块监控器镜像文档

镜像概述

OpenRelay第二代区块监控器是一个用于监控*** RPC服务器的工具，能够实时检测新区块并生成包含块号、块哈希和块布隆过滤器的消息。该工具可有效处理服务重启和***链重组场景，并支持下游服务订阅，帮助减少对RPC服务器的直接访问频率。

核心功能与特性

• 新区块监控：持续监听*** RPC服务器，实时捕捉新区块，输出包含块号、块哈希和块布隆过滤器的结构化消息。
• 链重组处理：具备对***链重组的优雅处理能力，确保区块数据的准确性和一致性。
• 服务重启恢复：支持服务重启后的数据恢复，维持监控连续性。
• 下游服务订阅：允许下游服务通过订阅方式获取区块信息，仅在布隆过滤器提示可能存在相关事件时才访问RPC服务器，优化资源使用。

使用场景与适用范围

• DApp后端服务：需实时获取***区块数据的去中心化应用，通过订阅监控器减少对RPC服务器的直接请求。
• 智能合约事件监控：下游服务可基于块布隆过滤器快速判断是否存在指定事件，仅在必要时查询RPC服务器，提升效率。
• ***数据分析系统：需要持续收集区块基础数据的分析平台，通过监控器实现高效数据采集。

使用方法与配置说明

基本使用（Docker Run）

bash
docker run -e ETH_RPC_URL=https://your-ethereum-rpc-server docker.xuanyuan.run/openrelay/block-monitor:2nd-gen

环境变量配置

Docker Compose配置示例

yaml
version: '3'
services:
  block-monitor:
    image: docker.xuanyuan.run/openrelay/block-monitor:2nd-gen
    environment:
      - ETH_RPC_URL=https://mainnet.infura.io/v3/your-api-key
      - LOG_LEVEL=DEBUG
      - POLL_INTERVAL=3
    restart: always

下游服务订阅

下游服务可通过监听监控器输出的消息（通常通过标准输出或指定消息队列）获取区块信息，示例消息格式如下：

json
{
  "blockNumber": 18000000,
  "blockHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "bloomFilter": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
}

下游服务可通过解析bloomFilter判断是否存在目标事件，从而决定是否进一步访问RPC服务器获取详细区块数据。