feat: add oracle hint mechanism in Rex2 spec #117
Draft
+719
−42
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add support for the oracle hint mechanism in Rex2: - Add `sendHint(bytes32 topic, bytes data)` function to Oracle contract (v1.1.0) - Add `Hint(bytes32 indexed topic, bytes data)` event for signaling oracle service - Add `on_hint` callback to `OracleEnv` trait for receiving hints - Intercept Hint events in EVM host and decode ABI-encoded bytes data - Deploy v1.1.0 oracle bytecode on Rex2 activation (upgrade from v1.0.0) - Add comprehensive tests for the hint mechanism
Troublor
changed the title
megakabi
reviewed
Dec 22, 2025
Update the Hint event from Hint(bytes32 indexed topic, bytes data) to Hint(address indexed from, bytes32 indexed topic, bytes data). The 'from' address captures msg.sender, enabling off-chain access control since it cannot be faked. On-chain access control can be enforced in a periphery contract which directly calls sendHint. Changes: - Oracle.sol: Add indexed 'from' parameter to Hint event - OracleEnv::on_hint: Add 'from' parameter to trait method - Host::log: Extract 'from' from topics[1], topic from topics[2] - Update bytecode, code hash, and event signature hash constants - Update all related tests
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Add the oracle hint mechanism for Rex2, enabling on-chain contracts to signal the off-chain oracle service about upcoming data needs.
Changes
sendHint(bytes32 topic, bytes data)function to Oracle contract (v1.1.0)Hint(bytes32 indexed topic, bytes data)event for signaling oracle serviceon_hintcallback toOracleEnvtrait for receiving hintsHow It Works
Oracle.sendHint(topic, data)to emit aHinteventOracleEnv::on_hintTest plan
test_on_hint_called_on_rex2- verifies hints work on Rex2test_on_hint_not_called_on_rex1- verifies hints don't trigger pre-Rex2test_on_hint_not_called_for_non_oracle_contract- verifies only oracle contract triggers hintstest_multiple_hints_recorded- verifies multiple hints in one txtest_on_hint_direct_oracle_call- verifies direct calls to oracle work