Files
serai/coordinator
Luke Parker 90bc364f9f Replace Ciphersuite::hash_to_F
The prior-present `Ciphersuite::hash_to_F` was a sin. Implementations took a
DST, yet were not require to securely handle it. It was also biased towards the
requirements of `modular-frost` as `ciphersuite` was originally written all
those years ago, when `modular-frost` had needs exceeding what `ff`, `group`
satisfied.

Now, the hash is bound to produce an output which can be converted to a scalar
with `ff::FromUniformBytes`. A new `hash_to_F`, which accepts a single argument
of the value to hash (removing the potential to insecurely handle the DST by
removing the DST entirely). Due to `digest` yielding a `GenericArray`, yet
`FromUniformBytes` taking a `const usize`, the `ciphersuite` crate now defines
a `FromUniformBytes` trait taking an array (then implemented for all satisfiers
of `ff::FromUniformBytes`). In order to get the array type from the
`GenericArray`, the output of the hash, `digest` is updated to the `0.11`
release candidate which moves to `flexible-array` which solves that problem.

The existing, specific `hash_to_F` functions have been moved to `modular-frost`
as necessary.

`flexible-array` itself is patched to a fork due to
https://github.com/RustCrypto/hybrid-array/issues/131.
2025-08-29 05:21:43 -04:00
..
2025-08-26 14:13:00 -04:00
2025-08-26 14:13:00 -04:00
2025-08-25 09:17:29 -04:00
2025-08-26 14:13:00 -04:00
2025-01-11 05:13:43 -05:00

Coordinator

  • tendermint is an implementation of the Tendermint BFT algorithm.

  • tributary-sdk is a micro-blockchain framework. Instead of a producing a blockchain daemon like the Polkadot SDK or Cosmos SDK intend to, tributary is solely intended to be an embedded asynchronous task within an application.

    The Serai coordinator spawns a tributary for each validator set it's coordinating. This allows the participating validators to communicate in a byzantine-fault-tolerant manner (relying on Tendermint for consensus).

  • cosign contains a library to decide which Substrate blocks should be cosigned and to evaluate cosigns.

  • substrate contains a library to index the Substrate blockchain and handle its events.

  • tributary is our instantiation of the Tributary SDK for the Serai processor. It includes the Transaction definition and deferred execution logic.

  • p2p is our abstract P2P API to service the Coordinator.

  • libp2p is our libp2p-backed implementation of the P2P API.

  • src contains the source code for the Coordinator binary itself.