Enum AnchorPolicy 

pub enum AnchorPolicy {
    Never,
    Always,
    HighValue,
    Epoch,
}

When a ProvenanceLog::record write should incur the expensive Bitcoin block-trail anchor on top of the always-on git-mark.

The cheap tier (git-mark) runs for every policy — these variants only govern the opt-in anchor. Pure, Copy, wasm-safe: it carries no I/O.

Variant	Anchor behaviour
Never	git-mark only — no on-chain cost. The default for ordinary writes.
Always	anchor every write (commits the git SHA on-chain). Expensive; only for trails where every state must be externally timestamped.
HighValue	anchor iff the resource is flagged anchor-worthy (its ACL carries a ProvenanceAnchor condition / the caller passes the high-value flag). Settlement receipts, elevation/ACSP decisions.
Epoch	accumulate the git SHA into an EpochAccumulator; the batch root is anchored once on epoch close (one Bitcoin tx notarises many commits — ADR-059 D5).

An anchor is attempted only when the policy says so and the ProvenanceLog was built with an anchorer (ProvenanceLog::anchorer is Some). With anchorer: None (the wasm / no-Bitcoin pod) every policy degrades to git-mark-only, silently.

Variants

Never

git-mark only; never anchor. The default for ordinary pod writes.

Always

Anchor every write — the git commit SHA is committed on-chain each time.

HighValue

Anchor only when the resource is flagged high-value (ACL carries a ProvenanceAnchor condition). Otherwise git-mark only.

Epoch

Accumulate the commit into the current epoch; the epoch’s Merkle root is anchored once on close (amortised on-chain cost — ADR-059 D5).

Implementations

impl AnchorPolicy

pub fn anchors_inline(self, high_value: bool) -> bool

Whether this write should be anchored inline (i.e. produce a BlockTrailAnchor on the returned mark), given whether the resource is flagged high-value.

• Never / Epoch ⇒ never inline (Epoch defers to the accumulator).
• Always ⇒ always inline.
• HighValue ⇒ inline iff high_value.

Trait Implementations

impl Clone for AnchorPolicy

fn clone(&self) -> AnchorPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for AnchorPolicy

impl Debug for AnchorPolicy

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

Formats the value using the given formatter.

impl Default for AnchorPolicy

fn default() -> AnchorPolicy

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AnchorPolicy

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for AnchorPolicy

impl PartialEq for AnchorPolicy

fn eq(&self, other: &AnchorPolicy) -> 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 Serialize for AnchorPolicy

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 AnchorPolicy