react-native-privyx-crypto 0.1.0

package/README.md

@@ -0,0 +1,113 @@
+# react-native-privyx-crypto
+
+Post-quantum hybrid cryptography for React Native.
+
+Combines **X25519** (ECDH) + **ML-KEM-768** (post-quantum KEM) with **AES-256-GCM** encryption. Uses prebuilt native binaries — no Rust toolchain required.
+
+## Installation
+
+```bash
+npm install react-native-privyx-crypto
+```
+
+For iOS, after installing:
+
+```bash
+cd ios && pod install
+```
+
+## Usage
+
+```ts
+import {
+  generateX25519KeyPair,
+  generateMlKemKeyPair,
+  x25519DeriveSecret,
+  mlKemEncapsulate,
+  mlKemDecapsulate,
+  deriveHybridSecret,
+  encrypt,
+  decrypt,
+  generateIV,
+} from 'react-native-privyx-crypto';
+```
+
+### Key Generation
+
+```ts
+// Generate X25519 (ECDH) key pair
+const x25519 = await generateX25519KeyPair();
+// { publicKey: 'base64...', privateKey: 'base64...' }
+
+// Generate ML-KEM-768 (post-quantum) key pair
+const mlkem = await generateMlKemKeyPair();
+// { publicKey: 'base64...', privateKey: 'base64...' }
+```
+
+### Key Exchange (Initiator)
+
+```ts
+// Alice derives shared secret using her private key + Bob's public keys
+const x25519Secret = await x25519DeriveSecret(alice.privateKey, bob.x25519PublicKey);
+
+const mlkemEnc = await mlKemEncapsulate(bob.mlkemPublicKey);
+// { sharedSecret: 'base64...', ciphertext: 'base64...' }
+
+const hybridSecret = await deriveHybridSecret(x25519Secret, mlkemEnc.sharedSecret);
+```
+
+### Key Exchange (Responder)
+
+```ts
+// Bob derives shared secret using his private key + Alice's ciphertext
+const x25519Secret = await x25519DeriveSecret(bob.privateKey, alice.x25519PublicKey);
+
+const mlkemSecret = await mlKemDecapsulate(bob.mlkemPrivateKey, mlkemCiphertext);
+
+const hybridSecret = await deriveHybridSecret(x25519Secret, mlkemSecret);
+```
+
+Both parties arrive at the same `hybridSecret`.
+
+### Encrypt / Decrypt
+
+```ts
+const iv = await generateIV();
+const ciphertext = await encrypt('Hello, post-quantum world!', hybridSecret, iv);
+
+const plaintext = await decrypt(ciphertext, iv, hybridSecret);
+```
+
+## API
+
+All functions return `Promise`. All keys and ciphertexts are base64-encoded strings.
+
+| Function | Returns |
+|---|---|
+| `generateX25519KeyPair()` | `{ publicKey, privateKey }` |
+| `generateMlKemKeyPair()` | `{ publicKey, privateKey }` |
+| `x25519DeriveSecret(privateKey, publicKey)` | `string` (shared secret) |
+| `mlKemEncapsulate(publicKey)` | `{ sharedSecret, ciphertext }` |
+| `mlKemDecapsulate(privateKey, ciphertext)` | `string` (shared secret) |
+| `deriveHybridSecret(x25519Secret, mlkemSecret)` | `string` (SHA-256 hybrid) |
+| `encrypt(plaintext, sharedSecret, iv)` | `string` (base64 ciphertext) |
+| `decrypt(ciphertext, iv, sharedSecret)` | `string` (plaintext) |
+| `generateIV()` | `string` (base64 12-byte IV) |
+
+## Supported Platforms
+
+| Platform | Architectures |
+|---|---|
+| Android | arm64-v8a, armeabi-v7a, x86_64 |
+| iOS (device) | arm64 |
+| iOS (simulator) | arm64-sim, x86_64-sim |
+
+## Requirements
+
+- React Native >= 0.71
+- Android minSdk 24+
+- iOS 15.1+
+
+## License
+
+MIT

package/android/build/generated/source/buildConfig/debug/com/privyx/BuildConfig.java

@@ -0,0 +1,10 @@
+/**
+ * Automatically generated file. DO NOT MODIFY
+ */
+package com.privyx;
+
+public final class BuildConfig {
+  public static final boolean DEBUG = Boolean.parseBoolean("true");
+  public static final String LIBRARY_PACKAGE_NAME = "com.privyx";
+  public static final String BUILD_TYPE = "debug";
+}

package/android/build/intermediates/aapt_friendly_merged_manifests/debug/processDebugManifest/aapt/AndroidManifest.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.privyx" >
+
+    <uses-sdk android:minSdkVersion="24" />
+
+</manifest>

package/android/build/intermediates/aapt_friendly_merged_manifests/debug/processDebugManifest/aapt/output-metadata.json

@@ -0,0 +1,18 @@
+{
+  "version": 3,
+  "artifactType": {
+    "type": "AAPT_FRIENDLY_MERGED_MANIFESTS",
+    "kind": "Directory"
+  },
+  "applicationId": "com.privyx",
+  "variantName": "debug",
+  "elements": [
+    {
+      "type": "SINGLE",
+      "filters": [],
+      "attributes": [],
+      "outputFile": "AndroidManifest.xml"
+    }
+  ],
+  "elementType": "File"
+}

package/android/build/intermediates/aar_metadata/debug/writeDebugAarMetadata/aar-metadata.properties

@@ -0,0 +1,6 @@
+aarFormatVersion=1.0
+aarMetadataVersion=1.0
+minCompileSdk=1
+minCompileSdkExtension=0
+minAndroidGradlePluginVersion=1.0.0
+coreLibraryDesugaringEnabled=false

package/android/build/intermediates/annotation_processor_list/debug/javaPreCompileDebug/annotationProcessors.json

@@ -0,0 +1 @@
+{}

package/android/build/intermediates/incremental/debug/packageDebugResources/compile-file-map.properties

@@ -0,0 +1 @@
+#Sun May 10 16:59:06 WIB 2026

package/android/build/intermediates/incremental/debug/packageDebugResources/merger.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merger version="3"><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="main$Generated" generated="true" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/android/src/main/res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="main" generated-set="main$Generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/android/src/main/res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="debug$Generated" generated="true" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/android/src/debug/res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="debug" generated-set="debug$Generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/android/src/debug/res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="generated$Generated" generated="true" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/android/build/generated/res/resValues/debug"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="generated" generated-set="generated$Generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/android/build/generated/res/resValues/debug"/></dataSet><mergedItems/></merger>

package/android/build/intermediates/incremental/mergeDebugAssets/merger.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merger version="3"><dataSet config="main" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/android/src/main/assets"/></dataSet><dataSet config="debug" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/android/src/debug/assets"/></dataSet><dataSet config="generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/android/build/intermediates/shader_assets/debug/compileDebugShaders/out"/></dataSet></merger>

package/android/build/intermediates/incremental/mergeDebugJniLibFolders/merger.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merger version="3"><dataSet config="main" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/libs/android"><file name="armeabi-v7a/libprivyx_crypto.so" path="/Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/libs/android/armeabi-v7a/libprivyx_crypto.so"/><file name="arm64-v8a/libprivyx_crypto.so" path="/Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/libs/android/arm64-v8a/libprivyx_crypto.so"/><file name="x86_64/libprivyx_crypto.so" path="/Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/libs/android/x86_64/libprivyx_crypto.so"/></source></dataSet><dataSet config="debug" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/android/src/debug/jniLibs"/></dataSet></merger>

package/android/build/intermediates/incremental/mergeDebugShaders/merger.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merger version="3"><dataSet config="main" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/android/src/main/shaders"/></dataSet><dataSet config="debug" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/android/src/debug/shaders"/></dataSet></merger>

package/android/build/intermediates/local_only_symbol_list/debug/parseDebugLocalResources/R-def.txt

@@ -0,0 +1,2 @@
+R_DEF: Internal format may change without notice
+local

package/android/build/intermediates/manifest_merge_blame_file/debug/processDebugManifest/manifest-merger-blame-debug-report.txt

@@ -0,0 +1,7 @@
+1<?xml version="1.0" encoding="utf-8"?>
+2<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+3    package="com.privyx" >
+4
+5    <uses-sdk android:minSdkVersion="24" />
+6
+7</manifest>

package/android/build/intermediates/merged_manifest/debug/processDebugManifest/AndroidManifest.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.privyx" >
+
+    <uses-sdk android:minSdkVersion="24" />
+
+</manifest>

package/android/build/intermediates/navigation_json/debug/extractDeepLinksDebug/navigation.json

@@ -0,0 +1 @@
+[]

package/android/build/intermediates/nested_resources_validation_report/debug/generateDebugResources/nestedResourcesValidationReport.txt

@@ -0,0 +1 @@
+0 Warning/Error

package/android/build/intermediates/symbol_list_with_package_name/debug/generateDebugRFile/package-aware-r.txt

@@ -0,0 +1 @@
+com.privyx

package/android/build/kotlin/compileDebugKotlin/cacheable/caches-jvm/lookups/counters.tab

@@ -0,0 +1,2 @@
+2
+0

package/android/build/outputs/logs/manifest-merger-debug-report.txt

@@ -0,0 +1,17 @@
+-- Merging decision tree log ---
+manifest
+ADDED from /Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/android/src/main/AndroidManifest.xml:1:1-3:12
+INJECTED from /Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/android/src/main/AndroidManifest.xml:1:1-3:12
+	package
+		ADDED from /Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/android/src/main/AndroidManifest.xml:2:11-31
+		INJECTED from /Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/android/src/main/AndroidManifest.xml
+	xmlns:android
+		ADDED from /Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/android/src/main/AndroidManifest.xml:1:11-69
+uses-sdk
+INJECTED from /Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/android/src/main/AndroidManifest.xml reason: use-sdk injection requested
+INJECTED from /Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/android/src/main/AndroidManifest.xml
+INJECTED from /Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/android/src/main/AndroidManifest.xml
+	android:targetSdkVersion
+		INJECTED from /Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/android/src/main/AndroidManifest.xml
+	android:minSdkVersion
+		INJECTED from /Users/erfinbadriansyah/Documents/privyx/mobile-apps/node_modules/react-native-privyx-crypto/android/src/main/AndroidManifest.xml

package/android/build.gradle

@@ -0,0 +1,36 @@
+def safeExtGet(prop, fallback) {
+    rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+}
+
+apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android'
+
+android {
+    namespace "com.privyx"
+    compileSdkVersion safeExtGet('compileSdkVersion', 36)
+
+    defaultConfig {
+        minSdkVersion safeExtGet('minSdkVersion', 24)
+        targetSdkVersion safeExtGet('targetSdkVersion', 36)
+    }
+
+    sourceSets {
+        main {
+            jniLibs.srcDirs = ['../libs/android']
+        }
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+
+    kotlinOptions {
+        jvmTarget = '17'
+    }
+}
+
+dependencies {
+    implementation "com.facebook.react:react-android:+"
+    implementation "org.jetbrains.kotlin:kotlin-stdlib:${safeExtGet('kotlinVersion', '2.1.20')}"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,3 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+          package="com.privyx">
+</manifest>