@lens-protocol/react-native

Lens React Native SDK

The official Lens Protocol React bindings for React Native.

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

Documentation

• GitHub monorepo
• Reference

Quick start

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

Package Manager	Command
npm	npm install @lens-protocol/react-native@latest
yarn	yarn add @lens-protocol/react-native@latest
pnpm	pnpm add @lens-protocol/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 Lens 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 '@lens-protocol/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 LensConfig. 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 LensConfig object:

import { LensConfig, development } from '@lens-protocol/react-web';
import { storage } from '@lens-protocol/react-web/storage/mmkv';
import { bindings } from './wallet.ts';

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

Wrap your app with the <LensProvider> and pass the LensConfig as a prop.

import { LensProvider } from '@lens-protocol/react-web';

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