switchboardlabs/node Docker Image Overview

switchboardlabs/node

switchboardlabs

Switchboard Fulfillment Node

0 次下载

📦 一套镜像服务，解决研发 / 测试 / 生产三套环境

镜像简介版本下载

📦 一套镜像服务，解决研发 / 测试 / 生产三套环境

switchboardlabs/node

A NodeJS container that facilitates on*** update requests from an oracle's assigned queue.

</a>
<a href="[***]">
  
</a>

Documentation: docs.switchboard.xyz/operator/oracle

Switchboard Oracle

A Switchboard oracle is a Node.js container that sits between a *** and the internet and waits for update requests from an oracle queue. An oracle queue assigns updates to oracles in a round robin fashion.

Switchboard oracles on all supported chains MUST have a mainnet *** RPC in order to run the task runner. This is used to support legacy task types for fetching on*** *** data.

Image

This image is still in active development and not all release tags are guaranteed to work. You can view the current Switchboard network stats to get an idea of the latest version.

Stable tags will be provided soon.

Keypair

A Switchboard oracle requires a keypair in order to pay for on*** updates. You may mount the secret at /home/node/sbv2-oracle/payer_secrets.json or provide your own path by updating the env variable $FS_PAYER_SECRET_PATH. You can also provide the PAYER_SECRETS docker secret. Google and Amazon secrets are also supported.

Environment

Base Environment Variables

Env Variable	Definition
CHAIN	Required Type - Enum [aptos / evm / near / * / * / sui] Description - Dictates which chain to listen on for on*** events
ORACLE_KEY	Required Type - String Description - The address of the Switchboard oracle
HEARTBEAT_INTERVAL	Type - Integer Default - 30 Description - Seconds between oracle heartbeats. Queues have different oracle heartbeat requirements. Recommended value is 30
RPC_URL	Required Type - String Description - The URL of the RPC server to connect to for any on*** network requests.
NETWORK_ID	Type - Enum [mainnet / mainnet-beta / devnet / testnet / localnet] Description - The network ID of the $CHAIN to connect to. Not required for most CHAINS.
PROGRAM_ID	Type - String Description - The Switchboard program ID for the given $CHAIN and $NETWORK_ID
TASK_RUNNER_***_RPC	Required, if $CHAIN is not * and $NETWORK_ID is not mainnet-beta Type - String Description - * mainnet RPC URL used for fulfilling task types that require data on ***.
VERBOSE	Type - Boolean Default - disabled Description - Enable additional logging.
DEBUG	Type - Boolean Default - disabled Description - Enable additional debug logging.

Keypair Environment Variables

Env Variable	Definition
FS_PAYER_SECRET_PATH	Type - Filesystem Path Default - /home/node/sbv2-oracle/payer_secrets.json Description - Local filesystem path to keypair file that will pay for on*** transactions and is the authority for the oracle
PAYER_SECRETS or DOCKER_PAYER_SECRET	Type - Docker Secret Description - Docker Secret path to keypair file that will pay for on*** transactions and is the authority for the oracle
GOOGLE_PAYER_SECRET_PATH	Type - GCP Resource Path Description - Google cloud resource to manage your keypair securely.
AMAZON_PAYER_SECRET_PATH	Type - AWS ARN path Description - Amazon web services ARN path of secret.

Monitoring Environment Variables

Env Variable	Definition
PAGERDUTY_EVENT_KEY	Type - String Description - PagerDuty event key to send alerts. Paging disabled if not provided.
HEALTH_CHECK_PORT	Type - Integer Default - 8080 Description - The network port to serve healthcheck requests. The docker healthcheck will ping http://localhost:${HEALTH_CHECK_PORT}/healthz periodically to determine a containers health status.
METRICS_EXPORTER	Type - Enum [prometheus / opentelemetry-collector] Default - prometheus Description - The OpenTelemetry metrics provider.
METRICS_EXPORTER_PORT	Type - Integer Default - 9090 Description - The network port to collect metrics.