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

add data availability docs #1995

Open
wants to merge 11 commits into
base: master
Choose a base branch
from
Open

add data availability docs #1995

wants to merge 11 commits into from

Conversation

Jason-W123
Copy link
Contributor

No description provided.

Copy link

vercel bot commented Jan 24, 2025

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

Name Status Preview Updated (UTC)
arbitrum-docs ✅ Ready (Inspect) Visit Preview Jan 25, 2025 4:36am


**Rollup Mode:** In this mode, all transaction data is included in either the calldata of transactions submitted to the Ethereum mainnet (the parent chain) or the blobs submitted by the transaction. This inclusion ensures that all data is readily available on-chain for anyone to download and verify.

**Anytrust Mode:** In Anytrust mode, transaction data initially gets submitted to a group of nodes known as the Data Availability Servers (DAS). The DAS stores and distributes the data. Instead of including the entire dataset on-chain, only a cryptographic proof (Data Availability Certificate, or DACert) is submitted to the parent chain. This proof significantly reduces the amount of data stored on-chain, reducing costs.
Copy link
Contributor

Choose a reason for hiding this comment

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

Does it make sense to say Data Availability Committee (DAC) instead? It involves the committee as a whole, instead of the individual servers.

Copy link
Contributor

Choose a reason for hiding this comment

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

Also, I'd say "only a cryptographic proof that the data has been stored by the DAC (Data Availability Certificate...)", so it is not confused with other types of proof.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Sorry, kind confused here, do you here mean DACert or DAC?

Copy link
Contributor

Choose a reason for hiding this comment

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

Oh, my comment is a bit confusing, you're right. I meant that the data is stored by the DAC, and the cryptographic proof is the Data Availability Certificate. So the text would read "only a cryptographic proof that the data has been stored by the DAC (Data Availability Certificate, or DACert)...". I think we've introduced the DAC before, so in this case we are just saying that the data is stored by the DAC, and they return the DACert, which is posted to the parent chain.
Let me know if it's clearer now. If not, maybe we can try to find a different way to describe the process 🙏


Because of those data availability mechanisms, Arbitrum Nitro nodes synchronize their data differently than Ethereum nodes or other layer-one network nodes. While Go-Ethereum nodes utilize a sophisticated P2P network to synchronize with the Ethereum blockchain by discovering other nodes, exchanging data, and participating in the consensus mechanism, Arbitrum nodes diverge from this traditional approach.

However, Arbitrum nodes do **not** primarily rely on a traditional peer-to-peer (P2P) mechanism for syncing their state as many other blockchains do.
Copy link
Contributor

Choose a reason for hiding this comment

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

I'd remove this paragraph. It doesn't add value to what has already been said, and it says that it somehow relies on a P2P mechanism (not primarily, but still...)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I add this paragraph is because I want to say arbitrum sync and process the data by a much more trustless way, but ya, I forget to add this word in, how do you think if we add trustless in this paragraph?

Copy link
Contributor

Choose a reason for hiding this comment

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

Maybe in the paragraph above that compares Ethereum to Arbitrum: "However, Arbitrum nodes do not primarily rely on a traditional peer-to-peer (P2P) mechanism for syncing their state as many other blockchains do."
What do you think?

Copy link
Contributor

@TucksonDev TucksonDev left a comment

Choose a reason for hiding this comment

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

This is a great page to have, thanks very much @Jason-W123 !!
I did a thorough review and requested some changes. Happy to discuss any of them! 🙏


Here's how Arbitrum data flow works:

1. Batching and submission:
Copy link
Contributor

Choose a reason for hiding this comment

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

For these lists below, I would change to:

  1. asdf
    a. asdf
    i.

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.

3 participants