Permissionless NPM

permissionless.js

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.

Features

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...

Documentation

Take a look at our documentation to learn more about permissionless.js.

Installation

Install viem as a peer dependency.

Then install permissionless.js:

npm install viem permissionless

bun install viem permissionless

yarn add viem permissionless

Quick Start

// 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"
})

Contributors

For a full explanation of permissionless.js, please visit our docs page

Build permissionless.js locally with:

bun run build

License

Distributed under an MIT License. See LICENSE for more information.

Contact

Feel free to ask any questions in our Telegram group

ethereum erc-4337 eip-4337 paymaster bundler

0.0.0-main.20240507T153712

2 days ago

0.0.0-main.20240507T160251

2 days ago

0.0.0-main.20240507T153851

2 days ago

0.1.26

2 days ago

0.0.0-main.20240506T110420

3 days ago

0.1.25

3 days ago

0.0.0-main.20240506T110337

3 days ago

0.0.0-main.20240502T125237

7 days ago

0.0.0-main.20240502T125905

7 days ago

0.0.0-main.20240502T135826

7 days ago

0.0.0-main.20240502T135906

7 days ago

0.1.23

7 days ago

0.1.24

7 days ago

0.0.0-main.20240502T125814

7 days ago

0.0.0-main.20240430T091058

9 days ago

0.0.0-main.20240429T162141

10 days ago

0.0.0-main.20240429T165244

10 days ago

0.0.0-main.20240429T162758

10 days ago

0.0.0-main.20240429T161213

10 days ago

0.1.22

10 days ago

0.0.0-main.20240425T132332

14 days ago

0.1.21

14 days ago

0.0.0-main.20240425T133009

14 days ago

0.0.0-main.20240420T115955

19 days ago

0.0.0-main.20240420T124656

19 days ago

0.1.20

19 days ago

0.0.0-main.20240419T075459

20 days ago

0.0.0-main.20240419T074704

20 days ago

0.1.19

20 days ago

0.0.0-main.20240417T113144

22 days ago

0.0.0-main.20240417T115342

22 days ago

0.1.18

22 days ago

0.0.0-main.20240415T180953

24 days ago

0.1.17

24 days ago

0.0.0-main.20240415T181030

24 days ago

0.0.0-main.20240410T073644

29 days ago

0.1.15

29 days ago

0.0.0-main.20240410T193135

29 days ago

0.0.0-main.20240410T073557

29 days ago

0.0.0-main.20240410T193339

29 days ago

0.1.16

29 days ago

0.0.0-main.20240411T150855

28 days ago

0.0.0-main.20240405T215959

1 month ago

0.0.0-fix-prepareuseroperation.20240406T093404

1 month ago

0.0.0-main.20240405T215813

1 month ago

0.1.13

1 month ago

0.1.14

1 month ago

0.0.0-main.20240405T221217

1 month ago

0.0.0-main.20240406T093631

1 month ago

0.0.0-main.20240406T093744

1 month ago

0.0.0-main.20240405T011154

1 month ago

0.0.0-main.20240405T091543

1 month ago

0.0.0-main.20240331T121656

1 month ago

0.0.0-main.20240329T111205

1 month ago

0.0.0-main.20240329T104243

1 month ago

0.0.0-main.20240329T130218

1 month ago

0.1.12

1 month ago

0.0.0-main.20240328T115730

1 month ago

0.0.0-main.20240328T120607

1 month ago

0.1.11

2 months ago

0.0.0-main.20240320T093622

2 months ago

0.0.0-main.20240320T093414

2 months ago

0.0.0-main.20240320T092932

2 months ago

0.0.0-main.20240311T053615

2 months ago

0.1.10

2 months ago

0.0.0-main.20240311T053712

2 months ago

0.0.0-main.20240311T053150

2 months ago

0.0.0-main.20240310T155659

2 months ago

0.0.0-main.20240310T155754

2 months ago

0.1.9

2 months ago

0.0.0-main.20240309T003341

2 months ago

0.1.8

2 months ago

0.0.0-main.20240309T003439

2 months ago

0.0.0-main.20240306T233509

2 months ago

0.0.0-main.20240306T233434

2 months ago

0.1.7

2 months ago

0.0.0-main.20240306T025802

2 months ago

0.0.0-main.20240306T031214

2 months ago

0.0.0-main.20240306T031316

2 months ago

0.1.6

2 months ago

0.0.0-main.20240304T233745

2 months ago

0.0.0-main.20240304T233854

2 months ago

0.0.0-main.20240304T233857

2 months ago

0.1.5

2 months ago

0.0.0-main.20240225T180125

2 months ago

0.0.0-feat-introduce-middleware.20240225T054242

2 months ago

0.0.0-main.20240225T031107

2 months ago

0.0.0-main.20240225T062303

2 months ago

0.0.0-main.20240225T180050

