# AdBlock Network — Full Technical & System Documentation

## 1. System Summary & Purpose
AdBlock Network is a Manifest V3 browser extension and security framework designed to protect users against aggressive advertising, cross-site trackers, malicious domains, and unwanted network telemetry. Engineered by Juan Romero Domínguez, it operates entirely within the client's browser using native Declarative Net Request rulesets, ensuring instantaneous network request matching with zero latency penalty and zero external telemetry transmission.

---

## 2. Technical Architecture & Manifest V3 Engine
- **Declarative Net Request Engine**: Compiles rule dictionaries directly into browser-optimized bytecode arrays for Chromium (Chrome, Edge, Opera, Brave, Whale).
- **Zero-Cloud Filtering**: No web requests are routed through VPNs or external proxy servers. All evaluation occurs locally on the client machine.
- **Minimal RAM Footprint**: Eliminates heavy JavaScript content scripts in favor of declarative network blocking rules and CSS style injection only when necessary.
- **Whitelisting System**: Dynamic temporary (5-minute TTL) or permanent domain whitelisting directly via the extension popup.

---

## 3. Comprehensive 26-Module Security Taxonomy

### 3.1 Comfort & Navigation Shield (FREE & PRO)
1. **General Navigation Shield**: Core blocklist neutralizing banner ads, tracking scripts, and intrusive ad-servers.
2. **Social Media Blocker**: Strips tracking pixels, embedded like buttons, and social widget telemetry (Meta, X, TikTok, LinkedIn).
3. **Safe Search Filter**: Blocks forced search redirect loops and low-reputation search landing pages.
4. **URL Shortener Bypass**: Evades countdown timers, intermediary interstitials, and telemetry hops from short link services.
5. **Cookie Consent Blocker (CMP)**: Suppresses intrusive cookie consent popups while denying cross-site consent telemetry.
6. **Aggressive Popup Blocker**: Intercepts background tab-spawning scripts, onclick trigger popunders, and rogue redirects.
7. **YouTube No-Stop Mode**: Automatically dismisses the video playback pause dialog ("Video paused. Continue watching?") to ensure uninterrupted background audio and video.
8. **Google One Tap Auto-Login Blocker**: Suppresses the recurring Google identity prompt iframe on third-party sites.
9. **Anti-Anti-Adblock Module**: Neutralizes ad-block detection scripts to preserve clean web access.

### 3.2 Network Integrity & Telemetry
10. **DoH (DNS over HTTPS) Blocker**: Restricts unmanaged encrypted DNS telemetry evasion.
11. **Anti-Bypass VPN/DoH**: Prevents tracking scripts from leveraging public proxy endpoints to circumvent local filters.
12. **Dynamic DNS (DynDNS) Filter**: Filters high-risk domain registries frequently weaponized for temporary botnet nodes.

### 3.3 Advanced Threat Intelligence & Cybersecurity (PRO)
13. **Threat Intelligence Feed (TIF)**: Live multi-source threat intelligence database updated with active command & control (C2) servers.
14. **Zero-Day NRD7 Protection**: Proactively intercepts all domains registered within the past 7 days, eliminating flash phishing attacks.
15. **Malware Distribution Servers**: Neutralizes known drive-by exploit kits and malicious payload hosts.
16. **Fake & Phishing Portals**: Blocks deceptive cloned login portals (banking, crypto, social).
17. **DNS Rebinding Prevention**: Protects private LAN subnets (RFC 1918) against browser-mediated cross-origin pivot attacks.

### 3.4 Content & Privacy Controls (PRO)
18. **Adult & NSFW Parental Filter**: Total suppression of adult content and explicit media networks.
19. **Gambling & Casino Blocker**: Restricts betting platforms, lottery engines, and crypto casinos.
20. **Anti-Piracy Shield**: Blocks malicious torrent trackers and deceptive P2P delivery networks.
21. **Mass Spam TLD Filter**: Drops traffic to top-level domains known predominantly for hosting spam campaigns.

### 3.5 Device Vendor Telemetry Isolation (PRO)
22. **Amazon / AWS Web Telemetry**: Blocks diagnostic profiling and tracking across Amazon web portals.
23. **Apple iCloud & Services Telemetry**: Isolates background reporting when using Apple web services.
24. **Huawei / Honor Cloud Telemetry**: Neutralizes device tracking endpoints.
25. **LG WebOS & Samsung SmartThings**: Stops smart TV profiling and app store ad telemetry.
26. **Microsoft / Windows, Xiaomi, OPPO/Realme, Vivo, Roku, TikTok / TikTok Extended**: Prevents cloud profiling and background behavioral logging.

---

## 4. Authorship & Infrastructure
- **Author & Architect**: Juan Romero Domínguez (https://juanromerodominguez.dev)
- **Host Infrastructure**: Bare-Metal DELL PowerEdge R630, MikroTik CCR2116-12G-4S+, NGINX, Cloudflare edge.
- **Chrome Web Store**: https://chromewebstore.google.com/detail/adblock-network-firewall/aeacakanaldjkllcmigolpcokkpfncmc
- **Microsoft Edge Add-ons**: https://microsoftedge.microsoft.com/addons/detail/helfjcnfekkgojpcfecdickicngllkpp
- **Naver Whale Store**: https://store.whale.naver.com/detail/nbehkmkmojndgdeflpdkclgfpfibhdjl
- **Website**: https://adblock.network