Operate a Base Oracle

Run an automated operator agent using the OrbOracle Poster. Fetch multi-source market rates, compute normalized medians, and submit verified on-chain observations to earn continuous operator rewards.

View Poster on GitHub Find Oracles to Operate

01 // Multi-Source Aggregation

Cross-Source Resilience

The oracle operator can modify the oracle poster to fetch data from a variety of sources that he/she trusts (Source A, Source B, Source C, etc.), computing an 18-decimal normalized median or aggregate before submitting.

Standardized 18-decimal WAD format

02 // Operator Rewards

Automated Reward Yield

Every confirmed submission claims a proportional share of the oracle reward reserve. Operators can configure gas limits and update intervals to optimize operational expenses.

Configured reward percentage per cycle

03 // Time-Decay Weight

Continuous Weight Dominance

The weight of a previously submitted value decays continuously based on the configured half-life. Continuous value submission refreshes submitted value weight, maintaining responsive and accurate on-chain consensus.

Decay rate defined by Half-Life parameter

CHECKLIST

Operator Prerequisites

3 REQUIRED ITEMS

1Staked Weight Token

Deposit the required weightToken in the Base Oracle via the Oracle detail page using the depositTokens() function.

2Native Gas Balance (ETH)

Ensure the operator wallet has native gas tokens (ETH on Mainnet/Sepolia or respective L2) to execute recurring on-chain transactions.

3EVM RPC Endpoint

Obtain an active EVM JSON-RPC URL matching the chain ID where the target oracle is deployed.

DEPLOYMENT // RUNBOOK

Poster Setup Runbook

Follow these simple steps to configure and launch your automated operator bot.

Clone the Poster Repository & Install Dependencies

# Clone repository

git clone https://github.com/StabilityNexus/OrbOracle-Poster.git

cd OrbOracle-Poster

# Install Node.js packages

npm install

Configure Environment Variables (`.env`)

Create a .env file in the project root by copying .env.example:

# Network & Operator Wallet
RPC_URL=https://your-rpc-endpoint.example.com
PRIVATE_KEY=0xYOUR_OPERATOR_PRIVATE_KEY
ORACLE_ADDRESS=0xTARGET_BASE_ORACLE_ADDRESS

# Data Sources Configuration (Customizable to any trusted sources)
SOURCE_A_URL=https://api.source-a.org/data
SOURCE_B_URL=https://api.source-b.org/data
SOURCE_C_URL=https://api.source-c.org/data

# Execution Parameters
UPDATE_INTERVAL_MS=60000
MIN_STAKE_REQUIRED=10

ORACLE_ADDRESS

Contract address of the Base Oracle you are operating for.

UPDATE_INTERVAL_MS

Frequency in milliseconds (e.g. 60000 for 1-minute cycles).

Start the Operator Worker

Direct Node Execution:

npm start

Docker Compose (Daemon):

docker compose up -d

operator-worker.log

ACTIVE CYCLE

Starting Orb Oracle Poster worker...

Oracle Address: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e

Interval: 60 seconds

--- Starting submission cycle at 2026-09-27T02:00:00.000Z ---

[Stake Verifier] Current stake: 250.0 Tokens

[Smart Trigger] Conditions optimal for submission. Network Gas Price: 14.2 gwei

[Data Source] Source A: 0.4285

[Data Source] Source B: 0.4281

[Data Source] Source C: 0.4283

[Aggregation] Calculated and Normalized Median Value.

[Tx Builder] Submitting normalized value: 428300000000000000

[Tx Builder] Transaction submitted. Hash: 0x9f8b...3e12

[Tx Success] Block Number: 7129482, Gas Used: 43280

--- Cycle Complete ---