2 months ago

0.0.0-fix-paymaster-actions.20240225T172106

2 months ago

0.0.0-fix-paymaster-actions.20240225T163625

2 months ago

0.0.0-main.20240225T032238

2 months ago

0.0.0-main.20240225T150616

2 months ago

0.0.0-main.20240225T060022

2 months ago

0.0.0-main.20240225T062213

2 months ago

0.0.0-main.20240225T055808

2 months ago

0.0.0-fix-paymaster-actions.20240225T170916

2 months ago

0.0.0-main.20240225T151402

2 months ago

0.0.0-main.20240225T032835

2 months ago

0.0.0-main.20240225T145517

2 months ago

0.0.0-fix-paymaster-actions.20240225T171309

2 months ago

0.0.0-fix-paymaster-actions.20240225T173048

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

0.0.0-fix-paymaster-actions.20240225T161832

2 months ago

0.0.0-main.20240224T211916

2 months ago

0.0.0-feat-ep-v0-7.20240222T120918

3 months ago

0.0.0-feat-ep-v0-7.20240222T063139

3 months ago

0.0.0-main.20240224T214411

2 months ago

0.0.36

3 months ago

0.0.0-main.20240217T135822

3 months ago

0.0.0-main.20240217T135846

3 months ago

0.0.0-fix-signer-type.20240213T113751

3 months ago

0.0.0-main.20240201T121604

3 months ago

0.0.0-main.20240201T123214

3 months ago

0.0.35

3 months ago

0.0.0-main.20240130T173141

3 months ago

0.0.0-main.20240130T172727

3 months ago

0.0.0-feat-wagmi.20240130T155639

3 months ago

0.0.0-main.20240130T171508

3 months ago

0.0.0-main.20240130T145903

3 months ago

0.0.0-feat-wagmi.20240130T162620

3 months ago

0.0.0-feat-wagmi.20240130T172152

3 months ago

0.0.0-feat-wagmi.20240130T171635

3 months ago

0.0.34

3 months ago

0.0.0-feat-wagmi.20240130T151420

3 months ago

0.0.0-main.20240130T150229

3 months ago

0.0.0-main.20240129T170749

3 months ago

0.0.0-feat-providertosmartaccountsigner.20240129T160732

3 months ago

0.0.0-feat-wagmi-connector.20240128T141207

3 months ago

0.0.0-main.20240129T175839

3 months ago

0.0.0-feat-wagmi-connector.20240128T114123

3 months ago

0.0.32

3 months ago

0.0.33

3 months ago

0.0.0-feat-wagmi-connector.20240127T183329

3 months ago

0.0.0-feat-wagmi-connector.20240128T134502

3 months ago

0.0.0-main.20240128T152239

3 months ago

0.0.0-feat-wagmi-connector.20240127T184157

3 months ago

0.0.0-main.20240125T155713

4 months ago

0.0.31

4 months ago

0.0.0-main.20240125T155209

4 months ago

0.0.0-main.20240125T155634

4 months ago

0.0.0-main.20240121T223942

4 months ago

0.0.30

4 months ago

0.0.0-feat-sendcompresseduseroperation.20240121T211804

4 months ago

0.0.0-feat-sendcompresseduseroperation.20240121T214807

4 months ago

0.0.0-main.20240121T223910

4 months ago

0.0.0-feat-state-overrides.20240120T083924

4 months ago

0.0.0-main.20240120T090922

4 months ago

0.0.29

4 months ago

0.0.0-main.20240120T091015

4 months ago

0.0.0-main.20240118T111234

4 months ago

0.0.0-main.20240118T035919

4 months ago

0.0.0-main.20240118T051143

4 months ago

0.0.28

4 months ago

0.0.0-main.20240118T051226

4 months ago

0.0.0-main.20240113T172358

4 months ago

0.0.0-fix-type.20240114T164417

4 months ago

0.0.0-main.20240115T141734

4 months ago

0.0.0-fix-type.20240115T113628

4 months ago

0.0.0-fix-type.20240115T103719

4 months ago

0.0.0-main.20240113T172300

4 months ago

0.0.0-main.20240115T142044

4 months ago

0.0.26

4 months ago

0.0.27

4 months ago

0.0.0-fix-type.20240115T074824

4 months ago

0.0.0-main.20240111T190246

4 months ago

0.0.0-main.20240112T074542

4 months ago

0.0.0-main.20240111T103646

4 months ago

0.0.0-main.20240111T190019

4 months ago

0.0.0-main.20240111T164652

4 months ago

0.0.0-main.20240111T182221

4 months ago

0.0.0-main.20240111T103719

4 months ago

0.0.0-main.20240112T074612

4 months ago

0.0.0-main.20240111T190334

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

0.0.0-main.20240107T163952

4 months ago

0.0.0-main.20240107T162050

4 months ago

