package tezos-protocol-004-Pt24m4xi

You can search for identifiers within the package.

in-package search v0.2.0

On This Page

Random Generation
Predefined seeds
Entropy
Predefined nonce
Serializers

tezos-protocol-004-Pt24m4xi
- Tezos_protocol_004_Pt24m4xi
  - Protocol
tezos-protocol-004-Pt24m4xi.environment
- Tezos_protocol_environment_004_Pt24m4xi
  - Environment
    
    Base58
    
    Blake2B
    
    Make
    
    Map
    
    Name
    
    Register
    
    Set
    
    Make_minimal
    
    Name
    
    Name
    
    PrefixedName
    
    Block_hash
    
    Map
    
    Set
    
    Block_header
    
    CamlinternalFormatBasics
    
    Chain_id
    
    Map
    
    Set
    
    Compare
    
    Bool
    
    COMPARABLE
    
    Char
    
    Float
    
    Int
    
    Int32
    
    Int64
    
    List
    
    P
    
    Make
    
    P
    
    Option
    
    P
    
    S
    
    String
    
    Uint32
    
    Uint64
    
    Z
    
    Context
    
    Context_hash
    
    Map
    
    Set
    
    Data_encoding
    
    Binary
    
    Bounded
    
    Fixed
    
    Json
    
    Variable
    
    Ed25519
    
    Public_key
    
    Public_key_hash
    
    Map
    
    Set
    
    Error_monad
    
    Fitness
    
    Format
    
    Int32
    
    Int64
    
    Lift
    
    P
    
    List
    
    Logging
    
    Lwt
    
    Lwt_list
    
    MBytes
    
    LE
    
    Map
    
    Make
    
    Ord
    
    OrderedType
    
    Micheline
    
    Name
    
    Operation
    
    Operation_hash
    
    Map
    
    Set
    
    Operation_list_hash
    
    Map
    
    Set
    
    Operation_list_list_hash
    
    Map
    
    Set
    
    Option
    
    P256
    
    Public_key
    
    Public_key_hash
    
    Map
    
    Set
    
    Pervasives
    
    Protocol
    
    Protocol_hash
    
    Map
    
    Set
    
    RPC_answer
    
    RPC_arg
    
    RPC_context
    
    simple
    
    RPC_directory
    
    RPC_path
    
    RPC_query
    
    RPC_service
    
    Raw_hashes
    
    S
    
    B58_DATA
    
    ENCODER
    
    HASH
    
    Map
    
    Set
    
    HASHABLE
    
    INDEXES
    
    Map
    
    Set
    
    MAP
    
    MERKLE_TREE
    
    Map
    
    Set
    
    MINIMAL_HASH
    
    RAW_DATA
    
    SET
    
    SIGNATURE
    
    Public_key
    
    Public_key_hash
    
    Map
    
    Set
    
    T
    
    Secp256k1
    
    Public_key
    
    Public_key_hash
    
    Map
    
    Set
    
    Set
    
    Make
    
    Ord
    
    OrderedType
    
    Signature
    
    Public_key
    
    Public_key_hash
    
    Map
    
    Set
    
    String
    
    LE
    
    Time
    
    Updater
    
    PROTOCOL
    
    Z
    
    proto_rpc_context
    
    proto_rpc_context_of_directory
