Migration Overview

This guide will explain at high level the paradigms shifts between Lens v2 and Lens v3.


Exiting Concepts

  • Profile > Account - Lens v2 Profile are state of a single smart contract. Lens v3 Account on the other hand are smart contracts on their own.

  • Profile Manager > Account Manager - In v3, the concept of manager is handled by the Account smart contract itself.

  • Handle > Usernames - In v3 handles are now called usernames and you can have many namespaces.

  • Follow modules > Follow rules - In v3 rules are the new name for follow modules.

  • Reference modules > Post rules - In v3 rules are the new name for reference modules.

  • App ID > Fully fledged App primitives - Lens v3 has apps fully onchain which empowers tons of amazing stuff.

  • Gasless > Sponsorhips - Apps now create sponsorships for their users and are in control of who is sponsored or not.

New Concepts

You can explore the full documentation to see the new concepts Lens v3 offers, recommended to start at the "Concepts" tab at the top.

Deprecated Concepts

  • Profile Guardian in v3, the Account has an owner in more typical smart wallet fashion.

  • Handle Guardian there is not analog in v3.