Repository navigation
evm-oracle-state v0.3.0-alpha.2
Pre-release
Pre-release
This is the supported alpha for the opt-in pending oracle update channel. It lets searchers simulate oracle-dependent actions before a candidate transaction lands while keeping speculative updates completely separate from confirmed oracle state and reconciliation.
Highlights:
- Reuses the feeds already registered through OracleRuntime; no second feed subscription is required.
- Decodes Chainlink OCR2 direct, secondary, and forwarded transmissions with signed-envelope validation, deduplication, and committed-log correlation.
- Includes Ethereum mainnet sources for Alchemy full pending transactions and Flashbots MEV-Share behind explicit feature gates.
- Exposes transaction hashes, calldata, ordering material, proposed values, source observations, and lifecycle outcomes for downstream simulation and bundle construction.
- Adds public adapter, source, transport-identity, and chain-configuration seams for future oracle families and networks.
- Corrects the transport-test feature gate found during the hosted isolated-feature release check; all eight isolated features and the complete Rust 1.88 validation job are green.
Current scope and limitations:
- Experimental and disabled by default.
- Built-in presets are Ethereum mainnet only; other chains require explicit custom configuration and a compatible source.
- The built-in decoder covers registered Chainlink OCR2 feeds only.
- Pending visibility is best effort and never guarantees completeness, inclusion, success, or sufficient lead time.
- The crate observes and classifies candidates; it does not simulate strategies, sign transactions, or submit bundles.
See the pending-oracle guide and compile-checked example for setup and operational guidance.