Struct FileAnchor 

pub struct FileAnchor { /* private fields */ }

File-based anchor backend

Stores anchor receipts in a local JSON Lines file (one receipt per line). Suitable for development, testing, and single-node deployments.

Security

Use try_new() or with_base_dir() for production to prevent path traversal.

Implementations

impl FileAnchor

pub fn new(path: impl Into<PathBuf>) -> Self

Create a new file anchor (no path validation)

Warning

This constructor does not validate the path. For production use, prefer try_new() or with_base_dir() to prevent path traversal.

pub fn with_base_dir( path: impl Into<PathBuf>, base_dir: impl Into<PathBuf>, ) -> Result<Self, AnchorError>

Create a file anchor with path validation (HIGH-1 fix)

Validates that the path:

• Does not contain path traversal sequences (..)
• Is within the specified base directory

Errors

Returns AnchorError::BackendUnavailable if path validation fails.

pub fn path(&self) -> &PathBuf

Get the path to the anchor file

Trait Implementations

impl AnchorBackend for FileAnchor

fn anchor<'life0, 'life1, 'async_trait>( &'life0 self, root: &'life1 Hash, metadata: AnchorMetadata, ) -> Pin<Box<dyn Future<Output = Result<AnchorReceipt, AnchorError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Anchor a Merkle root to the external system

fn verify<'life0, 'life1, 'async_trait>( &'life0 self, receipt: &'life1 AnchorReceipt, ) -> Pin<Box<dyn Future<Output = Result<bool, AnchorError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Verify that a previously issued receipt is still valid

fn name(&self) -> &str

Get the human-readable name of this backend

fn is_healthy<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = bool> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Check if the backend is available and healthy

impl Clone for FileAnchor

fn clone(&self) -> FileAnchor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileAnchor

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

Formats the value using the given formatter.