Llama Forge Template

This template is inspired by Cleanunicorn's template.

Installation

It requires Foundry installed to run. You can find instructions here Foundry installation.

It's easiest to start a new project by clicking the "Use this template".

Then clone the templated repository locally and cd into it and run the following commands:

$ npm install
$ forge install

If you want to create your project manually, run the following commands:

$ forge init --template https://github.com/llama-community/llama-forge-template <my-repo>
$ cd <my-repo>
$ npm install
$ forge install

Duplicate .env.example and rename to .env:

Add a valid mainnet URL for an Ethereum JSON-RPC client for the RPC_URL variable.
Add the latest mainnet block number for the BLOCK_NUMBER variable.
Add a valid Etherscan API Key for the ETHERSCAN_API_KEY variable.

make build - build the project
make test [optional](V={1,2,3,4,5}) - run tests (with different debug levels if provided)
make match MATCH=<TEST_FUNCTION_NAME> [optional](V=<{1,2,3,4,5}>) - run matched tests (with different debug levels if provided)

Mainnet: When you're ready to deploy and verify, run ./scripts/deploy_verify_mainnet.sh and follow the prompts.
Testnet: When you're ready to deploy and verify, run ./scripts/deploy_verify_testnet.sh and follow the prompts.

To confirm the deploy was successful, re-run your test suite but use the newly created contract address.