Account SDKs

How to use the Module SDK with Permissionless.js

Permissionless.js (opens in a new tab) is one of the most widely used account SDKs. It is a typescript library that makes it easy to build with smart accounts. This guide will show you how to use the Module SDK with permissionless.js.

Install the packages

npm i viem @rhinestone/module-sdk permissionless

Import the required packages

import {
} from "permissionless";
import { signerToSafeSmartAccount } from "permissionless/accounts";
import {
} from "permissionless/clients/pimlico";
import { createPublicClient, getContract, http, parseEther } from "viem";
import { sepolia } from "viem/chains";

Create the clients

Create the smart account client and the bundler client.

export const publicClient = createPublicClient({
  transport: http(""),
export const pimlicoBundlerClient = createPimlicoBundlerClient({
  transport: http(""),

Create the signer

The Safe account will need to have a signer to sign user operations. In permissionless.js, the default Safe account validates ECDSA signatures.

For example, to create a signer based on a private key:

import { privateKeyToAccount } from "viem/accounts";
const signer = privateKeyToAccount("0xPRIVATE_KEY");

Create the Safe account

Create the Safe account object using the signer.

const safeAccount = await signerToSafeSmartAccount(publicClient, {
  signer: signer,
  saltNonce: 0n, // optional
  safeVersion: "1.4.1",
  address: "0x...", // optional, only if you are using an already created account

Create the smart account client

The smart account client is used to interact with the smart account.

const smartAccountClient = createSmartAccountClient({
  account: safeAccount,
  chain: sepolia,
  bundlerTransport: http(
  middleware: {
    gasPrice: async () => {
      return (await pimlicoBundlerClient.getUserOperationGasPrice()).fast;
}).extend(erc7579Actions({ entryPoint: ENTRYPOINT_ADDRESS_V07 }));

Create the module object

Get the module object for the module that you want to install on the smart account. In this case, we will install the Social Recovery Module. We will pass to it a number of guardians that can recover the account as well as a threshold of guardians required to recover the account.

import { getSocialRecoveryValidator } from "@rhinestone/module-sdk";
const module = getSocialRecoveryValidator({
  threshold: 2,
  guardians: ["0x1234...", "0x5678..."],

Install the module

With this module object, we can now install it on the smart account.

const opHash = await smartClient.installModule({
  type: module.type,
  address: module.module,

Wait for the UserOperation to be confirmed

Let's wait until the UserOperation is confirmed, after which the module will be installed.

await bundlerClientV07.waitForUserOperationReceipt({
  hash: opHash,
  timeout: 100000,