AmateRS is a next-generation distributed database with Fully Homomorphic Encryption (FHE) capabilities, enabling computation on encrypted data without ever exposing plaintext to servers.

"Reclaiming Digital Dignity through Computation in the Dark"

Like the sun goddess Amaterasu hiding in the rock cave (Iwato), data remains hidden within a robust cryptographic shell. Yet the light (computational power) emanating from it continues to illuminate the world.

AmateRS resolves the fundamental trade-off between privacy protection and data utilization.

AmateRS consists of four core components inspired by Japanese mythology:

• Encryption in Use: Data remains encrypted during computation via TFHE (Fully Homomorphic Encryption)
• Zero Trust: Servers never see plaintext - mathematically impossible to decrypt without client keys
• Distributed Consensus: Raft-based replication with encrypted log entries
• High Performance: GPU-accelerated FHE operations, optimized LSM-Tree storage
• Post-Quantum Security: LWE-based cryptography resistant to quantum attacks

• Rust nightly (automatically configured via rust-toolchain.toml)
• Linux with io_uring support (for optimal performance)
• Optional: CUDA/Metal for GPU acceleration

git clone https://github.com/cool-japan/amaters
cd amaters
cargo build --release

# Start a single-node server
cargo run --bin amaters-server -- start --data-dir ./data

# Set encrypted value
cargo run --bin amaters-cli -- set my_key "encrypted_data"

# Get value
cargo run --bin amaters-cli -- get my_key

# Execute query
cargo run --bin amaters-cli -- query "collection('users').filter(age > 18)"

use amaters_sdk_rust::{AmateRSClient, CipherBlob, Key};

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let client = AmateRSClient::connect("http://localhost:7878").await?;

    // Encrypt and store data (client-side encryption)
    let key = Key::new(b"user:123");
    let encrypted_data = CipherBlob::new(vec![/* encrypted bytes */]);
    client.set("users", &key, &encrypted_data).await?;

    // Retrieve encrypted data
    let result = client.get("users", &key).await?;

    Ok(())
}

• Store encrypted DNA/medical data
• Perform analysis without exposing patient information
• Enable global medical research while preserving privacy

• Track CO2 emissions without revealing trade secrets
• Verify ethical sourcing without exposing supplier networks
• Maintain competitive advantage while ensuring transparency

• Credit scoring without revealing personal transaction history
• Privacy-preserving identity verification
• Secure cross-border payments

amaters/
├── crates/
│   ├── amaters-core/        # Core kernel (Iwato + Yata)
│   ├── amaters-net/         # Network layer (Musubi)
│   ├── amaters-cluster/     # Consensus (Ukehi)
│   ├── amaters-server/      # Server binary
│   ├── amaters-sdk-rust/    # Rust SDK
│   └── amaters-cli/         # Command-line interface
├── docs/                    # Architecture documentation
├── examples/                # Use case examples
└── AmateRS--Tech-EN.md     # Technical whitepaper

Current Version: 0.1.0 (Production Ready)

• ✅ Core storage engine (Iwato) - LSM-Tree with WAL and compaction
• ✅ FHE compute engine (Yata) - TFHE-rs integration with predicate evaluation
• ✅ Network layer (Musubi) - gRPC with TLS/mTLS
• ✅ Rust SDK with connection pooling and retry logic
• ✅ CLI tool with full admin capabilities
• ✅ 491+ tests passing (99% coverage)
• 🚧 Consensus layer (Ukehi) - Foundation complete, clustering in progress
• 📋 GPU acceleration (CUDA/Metal) - Planned for v0.2.0

We welcome contributions! Please see our contribution guidelines.

# Run tests
cargo test --workspace --all-features

# Run clippy
cargo clippy --workspace --all-features -- -D warnings

# Run benchmarks
cargo bench --workspace

# Format code
cargo fmt --all

• Technical Whitepaper - Detailed architecture
• Vision Paper - Philosophy and use cases
• Architecture Decision Records - Design decisions
• Security Model - Threat analysis

Licensed under either of:

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

COOLJAPAN OU (Team KitaSan) Contact: contact@cooljapan.tech Website: https://github.com/cool-japan

"We are not just building a database. We are building the Vault of Civilization."