Struct BandwidthProofState 

pub struct BandwidthProofState<S> {
    pub id: String,
    pub bytes_transferred: u64,
    pub latency_ms: u64,
    pub points: u64,
    pub rejection_reason: Option<String>,
    /* private fields */
}

Type-safe bandwidth proof with state machine enforcement.

Uses phantom types to ensure only valid state transitions are possible.

Example

use chie_shared::BandwidthProofState;
use chie_shared::proof_states::*;

// Create a new proof
let proof = BandwidthProofState::<Created>::new("proof123", 1024, 100);

// Submit for verification (changes state)
let submitted = proof.submit();

// Verify the proof (changes state again)
let verified = submitted.verify(true);

// Can't submit again - compile error!
// let error = verified.submit(); // Error: method not available for Verified state

Fields

id: String

Proof identifier

bytes_transferred: u64

Bytes transferred

latency_ms: u64

Latency in milliseconds

points: u64

Points awarded (only set in Verified state)

rejection_reason: Option<String>

Rejection reason (only set in Rejected state)

Implementations

impl BandwidthProofState<Created>

pub fn new( id: impl Into<String>, bytes_transferred: u64, latency_ms: u64, ) -> Self

Create a new bandwidth proof in Created state.

pub fn submit(self) -> BandwidthProofState<Submitted>

Submit the proof for verification (transition to Submitted state).

impl BandwidthProofState<Submitted>

pub fn verify( self, valid: bool, ) -> Result<BandwidthProofState<Verified>, BandwidthProofState<Rejected>>

Verify the proof (transition to Verified or Rejected state).

Errors

Returns BandwidthProofState<Rejected> if validation fails

impl BandwidthProofState<Verified>

pub fn awarded_points(&self) -> u64

Get the awarded points (only available in Verified state).

impl BandwidthProofState<Rejected>

pub fn reason(&self) -> &str

Get the rejection reason (only available in Rejected state).

Trait Implementations

impl<S: Clone> Clone for BandwidthProofState<S>

fn clone(&self) -> BandwidthProofState<S>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S: Debug> Debug for BandwidthProofState<S>

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

Formats the value using the given formatter.

impl<'de, S> Deserialize<'de> for BandwidthProofState<S>

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<S> Serialize for BandwidthProofState<S>

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

where __S: Serializer,

Serialize this value into the given Serde serializer.