AgentSkillsCN

gas-report

对合约函数进行 Gas 分析并生成费用报告。当用户咨询 Gas 使用情况、优化方案，或合约效率相关问题时，可调用此技能。

SKILL.md
--- frontmatter
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

  1. •Run npm run compile to ensure contracts are compiled
  2. •Run npm run test:gas (sets REPORT_GAS=true and runs all tests)
  3. •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-toolbox
  • •hardhat-contract-sizer is installed as a devDependency