Lens SDK

The official SDK for the Lens 🌿.

Table of Contents

• Installation
• Development Workflow
• Troubleshooting
• Contributing
• License

Installation

Development Workflow

This section is for developers who want to contribute to the SDK.

Initial Setup

Clone the repository:

git clone https://github.com/lens-network/sdk.git

Install the dependencies:

pnpm install

Pre-requisites:

• Node.js: >= v20. See installation guide.
• pnpm: v9.1.2. See installation guide.

Use nvm to manage your Node.js versions. Run the following command in the project root folder:

nvm use

to switch to the correct Node.js version.

Enable corepack to use the the correct version of pnpm.

Run the following command in the project root folder:

corepack install

to install the correct version once. After that corepack will automatically use the correct version of pnpm when entering the project folder.

Usage

Run the tests:

• pnpm test:client: Run the tests for the @lens-protocol/client package.

Lint the code:

pnpm lint

Compile the code:

pnpm build

Clean the build:

pnpm clean

Create a new package:

pnpm new:lib

IDE Setup

The project uses Biome to format and lint the code. You can install the Biome extension for your IDE: https://biomejs.dev/guides/editors/first-party-extensions/

Publishing

1. Create a new release branch using the release/X.Y.Z naming convention.

2. Bumps up version number and updates the changelog.

   pnpm changeset version

3. Commit the changes using chore: bumps up version number as the commit message.

4. Push the changes to the remote repository.

5. Open a pull request to the main branch.

6. Wait for all checks to pass and for the pull request to be approved.

7. Publish the package.

   pnpm changeset publish

8. Push tags to the remote repository.

   git push --follow-tags

9. Merge the pull request to the main branch.

Troubleshooting

Incompatible Types Across Packages

Working within a monorepo can sometimes lead to type incompatibilities across packages. If you encounter an error like:

Type 'import("[...]/packages/client/dist/index").PublicClient<import("[...]/packages/client/dist/index").Context>' is not assignable to type 'import("[...]/packages/client/src/clients").PublicClient<import("[...]/packages/client/src/context").Context>'.

This usually indicates that TypeScript is picking up types from different versions of the same package. To resolve this, make sure you have configured the entry points correctly as aliases in the top level tsconfig.json file.

{
  "$schema": "https://json.schemastore.org/tsconfig",
  "compilerOptions": {
    "skipLibCheck": true,
    "types": ["node"],
    "paths": {
      "@lens-protocol/client": ["./packages/client/src"],
      "@lens-protocol/client/actions": ["./packages/client/src/actions"],
      "@lens-protocol/client/test-utils": ["./packages/client/src/test-utils"],
      "@lens-protocol/env": ["./packages/env/src"],
      "@lens-protocol/graphql": ["./packages/graphql/src"],
      "@lens-protocol/react": ["./packages/react/src"],
      "@lens-protocol/storage": ["./packages/storage/src"],
      "@lens-protocol/types": ["./packages/types/src"]
    }
  },
  "include": ["**/*.ts"],
  "exclude": ["dist", "node_modules"]
}

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

License

Lens SDK is MIT licensed.