Struct RingtailConsensus 

pub struct RingtailConsensus { /* private fields */ }

Ringtail-compatible consensus for ZAP agents

Implements threshold lattice-based signing with the following protocol:

1. Setup: Trusted dealer generates secret shares and MAC keys
2. Round 1: Each party generates commitment D_i and MACs
3. Round 2: Verify MACs, compute response share z_i
4. Finalize: Combiner aggregates into signature (c, z, Delta)

Implementations

impl RingtailConsensus

pub fn new(party_id: usize, parties: usize, threshold: usize) -> Self

Create a new Ringtail consensus party

pub fn party_id(&self) -> usize

Get party ID

pub fn parties(&self) -> usize

Get total parties

pub fn threshold(&self) -> usize

Get threshold

pub fn has_quorum(&self) -> bool

Check if connected to minimum peers for signing

pub fn set_sk_share(&mut self, sk_share: PolyVector)

Set secret key share from trusted dealer

pub fn set_mac_keys(&mut self, keys: HashMap<usize, [u8; 32]>)

Set MAC keys for peer authentication

pub fn set_seeds(&mut self, seeds: HashMap<usize, Vec<[u8; 32]>>)

Set PRF seeds

pub fn set_public_params(&mut self, a: PolyMatrix, b: PolyVector)

Set public parameters

pub fn set_lambda(&mut self, lambda: Poly)

Set Lagrange coefficient

pub async fn connect_peers(&mut self, addresses: Vec<String>) -> Result<()>

Connect to peer network

pub async fn disconnect(&mut self)

Disconnect from peers

pub async fn sign_round1(&mut self, message: &[u8]) -> Result<Round1Output>

Sign Round 1 - Generate commitment matrix D and MACs

Computes D_i = A * R_i + E_i where R_i, E_i are Gaussian-sampled

pub async fn sign_round2( &self, round1_outputs: Vec<Round1Output>, ) -> Result<Round2Output>

Sign Round 2 - Verify MACs, compute response share

Verifies all received MACs and computes z_i = R_i * u + s_i * c * lambda_i - mask

pub async fn finalize( &self, round2_outputs: Vec<Round2Output>, ) -> Result<RingtailSignature>

Finalize - Combine shares into final signature (combiner only)

Aggregates all z_i shares and computes Delta correction

pub fn verify( message: &[u8], signature: &RingtailSignature, public_key: &[u8], ) -> bool

Verify a Ringtail signature

Checks: c = LowNormHash(A, b, h) where h = Az - bc + Delta