package octez-libs

  1. Overview
  2. Docs
Legend:
Page
Library
Module
Module type
Parameter
Class
Class type
Source

Module Bls12_381_signature.MinSigSource

BLS signatures instantiation minimizing the size of the signatures (48 bytes) but use longer public keys (96 bytes).

Sourcetype pk

Type of the public keys

Sourceval pk_size_in_bytes : int

The size of a serialized value pk

Sourceval unsafe_pk_of_bytes : Bytes.t -> pk

Build a value of type pk without performing any check on the input (hence the unsafe prefix because it might not give a correct inhabitant of the type pk). It is safe to use this function when verifying a signature as the signature function verifies if the point is in the prime subgroup. Using unsafe_pk_of_bytes removes a verification performed twice when used pk_of_bytes_exn or pk_of_bytes_opt.

The expected bytes format are the compressed form of a point on G2.

Sourceval pk_of_bytes_exn : Bytes.t -> pk

Build a value of type pk safely, i.e. the function checks the bytes given in parameters represents a point on the curve and in the prime subgroup. Raise Invalid_argument if the bytes are not in the correct format or does not represent a point in the prime subgroup.

The expected bytes format are the compressed form of a point on G2.

Sourceval pk_of_bytes_opt : Bytes.t -> pk option

Build a value of type pk safely, i.e. the function checks the bytes given in parameters represents a point on the curve and in the prime subgroup. Return None if the bytes are not in the correct format or does not represent a point in the prime subgroup.

The expected bytes format are the compressed form of a point on G2.

Sourceval pk_to_bytes : pk -> Bytes.t

Returns a bytes representation of a value of type pk. The output is the compressed form of the point Bls12_381.Bls12_381.G2.t the pk represents.

Sourceval derive_pk : sk -> pk

derive_pk sk derives the corresponding public key of sk.

Sourcetype signature

Type of the signatures

Sourceval signature_size_in_bytes : int

The size of a serialized value signature

Sourceval unsafe_signature_of_bytes : Bytes.t -> signature

Build a value of type signature without performing any check on the input (hence the unsafe prefix because it might not give a correct inhabitant of the type signature). It is safe to use this function when verifying a signature as the signature function verifies if the point is in the prime subgroup. Using unsafe_signature_of_bytes removes a verification performed twice when used signature_of_bytes_exn or signature_of_bytes_opt.

The expected bytes format are the compressed form of a point on G1.

Sourceval signature_of_bytes_exn : Bytes.t -> signature

Build a value of type signature safely, i.e. the function checks the bytes given in parameters represents a point on the curve and in the prime subgroup. Raise Invalid_argument if the bytes are not in the correct format or does not represent a point in the prime subgroup.

The expected bytes format are the compressed form of a point on G1.

Sourceval signature_of_bytes_opt : Bytes.t -> signature option

Build a value of type signature safely, i.e. the function checks the bytes given in parameters represents a point on the curve and in the prime subgroup. Return None if the bytes are not in the correct format or does not represent a point in the prime subgroup.

The expected bytes format are the compressed form of a point on G1.

Sourceval signature_to_bytes : signature -> Bytes.t

Returns a bytes representation of a value of type signature. The output is the compressed form a the point Bls12_381.G1.t the signature represents.

Sourceval aggregate_signature_opt : signature list -> signature option

aggregate_signature_opt signatures aggregates the signatures signatures, following section 2.8. Return None if INVALID is expected in the specification

Sourcemodule Basic : sig ... end

Basic scheme described in section 3.1

Sourcemodule Aug : sig ... end

Augmentation scheme described in section 3.2

Sourcemodule Pop : sig ... end

Follow section 3.3.

OCaml

Innovation. Community. Security.