Crate mutant_lib

MutAnt

MutAnt is a private, mutable key-value store built on Autonomi network scratchpads, offering resilient, cost-efficient, and async-first storage.

Why MutAnt?

Addressing on-chain storage limitations, MutAnt:

• Splits large data into scratchpad-sized chunks.
• Resumes interrupted transfers automatically.
• Recycles freed pads to reduce costs.
• Caches index locally for fast lookups and syncs remotely.
• Adapts to business logic with pluggable backends.

Key Highlights

• Chunk Management: Configurable pad sizes with automatic chunking and reassembly.
• Resumption & Retries: Transparent retry logic and transfer continuation.
• Cost Efficiency: Reuses freed pads to minimize redundant on-chain writes.
• Flexible Interfaces: Rust SDK (mutant-lib) and CLI tool (mutant).
• Async-First: Built on tokio and async/await.
• Extensible Architecture: Modular design allows custom network layers.

Quickstart

Add to Cargo.toml:

mutant-lib = "0.4.0"

use mutant_lib::MutAnt;
use mutant_lib::storage::StorageMode;
use anyhow::Result;

#[tokio::main]
async fn main() -> Result<()> {
    // Use a dummy private key for doctest purposes.
    let key_hex = "000102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f";

    let mut ant = MutAnt::init(key_hex).await?;

    ant.put("file1", b"hello", StorageMode::Medium, false).await?;

    let data = ant.get("file1").await?;

    println!("Fetched: {}", String::from_utf8_lossy(&data));
    Ok(())
}

Fetching Public Data (without a private key)

If you only need to fetch data that was stored publicly (using put), you can initialize a lightweight MutAnt instance without providing a private key:

use mutant_lib::MutAnt;
use mutant_lib::storage::ScratchpadAddress;
use anyhow::Result;

#[tokio::main]
async fn main() -> Result<()> {
    // Initialize for public fetching (defaults to Mainnet)
    let public_fetcher = MutAnt::init_public().await?;

    // You need the public address of the data (obtained elsewhere)
    let public_address = ScratchpadAddress::from_hex("...")?;

    // Fetch the public data
    let data = public_fetcher.get_public(&public_address).await?;

    println!("Fetched public data: {} bytes", data.len());
    Ok(())
}

Note: An instance created with init_public can only be used for get_public. Other operations requiring a private key (like put, get, remove, etc.) will fail.

Resources & Support

• API docs : https://docs.rs/mutant_lib
• CLI help : mutant --help
• Repository : https://github.com/Champii/MutAnt
• Issues : https://github.com/Champii/MutAnt/issues

Modules

config

error

events

storage

Structs

MutAnt

The main entry point for interacting with the MutAnt distributed storage system.