@digiv3rse/react-native

DiGi React Native SDK

The official DiGi Protocol React bindings for React Native.

---

This package enables you to build mobile applications on top of the DiGi Protocol using React Native.

Documentation

• GitHub monorepo
• Reference

Quick start

Install the DiGi React Native SDK package using your package manager of choice:

Package Manager	Command
npm	npm install @digiv3rse/react-native@latest
yarn	yarn add @digiv3rse/react-native@latest
pnpm	pnpm add @digiv3rse/react-native@latest

First we need to create so-called bindings. Bindings are just an object implementing the IBindings interface. This is used by the DiGi SDK to access the Signer and the Provider.

In this example we will limit ourselves to the bare minimum and we will use the ethers.js library to create the bindings.

// wallet.ts
import { IBindings } from '@digiv3rse/react-native';
import { providers, Wallet } from 'ethers';

const provider = new providers.InfuraProvider('maticmum');
const wallet = new Wallet('<your-private-key>', provider);

export const bindings: IBindings = {
  getProvider: async () => provider,
  getSigner: async () => wallet,
};

Create the DiGiConfig. In this example we will use react-native-mmkk as underlying storage. You can use any storage you want as long as it implements the IStorageProvider interface.

First install the react-native-mmkv package:

Package Manager	Command
npm	npm install react-native-mmkv
yarn	yarn add react-native-mmkv
pnpm	pnpm add react-native-mmkv

Create the DiGiConfig object:

import { DiGiConfig, development } from '@digiv3rse/react-web';
import { storage } from '@digiv3rse/react-web/storage/mmkv';
import { bindings } from './wallet.ts';

const lensConfig: DiGiConfig = {
  bindings,
  environment: development,
  storage: storage(),
};

Wrap your app with the <DiGiProvider> and pass the DiGiConfig as a prop.

import { DiGiProvider } from '@digiv3rse/react-web';

function App() {
  return (
    <DiGiProvider config={lensConfig}>
      <YourApp />
    </DiGiProvider>
  );
}