Struct SettlementObservation 

pub struct SettlementObservation {
    pub schema: String,
    pub receipt_id: String,
    pub finalized_at: u64,
    pub tenant_id: Option<String>,
    pub tool_server: String,
    pub tool_name: String,
    pub capability_id: String,
    pub amount: MonetaryAmount,
    pub content_hash: String,
    pub policy_hash: String,
}

Observation handed to a SettlementHook by the kernel observer slot once a receipt has been signed and persisted. The structure is deliberately storage-agnostic: it carries the finalized-receipt identity plus the financial coordinates required to route the settlement through chio-settle/ops.rs.

The kernel sets [finalized_at] to the receipt timestamp so a hook implementation can sort by (finalized_at, receipt_id) to guarantee the deterministic ordering the integration tests enforce.

Fields

schema: String

Schema tag (chio.settle.observation.v1).

receipt_id: String

id of the finalized chio_core::receipt::body::ChioReceipt.

finalized_at: u64

timestamp carried over from the receipt (deterministic sort key).

tenant_id: Option<String>

Cluster operator (tenant) that owes the obligation, or None for single-tenant deployments.

tool_server: String

Tool server invoked.

tool_name: String

Tool name invoked.

capability_id: String

Capability id matched at evaluation time.

amount: MonetaryAmount

Settlement amount derived from the manifest pricing context. The kernel skips the hook entirely for zero-priced receipts; the amount on this struct is therefore always strictly positive.

content_hash: String

Receipt content hash, carried verbatim so a downstream auditor can confirm the settlement references the same bytes the kernel signed.

policy_hash: String

Receipt policy hash, carried verbatim for the same reason.

Implementations

impl SettlementObservation

pub fn new( receipt_id: impl Into<String>, finalized_at: u64, tool_server: impl Into<String>, tool_name: impl Into<String>, capability_id: impl Into<String>, amount: MonetaryAmount, content_hash: impl Into<String>, policy_hash: impl Into<String>, ) -> Self

Construct a fresh observation, stamping the canonical schema tag.

pub fn with_tenant(self, tenant_id: impl Into<String>) -> Self

Attach a tenant identifier. Single-tenant deployments may leave this unset.

pub fn ordering_key(&self) -> (u64, &str)

Return the deterministic sort key used by hook implementations. Tuples sort lexicographically by (finalized_at, receipt_id).

Trait Implementations

impl Clone for SettlementObservation

fn clone(&self) -> SettlementObservation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SettlementObservation

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SettlementObservation

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for SettlementObservation

impl PartialEq for SettlementObservation

fn eq(&self, other: &SettlementObservation) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for SettlementObservation

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SettlementObservation