Secure Ledger (sl)

A secure, encrypted ledger system for storing and managing sensitive data with cryptographic verification.

Features

• End-to-End Encryption: All data is encrypted using AES-256-GCM with keys derived from Argon2 password hashing
• Tamper Detection: Cryptographic hashing ensures data integrity
• Error Logging: Comprehensive event logging for audit trails
• Persistence: Data is stored in encrypted ZIP archives

Installation

Add to your Cargo.toml:

[dependencies]
sl = { git = "https://github.com/rdYards/sl.git" }

File Structure

pub struct SecureLedger {
    pub meta: MetaData,
    pub ledger: Vec<LedgerEntry>,
    pub hash_info: HashInfo,
    pub error_log: Vec<String>,
}

pub struct MetaData {
    pub root_path: PathBuf,
    pub title: String,
    pub version: f32,
    pub created_at: String,
    pub last_modified: String,
    pub description: String,
    pub write_on_change: bool,
    pub ledger_hash: String
}

pub struct LedgerEntry {
    pub genre: String,
    pub id: String,
    pub data: String,
    pub timestamp: String,
}

pub struct HashInfo {
    pub algorithm: String,
    pub salt: String,
    pub iterations: u32,
    pub hash: String,
}

Usage

Basic Example

use sl::SecureLedger;
use sl::types::LedgerEntry;
use std::path::Path;

fn main() {
    // Initialize a new ledger
    let mut ledger = SecureLedger::initialize(None, None).unwrap();

    // Set up metadata
    ledger.update_meta("my_ledger.sl", "My Secure Ledger", "Important documents");

    // Add an entry
    let entry = LedgerEntry {
        id: "doc1".to_string(),
        data: "Confidential information".to_string(),
        timestamp: sl::tools::return_time(),
    };

    let password = "my_secure_password";
    ledger.add_entry(entry, password).unwrap();

    // Save the ledger
    ledger.upload_to_sl(password).unwrap();

    // Load the ledger later
    let loaded_ledger = SecureLedger::initialize(Some(file_path), Some(password)).unwrap();
    println!("Loaded {} entries", loaded_ledger.ledger.len());
}

Testing

Run the test suite:

cargo test

License

MIT License