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