v1.9.2

Featured Changes

• fix: logMemory in safeconsole now works as expected by @Philogy in #591
• New cheats added across various PRs
  • List of new cheats can be found by looking at this diff. Note that some cheats were re-organized in foundry-rs/foundry#8578, so not all cheats that show as added are new.
  • PRs that added them to forge-std:
    • feat: update vm interface with new cheats by @lightclient in #582
    • feat: add broadcastRawTransaction cheatcode by @zerosnacks in #587
    • new cheats + v1.9.2 by @mds1 in #593

Other Changes

• fix(StdStorage): check last read slots first by @klkvr in #581

New Contributors

• @lightclient made their first contribution in #582

Full Changelog: v1.9.1...v1.9.2

v1.9.1

Featured Changes

• fix: add missing console logs by @DaniPopes in #577

Other Changes

• bump to v1.9.1 by @mds1 in #578

Full Changelog: v1.9.0...v1.9.1

v1.9.0

Featured Changes

• feat: deprecate console2 by @DaniPopes in #573
• feat(cheatcode): vm.promptSecretUint cheat by @DhairyaSethi in #566
• feat: vm.randomAddress and vm.randomUint cheats by @mds1 in #572
• feat: add invariant excludeSelector helper by @grandizzy in #569

Other Changes

• chore: remove duplicate interface by @stevennevins in #560
• New chains in standard chains:
  • feat: add blast goerli & blast chaindata setup by @CruzMolina in #558
  • feat: add fantom to default chains by @sujithsomraaj in #568
  • feat: 🎸 New Berachain V2 bArtio Testnet by @codingwithmanny in #571
• chore: bump to v1.9.0 by @mds1 in #575

New Contributors

• @CruzMolina made their first contribution in #558
• @stevennevins made their first contribution in #560
• @DhairyaSethi made their first contribution in #566
• @sujithsomraaj made their first contribution in #568
• @grandizzy made their first contribution in #569
• @codingwithmanny made their first contribution in #571

Full Changelog: v1.8.2...v1.9.0

v1.8.2

Featured Changes

• Add vm.prompt cheatcodes to Vm interface by @Tudmotu in #529
• chore(networks): goerli sunset by @sambacha in #525
• feat: Add support for polygon amoy testnet by @kcyeu in #540
• feat: add all new cheats to interface by @mds1 in #549
• add: blobhashes cheats by @yash-atreya in #553
• fix(StdInvariant): correct targetArtifactSelector type by @DaniPopes in #524
• feat(vm): add ensNamehash cheatcode by @meetmangukiya in #555

Expand to see the full set of new cheats

/// Gets the environment variable `name` and returns true if it exists, else returns false.
function envExists(string calldata name) external view returns (bool result);

/// Returns true if `forge` command was executed in given context.
function isContext(ForgeContext context) external view returns (bool result);

/// Gets the current `block.blobbasefee`.
/// You should use this instead of `block.blobbasefee` if you use `vm.blobBaseFee`, as `block.blobbasefee` is assumed to be constant across a transaction,
/// and as a result will get optimized out by the compiler.
/// See https://github.com/foundry-rs/foundry/issues/6180
function getBlobBaseFee() external view returns (uint256 blobBaseFee);

/// Gets the gas used in the last call.
function lastCallGas() external view returns (Gas memory gas);

/// Signs `digest` with signer provided to script using the secp256k1 curve.
/// If `--sender` is provided, the signer with provided address is used, otherwise,
/// if exactly one signer is provided to the script, that signer is used.
/// Raises error if signer passed through `--sender` does not match any unlocked signers or
/// if `--sender` is not provided and not exactly one signer is passed to the script.
function sign(bytes32 digest) external pure returns (uint8 v, bytes32 r, bytes32 s);

/// Signs `digest` with signer provided to script using the secp256k1 curve.
/// Raises error if none of the signers passed into the script have provided address.
function sign(address signer, bytes32 digest) external pure returns (uint8 v, bytes32 r, bytes32 s);

/// Prompts the user for a string value in the terminal.
function prompt(string calldata promptText) external returns (string memory input);

/// Prompts the user for an address in the terminal.
function promptAddress(string calldata promptText) external returns (address);

/// Prompts the user for a hidden string value in the terminal.
function promptSecret(string calldata promptText) external returns (string memory input);

/// Prompts the user for uint256 in the terminal.
function promptUint(string calldata promptText) external returns (uint256);

/// See `serializeJson`.
function serializeUintToHex(string calldata objectKey, string calldata valueKey, uint256 value)
    external
    returns (string memory json);

/// Returns the index of the first occurrence of a `key` in an `input` string.
/// Returns `NOT_FOUND` (i.e. `type(uint256).max`) if the `key` is not found.
/// Returns 0 in case of an empty `key`.
function indexOf(string calldata input, string calldata key) external pure returns (uint256);

/// Returns ENS namehash for provided string.
function ensNamehash(string calldata name) external pure returns (bytes32);

/// Sets `block.blobbasefee`
function blobBaseFee(uint256 newBlobBaseFee) external;

/// Sets the blobhashes in the transaction.
/// Not available on EVM versions before Cancun.
/// If used on unsupported EVM versions it will revert.
function blobhashes(bytes32[] calldata hashes) external;

/// Gets the blockhashes from the current transaction.
/// Not available on EVM versions before Cancun.
/// If used on unsupported EVM versions it will revert.
function getBlobhashes() external view returns (bytes32[] memory hashes);

