tezt-tezos 17.3 · OCaml Package

Spawn Data-availability-layer (DAL) nodes and control them

type t

DAL Node state

Creates a DAL node

val create : 
  ?path:string ->
  ?name:string ->
  ?color:Tezt.Log.Color.t ->
  ?data_dir:string ->
  ?event_pipe:string ->
  ?rpc_host:string ->
  ?rpc_port:int ->
  ?listen_addr:string ->
  node:Node.t ->
  client:Client.t ->
  unit ->
  t

val name : t -> string

Get the name of an dal node.

val rpc_host : t -> string

Get the RPC host given as --rpc-addr to an dal node.

val rpc_port : t -> int

Get the RPC port given as --rpc-addr to an dal node.

val endpoint : t -> string

Return the endpoint of the dal node, i.e., http://rpc_host:rpc_port.

val data_dir : t -> string

Get the data-dir of an dal node.

val run : 
  ?wait_ready:bool ->
  ?env:string Tezt.Base.String_map.t ->
  t ->
  unit Lwt.t

run ?wait_ready ?env node launches the given dal node where env is a map of environment variable.

If wait_ready is true, the promise waits for the dal node to be ready. true by default.

val terminate : ?timeout:float -> t -> unit Lwt.t

Send SIGTERM and wait for the process to terminate.

Default timeout is 30 seconds, after which SIGKILL is sent.

val kill : t -> unit Lwt.t

Send SIGKILL and wait for the process to terminate.

val log_events : t -> unit

Shows in stdout every events sent by the node

val wait_for : 
  ?where:string ->
  t ->
  string ->
  (Tezt.JSON.t -> 'a option) ->
  'a Lwt.t

See Daemon.Make.wait_for.

val is_running_not_ready : t -> bool

is_running_not_ready dal_node returns true if the given node is running but its status is not ready

val wait : t -> Unix.process_status Lwt.t

Wait until a node terminates and return its status. If the node is not running, make the test fail.

val init_config : ?use_unsafe_srs:bool -> t -> string Lwt.t

Run octez-dal-node init-config. Returns the name of the resulting configuration file.

If use_unsafe_srs is true, the dal node runs with unsafe computed SRS allowing tests to run faster, without the need of large file. Default is true in tezt.

module Config_file : sig ... end

DAL node configuration files.

package tezt-tezos