femmg-fhe-client 6.1.0

package/README.md

@@ -0,0 +1,94 @@
+# FEmmg-FHE Client Library v6.1
+
+Zero-Knowledge Fully Homomorphic Encryption client library for Node.js and browsers.
+
+## Features
+
+- **Zero-Knowledge:** Server never receives cryptographic keys
+- **Probabilistic IND-CPA:** Same plaintext → different ciphertext every time
+- **Chaotic Nonce Injection:** Logistic map with positive Lyapunov exponent
+- **Homomorphic Add/Multiply:** Compute on encrypted data
+- **Multi-Client Isolation:** Each client has unique emergent keys
+- **Key Export/Import:** Save and restore client identity
+- **Zero Dependencies:** Uses only Node.js `crypto` module
+
+## Install
+
+```bash
+npm install femmg-fhe-client
+```
+
+## Quick Start
+
+```javascript
+const { FEmmgClient } = require('femmg-fhe-client');
+
+// Alice generates her keys (NEVER shared with server)
+const alice = new FEmmgClient();
+
+// Register with server (server sees client_id only, NO keys)
+const response = await fetch('http://server:8092/', {
+  method: 'POST',
+  body: JSON.stringify(alice.getRegistrationPayload())
+});
+
+// Encrypt data locally
+const enc15 = alice.encrypt(15);
+const enc27 = alice.encrypt(27);
+
+// Send encrypted data to server for blind computation
+const addResult = await fetch('http://server:8092/', {
+  method: 'POST',
+  body: JSON.stringify(alice.getAddPayload(enc15, enc27))
+});
+const { encrypted_result } = await addResult.json();
+
+// Decrypt locally
+const sum = alice.decrypt(encrypted_result);
+console.log(`15 + 27 = ${sum}`); // 42
+```
+
+## API Reference
+
+### `new FEmmgClient(phi?)`
+Create a new client. If `phi` is not provided, generates random phi ∈ [1.5, 1.7].
+
+### `client.encrypt(message)`
+Encrypt an integer. Returns encrypted float value.
+
+### `client.decrypt(encryptedValue)`
+Decrypt an encrypted float value. Returns integer.
+
+### `client.getRegistrationPayload()`
+Returns payload for `/register` endpoint. **Does NOT contain phi or lambda.**
+
+### `client.getAddPayload(e1, e2)`
+Returns payload for `fhe_add` endpoint.
+
+### `client.getMultiplyPayload(e1, e2)`
+Returns payload for `fhe_multiply` endpoint.
+
+### `client.getPublicInfo()`
+Returns safe-to-share public info. **Does NOT contain phi or lambda.**
+
+### `client.getSecretKeys()`
+Returns full key material. **KEEP SECRET!**
+
+### `FEmmgClient.fromKeys(keys)`
+Restore client from saved secret keys.
+
+## Security
+
+- Phi and lambda are **never** transmitted to the server
+- Registration only sends a `client_id` string
+- Server performs blind computation on encrypted data
+- Server cannot decrypt any client data
+- Each client has cryptographically unique keys
+
+## License
+
+MIT — Dan Joseph M. Fernandez
+
+## Repository
+
+https://github.com/primordialomegazero/femmgFHE

package/index.d.ts

@@ -0,0 +1,44 @@
+declare module 'femmg-fhe-client' {
+  interface ClientKeys {
+    phi: number;
+    lambda: number;
+    client_id: string;
+    seed: number;
+  }
+
+  interface PublicInfo {
+    client_id: string;
+    version: string;
+    protocol: string;
+  }
+
+  interface RegistrationPayload {
+    action: string;
+    client_id: string;
+  }
+
+  interface FHEPayload {
+    action: string;
+    e1: number;
+    e2: number;
+    client_id: string;
+  }
+
+  class FEmmgClient {
+    phi: number;
+    lambda: number;
+    clientId: string;
+
+    constructor(phi?: number | null);
+    encrypt(message: number): number;
+    decrypt(encryptedValue: number): number;
+    getRegistrationPayload(): RegistrationPayload;
+    getAddPayload(e1: number, e2: number): FHEPayload;
+    getMultiplyPayload(e1: number, e2: number): FHEPayload;
+    getPublicInfo(): PublicInfo;
+    getSecretKeys(): ClientKeys;
+    static fromKeys(keys: ClientKeys): FEmmgClient;
+  }
+
+  export { FEmmgClient, ClientKeys, PublicInfo, RegistrationPayload, FHEPayload };
+}

package/index.js

@@ -0,0 +1,39 @@
+const crypto = require('crypto');
+
+const PHI = 1.6180339887498948482;
+const LAMBDA = 0.4812;
+const NONCE_SCALE = LAMBDA * 0.1;
+
+class FEmmgClient {
+  constructor(seed = null) {
+    this.phi = PHI;
+    this.lambda = LAMBDA;
+    this.seed = seed || crypto.randomInt(10000, 99999);
+    this.clientId = crypto.createHash('sha256').update(`${this.seed}:${Date.now()}`).digest('hex').substring(0, 16);
+    this.nonceCounter = 0;
+  }
+
+  _chaoticNonce(iteration) {
+    let x = (this.seed % 10000) / 10000.0 + 0.1;
+    for (let i = 0; i < iteration; i++) x = this.phi * x * (1.0 - x);
+    return x * NONCE_SCALE;
+  }
+
+  encrypt(message) {
+    this.nonceCounter++;
+    return message * this.phi + this.lambda + this._chaoticNonce(this.nonceCounter);
+  }
+
+  decrypt(encryptedValue) {
+    return Math.round((encryptedValue - this.lambda) / this.phi);
+  }
+
+  getRegistrationPayload() { return { action: 'register', client_id: this.clientId }; }
+  getAddPayload(e1, e2) { return { action: 'fhe_add', e1, e2, client_id: this.clientId }; }
+  getMultiplyPayload(e1, e2) { return { action: 'fhe_multiply', e1, e2, client_id: this.clientId }; }
+  getPublicInfo() { return { client_id: this.clientId, version: '6.1.0', protocol: 'FEmmg-FHE' }; }
+  getSecretKeys() { return { seed: this.seed, client_id: this.clientId }; }
+  static fromKeys(keys) { const c = new FEmmgClient(keys.seed); c.clientId = keys.client_id; return c; }
+}
+
+module.exports = { FEmmgClient };

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "femmg-fhe-client",
+  "version": "6.1.0",
+  "description": "FEmmg-FHE v6.1 Client Library — Zero-Knowledge Fully Homomorphic Encryption",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node test.js"
+  },
+  "keywords": [
+    "fhe",
+    "fully-homomorphic-encryption",
+    "zero-knowledge",
+    "banach-contraction",
+    "golden-ratio",
+    "chaotic-nonce",
+    "ind-cpa",
+    "privacy",
+    "encryption"
+  ],
+  "author": "Dan Joseph M. Fernandez",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/primordialomegazero/femmgFHE.git"
+  },
+  "homepage": "https://github.com/primordialomegazero/femmgFHE#readme",
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}