mirror of
https://github.com/serai-dex/serai.git
synced 2025-12-11 13:39:25 +00:00
47f8766da6
Provides a DST, and associated metadata as beneficial. Also utilizes MuSig's context to session-bind. Since set_keys_messages also binds to set, this is semi-redundant, yet that's appreciated.
79 lines
2.6 KiB
Rust
79 lines
2.6 KiB
Rust
#![cfg_attr(not(feature = "std"), no_std)]
|
|
|
|
#[cfg(feature = "std")]
|
|
use zeroize::Zeroize;
|
|
|
|
#[cfg(feature = "std")]
|
|
use serde::{Serialize, Deserialize};
|
|
|
|
use ciphersuite::{group::GroupEncoding, Ciphersuite, Ristretto};
|
|
|
|
use scale::{Encode, Decode, MaxEncodedLen};
|
|
use scale_info::TypeInfo;
|
|
|
|
use sp_core::{ConstU32, sr25519::Public, bounded::BoundedVec};
|
|
#[cfg(not(feature = "std"))]
|
|
use sp_std::vec::Vec;
|
|
|
|
use serai_primitives::{NetworkId, Network, Amount};
|
|
|
|
// Support keys up to 96 bytes (BLS12-381 G2).
|
|
const MAX_KEY_LEN: u32 = 96;
|
|
|
|
/// The type used to identify a specific session of validators.
|
|
#[derive(Clone, Copy, PartialEq, Eq, Hash, Debug, Encode, Decode, TypeInfo, MaxEncodedLen)]
|
|
#[cfg_attr(feature = "std", derive(Zeroize, Serialize, Deserialize))]
|
|
pub struct Session(pub u32);
|
|
|
|
/// The type used to identify a specific validator set during a specific session.
|
|
#[derive(Clone, Copy, PartialEq, Eq, Hash, Debug, Encode, Decode, TypeInfo, MaxEncodedLen)]
|
|
#[cfg_attr(feature = "std", derive(Zeroize, Serialize, Deserialize))]
|
|
pub struct ValidatorSet {
|
|
pub session: Session,
|
|
pub network: NetworkId,
|
|
}
|
|
|
|
/// The data for a validator set.
|
|
#[derive(Clone, PartialEq, Eq, Debug, Encode, Decode, TypeInfo, MaxEncodedLen)]
|
|
pub struct ValidatorSetData {
|
|
pub bond: Amount,
|
|
pub network: Network,
|
|
|
|
// Participant and their amount bonded to this set
|
|
// Limit each set to 100 participants for now
|
|
pub participants: BoundedVec<(Public, Amount), ConstU32<100>>,
|
|
}
|
|
|
|
type MaxKeyLen = ConstU32<MAX_KEY_LEN>;
|
|
/// The type representing a Key from an external network.
|
|
pub type ExternalKey = BoundedVec<u8, MaxKeyLen>;
|
|
|
|
/// The key pair for a validator set.
|
|
///
|
|
/// This is their Ristretto key, used for signing Batches, and their key on the external network.
|
|
pub type KeyPair = (Public, ExternalKey);
|
|
|
|
/// The MuSig context for a validator set.
|
|
pub fn musig_context(set: ValidatorSet) -> Vec<u8> {
|
|
[b"ValidatorSets-musig_key".as_ref(), &set.encode()].concat()
|
|
}
|
|
|
|
/// The MuSig public key for a validator set.
|
|
///
|
|
/// This function panics on invalid input.
|
|
pub fn musig_key(set: ValidatorSet, set_keys: &[Public]) -> Public {
|
|
let mut keys = Vec::new();
|
|
for key in set_keys {
|
|
keys.push(
|
|
<Ristretto as Ciphersuite>::read_G::<&[u8]>(&mut key.0.as_ref())
|
|
.expect("invalid participant"),
|
|
);
|
|
}
|
|
Public(dkg::musig::musig_key::<Ristretto>(&musig_context(set), &keys).unwrap().to_bytes())
|
|
}
|
|
|
|
/// The message for the set_keys signature.
|
|
pub fn set_keys_message(set: &ValidatorSet, key_pair: &KeyPair) -> Vec<u8> {
|
|
[b"ValidatorSets-key_pair".as_ref(), &(set, key_pair).encode()].concat()
|
|
}
|