Crate hakanai_lib 

Zero-knowledge secret sharing client library for Hakanai.

This library provides a complete client implementation for sending and receiving ephemeral secrets using the Hakanai service. All encryption and decryption happens client-side, ensuring the server never has access to plaintext data.

Architecture

The library uses a layered client architecture:

• WebClient - Handles HTTP communication
• CryptoClient - Adds AES-256-GCM encryption/decryption
• SecretClient - Handles Payload serialization/deserialization

Examples

Basic Usage

use hakanai_lib::{client, client::Client};
use std::time::Duration;
use url::Url;

// Create a client with the default configuration
let client = client::new();

// Send a text secret
let secret_url = client.send_secret(
    Url::parse("https://example.com")?,
    hakanai_lib::models::Payload::from_bytes(b"My secret message"),
    Duration::from_secs(3600), // 1 hour TTL
    "auth-token".to_string(),
    None, // No custom options
).await?;

println!("Secret URL: {}", secret_url);

// Receive the secret (normally done by recipient)
let payload = client.receive_secret(secret_url, None).await?;
println!("Retrieved: {:#?}", payload.data);

Sending Binary Files

use hakanai_lib::{client, client::Client, models::Payload};
use std::time::Duration;
use url::Url;

let client = client::new();

// Read file and create payload
let file_contents = std::fs::read("document.pdf")?;
let payload = Payload::from_bytes(&file_contents).with_filename("document.pdf");

// Send the file
let secret_url = client.send_secret(
    Url::parse("https://example.com")?,
    payload,
    Duration::from_secs(86400), // 24 hour TTL
    "auth-token".to_string(),
    None,
).await?;

println!("File shared at: {}", secret_url);

Using Progress Monitoring

use hakanai_lib::{client, client::Client, models::Payload, options::SecretSendOptions};
use hakanai_lib::observer::DataTransferObserver;
use std::sync::Arc;
use std::time::Duration;
use url::Url;

struct ProgressReporter;

#[async_trait::async_trait]
impl DataTransferObserver for ProgressReporter {
    async fn on_progress(&self, bytes_transferred: u64, total_bytes: u64) {
        println!("Progress: {:.1}%", (bytes_transferred as f64 / total_bytes as f64) * 100.0);
    }
}

let client = client::new();
let options = SecretSendOptions::new().with_observer(Arc::new(ProgressReporter));

client.send_secret(
    Url::parse("https://example.com")?,
    Payload::from_bytes(b"Secret data"),
    Duration::from_secs(3600),
    "auth-token".to_string(),
    Some(options),
).await?;

Modules

client

models

Data models and structures for the Hakanai library.

observer

options

utils

Utility functions and helpers for the Hakanai library.