docs: finalize badges (Single Version + Platform Support tags)

Author: athexweb3

README.md

@@ -1,91 +1,107 @@
 # Vanity Crypto
 
-![License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)
-![Language](https://img.shields.io/badge/language-Rust-orange.svg?style=flat-square)
-[![NPM Version](https://img.shields.io/npm/v/vanity_crypto.svg?style=flat-square)](https://www.npmjs.com/package/vanity_crypto)
-![CI - Linux](https://img.shields.io/github/actions/workflow/status/athexweb3/vanity_crypto/ci-linux.yml?label=Linux&style=flat-square)
-![CI - macOS](https://img.shields.io/github/actions/workflow/status/athexweb3/vanity_crypto/ci-macos.yml?label=macOS&style=flat-square)
-![CI - Windows](https://img.shields.io/github/actions/workflow/status/athexweb3/vanity_crypto/ci-windows.yml?label=Windows&style=flat-square)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Language](https://img.shields.io/badge/language-Rust-orange.svg)](https://www.rust-lang.org)
+[![Version](https://img.shields.io/github/v/release/athexweb3/vanity_crypto?label=version)](https://github.com/athexweb3/vanity_crypto/releases)
 
-**Vanity Crypto** is a high-performance, cryptographically secure Ethereum vanity address generator. It is designed to be the fastest and safest tool of its kind, leveraging Rust's safety guarantees and Rayon's parallelism.
+[![NPM](https://img.shields.io/badge/npm-supported-CB3837.svg?logo=npm&logoColor=white)](https://www.npmjs.com/package/vanity_crypto)
+[![Homebrew](https://img.shields.io/badge/homebrew-supported-FBB040.svg?logo=homebrew&logoColor=white)](https://github.com/athexweb3/vanity_crypto/tree/main/Formula)
+[![Scoop](https://img.shields.io/badge/scoop-supported-4084D0.svg?logo=windows&logoColor=white)](https://github.com/athexweb3/vanity_crypto/tree/main/scoop)
 
-## Design Goals
+[![CI - Linux](https://github.com/athexweb3/vanity_crypto/actions/workflows/ci-linux.yml/badge.svg)](https://github.com/athexweb3/vanity_crypto/actions/workflows/ci-linux.yml)
+[![CI - macOS](https://github.com/athexweb3/vanity_crypto/actions/workflows/ci-macos.yml/badge.svg)](https://github.com/athexweb3/vanity_crypto/actions/workflows/ci-macos.yml)
+[![CI - Windows](https://github.com/athexweb3/vanity_crypto/actions/workflows/ci-windows.yml/badge.svg)](https://github.com/athexweb3/vanity_crypto/actions/workflows/ci-windows.yml)
+[![Security Audit](https://github.com/athexweb3/vanity_crypto/actions/workflows/security.yml/badge.svg)](https://github.com/athexweb3/vanity_crypto/actions/workflows/security.yml)
+[![Benchmark](https://github.com/athexweb3/vanity_crypto/actions/workflows/benchmark.yml/badge.svg)](https://github.com/athexweb3/vanity_crypto/actions/workflows/benchmark.yml)
 
--   **Performance**: Utilizes all available CPU cores to maximize hash rate (MH/s).
--   **Security**: "Verify, Don't Trust." Every generated key is mathematically verifiable against standard Ethereum implementations.
--   **Experience**: A beautiful, real-time Terminal User Interface (TUI) that provides feedback without clutter.
--   **Portability**: First-class support for macOS (Apple Silicon/Intel), Linux, and Windows.
+**Vanity Crypto** is a high-performance, cryptographically secure Ethereum vanity address generator implementation. It is engineered to provide the highest possible search throughput on consumer hardware while maintaining strict distinctness of duties between key generation and verification.
 
----
+The library strictly adheres to the following standards:
+*   **[EIP-55](https://eips.ethereum.org/EIPS/eip-55)**: Mixed-case checksum address encoding.
+*   **[NIST FIPS 202](https://csrc.nist.gov/publications/detail/fips/202/final)**: SHA-3 Standard (Keccak-256).
+*   **[SEC 1](https://www.secg.org/sec1-v2.pdf)**: Elliptic Curve Cryptography (secp256k1).
+
+## Architecture
+
+The project employs a specific **Verify-after-Generate** architecture to eliminate single points of failure in the cryptographic logic.
+
+1.  **Entropy & Generation (Rust)**:
+    Using the `rand::OsRng` system entropy source, a 256-bit private key is generated. The corresponding public key is derived via `k256` (RustCrypto), and the address is computed via `keccak256`. This process is parallelized across all logical CPU cores using a work-stealing scheduler (`rayon`).
+
+2.  **Cross-Verification (Python)**:
+    Upon identifying a candidate address matching the user's constraints, the key material is passed to an isolated subprocess. This process invokes the `eth_account` library (the reference Python implementation) to independently re-derive the address from the private key.
+
+3.  **Validation**:
+    The result is presented to the user **if and only if** the Rust-derived address and the Python-derived address are bitwise identical.
 
 ## Installation
 
-### 1. NPM (Recommended)
-The quickest way to install for Node.js users.
+### NPM (Node.js)
+The suggested installation method for most users. This wrapper automatically downloads the correct architecture-specific binary for your system.
+
 ```bash
 npm install -g vanity_crypto
 ```
-*Or run purely without installation:*
-```bash
-npx vanity_crypto
-```
 
-### 2. Homebrew (macOS / Linux)
-Install via our official tap.
+### Homebrew (macOS / Linux)
+Distributed via a focused Tap to distinguish it from unverified tools.
+
 ```bash
 brew tap athexweb3/vanity_crypto https://github.com/athexweb3/vanity_crypto
 brew install vanity_crypto
 ```
 
-### 3. Scoop (Windows)
-Install via our official bucket.
+### Scoop (Windows)
+Distributed via a dedicated Bucket.
+
 ```bash
 scoop bucket add vanity_crypto https://github.com/athexweb3/vanity_crypto
 scoop install vanity_crypto
 ```
 
-### 4. Build from Source
-Required for running the Python Verification Suite.
+### Building from Source
+
+To build from source, a standard Rust toolchain (stable) is required. To run the verification suite, Python 3.10+ is also required.
+
 ```bash
 git clone https://github.com/athexweb3/vanity_crypto.git
 cd vanity_crypto
 cargo build --release
 ```
 
----
-
 ## Usage
 
-### Interactive Mode
-Simply run `vc` to launch the interactive TUI.
+### Interactive Mode (TUI)
+The binary launches into an interactive Terminal User Interface by default, providing real-time telemetry on hash rate and probability.
+
 ```bash
 vc
 ```
 
-### Command Line Arguments
-*(Coming in v1.0)*
+### Headless Mode
+For integration into automated pipelines, the CLI accepts arguments to bypass the TUI.
 
----
+| Argument | Description |
+| :--- | :--- |
+| `--prefix <HEX>` | The case-insensitive hex string to search for. |
+| `--case-sensitive` | strictly enforce casing (e.g. `DeaD` vs `dead`). |
+| `--threads <N>` | Override thread count (Default: logical core count). |
+| `--no-tui` | Disable the TUI and output only the final result JSON. |
 
-## Security & Verification
+## Independent Verification
 
-We believe cryptographic tools should be audible.
+Trust in cryptographic tools must be earned through verification. We provide a fuzzing suite that compares thousands of iterations of the Rust generator against the Python reference implementation.
 
-**Generation**: Keys are generated using strict adherence to `k256` (ECDSA) and `sha3` (Keccak-256) standards.
-
-**Verification**:
-To perform an independent audit of the generator's integrity, check out the source code and run the verification suite. This uses the Python `eth-account` library to cross-validate results.
+To run the audit:
 
 ```bash
 # Requires Python 3.10+
 python3 tests/verify_validate/fuzz_test.py 1000
 ```
-*Note: The binary release does not include the Python test scripts. You must clone the repo to run manual verification.*
-
----
 
 ## License
 
-The code is licensed under the [MIT License](LICENSE).
-
 Copyright (c) 2025 Athex Web3.
+This project is licensed under the **MIT License**.
+
+See [LICENSE](LICENSE) for more information.