react-native-randombytes

Usage

1import { randomBytes } from 'react-native-randombytes'
2
3// synchronous API
4// uses SJCL
5const rand = randomBytes(4)
6
7// asynchronous API
8// uses iOS-side SecRandomCopyBytes
9randomBytes(4, (err, bytes) => {
10  // bytes is a Buffer object
11  console.log(bytes.toString('hex'))
12})

Installation

1. Follow the steps in the next section

2. You have two options depending on your needs:

   1. if you're trying to get Node.js or browser crypto modules working in React Native, follow the installation workflow in react-native-crypto.
   2. if you only need asynchronous random bytes generation, and don't care about getting back Buffer objects, you can do the following:

   1import { NativeModules } from 'react-native'
   2const { RNRandomBytes } = NativeModules
   3RNRandomBytes.randomBytes(32, (err, bytes) => {
   4  // bytes is a base64string
   5})

Automatic - Android / iOS (recommended)

1react-native link

Manual

If Automatic installation failed you, dry your tears and read on.

iOS

• Drag RNRandomBytes.xcodeproj from node_modules/react-native-randombytes into your XCode project.

• Click on the project in XCode, go to Build Phases, then Link Binary With Libraries and add libRNRandomBytes.a

Confused? See an example with screenshots here

Android

• Update Gradle Settings

1// file: android/settings.gradle
2...
3
4include ':randombytes', ':app'
5project(':randombytes').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-randombytes/android')

• Update Gradle Build

1// file: android/app/build.gradle
2...
3
4dependencies {
5    ...
6    compile project(':randombytes')
7}

• Register React Package

1...
2import com.bitgo.randombytes.RandomBytesPackage // import
3
4public class MainActivity extends Activity implements DefaultHardwareBackBtnHandler {
5
6    private ReactInstanceManager mReactInstanceManager;
7    private ReactRootView mReactRootView;
8
9    @Override
10    protected void onCreate(Bundle savedInstanceState) {
11        super.onCreate(savedInstanceState);
12        mReactRootView = new ReactRootView(this);
13        mReactInstanceManager = ReactInstanceManager.builder()
14                .setApplication(getApplication())
15                .setBundleAssetName("index.android.bundle")
16                .setJSMainModuleName("index.android")
17                .addPackage(new MainReactPackage())
18                .addPackage(new RandomBytesPackage()) // register package here
19                .setUseDeveloperSupport(BuildConfig.DEBUG)
20                .setInitialLifecycleState(LifecycleState.RESUMED)
21                .build();
22        mReactRootView.startReactApplication(mReactInstanceManager, "AwesomeProject", null);
23        setContentView(mReactRootView);
24    }
25...
26

Windows

1react-native link react-native-randombytes

Depending on your project versions and the state of RN-Windows this may not always work. If it does not, a manual installation guide can be found here:

https://github.com/Microsoft/react-native-windows/blob/master/docs/LinkingLibrariesWindows.md