Skip to main content

Darkelf Cocoa privacy browser for macOS

Project description

🧿 Darkelf Cocoa Browser

Ephemeral, Post-Quantum Privacy Browser (macOS / Cocoa)

Darkelf is a memory-only, privacy-first web browser built using PyObjC + WebKit, featuring a deterministic Post-Quantum Integrity Layer (PQ) and an on-device AI security engine (MiniAI Sentinel).


🚀 Darkelf Cocoa 4.3.5

Stability • Accuracy • Privacy Reinforced

Darkelf Cocoa 4.3.5 builds on 4.3.4 with refined fingerprint realism and deterministic rotation improvements, enhancing stealth consistency without introducing instability.


🆕 Update in Darkelf Cocoa 4.3.5

🧩 WebGL / WebGPU Hash Rotation (PQ-Linked)

Introduces a refined fingerprint rotation model for Canvas/WebGL surfaces, aligned with Post-Quantum (PQ) identity progression.

Rotation Model

  • Fingerprint seeds now incorporate:
    • per-tab PQ seed
    • identity bucket grouping
    • previous PQ chain state

Behavior

  • Deterministic per tab
  • Stable across reloads
  • Gradual variation over navigation/session time
  • No JavaScript-triggered mutation

Result

  • Eliminates long-session fingerprint “freezing”
  • Improves realism of GPU-like entropy behavior
  • Reduces replay and correlation detection vectors
  • Maintains full cross-surface coherence

Implementation Detail

  • seed + bucket + previous_chain

🔐 Design Guarantee

  • No externally observable instability
  • No per-request jitter
  • No cross-tab leakage
  • Fully deterministic under PQ identity model

📌 (Previous Release) Darkelf Cocoa 4.3.4

Stability • Accuracy • Privacy Reinforced

Darkelf Cocoa 4.3.4 strengthens internal consistency, improves fingerprint realism, and enhances stealth across identity, rendering, and detection layers.


New Features in Darkelf Cocoa 4.3.4

Memory Chunking

Improved memory handling by breaking data into smaller, more efficient chunks for enhanced performance and stability.

Enhanced Error Logging

Upgraded logging system with more detailed diagnostics, making debugging and issue tracking more effective.

Safe URL Handling

Introduced safer URL processing to prevent malformed or unsafe links from causing unexpected behavior or security issues.


🧪 Stability & Verification

  • ✅ All 59 Pytests passing
  • Improved cold boot consistency
  • Hardened lifecycle + state handling
  • Stable under stress / long-session runtime

🧠 MiniAI Sentinel (Detection Engine)

Enhanced Detection Accuracy

  • Refined behavioral heuristics

  • Reduced false positives under load

  • Improved classification for:

    • scraping activity
    • credential abuse patterns
    • automation frameworks

Smarter Thresholding

  • Tuned for real-world browsing behavior
  • Concurrency-safe detection logic
  • No false triggers from high-performance systems

🕸️ Scraper Detection (Reworked)

Hybrid Detection Model

  • Same-path burst detection (test-safe)
  • Multi-path enumeration detection (real-world)

Improvements

  • Eliminates false positives from:

    • hardware concurrency
    • rapid navigation
  • Better alignment with real attacker behavior


🛡️ Network Policy Engine (Enhanced)

  • 🔒 Fixed HTTP → HTTPS upgrade enforcement
  • 🚫 Stricter tracker blocking (domain-level precision)
  • Works correctly without active tab context
  • Reduced interference with legitimate traffic

🔐 Post-Quantum Integrity Layer (PQ)

Enhancements

  • Stronger stateful request chaining
  • Improved replay resistance
  • Better entropy tracking
  • Stable behavior across rapid navigation

Identity Model

  • _pq_seed → per-tab root identity
  • _pq_salt → hidden entropy
  • _pq_counter → monotonic progression
  • _pq_prev_chain → chain continuity

Chain Construction

  • chain = SHA3_512( seed + normalized_url + previous_chain + counter + salt )

Features

  • Canonical URL normalization
  • Replay detection (~200 chain window)
  • TLS certificate binding
  • Deterministic third-party deception
  • Rendering isolation (Canvas/WebGL/Audio)

Identity Rotation

  • seed → SHA3_256(seed)

🎨 Fingerprint System (Enhanced)

PQ-Based Identity

Each tab now uses a deterministic, hidden identity derived from an internal PQ seed:

  • Stable within a tab session
  • Independent across tabs
  • Not exposed to websites

