@anonympins/fingerprint 0.3.8 → 0.4.1

package/CHANGELOG.md

@@ -1,3 +1,97 @@
+## Version 0.4.1
+
+### 🐍 Full Python Engine Support & Middlewares
+- **Introducing the Python Fingerprint Engine**: Ported the entire behavioral, cryptographic, and network analysis engine to Python 3.8+, ensuring complete cross-language parity with the Node.js and PHP versions.
+- **JS-Compatible Hashing (`cyrb53` & `imul`)**: Implemented deterministic JS-compatible `cyrb53` hashing by emulating JavaScript's signed 32-bit integer multiplication (`Math.imul`) for consistent fingerprint generation.
+- **Universal Middlewares (ASGI & WSGI)**:
+  - `ASGIFingerprintMiddleware`: Universal ASGI 3.0 middleware designed for FastAPI, Starlette, Quart, Sanic, and more.
+  - `WSGIFingerprintMiddleware`: Universal WSGI 1.0 middleware compatible with Flask, Django, and legacy python applications, featuring safe asynchronous bridges under the hood.
+  - `FastAPIFingerprintMiddleware`: Dedicated integration class utilizing Starlette's `BaseHTTPMiddleware` for seamless FastAPI injection.
+- **Full Detection Suite Ported**:
+  - Real-time CPU and Memory Proof-of-Work (PoW) verification.
+  - Advanced TLS Spoofing Detection cross-referencing JA3/JA4 signatures against User-Agents.
+  - Client Hints and HTTP header anomaly scoring.
+  - Honeypot form fields & trap URLs condemnation mechanism.
+- **Asynchronous Storage & State Management**: Ported the TTL-capable memory store to Python (`InMemoryStore`) supporting high-performance asynchronous lookups.
+- **Robust Testing & CI Integration**: Added complete pytest coverage (`test_engine.py`) and integrated Python testing matrix (Python 3.8 to 3.12) in the GitHub Actions CI pipeline.
+
+---
+
+## Version 0.4.0
+
+### ⚡ WebAssembly (WASM) v2 Client-Side Solver & Autoloader
+- **WASM by Default**: WebAssembly acceleration is now active by default (`wasm: true`). The client library automatically attempts to load the WASM modules from the public library path (`/fp.js` and `/fp.wasm`), falling back to pure JavaScript only if loading fails.
+- **Full WASM v2 Solver**: Re-engineered the client-side solvers (`solveCpuTargetInline`, `solveMemory`) to execute fully inside WebAssembly, ensuring high-speed cryptographic evaluations and significantly increasing resistance to client-side reverse engineering and tampering.
+
+### 🧬 Native PHP TLS Fingerprinting & `TLSClientHelloParser`
+- **Introducing TLSClientHelloParser**: Added native binary parser in PHP to inspect raw TLS Client Hello packets. This enables real-time extraction and computation of JA3 and JA4 TLS fingerprints directly inside PHP.
+- **Asynchronous PHP Support**: Built-in support for event-driven PHP runtimes (Swoole, ReactPHP, Workerman). This allows intercepting the raw TCP socket stream, parsing the TLS handshake, and attaching the calculated TLS fingerprint before upgrading to SSL/TLS.
+- **Architectural Documentation**: Added detailed guides on why standard PHP (PHP-FPM, Apache) cannot extract TLS fingerprints natively (due to TLS termination at Nginx/CDN layer) and how to bypass this using modern asynchronous PHP application servers.
+
+### 📊 Documentation & Monitoring Updates
+- **Prometheus Metrics**: Updated `prometheus_metrics.md` to reflect newer indicators and score metrics.
+- **Home Documentation**: Updated `home.md` with guidelines on WASM integrations and native PHP event-loop setups.
+
+---
+
+## Why can't PHP calculate TLS fingerprints natively?
+
+Unlike Node.js, which often acts as a direct web server terminating TLS connections itself and exposing socket metadata (like `socket.clientHello`), standard PHP (PHP-FPM, Apache `mod_php`) runs behind a web server or a reverse proxy.
+
+1. **TLS Termination**: Your web server (Nginx, Apache) or CDN (Cloudflare) terminates the TLS connection. It performs the cryptographic handshake and decrypts the traffic.
+2. **FastCGI / SAPI Abstraction**: The web server forwards a clean, plain-text HTTP request to PHP. By the time PHP gets the request, the raw **TLS Client Hello** packet (which contains the cipher suites and extensions order needed to compute JA3/JA4) has already been processed and discarded.
+
+### Alternatives to compiling server modules:
+If you cannot install custom modules like `ngx_http_ssl_ja3_module` on your server, you can use one of the following approaches:
+
+* **Cloudflare**: Cloudflare automatically calculates the JA3 signature and forwards it in the `CF-JA3-Sig` header. You can map this header to `X-JA3-Hash` in your configuration.
+* **AWS Cloudfront**: Cloudfront can be configured to forward TLS client handshakes headers.
+* **PHP Application Servers (Swoole / ReactPHP / Workerman)**: By bypassing standard reverse proxies and handling sockets directly, you can use the built-in native `TLSClientHelloParser` to intercept the binary handshake directly inside PHP's Event Loop.
+
+### Native TLS Extraction inside PHP Event Loops (e.g., Workerman)
+
+If you run a raw TCP worker, you can peek at the first incoming bytes of the stream connection (the raw **Client Hello** payload) before upgrading the connection stream to SSL/TLS.
+
+Here is a concrete example using the native `TLSClientHelloParser` within a Workerman connection listener:
+
+```php
+<?php
+
+use Workerman\Worker;
+use Workerman\Connection\TcpConnection;
+use Anonympins\Fingerprint\Utils\TLSClientHelloParser;
+
+$worker = new Worker('tcp://0.0.0.0:443');
+
+$worker->onConnect = function(TcpConnection $connection) {
+    // Intercept the first chunk of data (the raw TLS handshake)
+    $connection->onMessage = function(TcpConnection $connection, $rawData) {
+        // Parse the binary payload to calculate JA3 natively in PHP
+        $tlsData = TLSClientHelloParser::parse($rawData);
+        if ($tlsData) {
+            // Attach the fingerprint directly to the connection context
+            $connection->ja3Hash = $tlsData['ja3_hash'];
+        }
+
+        // Clear the temporary plain-text parser callback
+        $connection->onMessage = null;
+
+        // Dynamically upgrade the socket transport layer to SSL (initiates cryptographic handshake)
+        $connection->transport = 'ssl';
+
+        // Bind your final application logic/HTTP router
+        $connection->onMessage = function($conn, $httpPayload) {
+            // $conn->ja3Hash is available here for real-time security score checks!
+        };
+
+        // Pipe back the buffered bytes so the SSL engine can consume the Client Hello
+        $connection->consumeFirstLocalBuffer($rawData);
+    };
+};
+
+Worker::runAll();
+```
+
 ## Version 0.3.8
 
 ### 🎫 Opaque Tickets Implementation (JS/PHP)

