https://github.com/marktoda/forge-gas-snapshot

Library for checked-in, targeted gas snapshots with forge
https://github.com/marktoda/forge-gas-snapshot

Last synced: 15 days ago
JSON representation

Library for checked-in, targeted gas snapshots with forge

• Host: GitHub
• URL: https://github.com/marktoda/forge-gas-snapshot
• Owner: marktoda
• License: mit
• Archived: true
• Created: 2022-08-02T16:13:43.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-10-02T15:51:15.000Z (5 months ago)
• Last Synced: 2024-10-24T08:51:33.881Z (4 months ago)
• Language: Solidity
• Size: 46.9 KB
• Stars: 98
• Watchers: 3
• Forks: 11
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-foundry - forge-gas-snapshot - A flexible gas snapshotting library for forge tests. (Templates & Libraries)

README

        
# Forge Gas Snapshot

**[DEPRECATED] - [Upstreamed](https://github.com/foundry-rs/foundry/pull/8952) into Foundry**

Flexible, checked-in gas snapshotting for [Foundry](https://github.com/foundry-rs)

Forge has native gas reporting with `forge snapshot` and `forge test --gas-report`, but neither perfectly fit my needs. Specifically, `forge-gas-snapshot` aims to allow for:

- Gas reports over specific, known flows

    - not entire tests and not an average of all calls

- Check gas diffs into version control

- See gas changes over time through commit history

# Installation

## Soldeer

Package hosted at [soldeer/forge-gas-snapshot](https://soldeer.xyz/project/forge-gas-snapshot)

```solidity

forge soldeer install forge-gas-snapshot~0.0.4

```

## Foundry

```solidity

forge install marktoda/forge-gas-snapshot

```

- NOTE: foundry.toml must be updated to allow forge to write the snapshots

```toml

[profile.default]

...

ffi = true

fs_permissions = [{ access = "read-write", path = ".forge-snapshots/"}]

```

# Usage

By default, gas snapshots are automatically written to `./forge-snapshots/.snap` on run.

## Snapshot modes

### Wrap

Wrap arbitrary code in `snapStart(testName)` and `snapEnd` to snapshot gas usage.

```solidity

import {GasSnapshot} from "forge-gas-snapshot/GasSnapshot.sol";

contract MyTest is GasSnapshot {

    function test() public {

        snapStart("test name");

        // do stuff

        snapEnd();

    }

}

```

### Closure

Snapshot a zero-parameter function pointer with `snap`

```solidity

import {GasSnapshot} from "forge-gas-snapshot/GasSnapshot.sol";

contract MyTest is GasSnapshot {

    function doStuff() internal {

        // do stuff

    }

    function test() public {

        snap("test name", doStuff);

    }

}

```

### Arbitrary values

Snapshot arbitrary values with `snap`

```solidity

import {GasSnapshot} from "forge-gas-snapshot/GasSnapshot.sol";

contract MyTest is GasSnapshot {

    function test() public {

        uint256 value = getValue()

        snap("test name", value);

    }

}

```

### Contract Size

Snapshot contract size with `snapSize`

```solidity

import {GasSnapshot} from "forge-gas-snapshot/GasSnapshot.sol";

contract MyTest is GasSnapshot {

    function test() public {

        address addr = new Contract();

        snapSize("test name", addr);

    }

}

```

### Check Mode

Snapshots can be run in check-mode where they revert on mismatch by setting an environment variable `FORGE_SNAPSHOT_CHECK=true`

# TODO Improvements

- [ ] Introspection for file / function name

- [ ] Group related snapshots in a single file

- [ ] Check overhead and accuracy

- [ ] Env config for snap dir