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

Extend Documentation #180

Open
6 tasks
aszepieniec opened this issue Feb 15, 2023 · 1 comment
Open
6 tasks

Extend Documentation #180

aszepieniec opened this issue Feb 15, 2023 · 1 comment
Labels
💫 good first issue Good for newcomers 🧑‍🤝‍🧑 help wanted Need some help 🟡 prio: medium Not super urgent 📜 specification Relates to the specification

Comments

@aszepieniec
Copy link
Collaborator

Currently, the specification specifies the instruction set architecture and how to arithmetize it. However, it assumes the reader is familiar with BrainSTARK and that this architecture fits into a more or less standard STARK engine (whatever that means). In my opinion, what's missing is documentation for the other components of Triton VM. In no particular order or hierarchy:

  • The mechanics of the STARK prover and verifier.
  • Tweakable and non-tweakable parameters, such as FRI expansion factor.
  • The hash function (soon to be Tip5).
  • Where zero-knowledge comes from.
  • Where soundness comes from.
  • How to use Triton VM in other, non-Neptune, contexts.

Feel free to add to this list.

@jan-ferdinand jan-ferdinand added 🧑‍🤝‍🧑 help wanted Need some help 📜 specification Relates to the specification 💫 good first issue Good for newcomers 🟡 prio: medium Not super urgent labels Feb 15, 2023
@jan-ferdinand
Copy link
Member

I'm marking this as a good first issue: explaining something is an excellent way of learning the thing. Contributions, even partial ones, to any of the above items are welcome.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
💫 good first issue Good for newcomers 🧑‍🤝‍🧑 help wanted Need some help 🟡 prio: medium Not super urgent 📜 specification Relates to the specification
Projects
None yet
Development

No branches or pull requests

2 participants