0.0.0-fix-readme.20240107T161917

4 months ago

0.0.0-main.20240108T050310

4 months ago

0.0.0-main.20240107T164345

4 months ago

0.0.0-main.20240107T182656

4 months ago

0.0.0-main.20240108T031102

4 months ago

0.0.0-main.20240108T065519

4 months ago

0.0.21

4 months ago

0.0.0-main.20240107T194852

4 months ago

0.0.20

4 months ago

0.0.0-main.20231231T044336

4 months ago

0.0.0-main.20231227T141619

4 months ago

0.0.0-main.20231228T171300

4 months ago

0.0.0-main.20231228T153821

4 months ago

0.0.0-main.20231228T183316

4 months ago

0.0.0-main.20231227T141159

4 months ago

0.0.19

4 months ago

0.0.0-main.20231226T141001

5 months ago

0.0.0-main.20231226T141036

5 months ago

0.0.18

5 months ago

0.0.0-main.20231222T133445

5 months ago

0.0.0-main.20231222T071222

5 months ago

0.0.0-main.20231222T133516

5 months ago

0.0.17

5 months ago

0.0.0-main.20231216T054159

5 months ago

0.0.0-main.20231215T162004

5 months ago

0.0.16

5 months ago

0.0.0-main.20231216T053728

5 months ago

0.0.15

5 months ago

0.0.0-main.20231213T143452

5 months ago

0.0.0-main.20231212T201812

5 months ago

0.0.0-main.20231212T133141

5 months ago

0.0.0-main.20231211T012336

5 months ago

0.0.14

5 months ago

0.0.0-main.20231211T014043

5 months ago

0.0.0-main.20231207T132451

5 months ago

0.0.0-main.20231124T152118

6 months ago

0.0.0-auto-deprecate-canary.20231124T103530

6 months ago

0.0.0-main.20231005T164629

7 months ago

0.0.0-main.20231030T024906

6 months ago

0.0.0-main.20231122T142048

6 months ago

0.0.0-main.20231007T021648

7 months ago

0.0.0-main.20231122T112449

6 months ago

0.0.0-main.20231002T174516

7 months ago

0.0.0-main.20231019T031929

7 months ago

0.0.0-main.20231122T135546

6 months ago

0.0.0-main.20231017T163422

7 months ago

0.0.0-main.20231120T173047

6 months ago

0.0.0-main.20231024T153349

7 months ago

0.0.0-main.20231101T161309

6 months ago

0.0.0-main.20231019T122545

7 months ago

0.0.0-main.20231122T183651

6 months ago

0.0.0-main.20231101T152359

6 months ago

0.0.0-main.20231017T171039

7 months ago

0.0.0-main.20231017T170655

7 months ago

0.0.0-main.20231120T180338

6 months ago

0.0.0-main.20231002T225914

7 months ago

0.0.0-main.20231116T193631

6 months ago

0.0.0-auto-deprecate-canary.20231124T101846

6 months ago

0.0.0-main.20231124T131528

6 months ago

0.0.10

6 months ago

0.0.11

6 months ago

0.0.0-main.20231015T205648

7 months ago

0.0.12

6 months ago

0.0.13

5 months ago

0.0.0-main.20231017T235810

7 months ago

0.0.0-main.20231017T235733

7 months ago

0.0.0-main.20231024T153009

7 months ago

0.0.0-main.20231019T123426

7 months ago

0.0.0-main.20231030T023331

6 months ago

0.0.0-main.20231002T145023

7 months ago

0.0.0-main.20231116T101847

6 months ago

0.0.9

7 months ago

0.0.8

7 months ago

0.0.0-main.20231128T141243

5 months ago

7 months ago

7 months ago

7 months ago

7 months ago

0.0.0-main.20230929T165247

7 months ago

0.0.0-main.20230929T130724

7 months ago

0.0.0-main.20230929T130321

7 months ago

0.0.0-main.20230929T122123

7 months ago

0.0.0-main.20230928T120006

7 months ago

0.0.0-main.20230928T114921

7 months ago

0.0.3

7 months ago

0.0.0-main.20230927T185005

7 months ago

0.0.0-main.20230927T183947

7 months ago

0.0.0-main.20230927T125220

8 months ago

0.0.0-main.20230927T002447

8 months ago

0.0.2

8 months ago

0.0.0-main.20230927T000035

8 months ago

0.0.0-main.20230926T235711

8 months ago

0.0.0-main.20230926T233033

8 months ago

0.0.0-main.20230926T232830

8 months ago

0.0.0-main.20230926T231244

8 months ago

0.0.0-main.20230924T214141

8 months ago

0.0.0-main.20230924T194908

8 months ago

0.0.0-main.20230924T192428

8 months ago

0.0.0-main.20230924T192203

8 months ago

0.0.0-main.20230924T180519

8 months ago

0.0.1

8 months ago