permissionless.js is a TypeScript library built on top of viem for deploying and managing ERC-4337 smart accounts, interacting with bundlers and paymasters, and leveraging custom signers.
- High-Level Smart Account Support: We support a high-level API for deploying and managing smart accounts, including some of the most popular implementations (Safe, Kernel, Biconomy, etc.)
- Bundler Support: We support all bundler actions following ERC-4337.
- Gas Sponsorship: We support paymaster actions to allow you to easily sponsor gas fees.
- User Operation Utility Functions: We provide many low-level utility functions useful for dealing with User Operations.
- Modular and Extensible: We allow you to easily create and plug in your own smart account systems, bundlers, paymasters, and signers.
- Built on & for viem: permissionless.js is designed to be a thin wrapper around viem, maintaining the same style and overall feel viem provides.
- and a lot more...
Take a look at our documentation to learn more about permissionless.js.
Install viem as a peer dependency.
Then install permissionless.js:
npm install viem permissionlessbun install viem permissionlessyarn add viem permissionless// Import the required modules.
import { createBundlerClient } from "permissionless"
import { sepolia } from "viem/chains"
import { http } from "viem"
// Create the required clients.
const bundlerClient = createBundlerClient({
chain: sepolia,
transport: http(`https://api.pimlico.io/v1/sepolia/rpc?apikey=${pimlicoApiKey}`) // Use any bundler url
})
// Consume bundler, paymaster, and smart account actions!
const userOperationReceipt = await bundlerClient.getUserOperationReceipt({
hash: "0x5faea6a3af76292c2b23468bbea96ef63fb31360848be195748437f0a79106c8"
})For a full explanation of permissionless.js, please visit our docs page
Build permissionless.js locally with:
bun run buildDistributed under an MIT License. See LICENSE for more information.
Feel free to ask any questions in our Telegram group