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:

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,
};
Copy

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:

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(),
};
Copy

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>
  );
}
Copy