Skip to main content

Binary

warning

Running the modules natively means you opt out of the security guarantees made by Docker and it's up to you how to setup and ensure the modules run safely

Setup​

Get the binary of the module either by compiling from source or by downloading a published release.

Modules need some environment variables to work correctly.

Common​

  • CB_CONFIG: required, path to the toml config file
  • CHAIN_SPEC_ENV: optional, path to a chain spec file. This will override the [chain] field in the toml config
  • CB_METRICS_PORT: optional, port where to expose the /metrics endpoint for Prometheus
  • CB_LOGS_DIR: optional, directory to store logs. This will override the directory in the toml config

PBS Module​

  • CB_BUILDER_URLS: optional, comma-separated list of urls to events modules where to post builder events

Signer Module​

  • CB_JWTS: required, comma-separated list of MODULE_ID=JWT to process signature requests
  • CB_SIGNER_PORT: required, port to open the signer server on For loading keys we currently support:
    • CB_SIGNER_LOADER_FILE: path to a .json with plaintext keys (for testing purposes only)
    • CB_SIGNER_LOADER_KEYS_DIR and CB_SIGNER_LOADER_SECRETS_DIR: paths to the keys and secrets directories (ERC-2335 style keystores as used in Lighthouse) For storing proxy keys we currently support:
    • CB_PROXY_STORE_DIR: directory where proxy keys and delegations will be saved in plaintext (for testing purposes only)

Modules​

  • CB_MODULE_ID: required, unique id of the module

Commit modules​

  • CB_SIGNER_URL: required, url to the signer module server
  • CB_SIGNER_JWT: required, jwt to use to for signature requests (needs to match what is in CB_JWTS)

Events modules​

  • CB_BUILDER_PORT: required, port to open to receive builder events from the PBS module

Modules might also have additional envs required, which should be detailed by the maintainers.

Start​

After creating the cb-config.toml file, setup the required envs and run the binary. For example:

CB_CONFIG=./cb-config.toml commit-boost-pbs

Security​

Running the modules natively means you opt out of the security guarantees made by Docker and it's up to you how to setup and ensure the modules run safely.