Struct AnchoringController 

pub struct AnchoringController { /* private fields */ }

Policy-gated wrapper around a ChainAnchor backend.

Implementations

impl AnchoringController

pub fn new(backend: Arc<dyn ChainAnchor>, policy: AnchorFrequencyPolicy) -> Self

Wrap an existing backend with a frequency policy.

pub fn from_config( cfg: &ChainExternalAnchorConfig, ) -> Result<Option<Self>, String>

Build from kernel config. Returns None when backend is None.

pub fn backend_name(&self) -> &str

Backend name for logging/display.

pub fn policy(&self) -> AnchorFrequencyPolicy

Frequency policy in force.

pub fn backend(&self) -> &dyn ChainAnchor

Underlying backend (for direct verify / tests).

pub fn try_anchor( &self, hash: &[u8; 32], chain_seq: u64, ) -> Result<Option<AnchorReceipt>, String>

Anchor only when the frequency policy allows it.

Returns Ok(None) when the policy suppresses the call (not an error).

pub fn force_anchor( &self, hash: &[u8; 32], chain_seq: u64, ) -> Result<AnchorReceipt, String>

Force an anchor, bypassing the frequency policy (still updates state).

pub fn try_anchor_chain_head( &self, chain: &ChainManager, ) -> Result<Option<AnchorReceipt>, String>

Anchor the current ExoChain head when policy allows.

On success, also appends a chain.external_anchor audit event to the local chain so operators can see the receipt on the ExoChain.