Struct FileNodeStore 

pub struct FileNodeStore { /* private fields */ }

Durable filesystem node store using content-addressed object layout.

Nodes are stored under nodes/sha256/aa/bb/<cid-hex> below the configured root. Hints are stored under hints/<namespace-hex>/<key-hex>, and named roots are stored under roots/<name-hex>. Node reads and writes verify that bytes hash to the CID key.

Implementations

impl FileNodeStore

pub fn open(root: impl Into<PathBuf>) -> Result<Self, FileNodeStoreError>

Open or create a filesystem node store rooted at root.

pub fn root(&self) -> &Path

Return the root directory for this store.

pub fn node_namespace_dir(&self) -> PathBuf

Return the namespace directory containing immutable node objects.

pub fn hint_namespace_dir(&self) -> PathBuf

Return the namespace directory containing optional performance hints.

pub fn root_namespace_dir(&self) -> PathBuf

Return the namespace directory containing named root manifests.

pub fn path_for_cid(&self, cid: &Cid) -> PathBuf

Return the filesystem path for a content-addressed node.

Trait Implementations

impl Clone for FileNodeStore

fn clone(&self) -> FileNodeStore

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileNodeStore

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

Formats the value using the given formatter.

impl ManifestStore for FileNodeStore

type Error = FileNodeStoreError

Error type for manifest operations.

fn get_root(&self, name: &[u8]) -> Result<Option<RootManifest>, Self::Error>

Load a named root manifest.

fn put_root( &self, name: &[u8], manifest: &RootManifest, ) -> Result<(), Self::Error>

Unconditionally insert or replace a named root manifest.

fn delete_root(&self, name: &[u8]) -> Result<(), Self::Error>

Delete a named root manifest. Deleting a missing name is not an error.

fn compare_and_swap_root( &self, name: &[u8], expected: Option<&RootManifest>, new: Option<&RootManifest>, ) -> Result<ManifestUpdate, Self::Error>

Atomically update a named root if the current manifest matches expected.

impl ManifestStoreScan for FileNodeStore

fn list_roots(&self) -> Result<Vec<NamedRootManifest>, Self::Error>

List all durable named root manifests.

impl NodeStoreScan for FileNodeStore

type Error = FileNodeStoreError

Error type for scan operations.

fn list_node_cids(&self) -> Result<Vec<Cid>, Self::Error>

List all content-addressed node CIDs currently known to the store.

impl Store for FileNodeStore

type Error = FileNodeStoreError

Error type for storage operations

fn get(&self, key: &[u8]) -> Result<Option<Vec<u8>>, Self::Error>

Get value by key

fn put(&self, key: &[u8], value: &[u8]) -> Result<(), Self::Error>

Store key-value pair

fn delete(&self, key: &[u8]) -> Result<(), Self::Error>

Delete key

fn batch(&self, ops: &[BatchOp<'_>]) -> Result<(), Self::Error>

Batch write operations (atomic if supported by backend)

fn batch_get( &self, keys: &[&[u8]], ) -> Result<HashMap<Vec<u8>, Vec<u8>>, Self::Error>

Retrieve multiple keys in a single operation

fn batch_get_ordered( &self, keys: &[&[u8]], ) -> Result<Vec<Option<Vec<u8>>>, Self::Error>

Retrieve multiple keys in a single operation with order preservation

fn batch_get_ordered_unique( &self, keys: &[&[u8]], ) -> Result<Vec<Option<Vec<u8>>>, Self::Error>

Retrieve unique keys in input order.

fn batch_put(&self, entries: &[(&[u8], &[u8])]) -> Result<(), Self::Error>

Store multiple key-value pairs in a single operation

fn supports_hints(&self) -> bool

Whether this store persists performance hints.

fn get_hint( &self, namespace: &[u8], key: &[u8], ) -> Result<Option<Vec<u8>>, Self::Error>

Retrieve an optional performance hint for a logical namespace and key.

fn put_hint( &self, namespace: &[u8], key: &[u8], value: &[u8], ) -> Result<(), Self::Error>

Persist an optional performance hint for a logical namespace and key.

fn batch_put_with_hint( &self, entries: &[(&[u8], &[u8])], namespace: &[u8], key: &[u8], value: &[u8], ) -> Result<(), Self::Error>

Store content-addressed nodes and one hint atomically when supported.

fn prefers_batch_reads(&self) -> bool

Whether this store has an efficient batched-read implementation.

impl TransactionalStore for FileNodeStore

fn supports_transactions(&self) -> bool

Whether this backend can atomically commit staged nodes and roots.

fn commit_transaction( &self, node_writes: &[TransactionNodeWrite], root_conditions: &[RootCondition], root_writes: &[RootWrite], ) -> Result<TransactionUpdate, Error>

Atomically validate root conditions, write nodes, and apply root writes.