Oracle Aggregator

WHAT IT DOES

Oracle Aggregator gives DeFi protocols, developers, and data providers full control over oracle aggregation contracts. It reads live on-chain data including oracle contract state, price feeds, data sources, aggregator configuration, latest round data, historical price data, and deviation thresholds. You can add or remove data sources, set deviation thresholds, trigger manual updates, fetch latest prices, and monitor aggregator health. The tool shows you in real time the latest price, last update time, number of data sources, deviation threshold, and active status—so you can ensure your oracle aggregator is properly configured and delivering reliable price data.

HOW TO USE

Connect your EVM wallet (must be the contract owner or authorized address). Enter the oracle aggregator contract address, data source address, price feed address, and deviation threshold in basis points. Use "Check oracle state" to see the latest price, last update time, data source count, deviation threshold, and active status. Click "Add data source" to register a new price source. Use "Remove data source" to revoke a source. "Set deviation threshold" updates the percentage change that triggers an update. "Trigger update" manually refreshes the price. "Fetch latest price" retrieves the current price without updating state. Each action generates a transaction you review and sign in your wallet.

TECHNICAL APPROACH

This tool interacts with oracle aggregator contracts using ethers v5.7.2. It calls addDataSource(), removeDataSource(), setDeviationThreshold(), triggerUpdate(), latestPrice(), lastUpdateTime(), getDataSourceCount(), isDataSource(), getDeviationThreshold(), and active() on the oracle contract to manage and query aggregator state. The tool validates addresses and thresholds before submission. It checks aggregator status by reading active state and source count from the contract. All RPC calls are wrapped in a robust error handler that extracts the actual failure reason from Ethers error objects, digging three levels deep to avoid showing "[object Object]" when a transaction reverts. Transaction costing uses receipt.effectiveGasPrice post-EIP-1559 rather than tx.gasPrice, which overstates actual spend.

WHAT IT CANNOT SEE

This tool cannot verify off-chain data source accuracy or guarantee that aggregated prices reflect true market value in all conditions. It cannot detect malicious data sources or manipulated price feeds. It cannot predict future price movements or oracle deviations. It cannot see off-chain data source internal logic or quality. It cannot guarantee that the deviation threshold is appropriate for all market conditions. The tool manages oracle aggregator configuration, but it does not guarantee that the aggregated prices are accurate or that data sources are honest.

PLEASE NOTE

This tool supports EVM‑compatible chains only (Ethereum, Goerli, Sepolia, Arbitrum, Optimism, Polygon). Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, and XRP are not supported. This is a read‑write tool that requires signing transactions—always verify the oracle contract address, data source addresses, and thresholds before approving. No contract addresses are hardcoded; you paste the contracts you are managing. The tool is free and open under the BotGentz PLAYBOOK‑C specification.