Foundry-based template for developing Solidity smart contracts used by Vac
Go to file
Paul Razvan Berg a4eb52abc5
chore: git ignore "*.html" and "lcov.info" files
2023-01-02 13:54:45 +02:00
.github ci: be more specific in "build --sizes" step 2022-12-21 13:16:08 +02:00
.yarn build: upgrade to yarn v3.2.4 2022-10-30 18:39:19 +02:00
lib build: upgrade to latest forge-std 2022-12-19 15:29:38 +02:00
script feat: initial commit 2022-07-17 21:57:09 +03:00
src feat: initial commit 2022-07-17 21:57:09 +03:00
test ci: fuzz 10,000 times 2022-12-24 16:10:31 +02:00
.commitlintrc.yml feat: initial commit 2022-07-17 21:57:09 +03:00
.editorconfig chore: fix indenting for *.sol in .editorconfig 2022-09-15 00:57:35 +02:00
.env.example chore: change testnet to Sepolia 2022-10-30 18:28:21 +02:00
.gitignore chore: git ignore "*.html" and "lcov.info" files 2023-01-02 13:54:45 +02:00
.gitmodules build: upgrade to prb-test v0.3.1 2022-12-16 14:53:23 +02:00
.lintstagedrc.yml chore: simplify prettier command in lintstaged 2022-11-27 13:40:57 +02:00
.prettierignore feat: initial commit 2022-07-17 21:57:09 +03:00
.prettierrc.yml chore: pass "files" as string in Prettier config 2022-11-28 13:22:51 +02:00
.solhint.json feat: initial commit 2022-07-17 21:57:09 +03:00
.solhintignore feat: initial commit 2022-07-17 21:57:09 +03:00
.yarnrc.yml chore: surround values with double quotes in ".yarnrc.yml" 2022-11-28 13:29:02 +02:00
LICENSE.md chore: update copyright year in license 2023-01-01 13:26:12 +02:00
README.md docs: mention coverage command in README 2022-12-20 19:42:12 +02:00
foundry.toml ci: fuzz 10,000 times 2022-12-24 16:10:31 +02:00
package.json chore: rename script to "prettier:write" 2022-11-27 16:03:19 +02:00
remappings.txt chore: add "src" to remappings 2022-11-20 16:34:27 +02:00
yarn.lock build: upgrade to prettier-plugin-solidity v1.0.0 2022-11-21 12:46:00 +02:00

README.md

Foundry Template Open in Gitpod Github Actions Foundry License: MIT

A Foundry-based template for developing Solidity smart contracts, with sensible defaults.

What's Inside

  • Forge: compile, test, fuzz, debug and deploy smart contracts
  • PRBTest: modern collection of testing assertions and logging utilities
  • Forge Std: collection of helpful contracts and cheatcodes for testing
  • Solhint: code linter
  • Prettier Plugin Solidity: code formatter

Getting Started

Click the Use this template button at the top of the page to create a new repository with this repo as the initial state.

Or, if you prefer to install the template manually:

forge init my-project --template https://github.com/paulrberg/foundry-template
cd my-project
yarn install # install solhint and prettier and other goodies

If this is your first time with Foundry, check out the installation instructions.

Features

This template builds upon the frameworks and libraries mentioned above, so for details about their specific features, please consult their respective documentations.

For example, for Foundry, you can refer to the Foundry Book. You might be in particular interested in reading the Writing Tests guide.

Sensible Defaults

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

├── .commitlintrc.yml
├── .editorconfig
├── .gitignore
├── .prettierignore
├── .prettierrc.yml
├── .solhintignore
├── .solhint.json
├── .yarnrc.yml
├── foundry.toml
└── remappings.txt

GitHub Actions

This template comes with GitHub Actions pre-configured. Your contracts will be linted and tested on every push and pull request made to the main branch.

You can edit the CI script in .github/workflows/ci.yml.

Conventional Commits

This template enforces the Conventional Commits standard for git commit messages. This is a lightweight convention that creates an explicit commit history, which makes it easier to write automated tools on top of.

Git Hooks

This template uses Husky to run automated checks on commit messages, and Lint Staged to automatically format the code with Prettier when making a git commit.

Writing Tests

To write a new test contract, you start by importing PRBTest and inherit from it in your test contract. PRBTest comes with a pre-instantiated cheatcodes environment accessible via the vm property. You can also use console.log, whose logs you can see in the terminal output by adding the -vvvv flag.

This template comes with an example test contract Foo.t.sol.

Usage

Here's a list of the most frequently needed commands.

Build

Build the contracts:

$ forge build

Clean

Delete the build artifacts and cache directories:

$ forge clean

Compile

Compile the contracts:

$ forge build

Coverage

Get a test coverage report:

$ forge coverage

Deploy

Deploy to Anvil:

$ forge script script/Foo.s.sol:FooScript --fork-url http://localhost:8545 \
 --broadcast --private-key $PRIVATE_KEY

For instructions on how to deploy to a testnet or mainnet, check out the Solidity Scripting tutorial.

Format

Format the contracts with Prettier:

$ yarn prettier

Gas Usage

Get a gas report:

$ forge test --gas-report

Lint

Lint the contracts:

$ yarn lint

Test

Run the tests:

$ forge test

Notes

  1. Foundry piggybacks off git submodules to manage dependencies. There's a guide about how to work with dependencies in the book.
  2. You don't have to create a .env file, but filling in the environment variables may be useful when debugging and testing against a mainnet fork.

License

MIT © Paul Razvan Berg