Practical overview
When it fits
Use Oracle Core when operating the off-chain oracle component of an Ergo pool and you can provide a configured public node, wallet address, and mnemonic.
Who it is for
- Operators bootstrapping an Ergo oracle pool.
- Oracle operators joining or maintaining an existing pool.
- Teams running multiple pools through separate Oracle Core instances.
Documented uses
- Create a pool and generate its pool configuration.
- Run an oracle instance in a new or existing pool.
- Inspect or extract accumulated reward tokens and transfer an oracle token.
- Prepare and submit pool contract or token updates through the documented update commands.
Requirements & limits
The repository is public and licensed under Apache-2.0. The README documents Docker images for AMD64 and ARM64, release binaries, and installation from source.
- The required public node must have the extra transaction-creation option enabled.
- Each instance serves one pool; multiple instances can share a full node when configured with different API ports.
- The configured oracle address needs coins for transaction fees and pool operations.
- Bootstrapping requires an unlocked node wallet; joining an existing pool requires its configuration and specified tokens.
- The README describes the implementation as following the protocol specified in the EIP-0023 pull request.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Bootstrap and start a new oracle pool
Create a pool configuration and start an Oracle Core instance for the new pool.
Before you start
- Oracle Core installed or available as a Docker image.
- Access to a public Ergo node with the extra transaction-creation option enabled.
- A funded oracle address, the oracle mnemonic, and an unlocked node wallet.
Steps
Generate the default oracle configuration with
oracle-core generate-oracle-configand set the oracle address and node URL.Set
ORACLE_WALLET_MNEMONICin the environment; the README suggests loading it from a.secretsfile.Generate a bootstrap template with
oracle-core bootstrap --generate-config-template bootstrap.yamland edit its pool parameters.Run
oracle-core bootstrap bootstrap.yamlto create the pool and generatepool_config.yaml, then start the oracle withoracle-core run.
Expected outcome
A pool is created and its generated configuration is available for running the oracle.
Guide limitations
- Each Oracle Core instance is designed for one pool.
- The available data-point sources listed are NanoErgUsd, NanoErgXau, and NanoErgAda.
- The node wallet must be unlocked for bootstrapping.
Join an existing oracle pool
Configure and run an Oracle Core instance as an oracle in a pool that already exists.
Before you start
- Access to a public Ergo node with the extra transaction-creation option enabled.
- One oracle token and one reward token sent to the address used as
oracle_address. - The pool operator’s
pool_config.yaml, an oracle mnemonic, and a node wallet that can be unlocked.
Steps
Obtain the pool configuration and required tokens from the pool operator.
Generate an oracle configuration with
oracle-core generate-oracle-config, then set the oracle address and node URL.Set
ORACLE_WALLET_MNEMONICin the environment and place the pool configuration where Oracle Core can use it.Unlock the node wallet and run
oracle-core run.
Expected outcome
Oracle Core starts an instance configured to work with the existing pool.
Guide limitations
- Each instance supports only one pool.
- The README specifies that the joining address must receive both an oracle token and a reward token.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 9 October 2026
- Original website title
- ergoplatform/oracle-core · Official homepage title · retained in its source language