Struct GCounter 

pub struct GCounter { /* private fields */ }

A Grow-only Counter (G-Counter)

Each node maintains its own count, total is the sum of all counts. Only supports increment operations.

Implementations

impl GCounter

pub fn new() -> Self

Create a new empty counter

pub fn value(&self) -> u64

Get the total count

pub fn increment(&mut self, node_id: &NodeId, amount: u64)

Increment the counter for a node

pub fn node_count(&self, node_id: &NodeId) -> u64

Get the count for a specific node

pub fn merge(&mut self, other: &GCounter)

Merge with another counter

Takes the max of each node’s count

pub fn node_count_total(&self) -> usize

Get the number of nodes that have contributed

pub fn entries(&self) -> impl Iterator<Item = (u32, u64)> + '_

Get all entries as (node_id, count) pairs

Returns an iterator over all nodes and their counts. Used for building delta documents.

pub fn encode(&self) -> Vec<u8>

Encode to bytes for transmission

pub fn decode(data: &[u8]) -> Option<Self>

Decode from bytes with validation

Security

Limits number of entries to prevent DoS via huge allocations. Skips zero node IDs.

Trait Implementations

impl Clone for GCounter

fn clone(&self) -> GCounter

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GCounter

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

Formats the value using the given formatter.

impl Default for GCounter

fn default() -> GCounter

Returns the “default value” for a type.