Struct FederatedRound 

pub struct FederatedRound {
    pub round_num: usize,
    pub client_count: usize,
    pub global_model: Cid,
    pub aggregated_gradient: Option<Vec<f32>>,
    pub start_time: i64,
    pub end_time: Option<i64>,
    pub completed_count: usize,
    pub round_id: u32,
    pub expected_clients: Vec<String>,
    pub contributions: HashMap<String, Vec<f32>>,
    /* private fields */
}

Federated learning round.

Supports two construction modes:

• Legacy: FederatedRound::new(round_num, global_model, client_count)
• Session: FederatedRound::start(round_id, client_ids) + record_contribution + aggregate

Fields

round_num: usize

Round number

client_count: usize

Clients participating in this round (stored as count for serialization)

global_model: Cid

Global model CID for this round

aggregated_gradient: Option<Vec<f32>>

Aggregated gradient for this round (if computed)

start_time: i64

Round start timestamp

end_time: Option<i64>

Round end timestamp (if completed)

completed_count: usize

Completed client count

round_id: u32

Round ID (session mode)

expected_clients: Vec<String>

Expected client IDs (session mode)

contributions: HashMap<String, Vec<f32>>

Per-client gradient contributions (session mode)

Implementations

impl FederatedRound

pub fn new(round_num: usize, global_model: Cid, client_count: usize) -> Self

Create a new federated round (legacy mode).

pub fn mark_client_completed(&mut self)

Mark a client as completed (legacy mode).

pub fn is_complete(&self) -> bool

Check if round is complete (works in both modes).

pub fn complete(&mut self, aggregated_gradient: Vec<f32>)

Complete the round (legacy mode).

pub fn duration(&self) -> Option<i64>

Get round duration in seconds (legacy mode).

pub fn start(round_id: u32, client_ids: Vec<String>) -> Self

Start a new round with the given participating client IDs (session mode).

pub fn record_contribution(&mut self, client_id: &str, gradient: Vec<f32>)

Record a client’s gradient contribution (session mode).

pub fn aggregate( &self, dp: Option<&DifferentialPrivacy>, ) -> Result<Vec<f32>, FederatedError>

Aggregate all contributions using FedAvg, optionally applying DP noise.

pub fn stats(&self) -> RoundStats

Return statistics for this round.

Trait Implementations

impl Clone for FederatedRound

fn clone(&self) -> FederatedRound

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FederatedRound

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FederatedRound

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for FederatedRound

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.