tezos-protocol-004-Pt24m4xi.raw
- Tezos_raw_protocol_004_Pt24m4xi
  - Alpha_context
    
    BASIC_DATA
    
    Block_header
    
    Bootstrap
    
    Commitment
    
    Constants
    
    Contract
    
    Big_map
    
    Cycle
    
    Map
    
    Delegate
    
    Fees
    
    Fitness
    
    Gas
    
    Global
    
    Kind
    
    Level
    
    Nonce
    
    Operation
    
    Encoding
    
    Manager_operations
    
    Period
    
    Raw_level
    
    Roll
    
    Script
    
    Script_int
    
    Script_timestamp
    
    Seed
    
    Tez
    
    Timestamp
    
    Vote
    
    Voting_period
  - Alpha_services
    
    Nonce
    
    Seed
  - Amendment
  - Apply
  - Apply_results
  - Baking
  - Blinded_public_key_hash
    
    Index
    
    Map
    
    Set
  - Block_header_repr
  - Bootstrap_storage
  - Commitment_repr
  - Commitment_storage
  - Constants_repr
  - Constants_services
  - Constants_storage
  - Contract_hash
    
    Map
    
    Set
  - Contract_repr
    
    Index
  - Contract_services
  - Contract_storage
    
    Big_map
  - Cycle_repr
    
    Index
    
    Map
  - Delegate_services
    
    Baking_rights
    
    Endorsing_rights
  - Delegate_storage
  - Fees_storage
  - Fitness_repr
  - Fitness_storage
  - Gas_limit_repr
  - Helpers_services
    
    Forge
    
    Manager
    
    Parse
    
    Scripts
  - Init_storage
  - Level_repr
  - Level_storage
  - Main
  - Manager_repr
  - Michelson_v1_gas
    
    Cost_of
    
    Typechecking
    
    Unparse
  - Michelson_v1_primitives
  - Misc
  - Nonce_hash
    
    Map
    
    Set
  - Nonce_storage
  - Operation_repr
    
    Encoding
    
    Manager_operations
    
    Kind
  - Parameters_repr
    
    Proto_003
  - Period_repr
  - Qty_repr
    
    Make
    
    T
    
    QTY
    
    S
  - Raw_context
    
    T
  - Raw_level_repr
    
    Index
  - Roll_repr
    
    Index
  - Roll_storage
    
    Contract
    
    Delegate
  - Script_expr_hash
    
    Map
    
    Set
  - Script_int_repr
  - Script_interpreter
  - Script_ir_annot
  - Script_ir_translator
  - Script_repr
  - Script_tc_errors
  - Script_tc_errors_registration
  - Script_timestamp_repr
  - Script_typed_ir
    
    Boxed_map
    
    OPS
    
    Boxed_set
    
    OPS
  - Seed_repr
  - Seed_storage
  - Services_registration
  - State_hash
    
    Map
    
    Set
  - Storage
    
    Active_delegates_with_rolls
    
    Commitments
    
    Contract
    
    Balance
    
    Big_map
    
    Code
    
    Counter
    
    Delegatable
    
    Delegate
    
    Delegate_desactivation
    
    Delegated
    
    Frozen_deposits
    
    Frozen_fees
    
    Frozen_rewards
    
    Global_counter
    
    Inactive_delegate
    
    Manager
    
    Paid_storage_space
    
    Spendable
    
    Storage
    
    Used_storage_space
    
    Delegates
    
    Delegates_with_frozen_balance
    
    Last_block_priority
    
    Ramp_up
    
    Rewards
    
    Security_deposits
    
    Roll
    
    Delegate_change
    
    Delegate_roll_list
    
    Last_for_snapshot
    
    Limbo
    
    Next
    
    Owner
    
    Snapshot
    
    Snapshot_for_cycle
    
    Successor
    
    Seed
    
    For_cycle
    
    Nonce
    
    Vote
    
    Ballots
    
    Current_period_kind
    
    Current_proposal
    
    Current_quorum
    
    Listings
    
    Listings_size
    
    Proposals
    
    Proposals_count
  - Storage_description
    
    INDEX
  - Storage_functors
    
    INDEX
    
    Make_data_set_storage
    
    C
    
    I
    
    Make_indexed_carbonated_data_storage
    
    C
    
    I
    
    V
    
    Make_indexed_data_snapshotable_storage
    
    C
    
    I
    
    Snapshot
    
    V
    
    Make_indexed_data_storage
    
    C
    
    I
    
    V
    
    Make_indexed_subcontext
    
    C
    
    I
    
    Make_carbonated_map
    
    N
    
    V
    
    Make_map
    
    N
    
    V
    
    Make_set
    
    N
    
    Raw_context
    
    Make_single_data_storage
    
    C
    
    N
    
    V
    
    Make_subcontext
    
    C
    
    N
    
    Pair
    
    I1
    
    I2
    
    Wrap_indexed_data_storage
    
    C
    
    K
  - Storage_sigs
    
    Data_set_storage
    
    Indexed_data_snapshotable_storage
    
    Snapshot
    
    Indexed_data_storage
    
    Indexed_raw_context
    
    Make_carbonated_map
    
    N
    
    V
    
    Make_map
    
    N
    
    V
    
    Make_set
    
    N
    
    Raw_context
    
    NAME
    
    Non_iterable_indexed_carbonated_data_storage
    
    Non_iterable_indexed_data_storage
    
    Single_carbonated_data_storage
    
    Single_data_storage
    
    VALUE
  - Tez_repr
  - Time_repr
  - Vote_repr
  - Vote_storage
  - Voting_period_repr
  - Voting_services

Legend:
Library
Module
Module type
Parameter
Class
Class type

Tezos Protocol Implementation - Random number generation

This is not expected to be a good cryptographic random number generator. In particular this is supposed to be used in situations where the seed is a globaly known information.

The only expected property is: It should be difficult to find a seed such that the generated sequence is a given one.

Random Generation

***************************************************

type t

The state of the random number generator

type seed

A random seed, to derive random sequences from

type sequence

A random sequence, to derive random values from

val initialize_new : 
  seed ->
  Tezos_protocol_environment_structs.V0.M.MBytes.t list ->
  t

initialize_new state ident returns a new generator

val sequence : t -> int32 -> sequence

sequence state n prepares the n-th sequence of a state

val take : 
  sequence ->
  Tezos_protocol_environment_structs.V0.M.MBytes.t * sequence

Generates the next random value in the sequence

val take_int32 : sequence -> int32 -> int32 * sequence

Generates the next random value as a bounded int32

Predefined seeds

****************************************************

val empty : seed

val deterministic_seed : seed -> seed

Returns a new seed by hashing the one passed with a constant.

val initial_seeds : int -> seed list

intial_seeds n generates the first n seeds for which there are no nonces. The first seed is a constant value. The kth seed is the hash of seed (k-1) concatenated with a constant.

Entropy

*************************************************************

type nonce

A nonce for adding entropy to the generator

val nonce : seed -> nonce -> seed

Add entropy to the seed generator

val make_nonce : 
  Tezos_protocol_environment_structs.V0.M.MBytes.t ->
  (nonce,
    Tezos_protocol_environment_004_Pt24m4xi__Environment.Error_monad.error list)
    Stdlib.result

Use a byte sequence as a nonce

val hash : nonce -> Nonce_hash.t

Compute the has of a nonce

val check_hash : nonce -> Nonce_hash.t -> bool

check_hash nonce hash is true if the nonce correspond to the hash

val nonce_hash_key_part : Nonce_hash.t -> string list -> string list

For using nonce hashes as keys in the hierarchical database

Predefined nonce

****************************************************

val initial_nonce_0 : nonce

val initial_nonce_hash_0 : Nonce_hash.t

Serializers

*********************************************************

val nonce_encoding : nonce Tezos_base__TzPervasives.Data_encoding.t

val seed_encoding : seed Tezos_base__TzPervasives.Data_encoding.t