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

refactor(docs): update the consensus page #5636

Open
wants to merge 2 commits into
base: develop
Choose a base branch
from

Conversation

Ginowine
Copy link
Contributor

Description of change

This PR will update the consensus page on docs.

Links to any relevant issues

fixes #5578

Type of change

  • Documentation Fix

How the change has been tested

Preview test passed locally.

Change checklist

  • I have followed the contribution guidelines for this project
  • I have performed a self-review of my own code
  • I have added tests that prove my fix is effective or that my feature works

@Ginowine Ginowine added documentation Improvements or additions to documentation devx Issues related to the DevX team labels Feb 26, 2025
Copy link

vercel bot commented Feb 26, 2025

The latest updates on your projects. Learn more about Vercel for Git ↗︎

4 Skipped Deployments
Name Status Preview Comments Updated (UTC)
apps-backend ⬜️ Ignored (Inspect) Feb 26, 2025 2:57pm
apps-ui-kit ⬜️ Ignored (Inspect) Feb 26, 2025 2:57pm
rebased-explorer ⬜️ Ignored (Inspect) Feb 26, 2025 2:57pm
wallet-dashboard ⬜️ Ignored (Inspect) Feb 26, 2025 2:57pm

@Ginowine Ginowine marked this pull request as ready for review February 27, 2025 09:30
@Ginowine Ginowine requested a review from a team as a code owner February 27, 2025 09:30
Copy link
Contributor

✅ Vercel Preview Deployment is ready!

View Preview

IOTA employs Delegated Proof-of-Stake (dPoS) as the overarching consensus mechanism. In this model:

- Token holders delegate their voting power to validators.
- Validators participate in block production and execute the Mysticeti protocol to finalize transactions.
Copy link
Contributor

Choose a reason for hiding this comment

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

Add staking rewards as the main incentive for validators behaving honestly.

- The commit rule also tolerates unavailable leaders without significantly increasing the commit latencies.
- Users submit transactions to validators.
- Validators execute the Mysticeti protocol to reach agreement on the order and finalization of transactions.
- The result is a consistently ordered ledger that is agreed upon by an honest majority of validators.
Copy link
Contributor

Choose a reason for hiding this comment

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

Weak arguments for this list. The first two items describe how consensus works, the last item is the actual protocol feature/guarantee. Maybe we should shift focus to features such as: lower latency, higher throughput, faster finality, more energy-efficient (compared to PoW), etc. Or, if we want to talk about protocol security guarantees, then we should be more formal: security, scalability, decentralization and how and why it resists known attacks/issues. Otherwise, this list is non-informative and confusing.


The Mysticeti protocol is a leaderless BFT protocol optimized for low-latency and high-throughput using an uncertified DAG structure. It is designed to facilitate efficient and parallel transaction processing while maintaining strong security guarantees.

### Key features of Mysticeti include:
Copy link
Contributor

Choose a reason for hiding this comment

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

Remove include: from the header.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
devx Issues related to the DevX team documentation Improvements or additions to documentation
Projects
Status: Product Backlog
Development

Successfully merging this pull request may close these issues.

[docs] Review: consensus
2 participants