|
1 | | -# ЖАР ПТИЦА Browser Extension |
| 1 | +# NeoDetect Anti-Detect Browser Extension |
| 2 | + |
| 3 | +Advanced antidetect browser extension with WASM-powered fingerprint protection. |
| 4 | + |
| 5 | +## Features |
| 6 | + |
| 7 | +### Core Protections |
| 8 | +- **Canvas Fingerprint** - Adds ternary noise to canvas operations |
| 9 | +- **WebGL Fingerprint** - Spoofs GPU vendor and renderer |
| 10 | +- **Audio Fingerprint** - Injects noise into audio context |
| 11 | +- **Navigator Spoofing** - Spoofs platform, userAgent, hardware info |
| 12 | + |
| 13 | +### Advanced Protections |
| 14 | +- **WebRTC IP Leak** - Filters local IP addresses from ICE candidates |
| 15 | +- **Battery API** - Returns spoofed battery status (100%, charging) |
| 16 | +- **Bluetooth API** - Blocks device enumeration |
| 17 | +- **Permissions API** - Returns configured permission states |
| 18 | +- **Storage API** - Spoofs quota and usage information |
| 19 | +- **Client Hints** - Spoofs User-Agent Client Hints |
| 20 | + |
| 21 | +### Profile Management |
| 22 | +- Save/load multiple browser profiles |
| 23 | +- Import/export profiles as JSON |
| 24 | +- Deterministic fingerprint recreation from seed |
| 25 | +- Profile presets (Paranoid, Balanced, Minimal) |
| 26 | + |
| 27 | +### OS Emulation |
| 28 | +Emulate different operating systems without VM: |
| 29 | +- Windows 10/11 |
| 30 | +- macOS Sonoma |
| 31 | +- Linux Ubuntu |
| 32 | + |
| 33 | +### Hardware Emulation |
| 34 | +- Intel i5/i7/i9 |
| 35 | +- AMD Ryzen 5/7/9 |
| 36 | +- Apple M1/M2/M3 |
| 37 | + |
| 38 | +### GPU Emulation |
| 39 | +- NVIDIA RTX 3060/4070/4090 |
| 40 | +- AMD RX 6700/7900 |
| 41 | +- Intel UHD 770 |
| 42 | +- Apple M1/M2/M3 GPU |
| 43 | + |
| 44 | +## Installation |
| 45 | + |
| 46 | +### From Release |
| 47 | +1. Download `neodetect-v2.0.0.zip` from releases |
| 48 | +2. Open `chrome://extensions/` |
| 49 | +3. Enable "Developer mode" |
| 50 | +4. Click "Load unpacked" |
| 51 | +5. Select the extracted folder |
| 52 | + |
| 53 | +### From Source |
| 54 | +```bash |
| 55 | +# Clone repository |
| 56 | +git clone https://github.com/gHashTag/trinity.git |
| 57 | +cd trinity |
2 | 58 |
|
3 | | -## Структура |
| 59 | +# Build WASM module |
| 60 | +zig build-lib src/firebird/neodetect_wasm.zig \ |
| 61 | + -target wasm32-freestanding \ |
| 62 | + -O ReleaseFast \ |
| 63 | + -femit-bin=extension/chrome/wasm/neodetect.wasm |
4 | 64 |
|
| 65 | +# Load extension/chrome folder in Chrome |
5 | 66 | ``` |
6 | | -extension/ |
7 | | -├── manifest.json # Chrome Manifest V3 (генерируется из .vibee) |
8 | | -├── popup/ |
9 | | -│ ├── popup.html # Popup UI (генерируется) |
10 | | -│ ├── popup.js # Popup logic (генерируется) |
11 | | -│ └── popup.css # Styles (генерируется) |
| 67 | + |
| 68 | +## Usage |
| 69 | + |
| 70 | +### Quick Start |
| 71 | +1. Click the NeoDetect icon in toolbar |
| 72 | +2. Select a preset (Paranoid, Balanced, or Minimal) |
| 73 | +3. Browse normally - fingerprint protection is active |
| 74 | + |
| 75 | +### Protection Presets |
| 76 | + |
| 77 | +| Preset | Description | Use Case | |
| 78 | +|--------|-------------|----------| |
| 79 | +| Paranoid | All protections enabled | Maximum privacy | |
| 80 | +| Balanced | Most protections, some disabled for compatibility | Daily browsing | |
| 81 | +| Minimal | Basic protections only | When sites break | |
| 82 | + |
| 83 | +### Profile Management |
| 84 | +1. Configure OS/Hardware/GPU settings |
| 85 | +2. Click "Save" to save current profile |
| 86 | +3. Click a saved profile to load it |
| 87 | +4. Use "Export" to backup profiles |
| 88 | +5. Use "Import" to restore profiles |
| 89 | + |
| 90 | +## File Structure |
| 91 | + |
| 92 | +``` |
| 93 | +extension/chrome/ |
| 94 | +├── manifest.json # Chrome Manifest V3 |
12 | 95 | ├── background/ |
13 | | -│ └── background.js # Service worker (генерируется) |
| 96 | +│ └── service-worker.js # WASM initialization, state management |
14 | 97 | ├── content/ |
15 | | -│ └── content.js # Content script (генерируется) |
| 98 | +│ └── content.js # Fingerprint injection |
| 99 | +├── popup/ |
| 100 | +│ ├── popup.html # Extension popup UI |
| 101 | +│ └── popup.js # Popup logic |
16 | 102 | ├── wasm/ |
17 | | -│ ├── firebird.wasm # Compiled from extension_wasm.zig |
18 | | -│ └── firebird.js # WASM loader (генерируется) |
19 | | -├── icons/ |
20 | | -│ ├── firebird-16.png |
21 | | -│ ├── firebird-32.png |
22 | | -│ ├── firebird-48.png |
23 | | -│ └── firebird-128.png |
24 | | -└── README.md # This file |
| 103 | +│ ├── neodetect.wasm # Compiled WASM module |
| 104 | +│ └── neodetect-loader.js # WASM JavaScript wrapper |
| 105 | +└── icons/ |
| 106 | + └── *.png # Extension icons |
25 | 107 | ``` |
26 | 108 |
|
27 | | -## Сборка |
| 109 | +## WASM API |
28 | 110 |
|
29 | | -### 1. Компиляция WASM модуля |
| 111 | +The extension uses a custom WASM module for fingerprint generation: |
30 | 112 |
|
31 | | -```bash |
32 | | -# Из корня проекта |
33 | | -cd /workspaces/trinity |
| 113 | +```javascript |
| 114 | +// Initialize |
| 115 | +NeoDetect.loadWasm(); |
| 116 | +NeoDetect.init(seed); |
34 | 117 |
|
35 | | -# Компиляция Zig → WASM (требует wasm32 target) |
36 | | -zig build-lib src/firebird/extension_wasm.zig \ |
37 | | - -target wasm32-freestanding \ |
38 | | - -O ReleaseFast \ |
39 | | - -femit-bin=extension/wasm/firebird.wasm |
40 | | -``` |
| 118 | +// Create profile |
| 119 | +NeoDetect.createProfile({ osType, hwType, gpuType }); |
41 | 120 |
|
42 | | -### 2. Генерация JS/HTML из .vibee |
| 121 | +// Get profile data |
| 122 | +const profile = NeoDetect.getProfileData(); |
43 | 123 |
|
44 | | -```bash |
45 | | -# Генерация из спецификаций |
46 | | -./bin/vibee gen specs/tri/browser_extension/manifest.vibee |
47 | | -./bin/vibee gen specs/tri/browser_extension/popup_ui.vibee |
48 | | -./bin/vibee gen specs/tri/browser_extension/content_script.vibee |
49 | | -./bin/vibee gen specs/tri/browser_extension/tri_staking.vibee |
| 124 | +// Evolution |
| 125 | +NeoDetect.evolveFingerprint(targetSimilarity, maxGenerations); |
| 126 | +NeoDetect.aiEvolve(targetSimilarity); |
50 | 127 | ``` |
51 | 128 |
|
52 | | -### 3. Загрузка в Chrome |
| 129 | +## Testing |
53 | 130 |
|
54 | | -1. Открыть `chrome://extensions/` |
55 | | -2. Включить "Developer mode" |
56 | | -3. Нажать "Load unpacked" |
57 | | -4. Выбрать папку `extension/` |
| 131 | +### Fingerprint Test Page |
| 132 | +Open `extension/test/fingerprint-test.html` to verify protections: |
| 133 | +- Navigator properties |
| 134 | +- Screen properties |
| 135 | +- Canvas fingerprint |
| 136 | +- WebGL fingerprint |
| 137 | +- Audio fingerprint |
| 138 | +- WebRTC IP leak |
| 139 | +- Battery API |
| 140 | +- Bluetooth API |
| 141 | +- Permissions API |
| 142 | +- Client Hints |
| 143 | +- Storage API |
58 | 144 |
|
59 | | -## Спецификации (.vibee) |
| 145 | +### External Testing |
| 146 | +- [BrowserLeaks](https://browserleaks.com) - Comprehensive fingerprint test |
| 147 | +- [CreepJS](https://abrahamjuliot.github.io/creepjs/) - Advanced detection test |
| 148 | +- [AmIUnique](https://amiunique.org) - Uniqueness test |
60 | 149 |
|
61 | | -Все файлы extension генерируются из спецификаций: |
| 150 | +## Privacy |
62 | 151 |
|
63 | | -| Спецификация | Генерирует | |
64 | | -|--------------|------------| |
65 | | -| `extension_core.vibee` | Основная логика | |
66 | | -| `manifest.vibee` | manifest.json | |
67 | | -| `popup_ui.vibee` | popup.html/js/css | |
68 | | -| `content_script.vibee` | content.js | |
69 | | -| `tri_staking.vibee` | Staking UI/logic | |
| 152 | +- **No data collection** - All processing happens locally |
| 153 | +- **No external requests** - Extension works offline |
| 154 | +- **No telemetry** - Zero tracking or analytics |
| 155 | +- **Open source** - Full code transparency |
70 | 156 |
|
71 | | -## WASM API |
| 157 | +## Specifications |
72 | 158 |
|
73 | | -Экспортируемые функции из `extension_wasm.zig`: |
74 | | - |
75 | | -```zig |
76 | | -// Инициализация |
77 | | -export fn wasm_init(seed: u64) i32; |
78 | | -
|
79 | | -// Профили |
80 | | -export fn wasm_create_profile(seed: u64, dim: u32) i32; |
81 | | -export fn wasm_get_similarity() f64; |
82 | | -export fn wasm_get_canvas_hash() u64; |
83 | | -export fn wasm_get_webgl_hash() u64; |
84 | | -export fn wasm_get_audio_hash() u64; |
85 | | -
|
86 | | -// Навигация |
87 | | -export fn wasm_init_navigation(dim: u32, seed: u64) i32; |
88 | | -export fn wasm_navigate_step(strength: f64) f64; |
89 | | -export fn wasm_get_nav_steps() u32; |
90 | | -
|
91 | | -// DePIN |
92 | | -export fn wasm_get_pending_tri() f64; |
93 | | -export fn wasm_get_total_tri() f64; |
94 | | -export fn wasm_claim_rewards() f64; |
95 | | -export fn wasm_record_evasion() void; |
96 | | -
|
97 | | -// Evasion helpers |
98 | | -export fn wasm_get_screen_width() u32; |
99 | | -export fn wasm_get_screen_height() u32; |
100 | | -export fn wasm_get_timezone_offset() i32; |
101 | | -export fn wasm_get_language_index() u32; |
102 | | -
|
103 | | -// Cleanup |
104 | | -export fn wasm_cleanup() void; |
105 | | -``` |
| 159 | +All code is generated from `.vibee` specifications: |
106 | 160 |
|
107 | | -## Тестирование |
| 161 | +| Specification | Purpose | |
| 162 | +|---------------|---------| |
| 163 | +| `neodetect_core.vibee` | Core antidetect types and behaviors | |
| 164 | +| `neodetect_wasm.vibee` | WASM exports and memory layout | |
| 165 | +| `os_emulation.vibee` | OS fingerprint emulation | |
| 166 | +| `behavior_simulation.vibee` | Human behavior simulation | |
| 167 | +| `ai_evolution.vibee` | AI-powered fingerprint evolution | |
| 168 | +| `profile_manager.vibee` | Profile storage and encryption | |
| 169 | +| `advanced_protection.vibee` | WebRTC, Battery, Bluetooth protection | |
108 | 170 |
|
109 | | -```bash |
110 | | -# Unit tests для WASM модуля |
111 | | -zig test src/firebird/extension_wasm.zig |
112 | | -# 31 tests passed |
113 | | - |
114 | | -# После загрузки в Chrome |
115 | | -# 1. Открыть https://browserleaks.com/canvas |
116 | | -# 2. Проверить что canvas hash отличается |
117 | | -# 3. Проверить консистентность при перезагрузке |
118 | | -``` |
| 171 | +## Version History |
| 172 | + |
| 173 | +See [CHANGELOG.md](CHANGELOG.md) for release notes. |
119 | 174 |
|
120 | | -## Ограничения |
| 175 | +## License |
121 | 176 |
|
122 | | -⚠️ **Согласно правилам проекта (AGENTS.md):** |
123 | | -- .js, .html, .css файлы НЕ создаются вручную |
124 | | -- Все файлы ГЕНЕРИРУЮТСЯ из .vibee спецификаций |
125 | | -- Только .vibee и .zig файлы редактируются напрямую |
| 177 | +MIT License - See LICENSE file for details. |
126 | 178 |
|
127 | 179 | --- |
128 | 180 |
|
129 | | -*φ² + 1/φ² = 3 = TRINITY | KOSCHEI IS IMMORTAL* |
| 181 | +**KOSCHEI IS IMMORTAL | GOLDEN CHAIN IS CLOSED** |
0 commit comments