NullFox Cryptographic Suite

A high-performance, cross-platform framework for universal data encryption utilizing hardware-optimized AES-256-CBC and SHA-256 engines.

Overview

NullFox is an enterprise-grade cryptographic toolkit designed for secure data processing across multiple operating systems. By bridging a high-performance C engine with a hardened Python interface via CFFI (Foreign Function Interface), NullFox delivers military-grade symmetric encryption with minimal latency, single-line import routing, and zero external runtime dependencies.

Key Features

• Single-Line Import Routing: Modernized top-level namespace integration allows calling tools via a unified interface (import nullfox) while completely preserving clean, isolated internal subfolder layouts.
• Strict Parameter Constraint Shield: Active verification layers immediately reject missing arguments (None) and enforce explicit credentials parsing before committing pointers to the native execution layer.
• Volatile Memory Sanitization: Built-in security hooks implement an automated try...finally memory dump wipe, leveraging CFFI buffers to zero-stamp (0x00) secret key arrays out of system RAM immediately post-use.
• Native Multi-Platform Acceleration: Native machine code execution support for Windows (.dll), Linux (.so), and Android (.so).
• Hardware Optimization: Dynamic runtime selection of AVX2, generic, ARM64, and x86_64 architecture cores to maximize CPU instruction-set throughput.
• Resource Efficient: Optimized 64KB streaming buffers designed for high-speed NVMe and mobile flash storage performance.

Architecture Matrix

NullFox automatically resolves the optimal binary asset for the host environment at runtime:

Installation & Setup

Standard Installation

The recommended method for standard deployments is via the Python package manager:

pip install nullfox

Native Compilation from Source

For developers requiring custom builds, platform-specific compile scripts are located inside the nullfox/src/Binaries/ directory:

Windows (PowerShell / Batch):

.\compile_engine_windows.bat

Linux / WSL (Bash):

./compile_engine_linux.sh

Android (NDK r30+):

./compile_engine_android.sh

Implementation & Verification

The following production blueprints demonstrate the streamlined top-level API workflows for string operations and file streaming pipelines with strict parameter constraints:

1. In-Memory String Operations Workflow

import nullfox

print("=== NULLFOX STRING CRYPTOGRAPHIC VERIFICATION ===")

try:
    # 1. Resource Initialization (Explicit Parameter Token Generation)
    key = nullfox.generate_key()  # 32-Byte Secure Token (AES-256)
    iv = nullfox.generate_iv()    # 16-Byte Initialization Vector (Block Aligned)

    print(f"[✓] Token Security Generation: SUCCESS")
    print(f"    ↳ Key (Hex): {key.hex()}")
    print(f"    ↳ IV (Hex):  {iv.hex()}\n")

    # 2. Data Payload Definition
    payload = b"Production Data Packet v0.7.0"
    print(f"[...] Passing payload into strict parameter backend...")

    # 3. Cryptographic Core Loops (Automatic Memory Sanitization Post-Execution)
    ciphertext, safe_key, safe_iv = nullfox.encrypt_string(payload, key, iv)
    decrypted = nullfox.decrypt_string(ciphertext, safe_key, safe_iv)

    # 4. Integrity Validation Check
    if decrypted == payload:
        print("\n[STATUS] Cryptographic Integrity: MATCHED & 100% STABLE")
    else:
        raise ValueError("Buffer unpacking payload mismatch detected.")

except Exception as e:
    print(f"\n[X] Cryptographic Fault Detected: {e}")

2. High-Speed File Streaming Workflow (64KB C-Buffer Routing)

from nullfox import encrypt_file, decrypt_file, generate_key, generate_iv

try:
    # Generate explicit validation parameters
    key = generate_key()
    iv = generate_iv()

    # Native streaming execution via single-line front-gate routing
    encrypt_file("source_data.bin", "vault.enc", key, iv)
    decrypt_file("vault.enc", "recovered_data.bin", key, iv)
    print("[✓] Native Streaming Pipeline: SUCCESS")
    
except Exception as e:
    print(f"[X] Streaming Execution Error: {e}")

Integrity Manifest

Verify the SHA-256 fingerprints of the distribution binaries against the official release signatures:

License

NullFox is released under the open-source MIT License.