Dev Docs: Add Section About Headers-First IBD #736
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
* Add flowchart illustration to blocks-first section to match new headers-first flowchart * Add new headers-first initial block download (IBD) section * Revise Block Broadcasting section * Add paragraph about orphan block handling in headers-first to the Orphan Blocks section
| {% include helpers/subhead-links.md %} | ||
|
|
||
| {% autocrossref %} | ||
|
|
||
| At the start of a connection with a peer, both nodes send `getblocks` messages containing the hash of the latest known block. If a peer believes they have newer blocks or a longer chain, that peer will send an `inv` message which includes a list of up to 500 hashes of newer blocks, stating that it has the longer chain. The receiving node would then request these blocks using the command `getdata`, and the remote peer would reply via `block`<!--noref--> messages. After all 500 blocks have been processed, the node can request another set with `getblocks`, until the node is caught up with the network. Blocks are only accepted when validated by the receiving node. | ||
| Bitcoin Core 0.10.0 uses a initial block download (IBD) method called |
There was a problem hiding this comment.
@harding s/a initial/an initial/ maybe?
|
@harding Very clear, thanks! |
|
@saivann thanks! I fixed the typo you found. In the absence of critical feedback, this pull will be merged around 13:00 UTC Friday. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Preview: http://dg0.dtrt.org/en/developer-guide#headers-first
This adds a short section describing headers-first Initial Block Download (IBD) to the developer guide. This was originally part of pull #660, but it has been substansially rewritten. (And, I hope, improved.) Specifics: