@onekeyfe/react-native-get-random-values 3.0.157-alpha.275 → 3.0.157-alpha.276

package/README.md

@@ -1,5 +1,49 @@
 # @onekeyfe/react-native-get-random-values
 
+OneKey's React Native `crypto.getRandomValues` integration and native random
+byte interface. Importing the package installs the global function only when
+it is not already defined.
+
+## Installation and usage
+
+The current wrapper requires Expo modules and uses `expo-crypto` from Expo
+SDK 57. For a bare React Native app, first
+[install and configure Expo modules](https://docs.expo.dev/bare/installing-expo-modules/)
+with a compatible SDK.
+
+```sh
+yarn add @onekeyfe/react-native-get-random-values react-native-nitro-modules
+```
+
+`expo-crypto` and `fast-base64-decode` are runtime dependencies and are installed
+with this package. Install iOS pods and rebuild the native application before
+using the native path.
+
+```ts
+import '@onekeyfe/react-native-get-random-values';
+
+const bytes = new Uint8Array(16);
+crypto.getRandomValues(bytes);
+```
+
+## API and limits
+
+The global function fills the provided integer typed array in place and returns
+it. Floating-point arrays are rejected. One call may request at most 65,536
+bytes; requests above that size throw a quota error.
+
+The wrapper prefers Expo Crypto when available, otherwise it uses the native
+`getRandomBase64(byteLength)` method. A development debugger without synchronous
+native-call support has an explicitly insecure `Math.random` fallback and emits
+a warning. That fallback must not be mistaken for the native random-byte path.
+
+The named `ReactNativeGetRandomValues` export exposes the Nitro object on native
+platforms. See [src/index.tsx](src/index.tsx) for path selection and validation,
+and [src/ReactNativeGetRandomValues.nitro.ts](src/ReactNativeGetRandomValues.nitro.ts)
+for the native method signature.
+
+## Upstream attribution
+
 First, a sincere thank-you to Linus Unnebäck and the
 `react-native-get-random-values` maintainers for their excellent work 🙏
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-get-random-values",
-  "version": "3.0.157-alpha.275",
+  "version": "3.0.157-alpha.276",
   "description": "react-native-get-random-values",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -50,17 +50,22 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/OneKeyHQ/app-modules/react-native-get-random-values.git"
+    "url": "git+https://github.com/OneKeyHQ/app-modules.git",
+    "directory": "native-modules/react-native-get-random-values"
   },
   "author": "onekeyfe <huanming@onekey.so> (https://github.com/OneKeyHQ/app-modules)",
   "license": "MIT",
   "bugs": {
-    "url": "https://github.com/OneKeyHQ/app-modules/react-native-get-random-values/issues"
+    "url": "https://github.com/OneKeyHQ/app-modules/issues"
   },
-  "homepage": "https://github.com/OneKeyHQ/app-modules/react-native-get-random-values#readme",
+  "homepage": "https://github.com/OneKeyHQ/app-modules/tree/main/native-modules/react-native-get-random-values#readme",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
   },
+  "dependencies": {
+    "expo-crypto": "57.0.1",
+    "fast-base64-decode": "2.0.0"
+  },
   "devDependencies": {
     "@commitlint/config-conventional": "^19.8.1",
     "@eslint/compat": "^1.3.2",
@@ -89,6 +94,7 @@
     "typescript": "^5.9.2"
   },
   "peerDependencies": {
+    "expo": "*",
     "react": "*",
     "react-native": "*",
     "react-native-nitro-modules": "0.37.0"