Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

WEB3-22: chore: Expand documentation on how to handle linking Steel proofs to verified block hashes #244

Merged
merged 3 commits into from
Sep 13, 2024

Conversation

Wollac
Copy link
Contributor

@Wollac Wollac commented Sep 13, 2024

This PR integrates the README improvements from #194 .

closes #181
closes WEB3-22

@Wollac Wollac requested a review from nategraf September 13, 2024 11:13
@Wollac Wollac requested a review from capossele as a code owner September 13, 2024 11:13
@github-actions github-actions bot changed the title chore: Expand documentation on how to handle linking Steel proofs to verified block hashes WEB3-22: chore: Expand documentation on how to handle linking Steel proofs to verified block hashes Sep 13, 2024
steel/README.md Outdated

* Save the required block hash to the contract state if known in advance (e.g., when initiating a governance proposal).
* Use RISC Zero to prove the hash chain from the queried block up to a block within the most recent 256.
A *bookmarking* validation technique can also be built on top of this. The idea is to store the target block hash in the contract state before generating a Steel proof that targets that specific block. Once the block hash (or beacon root) has been bookmarked, it can be used later for validation, ensuring that the proof corresponds to the correct blockchain state.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

With how this is written now, it might be implied that the bookmarking technique is only available for use with consensus block commitments, since it is under that heading.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hope you don't mind. I pushed 919d724 to break up the long lines, and 3c2f455 to add a "Bookmarking" heading and adjust working slightly to make it clear that bookmarking applied in both cases.

@Wollac
Copy link
Contributor Author

Wollac commented Sep 13, 2024

Yeah, that is better 👍

@Wollac Wollac merged commit 0ad2cc7 into main Sep 13, 2024
11 checks passed
@Wollac Wollac deleted the chore/validation-readme branch September 13, 2024 19:51
Wollac added a commit that referenced this pull request Oct 7, 2024
…roofs to verified block hashes (#244)

This PR integrates the README improvements from #194 .

closes #181 
closes WEB3-22

---------

Co-authored-by: Victor Graf <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Expand documentation on how to handle linking Steel proofs to verified block hashes
2 participants