switchboardlabs/node

Switchboard Oracle

镜像概述和主要用途

Switchboard预言机是一个Node.js容器，位于和互联网之间，用于等待来自预言机队列的更新请求。预言机队列以轮询方式向预言机分配更新任务。所有支持链上的Switchboard预言机都需要主网 RPC才能运行任务执行器，以支持获取链上***数据的传统任务类型。

核心功能和特性

• 多链支持：兼容aptos、evm、near、、、sui等多种***
• 链上更新处理：接收并处理来自预言机队列的链上数据更新请求
• 灵活密钥管理：支持文件系统、Docker secrets、Google Cloud和Amazon Web Services等多种密钥存储方式
• 可配置心跳机制：自定义预言机心跳间隔，满足不同队列的运行要求
• 完善监控体系：集成Prometheus/OpenTelemetry指标导出和PagerDuty告警功能
• 健康检查接口：内置健康检查端点，便于容器状态监控和自动恢复

使用场景和适用范围

适用于作为Switchboard网络的预言机节点，为***应用提供可靠的链下数据喂价服务。特别适合需要实时或定期更新链上数据的DeFi协议、NFT项目、智能合约应用等场景，确保链上数据的准确性和及时性。

详细使用方法和配置说明

镜像说明

该镜像处于积极开发阶段，并非所有发布标签都保证稳定可用。可通过Switchboard网络统计了解最新版本信息，稳定标签即将推出。

密钥对配置

预言机需要密钥对用于支付链上交易费用，可通过以下方式配置：

• 将密钥文件挂载至默认路径：/home/node/sbv2-oracle/payer_secrets.json
• 通过FS_PAYER_SECRET_PATH环境变量指定自定义密钥路径
• 使用Docker secret：PAYER_SECRETS或DOCKER_PAYER_SECRET
• 集成云服务密钥：Google Cloud资源路径或AWS ARN路径

环境变量配置

基础环境变量

密钥对环境变量

监控环境变量

Docker部署示例

使用docker run命令

bash
docker run -d \
  --name switchboard-oracle \
  -e CHAIN=solana \
  -e ORACLE_KEY=your_oracle_address \
  -e RPC_URL=https://api.mainnet-beta.solana.com \
  -e HEARTBEAT_INTERVAL=30 \
  -v /local/path/to/payer_secrets.json:/home/node/sbv2-oracle/payer_secrets.json \
  switchboardlabs/node:latest

使用docker-compose配置

yaml
version: '3'
services:
  switchboard-oracle:
    image: switchboardlabs/node:latest
    container_name: switchboard-oracle
    environment:
      - CHAIN=***
      - ORACLE_KEY=your_oracle_address
      - RPC_URL=[***]
      - HEARTBEAT_INTERVAL=30
      - VERBOSE=true
      - METRICS_EXPORTER=prometheus
    volumes:
      - /local/path/to/payer_secrets.json:/home/node/sbv2-oracle/payer_secrets.json
    ports:
      - "8080:8080"  # 健康检查端口
      - "9090:9090"  # 指标导出端口
    restart: unless-stopped