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

[Book] Stone configuration #29

Closed
Tracked by #18
dmirgaleev opened this issue Sep 25, 2024 · 12 comments
Closed
Tracked by #18

[Book] Stone configuration #29

dmirgaleev opened this issue Sep 25, 2024 · 12 comments
Assignees
Labels
difficulty: hard documentation Improvements or additions to documentation good first issue Good for newcomers ODHack8

Comments

@dmirgaleev
Copy link
Member

Add a documentation page that describes how to create a configuration file for the Stone prover, what are the security settings of the FRI protocol, what is the format of the config file.

Path to your markdown file: docs/pages/usage/configuration.md

References:

@dmirgaleev dmirgaleev added documentation Improvements or additions to documentation good first issue Good for newcomers ODHack8 difficulty: hard labels Sep 25, 2024
@dmirgaleev dmirgaleev mentioned this issue Sep 25, 2024
14 tasks
@Jemiiah
Copy link
Contributor

Jemiiah commented Sep 26, 2024

Hi @dmirgaleev ,Please let me work on this when od hack starts.

Copy link

onlydustapp bot commented Sep 26, 2024

Hi @Jemiiah!
Maintainers during the ODHack # 8.0 will be tracking applications via OnlyDust.
Therefore, in order for you to have a chance at being assigned to this issue, please apply directly here, or else your application may not be considered.

@anonfedora
Copy link

I am applying to this issue via OnlyDust platform.

My background and how it can be leveraged

I’m a blockchain developer with strong experience in building smart contracts and working with blockchain protocols. I’ve worked with technologies like Solidity, Cairo, and zero-knowledge proofs, which are at the core of systems like the Stone prover. I also have skills in Backend/Frontend web development using TypeScript, and ReactJS, NestJS, so I can document and explain complex setups in a way that makes sense.

How I plan on tackling this issue

With my background in zk-proof systems and experience in dApp development, I understand how to configure protocols to ensure security and efficiency. This means I can write documentation that’s not only clear but also practical for developers.

First, I’d do a deep dive into the Stone prover and FRI protocol to fully understand how the configuration file works and what the security settings are. From there, I’ll break down the documentation into three parts:

Creating the Config File – I’ll guide users through setting up the config file, explaining each option in a simple way, with recommended settings.

FRI Protocol Security Settings – I’ll break down the security options for the FRI protocol, like how to set up soundness and error correction, and explain what each setting does in terms of security.

Config File Format – I’ll provide the actual format of the config file (JSON or YAML), with explanations for each field and sample configurations to make things easy to follow.

Finally, I’ll test everything myself to make sure the instructions are correct and work in practice. By keeping it clear and straightforward, I’ll make sure the documentation is helpful for both beginners and experienced developers.

@CollinsC1O
Copy link
Contributor

I am applying to this issue via OnlyDust platform.

My background and how it can be leveraged

I am a front-end and also a blockchain developer with experience in technical writing and documentation

How I plan on tackling this issue

I can implement a very good documentation on the Stone configuration

@Jemiiah
Copy link
Contributor

Jemiiah commented Sep 26, 2024

I am applying to this issue via OnlyDust platform.

My background and how it can be leveraged

@dmirgaleev I would love to work on this issue when ODHack starts I have worked on about 6 different documentation issue on different repositories this is my OD Hack portfolio : https://app.onlydust.com/u/Jemiiah I have a very good track record on docs issues here are some of the repositories I have worked on:
Flex-NFT-Marketplace/Flex-Marketplace-Contract#106
dragan2234/worldcoin-scroll-bridge#13
dragan2234/worldcoin-scroll-bridge#11
NethermindEth/StarknetByExample#200

How I plan on tackling this issue

accurately and follow all instructions provided above

@LazarusAA
Copy link

LazarusAA commented Sep 27, 2024

I am applying to this issue via OnlyDust platform.

My background and how it can be leveraged

Hi, I'm Alvaro Lazarus a passionate blockchain developer with experience on Solidity, Cairo, Rust, TypeScript, Python and zero-knowledge proofs. I love working on clean documentations which makes me confident I can complete this issue perfectly, Id love for this to be my first contribution to the Stone-Packaging project.

How I plan on tackling this issue

  1. Research: Explore the Stone prover and FRI protocol to gain a solid understanding of the configuration file and its security settings.

  2. Documentation Structure: Break the documentation into three main parts:

  • Config File Creation: Offer a step-by-step guide for setting up the config file, with clear explanations and suggested settings.
  • FRI Protocol Security Options: Describe the security features of the FRI protocol, focusing on soundness and error correction.
  • File Format: Detail the format of the config file (JSON or YAML), including explanations for each field and examples.
  1. Verification: Test all instructions to confirm they are accurate and functional.

  2. Maintain Clarity: Ensure the documentation is easy to follow and accessible for developers of all skill levels.

@dmirgaleev
Copy link
Member Author

Hello @Jemiiah! Welcome aboard! Please don't hesitate to join our Telegram group https://t.me/baking_bad_odhack to ask questions and share your progress! Happy hacking!

@Jemiiah
Copy link
Contributor

Jemiiah commented Sep 27, 2024

thank you @dmirgaleev already in the group if I have any question won't hesitate to ask

@dmirgaleev
Copy link
Member Author

Hey @Jemiiah! Do you have any progress so far?

@Jemiiah
Copy link
Contributor

Jemiiah commented Oct 1, 2024

@dmirgaleev would be creating a PR today sorry for the delay

@dmirgaleev
Copy link
Member Author

Friendly heads up that you have until Sunday (October 6) to push your final PR. @Jemiiah

@Jemiiah
Copy link
Contributor

Jemiiah commented Oct 4, 2024

okay great sir

@dmirgaleev dmirgaleev linked a pull request Oct 6, 2024 that will close this issue
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
difficulty: hard documentation Improvements or additions to documentation good first issue Good for newcomers ODHack8
Projects
None yet
Development

Successfully merging a pull request may close this issue.

5 participants