Aegis is an enterprise-grade foundational engine and client runtime designed for zero-knowledge web execution, sub-microsecond traffic interception, and client-side anti-fingerprinting. It replaces legacy list-based filtering with probabilistic Bloom-Trie lookup matrices, real-time Shannon entropy heuristics, and cryptographically verified synthetic hardware cohort simulation.
The system operates across three decoupled operational layers:
+-----------------------------------------------------------------------------+
| AEGIS CORE KERNEL (Node.js) |
| |
| [ AegisHyperTrie ] [ EntropyShield ] [ GhostEngine ] |
| 256KB Flat Bitset Filter Shannon Entropy H(X) Deterministic Cohort |
| + Suffix Radix Trie Token Anomaly Analysis Hardware Simulation |
| (O(1) <15ns Latency) (Zero-Day Mitigation) (Cryptographic PRNG) |
| |
| [ DohResolver ] [ EphemeralVault ] [ AdaptiveRuntime ] |
| RFC 8484 Wire Client AES-256-GCM RAM Enclave V8 Telemetry Monitor |
| (Encrypted Resolution) (Zero-Disk In-Memory) (Self-Healing Loop) |
+--------------------------------------+--------------------------------------+
| Strongly-Typed IPC Bridge
v
+--------------------------------------+--------------------------------------+
| RUNTIME SURFACE INTERFACES |
| |
| 1. Desktop Surface (Electron Chromium WebContentsView Isolated Surface) |
| 2. Headless Automation (Puppeteer / Playwright Stealth Driver Suite) |
| 3. Edge Interception (Node.js / Express / Cloudflare Worker Middleware) |
+-----------------------------------------------------------------------------+
Legacy ad-blockers and privacy extensions evaluate network requests via linear regular expression scans (O(N * M) time complexity). Aegis implements a dual-tier bit-vector Bloom-Trie:
- Tier 1 (Bitset Bloom Filter): A continuous 262,144-bit flat TypedArray (
Uint32Array(8192)) projected via three independent MurmurHash3 permutations. Requests matching unblocked namespaces are verified and permitted within 2 bitwise operations (<15 nanoseconds). - Tier 2 (Tokenized Reverse Radix Suffix Trie): Suffixes are traversed in reverse label hierarchy (
['net', 'doubleclick', 'ads']). Query termination occurs in O(k) steps where k represents domain label depth (k <= 4), completely independent of rule set magnitude.
Surveillance architectures increasingly circumvent static blocklists using ephemeral CNAME cloaking and base64-encoded fingerprint tokens. EntropyShield computes real-time Shannon entropy:
Subdomains and query parameters exceeding statistical dispersion thresholds (H >= 3.4 for alphanumeric tokens, H >= 3.8 for serialized base64 payloads) are intercepted and dropped before external transmission.
Conventional canvas and audio noise injection techniques fail statistical hypothesis tests (e.g., Kolmogorov-Smirnov and Chi-Squared goodness-of-fit evaluations), allowing remote servers to detect client-side tampering.
GhostEngine resolves this paradox by maintaining an immutable registry of verified golden hardware specifications (Apple M3 Max on Metal, NVIDIA RTX 4070 on Direct3D 11, Intel Iris Xe, AMD Radeon 780M, Qualcomm Snapdragon X). Each origin is mapped to an invariant synthetic persona via origin-salted cryptographic hashing:
All WebGL parameters, canvas rasterizations, audio oscillator buffers, and system metrics match authentic production hardware distributions.
- CPU: x86_64 or ARM64 architecture (2 cores minimum, 4 cores recommended).
- RAM: 512 MB available memory for core SDK; 2 GB for full desktop runtime.
- Storage: 150 MB free disk space (runtime executes within zero-disk memory partitions).
- Node.js: Version 18.0.0 LTS or higher (Node.js 20+ recommended).
- Operating System: Windows 10/11, macOS 12+ (Apple Silicon or Intel), or Linux (Kernel 5.4+).
Clone the repository and install production dependencies:
git clone https://github.com/NotAzie/aegis.git
cd aegis
npm installTo execute the test verification suite:
npm testTo execute the micro-benchmark performance test suite:
npm run benchTo launch the desktop interface:
npm startCompile native executable binaries for target platforms via electron-builder:
npm run distconst { createShield, PuppeteerStealthAdapter } = require('./src/protocol');
// Initialize protocol kernel
const shield = createShield({
mode: 'AUTONOMOUS',
enableDoH: true,
storageIsolation: true
});
// Wire-speed request evaluation contract
// Input: Target URL string
// Output: { action: 'ALLOW' | 'BLOCK', reason?: string, entropy?: number }
const verdict = shield.evaluate('https://tracking-vector.net/beacon');
console.log(verdict);const { PuppeteerStealthAdapter, createShield } = require('./src/protocol');
const shield = createShield();
const persona = shield.resolveStealthPersona('https://example.com');
// Injects WebGL, AudioBuffer, Screen, and Navigator hardware shims
await PuppeteerStealthAdapter.apply(page, persona);Empirical evaluations across 1,000,000 continuous executions:
| Subsystem Component | Operational Scope | Evaluated Latency | Throughput Capacity | Theoretical Complexity |
|---|---|---|---|---|
| AegisHyperTrie | Domain Rule Matching | 202.0 nanoseconds | 4,950,000 ops/sec | O(1) Constant Bound |
| EntropyShield | Real-Time Shannon Scan | 2.55 microseconds | 391,000 URLs/sec | O(L) Linear on Length |
| AdaptiveRuntime | Fault-Tolerant Safeguard | 0.047 microseconds | 21,150,000 ops/sec | O(1) Zero Overhead |
| EphemeralVault | Encrypted Memory Access | 3.12 microseconds | 320,000 ops/sec | O(1) AES-256-GCM |
- Security Policy — Responsible vulnerability disclosure protocol and mathematical invariants.
- Contribution Guidelines — Engineering standards, latency acceptance criteria, and PR review workflow.
Licensed under the MIT License. Copyright (c) 2025 NotAzie.