tezos-shell 9.7 · OCaml Package

Block_validator_process is used to validate new blocks. This validation can be

internal: the same processus is used to run the node and to validate blocks
external: another processus is used to validate blocks This module also ensures the liveness of the operations (see Block_validation:check_liveness).

type validator_environment = {

genesis : Tezos_base.Genesis.t;
(*
genesis block of the current chain
*)
user_activated_upgrades : Tezos_base.User_activated.upgrades;
(*
user activated upgrades
*)
user_activated_protocol_overrides : Tezos_base.User_activated.protocol_overrides;
(*
user activated protocol overrides
*)

}

type validator_kind =

| Internal : Tezos_storage.Context.index -> validator_kind
| External : {
1. data_dir : string;
2. context_root : string;
3. protocol_root : string;
4. process_path : string;
5. sandbox_parameters : Data_encoding.json option;
} -> validator_kind

For performances reasons, it may be interesting to use another processus (from the OS) to validate blocks (External). However, in that case, only one processus has a write access to the context. Currently informations are exchanged via the file system.

type t

Internal representation of the block validator process

val init : 
  validator_environment ->
  validator_kind ->
  (t, Tezos_error_monad.TzCore.error list) Stdlib.result Lwt.t

val close : t -> unit Lwt.t

val restore_context_integrity : 
  t ->
  (int option, Tezos_error_monad.TzCore.error list) Stdlib.result Lwt.t

val apply_block : 
  t ->
  predecessor:State.Block.t ->
  Tezos_base.Block_header.t ->
  Tezos_base.Operation.t list list ->
  (Tezos_validation.Block_validation.result,
    Tezos_error_monad.TzCore.error list)
    Stdlib.result
    Lwt.t

apply_block bvp predecessor header os checks the liveness of the operations and then call Block_validation.apply

val commit_genesis : 
  t ->
  chain_id:Tezos_crypto.Chain_id.t ->
  (Tezos_crypto.Context_hash.t, Tezos_error_monad.TzCore.error list)
    Stdlib.result
    Lwt.t

val init_test_chain : 
  t ->
  State.Block.t ->
  (Tezos_base.Block_header.t, Tezos_error_monad.TzCore.error list)
    Stdlib.result
    Lwt.t

init_test_chain must only be called on a forking block.

package tezos-shell