Create an Account

This guide will help you create your first Lens account.

To create an Account, you need to:

Authenticate as an Onboarding User.
Create an Account Metadata object.
Upload the Account Metadata object onto a public URI.
Deploy the Lens Account smart contract.
Switch to Account Owner authentication role.

Log In as Onboarding User

First, authenticate as an Onboarding User.

The process is explained in detail in the Authentication guide, so we will keep it brief here.

TypeScript
GraphQL
React

Use the @lens-protocol/client package to authenticate as an Onboarding User:

import { client } from "./client";
const authenticated = await client.login({  onboardingUser: {    app: "0xaC19aa2402b3AC3f9Fe471D4783EC68595432465",    wallet: signer.address,  },  signMessage: (message) => signer.signMessage({ message }),});
if (authenticated.isErr()) {  return console.error(authenticated.error);}
// SessionClient: { ... }const sessionClient = authenticated.value;

Create Account Metadata

Then, construct a new Account Metadata object with the necessary details.

TS/JS
JSON Schema

Use the @lens-protocol/metadata package to construct a valid AccountMetadata object:

Exampleimport { MetadataAttributeType, account } from "@lens-protocol/metadata";
const metadata = account({  name: "Jane Doe",  bio: "I am a photographer based in New York City.",  picture: "lens://4f91cab87ab5e4f5066f878b72…",  coverPicture: "lens://4f91cab87ab5e4f5066f8…",  attributes: [    {      key: "twitter",      type: MetadataAttributeType.STRING,      value: "https://twitter.com/janedoexyz",    },    {      key: "dob",      type: MetadataAttributeType.DATE,      value: "1990-01-01T00:00:00Z",    },    {      key: "enabled",      type: MetadataAttributeType.BOOLEAN,      value: "true",    },    {      key: "height",      type: MetadataAttributeType.NUMBER,      value: "1.65",    },    {      key: "settings",      type: MetadataAttributeType.JSON,      value: '{"theme": "dark"}',    },  ],});

See the Lens Metadata Standards guide for more information on creating and hosting Metadata objects.

Upload Account Metadata

Then, upload the Account Metadata object to a public URI.

import { account } from "@lens-protocol/metadata";import { storageClient } from "./storage-client";
const metadata = account({  name: "Jane Doe",});
const { uri } = await storageClient.uploadAsJson(metadata);
console.log(uri); // e.g., lens://4f91ca…

This example uses Lens Storage to host the Metadata object. See the Lens Metadata Standards guide for more information on hosting Metadata objects.

Deploy Account Contract

Remember you MUST be authenticated as Onboarding User to make this request.

TypeScript
GraphQL
React

Then, you can use the createAccountWithUsername action to deploy Lens Account smart contract and contextually mint a username for it.

import { uri } from "@lens-protocol/client";import { createAccountWithUsername } from "@lens-protocol/client/action";
const result = await createAccountWithUsername(sessionClient, {  username: { localName: "wagmi" },  metadataUri: uri("lens://4f91ca…"),});

The Lens SDK example here leverages a functional approach to chaining operations using the Result<T, E> object. See the Error Handling guide for more information.

Handle Result

TypeScript
GraphQL
React

Finally, handle the result using the adapter for the library of your choice:

import { handleOperationWith } from "@lens-protocol/client/viem";
// …
const result = await createAccountWithUsername(sessionClient, {  username: { localName: "wagmi" },  metadataUri: uri("lens://4f91ca…"),}).andThen(handleOperationWith(walletClient));

See the Transaction Lifecycle guide for more information on how to determine the status of the transaction.

Switch to Account Owner

Finally, switch to the Account Owner authentication role.

GraphQL
React
TypeScript

Do so by using the account query to retrieve the newly created Account's address:

query {  account(request: { txHash: "0x5e9d8f8a4b8e4b8e4b8e4b8e4b8e4b8e4b8e4b" }) {    address    username    metadata {      name      picture    }  }}

Finally, use the switchAccount mutation to switch to the Account Owner role:

mutation {  switchAccount(request: { account: "0x1234…" }) {    ... on AuthenticationTokens {      accessToken      refreshToken      idToken    }
    ... on ForbiddenError {      reason    }  }}

That's it—you are now authenticated with the newly created Account.