@kryklin/darkstar-crypt-node 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,70 @@
+# @kryklin/darkstar-crypt-node
+
+> **Darkstar V2 Encryption Protocol - Node.js Implementation**
+
+A high-performance, standalone implementation of the Darkstar V2 security protocol for Node.js. Designed for web backends and desktop applications requiring defense-in-depth for sensitive mnemonic assets.
+
+## 🛡️ Security Features
+
+- **Dynamic Obfuscation Pool**: 12-stage transformation pipeline seeded by password and data.
+- **AES-256-CBC**: Encapsulated with 600,000 PBKDF2 iterations.
+- **Stateless Reversal**: Requires a "Reverse Key" produced during encryption for decryption.
+- **Native Performance**: Leverages the Node.js `crypto` module.
+
+## 🚀 Installation
+
+```bash
+npm install @kryklin/darkstar-crypt-node
+```
+
+## 💻 Usage
+
+### Library Usage
+
+```javascript
+import { DarkstarCrypt } from '@kryklin/darkstar-crypt-node';
+
+const crypt = new DarkstarCrypt();
+
+// Encrypt
+const { encryptedData, reverseKey } = await crypt.encrypt("my secret phrase", "password123");
+console.log('Encrypted:', encryptedData);
+console.log('Reverse Key:', reverseKey);
+
+// Decrypt
+const decrypted = await crypt.decrypt(encryptedData, "password123", reverseKey);
+console.log('Decrypted:', decrypted);
+```
+
+### CLI Usage
+
+The package includes a CLI tool that can be run via `npx`.
+
+```bash
+# Encrypt
+npx darkstar-crypt encrypt "secret message" "password"
+
+# Decrypt
+npx darkstar-crypt decrypt '{"v":2,"data":"..."}' "password" "REVERSE_KEY_B64"
+
+# Run internal tests
+npx darkstar-crypt test
+```
+
+## 📜 Data Format
+
+Standard output is a JSON-encapsulated object:
+
+```json
+{
+  "v": 2,
+  "data": "SALT(32)IV(32)CIPHERTEXT(B64)"
+}
+```
+
+> [!IMPORTANT]
+> The **Reverse Key** is essential for decryption. It must be stored securely alongside the encrypted data.
+
+## ⚖️ License
+
+MIT © Victor Kane

package/darkstar_crypt.js

@@ -233,7 +233,7 @@ export class DarkstarCrypt {
     const saltHex = this.buf2hex(salt);
     const ivHex = this.buf2hex(iv);
     const ciphertextBase64 = this.buf2base64(encrypted);
-
+    
     return saltHex + ivHex + ciphertextBase64;
   }
 
@@ -557,3 +557,53 @@ export class DarkstarCrypt {
     };
   }
 }
+
+// --- CLI Support ---
+
+import { fileURLToPath } from 'node:url';
+import { resolve } from 'node:path';
+
+const __filename = fileURLToPath(import.meta.url);
+const isMain = process.argv[1] && resolve(process.argv[1]) === resolve(__filename);
+
+if (isMain) {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    const crypt = new DarkstarCrypt();
+
+    if (command === 'encrypt') {
+        const mnemonic = args[1];
+        const password = args[2];
+        crypt.encrypt(mnemonic, password).then(res => {
+            console.log(JSON.stringify(res));
+        }).catch(err => {
+            console.error(err);
+            process.exit(1);
+        });
+    } else if (command === 'decrypt') {
+        const data = args[1];
+        const rk = args[2];
+        const password = args[3];
+        crypt.decrypt(data, rk, password).then(res => {
+            console.log(res);
+        }).catch(err => {
+            console.error(err);
+            process.exit(1);
+        });
+    } else if (command === 'test') {
+        const mnemonic = "cat dog fish bird";
+        const password = "MySecre!Password123";
+        crypt.encrypt(mnemonic, password).then(res => {
+            return crypt.decrypt(res.encryptedData, res.reverseKey, password);
+        }).then(decrypted => {
+            if (decrypted === "cat dog fish bird") {
+                console.log("Test Passed!");
+            } else {
+                console.error("Test Failed!");
+                process.exit(1);
+            }
+        });
+    } else {
+        console.log("Usage: node darkstar_crypt.js <encrypt|decrypt|test> ...");
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kryklin/darkstar-crypt-node",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Standalone Node.js implementation of Darkstar Encryption",
   "main": "darkstar_crypt.js",
   "type": "module",