persistenceone/staking-oracle

staking-oracle

镜像概述

本镜像为pstake eth流动性质押协议的Oracle组件，用于从指定端点拉取数据，保障协议的正常运行。

核心功能

1. 从eth1端点、Beacon链端点及Graph节点获取协议所需数据
2. 支持***/Slack渠道发送错误通知
3. 可通过环境变量配置私钥、合约地址等关键参数
4. 支持多Oracle实例同步运行，提升系统稳定性

使用场景

适用于pstake eth流动性质押协议的部署环境，为协议提供数据支撑，确保质押流程的顺畅执行。

配置说明

环境变量

• PRIVATE_KEY_ORACLE：与Oracle关联的eth1账户私钥
• ORACLE_CONTRACT：stkETH对应的Oracle合约地址
• STAKINGPOOL_CONTRACT：stkETH对应的质押池合约地址
• GAS_PRICE：交易使用的 gas 价格（未设置则从RPC端点自动计算）

构建参数

必选参数

• -eth1：eth1端点（支持WebSocket或HTTP，如[***]
• -beacon：Beacon链端点（如[***]
• -graph：Graph节点查询端点（如http://localhost:8000/subgraphs/name/keysmanager%EF%BC%89

可选参数

• -t：***机器人ID（用于发送错误通知）
• -ch：***频道ID（机器人订阅的频道）
• -s：Slack Webhook（用于发送错误到Slack频道）
• 日志参数：
  • -d：打印调试日志
  • -v：打印详细日志（包含信息、警告、错误）

Docker部署示例

拉取镜像

bash
docker pull docker.xuanyuan.run/persistenceone/staking-oracle:<tag>

单实例运行

bash
docker run -e PRIVATE_KEY_ORACLE="<PRIVATE_KEY>" -e ORACLE_ADDRESS="<ORACLE_CONTRACT_ADDRESS>" -e STAKINGPOOL_ADDRESS="<STAKINGPOOL_CONTRACT_ADDRESS>" -e GAS_PRICE=<GAS_PRICE> -d --name oracle <IMAGE_NAME> python main.py -eth1 <ETH-ENDPOINT> -beacon <BEACON_ENDPOINT> -graph <GRAPH_ENDPOINT> -t "<TELEGRAM_ID>" -ch "<CHANNEL_ID>" -v

多实例同步运行（docker-compose）

yaml
version: '3'
services:
  oracle-1:
    image: docker.xuanyuan.run/oracle
    environment:
      PRIVATE_KEY_ORACLE: "<PRIVATE_KEY_ORACLE>"
      ORACLE_ADDRESS: "<ORACLE_ADDRESS>"
      GAS_PRICE: 5
    command: ["python","/usr/src/app/main.py","-eth1","<ETH_ENDPOINT>","-beacon","<BEACON_ENDPOINT>","-graph","<GRAPH_ENDPOINT>","-d"]
  oracle-2:
    image: docker.xuanyuan.run/oracle
    environment:
      PRIVATE_KEY_ORACLE: "<PRIVATE_KEY_ORACLE>"
      ORACLE_ADDRESS: "<ORACLE_ADDRESS>"
      GAS_PRICE: 5
    command: ["python","/usr/src/app/main.py","-eth1","<ETH_ENDPOINT>","-beacon","<BEACON_ENDPOINT>","-graph","<GRAPH_ENDPOINT>","-d"]
  oracle-3:
    image: docker.xuanyuan.run/oracle
    environment:
      PRIVATE_KEY_ORACLE: "<PRIVATE_KEY_ORACLE>"
      ORACLE_ADDRESS: "<ORACLE_ADDRESS>"
      GAS_PRICE:5
    command: ["python","/usr/src/app/main.py","-eth1","<ETH_ENDPOINT>","-beacon","<BEACON_ENDPOINT>","-graph","<GRAPH_ENDPOINT>","-d"]

修改上述配置中的环境变量和端点后，执行以下命令启动：

bash
docker-compose up -d