README

Affinity SDK for React Native.

Please note that versions >=4.2.6 <=5.0.0 might not work properly (see this PR).

For v5, please use versions >=5.0.1.

For v4, please use version 4.2.5 or, even better, update to v5.

React Native SDK extends CORE SDK. Make sure to check the CORE SDK documentation.

How to install:

npm i --save @affinityproject/affinity-react-native-sdk

Setup Integration Tests

Test credentials should be added to the top level .env file. These contain usernames and passwords of pre-populated accounts on the staging environment. Reach out to a team member for instructions on how to set up this file, or to obtain a copy.

Mapping

You may need some polyfills as some of the dependencies assume running in a Node environment.

npm install --save vm-browserify stream-browserify @react-native-community/netinfo \
  react-native-crypto react-native-randombytes react-native-get-random-values \
  amazon-cognito-identity-js assert events

Also need to configure your bundler (webpack, parcel, metro, etc.) with aliases for the modules named ..-browserify in metro.config.js:

module.exports = {
  resolver: {
    resolverMainFields: ['react-native', 'browser', 'module', 'main'],
    extraNodeModules: {
      // Polyfills for node libraries
      mobileRandomBytes: require.resolve('@affinidi/wallet-react-native-sdk/mobileRandomBytes'),
      crypto: require.resolve('react-native-crypto'),
      stream: require.resolve('stream-browserify'),
      vm: require.resolve('vm-browserify'),
    },
  },
}

Add the line below to your index.js / App.js

import 'react-native-get-random-values'

TextEncoder issue

In case TextEncoder not found error for React Native on making bundle, add the following to your index.js or App.js:

import * as encoding from 'text-encoding'

How to use

Please refer to @affinidi/wallet-core-sdk README

Usage no npm install needed!