🔐 SYS.SECURE_VAULT // v1.0.0

A high-performance, memory-safe encrypted message vault built in C, compiled to WebAssembly (WASM), and wrapped in a dynamic, cybersecurity-themed React dashboard.

(Note: Add a screenshot of your UI here later)

---

🧠 Architecture: How It Works

Unlike traditional web applications that rely on remote backend servers, SecureVault runs entirely in the client's browser with near-native speed.

1. The Core (C): Memory management, encryption logic, and state management are written purely in C.
2. The Bridge (Emscripten): The C code is compiled into a WebAssembly binary (.wasm) alongside a JavaScript glue file.
3. The Interface (React): A React frontend hooks directly into the WebAssembly execution context via global function calls (ccall), passing payloads directly into the C binary's memory space.

---

⚡ Features

• Store Secure Payload: Encrypt text with a numeric PIN and assign a maximum read limit (self-destruct timer).
• Retrieve Payload: Decrypt payloads using the assigned ID and PIN.
• Vault Index: View a live-updating memory table of all active and destroyed payloads.
• Threat Analysis: A simulated security matrix that tracks failed brute-force decryption attempts and calculates real-time risk scores.
• Access Logs: A raw terminal dump of all successful and failed interactions with the WASM core.

---

🚀 Running the Project Locally

Prerequisites

• Node.js (v14 or higher)
• npm package manager
• (Optional) Emscripten SDK if you wish to modify and recompile the C backend.

Setup Instructions

1. Clone the repository:

   git clone https://github.com/YOUR_USERNAME/YOUR_REPO_NAME.git
   cd YOUR_REPO_NAME

2. Install dependencies:

   npm install

3. Initialize the Vault:

   npm start

   The application will boot up at http://localhost:3000.

---

🛠️ Modifying the WebAssembly Core

If you edit the C source code, you must recompile it to update the React frontend. Run this Emscripten command in your terminal:

emcc your_c_file.c -o public/securevault.js \
  -s MODULARIZE=1 \
  -s EXPORT_NAME="SecureVaultModule" \
  -s EXPORTED_RUNTIME_METHODS='["ccall","cwrap","FS"]' \
  -s FORCE_FILESYSTEM=1

This will automatically overwrite the .js and .wasm files in the React public/ directory with your new logic.

---

SYS.SECURE_VAULT — Developed for WebAssembly exploration and frontend integration.