The official React Hooks to interact with the Lens Protocol


This section of docs is valid for Lens Protocol v1

React Hooks SDK v2 is coming soon but it's not available yet.

🚧 🚧 🚧 🚧 🚧 🚧 🚧 🚧 🚧 🚧 🚧 🚧 🚧 🚧 🚧 🚧 🚧 🚧 🚧 🚧

The Lens SDK includes a collection of React Hooks containing all you need to interact with the Lens Protocol.

It provides a foundation that abstracts away the complexity of some low-level concepts of the Lens Protocol and Lens API.

Some of the key aspects:

Type Safe

The SDK is written in TypeScript and shipped with all the type definitions you need. It generates its underlying type definitions from the Lens API GraphQL schema so you can rely on end-to-end type safety.


Good to know

Although it is based on the Lens GraphQL API, you don't need to learn GraphQL to use it.


The SDK takes care of the initial authentication handshake, persistence of auth tokens, renewal of expired tokens and transparently retries unauthorized requests.


The SDK takes care of storing relevant information for subsequent user sessions. It comes with out-of-the-box adapters for common storage providers and will enable developers to define the storage provider solution that works best for their application needs.

It will guide you through breaking changes

The core logic of the Lens SDK has been developed side-by-side with the Lens Protocol and Lens API. It is the result of early integration efforts and encapsulates the knowledge of past technical decisions as well as future development direction.

It's the perfect place to provide support and migration strategies for protocol and API-breaking changes.


What’s Next