Rotation Model

  • Fingerprints remain stable on reload
  • New tabs receive distinct identities
  • Gradual variation over time and navigation

🧩 WebGL / WebGPU Rotation (4.3.5 Enhancement)

Fingerprint derivation now includes PQ chain progression, enabling controlled rotation without instability.

  • Removes static fingerprint persistence in long sessions
  • Maintains deterministic identity while introducing temporal variation
  • Aligns Canvas/WebGL entropy with real-world GPU behavior

Result

  • Prevents cross-tab tracking
  • Avoids unstable or overly-random behavior
  • Reduces long-session fingerprint correlation

🧩 Fingerprint Coherence

  • Canvas, WebGL, and font signals are now aligned
  • Eliminated inconsistent or conflicting fingerprint traits

Result

  • Coherent, realistic device fingerprint
  • Reduced detection via cross-surface mismatch

🕶️ User-Agent Stealth

  • Removed all Darkelf identifiers from the User-Agent

Result

  • Appears as a standard WebKit/macOS client
  • Internal identity system remains fully hidden

🔐 Internal Improvements

  • Hidden identity grouping (not externally visible)
  • Navigation-based entropy (no JS-driven mutation)
  • Stable, non-reactive fingerprint behavior

⚙️ JavaScript Hardening (PQ Unified)

  • All JS privacy surfaces aligned under PQ-seeded entropy

  • Consistent spoofing across:

    • Canvas
    • WebGL
    • Font fingerprinting

🔁 Fingerprint Isolation

Per-Tab Identity Model

  • 🔁 Deterministic per-tab identity
  • Group-based identity distribution (bucketed)
  • No cross-tab fingerprint reuse

Result

  • Eliminates cross-tab correlation vectors
  • Prevents long-session fingerprint linking
  • Creates overlapping identity clusters (crowd blending)

🎯 Content Rules / Adblocking

  • Refined and consolidated rule sets

  • Improved compatibility with PQ fingerprint system

  • Better filtering of:

    • trackers
    • ad iframes
    • consent frameworks
  • Reduced site breakage

  • Improved CNN / news-site handling (container-safe filtering)


🧩 Architecture Improvements

  • Clear separation between:

    • network policy layer
    • MiniAI detection engine
    • PQ cryptographic state
  • Reduced duplication

  • Fewer edge-case inconsistencies

  • Improved long-session stability


🔐 Ephemeral Browsing

  • No disk persistence
  • Memory-only cookies/cache/storage
  • Automatic cleanup on exit
  • Downloads disabled by default

🕵️ Privacy & Anti-Tracking

  • First-party isolation (FPI)
  • Deterministic third-party deception
  • Ad + tracker blocking
  • Fingerprint surface reduction
  • No stable cross-session identity

📦 PyPI

pip install darkelf-cocoa
darkelf

🔐 Security Model

Zero persistence
Deterministic identity isolation
Replay resistance
Behavioral anomaly detection
No telemetry

📜 License
LGPL-3.0-or-later
© Dr. Kevin Moore (2025)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

darkelf_cocoa-4.3.5.tar.gz (60.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

darkelf_cocoa-4.3.5-py3-none-any.whl (58.7 kB view details)

Uploaded Python 3

File details

Details for the file darkelf_cocoa-4.3.5.tar.gz.

File metadata

  • Download URL: darkelf_cocoa-4.3.5.tar.gz
  • Upload date:
  • Size: 60.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.13

File hashes

Hashes for darkelf_cocoa-4.3.5.tar.gz
Algorithm Hash digest
SHA256 53593ddf7b31541d328634e26a9542d12743e81abd207d83bcc3f81ba3cc7706
MD5 c13fcb9350b162acbcdbd5128638dc08
BLAKE2b-256 7f2fe9b82d7ace9a9db7806597695f8a401c98e9b6179a3541eee5759b56967e

See more details on using hashes here.

File details

Details for the file darkelf_cocoa-4.3.5-py3-none-any.whl.

File metadata

  • Download URL: darkelf_cocoa-4.3.5-py3-none-any.whl
  • Upload date:
  • Size: 58.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.13

File hashes

Hashes for darkelf_cocoa-4.3.5-py3-none-any.whl
Algorithm Hash digest
SHA256 abea491d3a659ffa0eed073e2429972ba854bde248ce1def434ae49ba3c36cfe
MD5 221f58efaac40ec32112e32122d5aa4e
BLAKE2b-256 275c15487669cebf01ce03094aadcf48030f7a5c813539d94fd4983f97fb5393

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page