package/README.md

@@ -1,54 +1,61 @@
-# Fingerprint anti-bot protection
-
-NodeJS tests : [![Test NodeJS](https://img.shields.io/github/actions/workflow/status/anonympins/fingerprint/ci-nodejs.yml)](https://github.com/anonympins/fingerprint/actions/workflows/ci.yml)
-
-PHP tests : [![PHP](https://img.shields.io/github/actions/workflow/status/anonympins/fingerprint/ci-php.yml)](https://github.com/anonympins/fingerprint/actions/workflows/ci.yml)
-
-[![Release](https://img.shields.io/github/v/release/anonympins/fingerprint)](https://github.com/anonympins/fingerprint/releases)
-[![License](https://img.shields.io/github/license/anonympins/fingerprint)](https://github.com/anonympins/fingerprint/blob/main/LICENSE)
-![GitHub commit activity](https://img.shields.io/github/commit-activity/w/anonympins/fingerprint)
-
-A multi-layered behavioral, cryptographic, and network analysis engine designed to identify and mitigate malicious requests (bots, scrapers, session hijacking) in real-time. Supports both **Node.js** and **PHP** environments.
-
-## Key Features
-
-- **Multi-Layered Detection**: Combines TLS/JA3/JA4 analysis, HTTP header consistency checks, IP reputation, and behavioral tracking (mouse movements, keystrokes).
-- **Adaptive Mitigation**: Imposes progressive cryptographic Proof-of-Work (PoW) challenges to block automated clients without impacting legitimate human users.
-- **Predefined Profiles**: Ready-to-use security profiles (`balanced`, `strict`, `api`, `blog`, `ecommerce`) tailored to your specific use case.
-
-## Quick Start
-
-### Node.js
-
-```bash
-npm install @anonympins/fingerprint
-```
-
-### PHP
-
-```bash
-composer require anonympins/fingerprint
-```
-
-## Documentation
-
-To prevent documentation drift, all detailed guides and reference materials are maintained in the `doc/` directory. Please refer to [these resources](home) to configure and integrate the engine:
-
-1. **[Key Concepts & Suspicion Vectors](https://github.com/anonympins/fingerprint/wiki/concepts)**: Learn how the engine calculates suspicion scores across the 15 distinct vectors and manages the Proof-of-Work mitigation layers.
-2. **[Node.js Integration Guide](https://github.com/anonympins/fingerprint/wiki/nodejs_integration)**: Step-by-step instructions for Express.js middleware and raw HTTP server integrations.
-3. **[PHP Integration Guide](https://github.com/anonympins/fingerprint/wiki/php_integration)**: Configuration details for direct PHP integration, TLS fingerprinting forwarding via Nginx/Apache, and securing Prometheus metrics.
-4. **[Full Configuration Options](https://github.com/anonympins/fingerprint/wiki/full_options)**: Complete parameter list for fine-tuning weights, custom honeypots, and security profile overrides.
-5. **[API Reference](https://github.com/anonympins/fingerprint/wiki/api_reference)**: Public API signatures and guides on substituting the in-memory datastore with Redis or MongoDB.
-
-Start with the **[Documentation Portal](home)** for a complete index.
-
-## Contributing
-
-We welcome community contributions! Please read our **[Contributing Guidelines](https://github.com/anonympins/fingerprint/blob/main/CONTRIBUTING.md)** for information on:
-- Setting up your local environment (Node.js and PHP).
-- Running the test suites (`Vitest` and `PHPUnit`).
-- Coding and pull request standards.
-
-## License
-
+# Fingerprint anti-bot protection
+
+NodeJS tests : [![Test NodeJS](https://img.shields.io/github/actions/workflow/status/anonympins/fingerprint/ci-nodejs.yml)](https://github.com/anonympins/fingerprint/actions/workflows/ci.yml) / PHP tests : [![PHP](https://img.shields.io/github/actions/workflow/status/anonympins/fingerprint/ci-php.yml)](https://github.com/anonympins/fingerprint/actions/workflows/ci-php.yml) / Python tests : [![PHP](https://img.shields.io/github/actions/workflow/status/anonympins/fingerprint/ci-php.yml)](https://github.com/anonympins/fingerprint/actions/workflows/ci-python.yml)
+
+[![Release](https://img.shields.io/github/v/release/anonympins/fingerprint)](https://github.com/anonympins/fingerprint/releases)
+[![License](https://img.shields.io/github/license/anonympins/fingerprint)](https://github.com/anonympins/fingerprint/blob/main/LICENSE)
+![GitHub commit activity](https://img.shields.io/github/commit-activity/w/anonympins/fingerprint)
+
+A multi-layered behavioral, cryptographic, and network analysis engine designed to identify and mitigate malicious requests (bots, scrapers, session hijacking) in real-time. Supports both **Node.js** and **PHP** environments.
+
+![illustration](https://i.ibb.co/fV1QT6Mf/image-c6e10859baae53bb595112ec08fc9e27.png)
+
+## Key Features
+
+- **Multi-Layered Detection**: Combines TLS/JA3/JA4 analysis, HTTP header consistency checks, IP reputation, and behavioral tracking (mouse movements, keystrokes).
+- **Adaptive Mitigation**: Imposes progressive cryptographic Proof-of-Work (PoW) challenges to block automated clients without impacting legitimate human users.
+- **Predefined Profiles**: Ready-to-use security profiles (`balanced`, `strict`, `api`, `blog`, `ecommerce`) tailored to your specific use case.
+
+## Quick Start
+
+### Node.js
+
+```bash
+npm install @anonympins/fingerprint
+```
+
+### PHP
+
+```bash
+composer require anonympins/fingerprint
+```
+
+## Documentation
+
+To prevent documentation drift, all detailed guides and reference materials are maintained in the `doc/` directory. Please refer to [these resources](https://github.com/anonympins/fingerprint/wiki/home) to configure and integrate the engine:
+
+1. **[Key Concepts & Suspicion Vectors](https://github.com/anonympins/fingerprint/wiki/concepts)**: Learn how the engine calculates suspicion scores across the 15 distinct vectors and manages the Proof-of-Work mitigation layers.
+2. **[Node.js Integration Guide](https://github.com/anonympins/fingerprint/wiki/nodejs_integration)**: Step-by-step instructions for Express.js middleware and raw HTTP server integrations.
+3. **[PHP Integration Guide](https://github.com/anonympins/fingerprint/wiki/php_integration)**: Configuration details for direct PHP integration, TLS fingerprinting forwarding via Nginx/Apache, and securing Prometheus metrics.
+4. **[Full Configuration Options](https://github.com/anonympins/fingerprint/wiki/full_options)**: Complete parameter list for fine-tuning weights, custom honeypots, and security profile overrides.
+5. **[API Reference](https://github.com/anonympins/fingerprint/wiki/api_reference)**: Public API signatures and guides on substituting the in-memory datastore with Redis or MongoDB.
+
+Start with the **[Documentation Portal](https://github.com/anonympins/fingerprint/wiki/home)** for a complete index.
+
+## Contributing
+
+We welcome community contributions! Please read our **[Contributing Guidelines](https://github.com/anonympins/fingerprint/blob/main/CONTRIBUTING.md)** for information on:
+- Setting up your local environment (Node.js and PHP).
+- Running the test suites (`Vitest` and `PHPUnit`).
+- Coding and pull request standards.
+
+Thanks to our contributors : 
+- [anonympins](https://github.com/anonympins)
+
+## Used actively on
+
+- https://primals.net and sub-sites
+
+## License
+
 This project is licensed under the MIT License.

package/composer.json

@@ -1,39 +1,39 @@
-{
-    "name": "anonympins/fingerprint",
-    "description": "Advanced anti-bot library for Node.js and PHP using multi-layer fingerprinting, behavioral analysis, and adaptive Proof-of-Work (PoW) challenges.",
-    "type": "library",
-    "license": "MIT",
-    "authors": [
-        {
-            "name": "anonympins",
-            "homepage": "https://github.com/anonympins"
-        }
-    ],
-    "require": {
-        "php": ">=8.0",
-        "ext-json": "*",
-        "ext-bcmath": "*"
-    },
-    "require-dev": {
-        "phpunit/phpunit": "^9.5"
-    },
-    "autoload": {
-        "psr-4": {
-            "Anonympins\\Fingerprint\\": "src/php/"
-        }
-    },
-    "autoload-dev": {
-        "psr-4": {
-            "Anonympins\\Fingerprint\\Tests\\": "src/php/Tests/"
-        }
-    },
-    "suggest": {
-        "ext-gmp": "Recommended for high-performance big integer arithmetic in cryptographic challenges.",
-        "ext-redis": "Required to use the Redis store adapter.",
-        "ext-pdo": "Required to use SQL store adapters (e.g., for PostgreSQL, MySQL)."
-    },
-    "config": {
-        "sort-packages": true
-    },
-    "minimum-stability": "stable"
+{
+    "name": "anonympins/fingerprint",
+    "description": "Advanced anti-bot library for Node.js and PHP using multi-layer fingerprinting, behavioral analysis, and adaptive Proof-of-Work (PoW) challenges.",
+    "type": "library",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "anonympins",
+            "homepage": "https://github.com/anonympins"
+        }
+    ],
+    "require": {
+        "php": ">=8.0",
+        "ext-json": "*",
+        "ext-bcmath": "*"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "^9.5"
+    },
+    "autoload": {
+        "psr-4": {
+            "Anonympins\\Fingerprint\\": "src/php/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Anonympins\\Fingerprint\\Tests\\": "src/php/Tests/"
+        }
+    },
+    "suggest": {
+        "ext-gmp": "Recommended for high-performance big integer arithmetic in cryptographic challenges.",
+        "ext-redis": "Required to use the Redis store adapter.",
+        "ext-pdo": "Required to use SQL store adapters (e.g., for PostgreSQL, MySQL)."
+    },
+    "config": {
+        "sort-packages": true
+    },
+    "minimum-stability": "stable"
 }

package/index.js

@@ -1,5 +1,5 @@
-/**
- * Point d'entrée principal pour le package Node.js.
- * Ré-exporte toutes les fonctionnalités de la bibliothèque principale.
- */
+/**
+ * Point d'entrée principal pour le package Node.js.
+ * Ré-exporte toutes les fonctionnalités de la bibliothèque principale.
+ */
 export * from './src/js/fingerprint.js';

package/package.json

@@ -1,103 +1,103 @@
-{
-  "name": "@anonympins/fingerprint",
-  "version": "0.3.8",
-  "description": "Advanced anti-bot library for Node.js using multi-layer fingerprinting (JA3, client-side, headers), behavioral analysis, and adaptive Proof-of-Work (PoW) challenges to mitigate scraping, scalping, and automated threats.",
-  "main": "index.js",
-  "type": "module",
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "scripts": {
-    "test": "vitest run --reporter=verbose",
-    "build": "node src/js/build-client.js"
-  },
-  "exports": {
-    ".": "./index.js",
-    "./client": {
-      "import": "./src/js/fingerprint.client.obfuscated.js",
-      "require": "./src/js/fingerprint.client.obfuscated.js",
-      "browser": "./src/js/fingerprint.client.obfuscated.js"
-    },
-    "./client/src/*": "./src/js/*",
-    "./fp.wasm": "./public/fp.wasm",
-    "./fp.js": "./public/fp.js",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "index.js",
-    "src/js/",
-    "public/",
-    "README.md",
-    "LICENSE",
-    "CHANGELOG.md",
-    "src/php/",
-    "composer.json",
-    "phpunit.xml"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/anonympins/fingerprint.git"
-  },
-  "keywords": [
-    "anti-bot",
-    "bot-detection",
-    "security",
-    "middleware",
-    "express",
-    "nodejs",
-    "fingerprint",
-    "device-fingerprinting",
-    "ja3",
-    "tls-fingerprinting",
-    "proof-of-work",
-    "pow",
-    "useful-proof-of-work",
-    "upow",
-    "waf",
-    "scraping",
-    "scalping",
-    "mitigation",
-    "rate-limiting",
-    "honeypot",
-    "behavioral-analysis"
-  ],
-  "author": "anonympins",
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/anonympins/fingerprint/issues"
-  },
-  "homepage": "https://github.com/anonympins/fingerprint#readme",
-  "devDependencies": {
-    "cookie-parser": "^1.4.6",
-    "express": "^4.22.2",
-    "javascript-obfuscator": "^4.1.0",
-    "jsdom": "^24.0.0",
-    "prom-client": "^15.1.2",
-    "terser": "^5.30.3",
-    "vitest": "^4.1.11"
-  },
-  "overrides": {
-    "body-parser": "2.3.0",
-    "qs": "6.16.0"
-  },
-  "peerDependencies": {
-    "ioredis": "^5.3.2",
-    "knex": ">=3.0.0",
-    "mongodb": "^6.3.0",
-    "sqlite3": "^5.1.7"
-  },
-  "peerDependenciesMeta": {
-    "ioredis": {
-      "optional": true
-    },
-    "mongodb": {
-      "optional": true
-    },
-    "knex": {
-      "optional": true
-    },
-    "sqlite3": {
-      "optional": true
-    }
-  }
-}
+{
+  "name": "@anonympins/fingerprint",
+  "version": "0.4.1",
+  "description": "Advanced anti-bot library for Node.js using multi-layer fingerprinting (JA3, client-side, headers), behavioral analysis, and adaptive Proof-of-Work (PoW) challenges to mitigate scraping, scalping, and automated threats.",
+  "main": "index.js",
+  "type": "module",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "test": "vitest run --reporter=verbose",
+    "build": "node src/js/build-client.js"
+  },
+  "exports": {
+    ".": "./index.js",
+    "./client": {
+      "import": "./src/js/fingerprint.client.obfuscated.js",
+      "require": "./src/js/fingerprint.client.obfuscated.js",
+      "browser": "./src/js/fingerprint.client.obfuscated.js"
+    },
+    "./client/src/*": "./src/js/*",
+    "./fp.wasm": "./public/fp.wasm",
+    "./fp.js": "./public/fp.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.js",
+    "src/js/",
+    "public/",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md",
+    "src/php/",
+    "composer.json",
+    "phpunit.xml"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anonympins/fingerprint.git"
+  },
+  "keywords": [
+    "anti-bot",
+    "bot-detection",
+    "security",
+    "middleware",
+    "express",
+    "nodejs",
+    "fingerprint",
+    "device-fingerprinting",
+    "ja3",
+    "tls-fingerprinting",
+    "proof-of-work",
+    "pow",
+    "useful-proof-of-work",
+    "upow",
+    "waf",
+    "scraping",
+    "scalping",
+    "mitigation",
+    "rate-limiting",
+    "honeypot",
+    "behavioral-analysis"
+  ],
+  "author": "anonympins",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/anonympins/fingerprint/issues"
+  },
+  "homepage": "https://github.com/anonympins/fingerprint#readme",
+  "devDependencies": {
+    "cookie-parser": "^1.4.6",
+    "express": "^4.22.2",
+    "javascript-obfuscator": "^4.1.0",
+    "jsdom": "^24.0.0",
+    "prom-client": "^15.1.2",
+    "terser": "^5.30.3",
+    "vitest": "^4.1.11"
+  },
+  "overrides": {
+    "body-parser": "2.3.0",
+    "qs": "6.16.0"
+  },
+  "peerDependencies": {
+    "ioredis": "^5.3.2",
+    "knex": ">=3.0.0",
+    "mongodb": "^6.3.0",
+    "sqlite3": "^5.1.7"
+  },
+  "peerDependenciesMeta": {
+    "ioredis": {
+      "optional": true
+    },
+    "mongodb": {
+      "optional": true
+    },
+    "knex": {
+      "optional": true
+    },
+    "sqlite3": {
+      "optional": true
+    }
+  }
+}

package/phpunit.xml

@@ -1,21 +1,21 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.6/phpunit.xsd"
-         bootstrap="vendor/autoload.php"
-         colors="true">
-    <testsuites>
-        <testsuite name="default">
-            <directory suffix="Test.php">src/php/Tests</directory>
-        </testsuite>
-    </testsuites>
-
-    <coverage>
-        <include>
-            <directory suffix=".php">./src/php</directory>
-        </include>
-        <exclude>
-            <directory>./src/php/Tests/*</directory>
-            <directory>./src/php/Tests</directory>
-        </exclude>
-    </coverage>
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.6/phpunit.xsd"
+         bootstrap="vendor/autoload.php"
+         colors="true">
+    <testsuites>
+        <testsuite name="default">
+            <directory suffix="Test.php">src/php/Tests</directory>
+        </testsuite>
+    </testsuites>
+
+    <coverage>
+        <include>
+            <directory suffix=".php">./src/php</directory>
+        </include>
+        <exclude>
+            <directory>./src/php/Tests/*</directory>
+            <directory>./src/php/Tests</directory>
+        </exclude>
+    </coverage>
 </phpunit>

package/public/fp.js

@@ -1,2 +1,2 @@
-var createFingerprintModule=(()=>{var _scriptName=globalThis.document?.currentScript?.src;return async function(moduleArg={}){var Module=moduleArg;var ENVIRONMENT_IS_WEB=!!globalThis.window;var ENVIRONMENT_IS_WORKER=!!globalThis.WorkerGlobalScope;var ENVIRONMENT_IS_NODE=globalThis.process?.versions?.node&&globalThis.process?.type!="renderer";var programArgs=[];var thisProgram="./this.program";var quit_=(status,toThrow)=>{throw toThrow};if(typeof __filename!="undefined"){_scriptName=__filename}else if(ENVIRONMENT_IS_WORKER){_scriptName=self.location.href}var scriptDirectory="";function locateFile(path){if(Module["locateFile"]){return Module["locateFile"](path,scriptDirectory)}return scriptDirectory+path}var readAsync,readBinary;if(ENVIRONMENT_IS_NODE){var fs=require("node:fs");scriptDirectory=__dirname+"/";readBinary=filename=>{filename=isFileURI(filename)?new URL(filename):filename;var ret=fs.readFileSync(filename);return ret};readAsync=async(filename,binary=true)=>{filename=isFileURI(filename)?new URL(filename):filename;var ret=fs.readFileSync(filename,binary?undefined:"utf8");return ret};if(process.argv.length>1){thisProgram=process.argv[1].replace(/\\/g,"/")}programArgs=process.argv.slice(2);quit_=(status,toThrow)=>{process.exitCode=status;throw toThrow}}else if(ENVIRONMENT_IS_WEB||ENVIRONMENT_IS_WORKER){try{scriptDirectory=new URL(".",_scriptName).href}catch{}{if(ENVIRONMENT_IS_WORKER){readBinary=url=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,false);xhr.responseType="arraybuffer";xhr.send(null);return new Uint8Array(xhr.response)}}readAsync=async url=>{if(isFileURI(url)){return new Promise((resolve,reject)=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,true);xhr.responseType="arraybuffer";xhr.onload=()=>{if(xhr.status==200||xhr.status==0&&xhr.response){resolve(xhr.response);return}reject(xhr.status)};xhr.onerror=reject;xhr.send(null)})}var response=await fetch(url,{credentials:"same-origin"});if(response.ok){return response.arrayBuffer()}throw new Error(response.status+" : "+response.url)}}}else{}var out=console.log.bind(console);var err=console.error.bind(console);var wasmBinary;var ABORT=false;var isFileURI=filename=>filename.startsWith("file://");class EmscriptenEH{}class EmscriptenSjLj extends EmscriptenEH{}var runtimeInitialized=false;function updateMemoryViews(){var b=wasmMemory.buffer;HEAP8=new Int8Array(b);HEAPU8=new Uint8Array(b);HEAPU32=new Uint32Array(b)}function preRun(){var preRun=Module["preRun"];if(preRun){if(typeof preRun=="function")preRun=[preRun];onPreRuns.push(...preRun)}callRuntimeCallbacks(onPreRuns)}function initRuntime(){runtimeInitialized=true;wasmExports["e"]()}function postRun(){var postRun=Module["postRun"];if(postRun){if(typeof postRun=="function")postRun=[postRun];onPostRuns.push(...postRun)}callRuntimeCallbacks(onPostRuns)}function abort(what){Module["onAbort"]?.(what);what=`Aborted(${what})`;err(what);ABORT=true;what+=". Build with -sASSERTIONS for more info.";var e=new WebAssembly.RuntimeError(what);throw e}var wasmBinaryFile;function findWasmBinary(){return locateFile("fp.wasm")}function getBinarySync(file){if(readBinary){return readBinary(file)}throw"both async and sync fetching of the wasm failed"}async function getWasmBinary(binaryFile){if(!wasmBinary){try{var response=await readAsync(binaryFile);return new Uint8Array(response)}catch{}}return getBinarySync(binaryFile)}async function instantiateArrayBuffer(binaryFile,imports){try{var binary=await getWasmBinary(binaryFile);var instance=await WebAssembly.instantiate(binary,imports);return instance}catch(reason){err(`failed to asynchronously prepare wasm: ${reason}`);abort(reason)}}async function instantiateAsync(binary,binaryFile,imports){if(!binary&&!isFileURI(binaryFile)&&!ENVIRONMENT_IS_NODE){try{var response=fetch(binaryFile,{credentials:"same-origin"});var instantiationResult=await WebAssembly.instantiateStreaming(response,imports);return instantiationResult}catch(reason){err(`wasm streaming compile failed: ${reason}`);err("falling back to ArrayBuffer instantiation")}}return instantiateArrayBuffer(binaryFile,imports)}function getWasmImports(){var imports={a:wasmImports};return imports}async function createWasm(){function receiveInstance(instance){wasmExports=instance.exports;assignWasmExports(wasmExports);updateMemoryViews();return wasmExports}function receiveInstantiationResult(result){return receiveInstance(result["instance"])}var info=getWasmImports();var instantiateWasm=Module["instantiateWasm"];if(instantiateWasm){return new Promise(resolve=>{instantiateWasm(info,inst=>resolve(receiveInstance(inst)))})}wasmBinaryFile??=findWasmBinary();var result=await instantiateAsync(wasmBinary,wasmBinaryFile,info);var exports=receiveInstantiationResult(result);return exports}class ExitStatus{name="ExitStatus";constructor(status){this.message=`Program terminated with exit(${status})`;this.status=status}}var callRuntimeCallbacks=callbacks=>{while(callbacks.length>0){callbacks.shift()(Module)}};var onPostRuns=[];var onPreRuns=[];var noExitRuntime=true;var HEAP8;var HEAPU32;class ExceptionInfo{constructor(excPtr){this.excPtr=excPtr;this.ptr=excPtr-24}set_type(type){HEAPU32[this.ptr+4>>2]=type}get_type(){return HEAPU32[this.ptr+4>>2]}set_destructor(destructor){HEAPU32[this.ptr+8>>2]=destructor}get_destructor(){return HEAPU32[this.ptr+8>>2]}set_caught(caught){caught=caught?1:0;HEAP8[this.ptr+12]=caught}get_caught(){return HEAP8[this.ptr+12]!=0}set_rethrown(rethrown){rethrown=rethrown?1:0;HEAP8[this.ptr+13]=rethrown}get_rethrown(){return HEAP8[this.ptr+13]!=0}init(type,destructor){this.set_adjusted_ptr(0);this.set_type(type);this.set_destructor(destructor)}set_adjusted_ptr(adjustedPtr){HEAPU32[this.ptr+16>>2]=adjustedPtr}get_adjusted_ptr(){return HEAPU32[this.ptr+16>>2]}}var uncaughtExceptionCount=0;var __Unwind_RaiseException=ex=>{abort()};var ___cxa_throw=(ptr,type,destructor)=>{var info=new ExceptionInfo(ptr);info.init(type,destructor);uncaughtExceptionCount++;__Unwind_RaiseException(ptr)};var __abort_js=()=>abort("");var abortOnCannotGrowMemory=requestedSize=>{abort("OOM")};var HEAPU8;var _emscripten_resize_heap=requestedSize=>{var oldSize=HEAPU8.length;requestedSize>>>=0;abortOnCannotGrowMemory(requestedSize)};{if(Module["noExitRuntime"])noExitRuntime=Module["noExitRuntime"];if(Module["print"])out=Module["print"];if(Module["printErr"])err=Module["printErr"];if(Module["arguments"])programArgs=Module["arguments"];if(Module["thisProgram"])thisProgram=Module["thisProgram"];var preInit=Module["preInit"];if(preInit){if(typeof preInit=="function")Module["preInit"]=preInit=[preInit];while(preInit.length>0){preInit.shift()()}}}var _hash_string,memory,__indirect_function_table,wasmMemory;function assignWasmExports(wasmExports){_hash_string=Module["_hash_string"]=wasmExports["f"];memory=wasmMemory=wasmExports["d"];__indirect_function_table=wasmExports["__indirect_function_table"]}var wasmImports={c:___cxa_throw,a:__abort_js,b:_emscripten_resize_heap};async function run(){preRun();var setStatus=Module["setStatus"];if(setStatus){setStatus("Running...");await new Promise(resolve=>setTimeout(resolve,1));setTimeout(setStatus,1,"")}if(ABORT)return;initRuntime();Module["onRuntimeInitialized"]?.();postRun()}var wasmExports;wasmExports=await createWasm();await run();
+var createFingerprintModule=(()=>{var _scriptName=globalThis.document?.currentScript?.src;return async function(moduleArg={}){var Module=moduleArg;var ENVIRONMENT_IS_WEB=!!globalThis.window;var ENVIRONMENT_IS_WORKER=!!globalThis.WorkerGlobalScope;var ENVIRONMENT_IS_NODE=globalThis.process?.versions?.node&&globalThis.process?.type!="renderer";var programArgs=[];var thisProgram="./this.program";var quit_=(status,toThrow)=>{throw toThrow};if(typeof __filename!="undefined"){_scriptName=__filename}else if(ENVIRONMENT_IS_WORKER){_scriptName=self.location.href}var scriptDirectory="";function locateFile(path){if(Module["locateFile"]){return Module["locateFile"](path,scriptDirectory)}return scriptDirectory+path}var readAsync,readBinary;if(ENVIRONMENT_IS_NODE){var fs=require("node:fs");scriptDirectory=__dirname+"/";readBinary=filename=>{filename=isFileURI(filename)?new URL(filename):filename;var ret=fs.readFileSync(filename);return ret};readAsync=async(filename,binary=true)=>{filename=isFileURI(filename)?new URL(filename):filename;var ret=fs.readFileSync(filename,binary?undefined:"utf8");return ret};if(process.argv.length>1){thisProgram=process.argv[1].replace(/\\/g,"/")}programArgs=process.argv.slice(2);quit_=(status,toThrow)=>{process.exitCode=status;throw toThrow}}else if(ENVIRONMENT_IS_WEB||ENVIRONMENT_IS_WORKER){try{scriptDirectory=new URL(".",_scriptName).href}catch{}{if(ENVIRONMENT_IS_WORKER){readBinary=url=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,false);xhr.responseType="arraybuffer";xhr.send(null);return new Uint8Array(xhr.response)}}readAsync=async url=>{if(isFileURI(url)){return new Promise((resolve,reject)=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,true);xhr.responseType="arraybuffer";xhr.onload=()=>{if(xhr.status==200||xhr.status==0&&xhr.response){resolve(xhr.response);return}reject(xhr.status)};xhr.onerror=reject;xhr.send(null)})}var response=await fetch(url,{credentials:"same-origin"});if(response.ok){return response.arrayBuffer()}throw new Error(response.status+" : "+response.url)}}}else{}var out=console.log.bind(console);var err=console.error.bind(console);var wasmBinary;var ABORT=false;var isFileURI=filename=>filename.startsWith("file://");class EmscriptenEH{}class EmscriptenSjLj extends EmscriptenEH{}var runtimeInitialized=false;function updateMemoryViews(){var b=wasmMemory.buffer;HEAP8=new Int8Array(b);HEAPU8=new Uint8Array(b);HEAPU32=new Uint32Array(b)}function preRun(){var preRun=Module["preRun"];if(preRun){if(typeof preRun=="function")preRun=[preRun];onPreRuns.push(...preRun)}callRuntimeCallbacks(onPreRuns)}function initRuntime(){runtimeInitialized=true;wasmExports["e"]()}function postRun(){var postRun=Module["postRun"];if(postRun){if(typeof postRun=="function")postRun=[postRun];onPostRuns.push(...postRun)}callRuntimeCallbacks(onPostRuns)}function abort(what){Module["onAbort"]?.(what);what=`Aborted(${what})`;err(what);ABORT=true;what+=". Build with -sASSERTIONS for more info.";var e=new WebAssembly.RuntimeError(what);throw e}var wasmBinaryFile;function findWasmBinary(){return locateFile("fp.wasm")}function getBinarySync(file){if(readBinary){return readBinary(file)}throw"both async and sync fetching of the wasm failed"}async function getWasmBinary(binaryFile){if(!wasmBinary){try{var response=await readAsync(binaryFile);return new Uint8Array(response)}catch{}}return getBinarySync(binaryFile)}async function instantiateArrayBuffer(binaryFile,imports){try{var binary=await getWasmBinary(binaryFile);var instance=await WebAssembly.instantiate(binary,imports);return instance}catch(reason){err(`failed to asynchronously prepare wasm: ${reason}`);abort(reason)}}async function instantiateAsync(binary,binaryFile,imports){if(!binary&&!isFileURI(binaryFile)&&!ENVIRONMENT_IS_NODE){try{var response=fetch(binaryFile,{credentials:"same-origin"});var instantiationResult=await WebAssembly.instantiateStreaming(response,imports);return instantiationResult}catch(reason){err(`wasm streaming compile failed: ${reason}`);err("falling back to ArrayBuffer instantiation")}}return instantiateArrayBuffer(binaryFile,imports)}function getWasmImports(){var imports={a:wasmImports};return imports}async function createWasm(){function receiveInstance(instance){wasmExports=instance.exports;assignWasmExports(wasmExports);updateMemoryViews();return wasmExports}function receiveInstantiationResult(result){return receiveInstance(result["instance"])}var info=getWasmImports();var instantiateWasm=Module["instantiateWasm"];if(instantiateWasm){return new Promise(resolve=>{instantiateWasm(info,inst=>resolve(receiveInstance(inst)))})}wasmBinaryFile??=findWasmBinary();var result=await instantiateAsync(wasmBinary,wasmBinaryFile,info);var exports=receiveInstantiationResult(result);return exports}class ExitStatus{name="ExitStatus";constructor(status){this.message=`Program terminated with exit(${status})`;this.status=status}}var callRuntimeCallbacks=callbacks=>{while(callbacks.length>0){callbacks.shift()(Module)}};var onPostRuns=[];var onPreRuns=[];var noExitRuntime=true;var HEAP8;var HEAPU32;class ExceptionInfo{constructor(excPtr){this.excPtr=excPtr;this.ptr=excPtr-24}set_type(type){HEAPU32[this.ptr+4>>2]=type}get_type(){return HEAPU32[this.ptr+4>>2]}set_destructor(destructor){HEAPU32[this.ptr+8>>2]=destructor}get_destructor(){return HEAPU32[this.ptr+8>>2]}set_caught(caught){caught=caught?1:0;HEAP8[this.ptr+12]=caught}get_caught(){return HEAP8[this.ptr+12]!=0}set_rethrown(rethrown){rethrown=rethrown?1:0;HEAP8[this.ptr+13]=rethrown}get_rethrown(){return HEAP8[this.ptr+13]!=0}init(type,destructor){this.set_adjusted_ptr(0);this.set_type(type);this.set_destructor(destructor)}set_adjusted_ptr(adjustedPtr){HEAPU32[this.ptr+16>>2]=adjustedPtr}get_adjusted_ptr(){return HEAPU32[this.ptr+16>>2]}}var uncaughtExceptionCount=0;var __Unwind_RaiseException=ex=>{abort()};var ___cxa_throw=(ptr,type,destructor)=>{var info=new ExceptionInfo(ptr);info.init(type,destructor);uncaughtExceptionCount++;__Unwind_RaiseException(ptr)};var __abort_js=()=>abort("");var abortOnCannotGrowMemory=requestedSize=>{abort("OOM")};var HEAPU8;var _emscripten_resize_heap=requestedSize=>{var oldSize=HEAPU8.length;requestedSize>>>=0;abortOnCannotGrowMemory(requestedSize)};{if(Module["noExitRuntime"])noExitRuntime=Module["noExitRuntime"];if(Module["print"])out=Module["print"];if(Module["printErr"])err=Module["printErr"];if(Module["arguments"])programArgs=Module["arguments"];if(Module["thisProgram"])thisProgram=Module["thisProgram"];var preInit=Module["preInit"];if(preInit){if(typeof preInit=="function")Module["preInit"]=preInit=[preInit];while(preInit.length>0){preInit.shift()()}}}var _hash_string,_solve_cpu_target,_solve_memory_challenge,memory,__indirect_function_table,wasmMemory;function assignWasmExports(wasmExports){_hash_string=Module["_hash_string"]=wasmExports["f"];_solve_cpu_target=Module["_solve_cpu_target"]=wasmExports["g"];_solve_memory_challenge=Module["_solve_memory_challenge"]=wasmExports["h"];memory=wasmMemory=wasmExports["d"];__indirect_function_table=wasmExports["__indirect_function_table"]}var wasmImports={c:___cxa_throw,a:__abort_js,b:_emscripten_resize_heap};async function run(){preRun();var setStatus=Module["setStatus"];if(setStatus){setStatus("Running...");await new Promise(resolve=>setTimeout(resolve,1));setTimeout(setStatus,1,"")}if(ABORT)return;initRuntime();Module["onRuntimeInitialized"]?.();postRun()}var wasmExports;wasmExports=await createWasm();await run();
 ;return Module}})();if(typeof exports==="object"&&typeof module==="object"){module.exports=createFingerprintModule;module.exports.default=createFingerprintModule}else if(typeof define==="function"&&define["amd"])define([],()=>createFingerprintModule);

package/src/js/build-client.js

@@ -14,7 +14,7 @@ const __dirname = dirname(__filename);
 function buildWasm() {
   return new Promise((resolve) => {
     console.log('Attempting to build WASM module (optional)...');
-    const command = "em++ src/cpp/main.cpp src/cpp/utils.cpp -o public/fp.js -s WASM=1 -s MODULARIZE=1 -s EXPORT_NAME='createFingerprintModule' -s \"EXPORTED_FUNCTIONS=['_hash_string']\" -O3 --no-entry";
+    const command = "em++ src/cpp/main.cpp src/cpp/utils.cpp -o public/fp.js -s WASM=1 -s MODULARIZE=1 -s EXPORT_NAME='createFingerprintModule' -s \"EXPORTED_FUNCTIONS=['_hash_string','_solve_cpu_target','_solve_memory_challenge']\" -O3 --no-entry";
     
     exec(command, (error, stdout, stderr) => {
       if (error) {

package/src/js/fingerprint.client.js

@@ -553,6 +553,8 @@ const ClientLibrary = {
             if (typeof wasmModule._hash_string !== 'function') {
                 throw new Error('WASM module did not export _hash_string.');
             }
+        window.wasmModule = wasmModule;
+        ClientLibrary.wasmModule = wasmModule;
 
             // 4. Remplacer la fonction de hachage par la version WASM
             activeCyrb53 = (str) => {