package octez-shell-libs
Install
Dune Dependency
Authors
Maintainers
Sources
sha256=dbc3b675aee59c2c574e5d0a771193a2ecfca31e7a5bc5aed66598080596ce1c
sha512=b97ed762b9d24744305c358af0d20f394376b64bfdd758dd4a81775326caf445caa57c4f6445da3dd6468ff492de18e4c14af6f374dfcbb7e4d64b7b720e5e2a
doc/octez-shell-libs.shell/Tezos_shell/Bootstrap_pipeline/index.html
Module Tezos_shell.Bootstrap_pipelineSource
The bootstrap pipeline works as follows: 1. From a locator, it computes a list of subchains (identified by a Block_locator.step) to fetch. 2. A worker starts to fetch all the headers (top to bottom) from a subchain, starting with the top subchain. 3. A worker starts to download the list of operations by batch of blocks once a batch of headers is available. 4. A worker validates blocks one by one (bottom to top).
These three workers work concurrently.
val create :
?notify_new_block:(Block_validator.new_block -> unit) ->
block_header_timeout:Tezos_base.Time.System.Span.t ->
block_operations_timeout:Tezos_base.Time.System.Span.t ->
Block_validator.t ->
Tezos_base.P2p_peer.Id.t ->
Distributed_db.chain_db ->
Tezos_base.Block_locator.t ->
tcreate ?notify_new_block ~block_header_timeout ~block_operations_timeout validator peer ddb locator initializes a bootstrap_pipeline for a locator sent by peer. It uses the Distributed_db to fetch the data needed and validator to validate blocks one by one with the function Block_validator.validate.
Moreover:
notify_new_blockis a called everytime a valid block is received.block_header_timeoutis the timeout to fetch ablock_header.block_operations_timeoutis the timeout to fetch a block operation.
If a timeout is triggered, the whole bootstrap_pipeline is canceled.
length pipeline returns the number of the headers and blocks fetched