Struct EvidenceExportV1 

pub struct EvidenceExportV1 {
    pub schema: String,
    pub from: String,
    pub to: String,
    pub rows: Vec<Value>,
    pub row_count: u64,
    pub totals: EvidenceTotals,
    pub rows_digest_blake3: String,
    pub signer_public_key: Option<String>,
    pub signature: Option<String>,
}

Signed, exportable usage evidence over a window.

Fields

schema: String

Discriminator so a verifier can refuse unrelated signed JSON.

from: String

Window bounds (inclusive), RFC 3339 UTC.

to: String

rows: Vec<Value>

Daily aggregates: day × person × project × model × provider.

row_count: u64

Row count (redundant with rows.len(), part of the signed payload).

totals: EvidenceTotals

Window totals over the raw events (not the aggregates).

rows_digest_blake3: String

BLAKE3 hex digest of the canonical rows bytes.

signer_public_key: Option<String>

Ed25519 public key (hex). None until signed.

signature: Option<String>

Ed25519 signature over the canonical bytes (hex). None until signed.

Implementations

impl EvidenceExportV1

pub fn build( from: DateTime<Utc>, to: DateTime<Utc>, rows: Vec<Value>, totals: EvidenceTotals, ) -> Self

Builds the unsigned artifact from already-aggregated rows + totals.

pub fn canonical_bytes(&self) -> Result<Vec<u8>, String>

Deterministic bytes that get signed/verified: the whole struct with the two signature fields cleared (same convention as SignedSavingsBatchV1).

pub fn sign(&mut self, agent_id: &str) -> Result<(), String>

Signs with the persistent machine identity (agent_identity keystore).

pub fn sign_with_key(&mut self, key: &SigningKey) -> Result<(), String>

Signs with an explicit key (hermetic tests).

pub fn verify(&self) -> EvidenceVerifyResult

Offline verification: digest over rows, then the Ed25519 signature over the canonical bytes with the embedded public key.

Trait Implementations

impl Clone for EvidenceExportV1

fn clone(&self) -> EvidenceExportV1

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EvidenceExportV1

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for EvidenceExportV1

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for EvidenceExportV1

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

where __S: Serializer,

Serialize this value into the given Serde serializer.