cfg/00-devnet-vars.cfg and cfg/00-mainnet-vars.cfg

devnet and mainnet variables

Intro

The two following files are basically identical, besides some small details that makes them dedicated to specific SOLANA clusters (or chains), that is devnet and mainnet(sometimes also referred to as mainnet-beta for historical reasons).

Let's go through the content, chunk by chunk.

Network definition

# ADD YOUR DEVNET ORACLE/GUARDIAN DATA

# NETWORK can be "devnet" or "mainnet"
NETWORK="devnet"

This just refers to the SOLANA cluster you're settings this up for. Could be devnet or mainnet.

Oracle pubkeys

# ORACLE DATA
PULL_ORACLE=""
PULL_QUEUE=""

# GUARDIAN DATA
GUARDIAN_ORACLE=""
GUARDIAN_QUEUE=""

These variables are the public keys of the accounts you will use to host your Oracle and will be created in a following step, later in the installation process.

Leave them empty for now and you will come back later to this section when the setup script that creates them will tell you to do so.

RPC URLs

# RPC endpoints - Add your NON-rate-limited RPC endpoints
RPC_URL="https://api.${NETWORK}.solana.com"
WSS_URL="wss://api.${NETWORK}.solana.com"

These variables are referring to SOLANA RPC URLs and once again we invite you to find one that is not rate limited from a trusted provider like https://triton.one/ or https://www.helius.dev/ or other similar solutions.

These two endpoints must be dedicatd to the network you're using, ie: devnet or mainnet.

Infisical settings

# CHANGE ONLY IF YOU USE INFISICAL
#INFISICAL_SECRET_KEY="SOLANA_KEY"
#INFISICAL_SECRET_PATH="/"
#INFISICAL_SECRET_SLUG="dev" # usually "dev" or "prod"
#INFISICAL_TOKEN_NS="infisical" # the K8S namespace where the Infisical TOKEN lives

This section is entirely dedicated to Infisical and is related to secrets management and can be used with Kubernetes based setups. It's not mandatory but we use in some of our installations successfully.

Namespace and Ingresses

##########
### !!! - DO NOT CHANGE ANYTHING BELOW THIS POINT - !!!
##########

GUARDIAN_ENABLED=false

NAMESPACE="switchboard-oracle-${NETWORK}"

# INGRESS gateway
ORACLE_INGRESS="https://${CLUSTER_DOMAIN}/devnet"
GATEWAY_INGRESS="https://${CLUSTER_DOMAIN}/devnet"
GUARDIAN_INGRESS="https://${CLUSTER_DOMAIN}/devnet"

DOCKER_IMAGE_TAG="${DEVNET_DOCKER_IMAGE_TAG}"

This section is mostly meant to stay untouched unless you know what you're changing. The variable GUARDIAN_ENABLED is an internal variable, if you don't know what its use is, you probably don't need it 😎

If you changed the CLUSTER_DOMAIN variable in the 00-common-vars.cfg file, then you MAY also need to adjust the *_INGRESS variables accordingly, remember to leave the /devnet and /mainnet string at the end to be able to host multiple Oracles.