Struct ForcedTransitionAudit 

pub struct ForcedTransitionAudit { /* private fields */ }

Durable audit evidence for one forced-transition attempt — emitted for allowed, denied, and failed attempts alike.

This is the durable audit evidence ADR 0037 requires. Because a forced transition can bypass quorum, every attempt — including the ones that were refused — must leave a trail; making the audit the return value of force_transition means a caller cannot perform a force without also receiving its evidence. The record captures who (operator), why (reason), what (collection/range/target), when (attempted_at_ms), and the disposition (the outcome, with the full epoch/version boundary on success).

Implementations

impl ForcedTransitionAudit

pub fn attempted_at_ms(&self) -> u64

The wall-clock time (ms) the attempt was evaluated, as supplied by the caller.

pub fn operator(&self) -> Option<&NodeIdentity>

The operator principal that exercised the capability, if one was presented. None on an attempt denied for MissingCapability.

pub fn reason(&self) -> Option<&str>

The operator’s stated reason, if one was attached. None on an attempt denied for MissingReason (or missing capability).

pub fn collection(&self) -> &CollectionId

pub fn range_id(&self) -> RangeId

pub fn target(&self) -> &NodeIdentity

The node the force tried to install as owner.

pub fn disposition(&self) -> &ForcedTransitionDisposition

pub fn is_allowed(&self) -> bool

Whether the force was authorised and applied.

pub fn fenced_old_owner(&self) -> bool

Whether a successful force bumped the ownership epoch — true for every allowed force, since installing a new owner always advances the epoch and so fences any old owner that later reappears. false for denied/failed attempts, where nothing moved.

Trait Implementations

impl Clone for ForcedTransitionAudit

fn clone(&self) -> ForcedTransitionAudit

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ForcedTransitionAudit

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

Formats the value using the given formatter.

impl Display for ForcedTransitionAudit

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

Formats the value using the given formatter.

impl Eq for ForcedTransitionAudit

impl PartialEq for ForcedTransitionAudit

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ForcedTransitionAudit