package octez-shell-libs

  1. Overview
  2. Docs
On This Page
  1. Bootstrapping
Octez shell libraries

Install 

dune-project
 Dependency

www.tezos.com Readme Edit opam file Versions (5)

Authors

  1. T
    Tezos devteam

Maintainers

  1. C
    contact@tezos.com

Sources

octez-19.0.tar.gz
sha256=c6df840ebbf115e454db949028c595bec558a59a66cade73b52a6d099d6fa4d4
sha512=d8aee903b9fe130d73176bc8ec38b78c9ff65317da3cb4f3415f09af0c625b4384e7498201fdb61aa39086a7d5d409d0ab3423f9bc3ab989a680cf444a79bc13

doc/octez-shell-libs.shell/Tezos_shell/Synchronisation_heuristic/Bootstrapping/index.html

Module Synchronisation_heuristic.BootstrappingSource

Bootstrapping

This module inherits from Core and handle a bootstrapped flag as well as Lwt callbacks when the status of heuristic or the bootstrap flag changes.

The bootstrap flag is set to true in two cases:

  • When the core heuristic status is Synchronised for the first time
  • When force_bootstrapped state b is called with b = true

Only the function force_bootstrapped can set the boolean flag to false.

Sourcetype t
Sourceval create : ?when_bootstrapped_changes:(bool -> unit Lwt.t) -> ?when_status_changes:(status -> unit Lwt.t) -> threshold:int -> latency:int -> unit -> t

create ?when_bootstrapped_changes ?when_status_changes ~threshold ~latency () is a wrapper around Core.create ~threshold ~latency ().

  • when_status_changes is a callback called immediately when the status changes (as a result of some calls to update) and when the status is first set (as a result of calling activate).
  • when_bootstrapped_changes is a callback called immediately when the bootstrap flagged changes (as a result of some calls to update or to force_bootstrapped) or when the flag is first set (as a result of calling activate).
Sourceval activate : t -> unit Lwt.t

activate state activates the heuristics. It sets the status and the bootstrap flag to their initial values (which depend on the initial value of threshold) and calls the when_status_changes and when_bootstrapped_changes callbacks with these initial values.

This function is intended to be used once, after the call to create and before the first call to update.

update state candidate is a wrapper around Core.update. If an update changes the status of the core heuristic, the when_status_changes callback is called. Similarly, if an update changes the bootstrap flag, the when_bootstrapped_changes callback is called.

Sourceval get_status : t -> status

get_status state is a wrapper around Core.get_status.

Sourceval is_bootstrapped : t -> bool

is_bootstrapped state returns the value of the bootstrap flag.

Sourceval force_bootstrapped : t -> bool -> unit Lwt.t

force_bootstrapped state b forces the status of the bootstrap flag. If the value of the flag changes as a result, the callback when_bootstrapped_changes is called.

Sourceval bootstrapped : t -> unit Lwt.t

bootstrapped state is a promise that becomes fulfilled when the current bootstrap flag becomes true. If the bootstrap flag is already true, the promise is already resolved.