Keeping Up with the Foundry Devs
An ongoing thread of foundry changes so you can stay up to date
First, follow all the Foundry legends:
@onbjerg @mattsse_ @gakonst @r_krasiuk @joshie_sh @brockjelmore @ashekhirin @rakitadragan
Ok, now on to the updates.
This thread will start with some highlights from the last few weeks, then I'll add to it over time as new features are added and bugs are fixed.
Various `forge fmt` updates and fixes. Available config options are now:
line_length
tab_width
bracket_spacing
int_types
multiline_func_header
quote_style
number_underscore
single_line_statement_blocks
Formatting reference: book.getfoundry.sh/reference/config/formatter
If the docs aren't updated, you can see options in the code here: github.com/foundry-rs/foundry/blob/master/config/src/fmt.rs
Note that options from those enums must be written as `snake_case` in your config file, e.g. `attributes_first` not `AttributesFirst`
Fork tests are easier than ever, details in the quoted thread.
In addition to what's in that thread, you can also fork from any transaction hash, and it will replay all *prior* transactions in that block.
You can see the relevant cheats for this here: github.com/foundry-rs/forge-std/pull/180/files
twitter.com/msolomon44/status/1564742781129502722
File reading and writing is easy too. This thread includes cheatcodes for reading JSON files and converting between strings and native solidity types.
twitter.com/msolomon44/status/1565387268105199616
New deploy patterns for `forge script`
twitter.com/msolomon44/status/1567204143689011200
Start anvil by forking from a node with archive data (@AlchemyPlatform and @infura_io offer this for free), and you can now use `debug_tranceTransaction` with anvil github.com/foundry-rs/foundry/pull/2868
This works with Hardhat too as mentioned in the quoted tweet
twitter.com/msolomon44/status/1461176450250276867
Missing dependencies are automatically installed on `forge build` and `forge test` github.com/foundry-rs/foundry/pull/3212
Improvement to broadcast artifacts (the JSON file outputs): For dry runs, i.e. no `--broadcast` flag, the artifact is now nested within a `dry-run` folder
Add `/broadcast/**/dry-run/` to your .gitignore to only commit broadcasted txs
Broadcast artifact fix: the `arguments` field showing constructor args is now populated instead of always being `null`.
You can suppress solc warnings using human-friendly aliases (instead of numeric error codes) with `ignored_error_codes` in the config file
See the full list of aliases here: github.com/foundry-rs/foundry/pull/3164/files
Previously there was `vm.getCode` to get the creation bytecode for a give file. There's now also `vm.getDeployedCode` to get the deployed bytecode.
More info and examples in the book: book.getfoundry.sh/cheatcodes/get-deployed-code#getdeployedcode
`forge snapshot` improvements:
1. New tests do not cause snapshot to exit with an error: github.com/foundry-rs/foundry/pull/3251
2. A new `forge snapshot --tolerance <pct>` flag can be used to allow tolerating snapshot deviations up to that percentage: github.com/foundry-rs/foundry/pull/3102
Previously the fuzz config had both `max_local_rejects` and `max_global_rejects` options.
The former is gone (it was never used anyway) and the latter is renamed to `max_test_rejects` for clarity (but behavior is unchanged).
github.com/foundry-rs/foundry/pull/3138
Blockscout and sourcify are supported for contract verification with `--verifier <name>`, where name can be `etherscan`, `sourcify`, or `blockscout`
book.getfoundry.sh/reference/forge/forge-verify-contract
And now some forge-std updates:
Small utils called `makeAddr` and `makeAddrAndKey` make it quick to generate and label addresses for arbitrary users: github.com/foundry-rs/forge-std/blob/e68214f75c4c9411baede13606544f228994396c/src/Test.sol#L90-L100
Thanks @0xkarmacoma for implementing and @eth_call for the inspiration
.@kelvinfichter added a package.json so you can properly import forge-std as a git dependency in your node.js projects github.com/foundry-rs/forge-std/pull/176
I'm sure there's plenty I've missed but that's it for now, more to come later.