| name | gas-report |
| description | Run gas analysis on contract functions and report costs. Use when the user asks about gas usage, optimization, or contract efficiency. |
| allowed-tools | Bash(npm run compile), Bash(npm run test:gas), Bash(npm run size) |
/gas-report — Gas Cost Analysis
Run the full gas analysis pipeline for SaThuCoin and produce a clear summary.
Steps
- Run
npm run compile to ensure contracts are compiled
- Run
npm run test:gas (sets REPORT_GAS=true and runs all tests)
- Run
npm run size to get contract size information
Output Requirements
Produce a structured summary with:
Per-Function Gas Costs
For each contract function (mint, mintForDeed, transfer, transferFrom, approve), report:
- Min / Avg / Max gas usage
- Number of calls observed during tests
Contract Size
- Report contract size in kB from
hardhat-contract-sizer output
- Base chain contract size limit is 24.576 kB (same as Ethereum)
- Flag if the contract exceeds 80% of the limit (>19.66 kB)
Cost Estimates
Using approximate Base chain gas prices:
- Base L2 execution gas: ~0.001 gwei (very cheap)
- L1 data fee: dominant cost, varies with Ethereum gas prices
- Provide rough USD estimates if possible, noting they vary with L1 gas
Optimization Notes
Highlight any of the following if observed:
- Functions exceeding 100,000 gas
- Significant variance between min and max (indicates input-dependent cost)
- The
deed string parameter in mintForDeed — note that longer strings cost more gas due to calldata
- Optimizer is set to 200 runs — note tradeoff (lower runs = cheaper deploy, higher runs = cheaper execution)
Key Context
- Contract:
contracts/SaThuCoin.sol (ERC20 + Ownable, 49 lines)
- Optimizer: enabled, 200 runs (configured in
hardhat.config.js)
hardhat-gas-reporter is bundled with @nomicfoundation/hardhat-toolboxhardhat-contract-sizer is installed as a devDependency
