Struct MutAnt

pub struct MutAnt { /* private fields */ }

Manages raw byte data storage using the PadManager.

Implementations

impl MutAnt

pub async fn init( private_key_hex: String, ) -> Result<(Self, Option<JoinHandle<()>>), Error>

Creates a new MutAnt instance using default configuration. Use init_with_progress for detailed initialization feedback and custom config.

pub async fn init_with_progress( private_key_hex: String, config: MutAntConfig, init_callback: Option<InitCallback>, ) -> Result<(Self, Option<JoinHandle<()>>), Error>

Creates a new MutAnt instance with optional progress reporting via callback and custom config.

pub async fn store( &self, user_key: &str, data_bytes: &[u8], ) -> Result<(), Error>

Stores raw bytes under a given user key without progress reporting. Use store_with_progress for detailed feedback.

pub async fn store_with_progress( &self, user_key: &str, data_bytes: &[u8], callback: Option<PutCallback>, ) -> Result<(), Error>

Stores raw bytes under a given user key with optional progress reporting via callback.

pub async fn fetch(&self, key: &str) -> Result<Vec<u8>, Error>

Fetches the raw bytes associated with the given user key without progress reporting. Use fetch_with_progress for detailed feedback.

pub async fn fetch_with_progress( &self, key: &str, callback: Option<GetCallback>, ) -> Result<Vec<u8>, Error>

Fetches the raw bytes associated with the given user key, with optional progress reporting.

pub async fn remove(&self, user_key: &str) -> Result<(), Error>

Removes a user key and its associated data/metadata.

pub async fn update( &self, user_key: &str, data_bytes: &[u8], ) -> Result<(), Error>

Updates the raw bytes associated with an existing user key without progress reporting. Use update_with_progress for detailed feedback.

Returns Error::KeyNotFound if the key does not exist.

pub async fn update_with_progress( &self, user_key: &str, data_bytes: &[u8], callback: Option<PutCallback>, ) -> Result<(), Error>

Updates the raw bytes associated with an existing user key, with optional progress reporting.

Returns Error::KeyNotFound if the key does not exist.

pub async fn get_user_keys(&self) -> Vec<String>

Retrieves a list of all user keys.

pub async fn get_storage_stats(&self) -> Result<StorageStats, Error>

Retrieves detailed statistics about the storage usage.

pub async fn reset_master_index(&self) -> Result<(), Error>

Resets the master index to its initial empty state. WARNING: This is a destructive operation and will orphan existing data pads.

pub async fn list_keys(&self) -> Result<Vec<String>, Error>

Lists all user keys currently tracked in the master index.

pub async fn list_key_details(&self) -> Result<Vec<KeyDetails>, Error>

Retrieves a list of keys along with their size and modification time.

Trait Implementations

impl Clone for MutAnt

fn clone(&self) -> MutAnt

Returns a copy of the value.

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

Performs copy-assignment from source.