Cross-Chain Oracle Relay Tool

WHAT IT DOES

Cross-Chain Oracle Relay Tool is a developer-focused tool that enables reliable relaying of oracle price data across EVM-compatible blockchain networks. Unlike generic bridge tools that only transfer tokens, this tool is specifically designed for oracle price feeds—it reads source oracle price data, verifies destination oracle state, checks bridge oracle configuration, enforces update thresholds, tracks timestamp data, monitors gas price data, and manages oracle heartbeat parameters. The tool supports Ethereum, Polygon, Arbitrum, Optimism, Avalanche, BNB Chain, and Base, providing a unified interface to monitor, validate, and relay oracle prices across chains. This is essential for DeFi protocols, cross-chain applications, and developers who need consistent, up-to-date price data across multiple networks.

HOW TO USE

Connect your wallet using WalletConnect or a compatible browser extension. Ensure your wallet is on the source chain where the oracle bridge contract is deployed. Select the source and destination chains from the dropdown menus. Enter the oracle bridge contract address that handles price relaying—this is the contract you are interacting with, and you are vouching for its safety. Enter the price feed ID (bytes32), set a deviation threshold percentage, and configure a heartbeat interval in seconds. Click "Check oracle state" to read the current source price, destination price, deviation, and last update time from the contract. The tool automatically determines if the price is stale or if the deviation exceeds the threshold. If a relay is needed, the "Relay price" button appears. Click it to submit the relay transaction. The tool displays a transaction link to your chain's block explorer and logs the final gas cost using receipt.effectiveGasPrice for accurate post-EIP-1559 fee tracking.

ADAPTIVE PRICE DEVIATION AND HEARTBEAT DETECTION ENGINE

The core technical mechanism that distinguishes this tool is its adaptive price deviation and heartbeat detection engine. Unlike simple price relays that just forward data, this tool implements a multi-layered validation pipeline before allowing a relay. The engine first reads the source oracle price and timestamp using getPrice(), which returns the current price value and the last update time. It then retrieves the destination oracle's stored price from the bridge contract's destinationPrice() view, calculating the absolute deviation percentage. The engine enforces a deviation threshold with hysteresis—the relay only triggers when the deviation exceeds the configured threshold plus a small margin, preventing rapid re-triggering on minor price fluctuations. The heartbeat mechanism checks the lastRelayTime() against the current block timestamp, triggering a relay if the configured interval has elapsed regardless of deviation. The engine also performs a staleness check using isStale() if available, which accounts for the source oracle's own heartbeat parameters. Before allowing execution, the tool performs a dry-run simulation of the relay transaction using eth_call to ensure the contract will accept the price update without reverting. All RPC calls are wrapped with timeout and retry logic, and the tool automatically falls back to a secondary provider if the primary endpoint fails or rate-limits, ensuring the validation completes even during network congestion.

WHAT IT CANNOT SEE

The tool cannot guarantee that oracle prices will be relayed accurately if the bridge network fails, the source oracle updates before the relay completes, the destination oracle's validation logic changes, or the price deviation exceeds the update threshold before the relayer processes the transaction. It has no visibility into off-chain bridge relayer status, operator interventions, or governance changes that occur after the relay transaction is submitted. The tool cannot predict the exact confirmation time on destination chains, nor can it detect mempool congestion beyond standard gas price estimates. It does not monitor oracle prices after relaying—it is a relay tool, not a continuous oracle monitoring service. The tool cannot interact with non-EVM chains, private networks, or oracle bridges that do not implement the standard price relay interface it expects. It also cannot recover funds if you relay an invalid price or send to an incorrect address.

PLEASE NOTE

This tool is designed exclusively for EVM-compatible blockchain networks. It supports Ethereum, Polygon, Arbitrum, Optimism, Avalanche, BNB Chain, Base, and similar chains. Non-EVM networks such as Solana, Cosmos, or Bitcoin are not supported. Always verify the oracle bridge contract address, price feed ID, and deviation thresholds before relaying—the tool does not validate contract safety or price accuracy beyond basic verification. The tool provides estimates only—actual fees and gas costs are determined at the time of transaction execution. Users are responsible for understanding oracle risks, including bridge downtime, price manipulation, and potential relay failures.