Getting Started

Smart contracts for ERC-4337 account and paymaster implementations.

Table of contents

• Repository structure
  • Sensible Defaults
  • VSCode Integration
  • GitHub Actions
• Usage
  • Pre Requisites
  • Compile
  • TypeChain
  • Test
  • Lint Solidity
  • Lint TypeScript
  • Coverage
  • Report Gas
  • Clean
  • Deploy
• License
• Contact

Repository structure

This repository builds upon the following frameworks and libraries:

• Hardhat: compile, run and test smart contracts
• TypeChain: generate TypeScript bindings for smart contracts
• Ethers: renowned Ethereum library and wallet implementation
• Solhint: code linter
• Solcover: code coverage
• Prettier Plugin Solidity: code formatter

Sensible Defaults

This repository comes with sensible default configurations in the following files:

├── .editorconfig
├── .eslintignore
├── .eslintrc.yml
├── .gitignore
├── .prettierignore
├── .prettierrc.yml
├── .solcover.js
├── .solhint.json
└── hardhat.config.ts

VSCode Integration

This repository is IDE agnostic, but for the best user experience, you may want to use it in VSCode alongside Nomic Foundation's Solidity extension.

GitHub Actions

All contracts will be linted and tested on every push and pull request made to the main branch.

Usage

Below are some useful commands for development.

Pre Requisites

Before being able to run any command, you need to create a .env file and set a BIP-39 compatible mnemonic as an environment variable. You can follow the example in .env.example. If you don't already have a mnemonic, you can use this website to generate one.

cp .env.example .env

Then, proceed with installing dependencies:

yarn run install

Compile

Compile the smart contracts with Hardhat:

yarn run compile

TypeChain

Compile the smart contracts and generate TypeChain bindings:

yarn run typechain

Test

Run the tests with Hardhat:

yarn run test

Lint Solidity

Lint the Solidity code:

yarn run lint:sol

Lint TypeScript

Lint the TypeScript code:

yarn run lint:ts

Coverage

Generate the code coverage report:

yarn run coverage

Report Gas

See the gas usage per unit test and average gas per method call:

REPORT_GAS=true yarn run test

Clean

Delete the smart contract artifacts, the coverage reports and the Hardhat cache:

yarn run clean

Deploy

Deploy the contracts to Hardhat Network:

yarn run deploy --greeting 'Bonjour, le monde!'

License

Distributed under the GPL-3.0 License. See LICENSE for more information.

Contact

Feel free to direct any technical related questions to the dev-hub channel in the Stackup Discord.