/// Sets `block.prevrandao`.
/// Not available on EVM versions before Paris. Use `difficulty` instead.
/// If used on unsupported EVM versions it will revert.
function prevrandao(uint256 newPrevrandao) external;

Other Changes

• ci(github): update CI workflow by @sambacha in #526
• Revert "ci(github): update CI workflow" by @mds1 in #532
• chore: fix typo in comment by @rustfix in #542
• chore: fix bound log by @totomanov in #544
• ci: modernize workflows by @mds1 in #550
• chore: bump to v1.8.2 by @mds1 in #556

New Contributors

• @sambacha made their first contribution in #526
• @rustfix made their first contribution in #542
• @kcyeu made their first contribution in #540
• @yash-atreya made their first contribution in #553
• @meetmangukiya made their first contribution in #555

Full Changelog: v1.8.1...v1.8.2

v1.8.1

What's Changed

• fix: add IS_TEST = true to Test by @mds1 in #523. This is a bug fix to ensure forge build --sizes continues to work as it did prior to forge-std v1.8.0

Full Changelog: v1.8.0...v1.8.1

v1.8.0

Featured Changes

• feat/perf: use native assertions by @klkvr in #514.
  • This replaces forge-std Solidity code with native cheatcode assertions from Foundry, so should give a small performance boost.
  • Assertion failures now cause tests to exit early, instead of continuing with execution.
  • This also will require some visibility modifier changes to tests, as assertion methods no longer set state.
  • NOTE: If you were using the vm.expectSafeMemory cheat, you may need to now use the new vm.stopExpectSafeMemory cheat from #507. See #503 (comment) to learn more, h/t @clabby.
• feat(stdStorage): support packed variables by @klkvr in #505. This means deal now works with USDC and other variables that reply on packed storage slots.
  • The USDC deal support works out of the box.
  • To avoid breaking changes arbitrary packed slot support is not enabled by default, and can be enabled with stdstore.enable_packed_slots().target(.....
• feat: add TOML reading/writing cheatcodes by @zerosnacks in #518. These are analogous to their JSON equivalents.
  • NOTE: This adds file specific keyExistsJson and keyExistsToml cheats. The ambiguous keyExists currently is an alias for keyExistsJson and will be deprecated.
• feat: native string maniupulation cheatcodes of toLowercase, toUppercase, trim, replace and split from foundry-rs/foundry#6891.
• feat: implement interfaces in mock tokens by @arr00 in #510.

Other Changes

• Exclude internal cheats from Vm by @klkvr in #501.
• Fix typo in StdJson.sol usage comments by @coopbri in #511.
• feat: fraxtal mainnet/testnet rpc support by @pegahcarter in #517.

New Contributors

• @coopbri made their first contribution in #511.
• @arr00 made their first contribution in #510.
• @pegahcarter made their first contribution in #517.
• @zerosnacks made their first contribution in #518.

Full Changelog: v1.7.6...v1.8.0

v1.7.6

Featured Changes:

• New cheatcodes:
  • vm.dumpState by @tynes in #499 (foundry-rs/foundry#6827)
  • vm.signP256 cheatcode for generating P256 (i.e. secp256r1) signatures, by @wilsoncusack in #497 (foundry-rs/foundry#6797)
  • vm.toBase64 and vm.toBase64URL cheatcodes by @ 0xAndoroid and @DaniPopes in #499 (foundry-rs/foundry#6785 and foundry-rs/foundry#6830)

Other Changes

• fix: don't hardcode string values in Vm generator by @DaniPopes in #497
• chore: bump to v1.7.6 by @mds1 in #500

Full Changelog: v1.7.5...v1.7.6

v1.7.5

Featured Changes

• vm.envOr and vm.getLabel are now view @anikaraghu in #491

Other Changes

• feat: automatically generate Vm.sol from cheatcodes.json by @DaniPopes in #487
• chore: bump to v1.7.5 by @mds1 in #492

New Contributors

• @anikaraghu made their first contribution in #491

Full Changelog: v1.7.4...v1.7.5

v1.7.4

Featured Changes

• Update Vm.sol with changes to AccountAccessKind by @emo-eth in #483.
  • This adds Balance, Extcodesize, Extcodehash, Extcodecopy as account access kinds
• feat: add new snapshot cheatcodes by @mattsse in #484.
  • The vm.revertTo(snapshotId) cheat does not automatically delete the snapshotId snapshot, which can lead to unbounded memory growth with lots of snapshots. Therefore, vm.revertToAndDelete(snapshotId), vm.deleteSnapshot(snapshotId), and vm.deleteSnapshots() were added as new cheats.

Other Changes

• chore: bump to v1.7.4 by @mds1 in #486

Full Changelog: v1.7.3...v1.7.4

v1.7.3

Featured Changes

• feat: add vm.startStateDiffRecording and vm.stopAndReturnStateDiff cheats to record all account accesses and storage accesses, by @Inphi in #481
• feat: add vm.computeCreateAddress and vm.computeCreate2Address cheats, by @qiweiii in #479
  • These native cheats replace the need for the StdUtils methods of the same now, which will now give a deprecation warning when used.
• feat: add mock contracts for ERC20 and ERC721, by @andreivladbrg in #470
  • Be aware that these use initializers instead of constructors for compatibility across Solidity versions. Therefore it's recommended to use the deployMockERC20 and deployMockERC721 methods in StdUtils to deploy them.

Other Changes

• chore: bump version to v1.7.3 by @mds1 in #482

New Contributors

• @Inphi made their first contribution in #481
• @qiweiii made their first contribution in #479
• @andreivladbrg made their first contribution in #470

Full Changelog: v1.7.2...v1.7.3