[FEAT] Build Automated Gas Comparison Benchmark Framework

[mijinummi]

Labels: medium-difficulty, testing, benchmarks
Difficulty: Medium
Module: tests/benchmarks/

---

🧠 Concept

Create a test runner that executes contracts before and after applying GasGuard refactors, measuring actual gas spent using Anvil / Soroban RPC local testnets.

⚠️ Problem

Estimates are helpful, but developers want empirical proof showing the exact gas difference before merging refactored code.

📁 Implementation Scope

• tests/benchmarks/gas-comparator.ts
• tests/benchmarks/fixtures/

🛠️ Requirements

1. Deploy original fixture contract and refactored contract to local dev node.
2. Execute target transaction and capture gasUsed / resource units.
3. Export a benchmark report comparing actual gas delta versus rule estimates.

🎯 Acceptance Criteria

• Automatically generates empirical gas usage comparisons for test fixtures.
• Validates accuracy of static analysis estimates against live execution traces.

[OG-wura]

@OG-wura has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Can I please work on this

ℹ️ Repo Maintainers: To accept this application, review their application or assign @OG-wura to this issue.

[SugaretaNajja]

@SugaretaNajja has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

can i work on this issue please

ℹ️ Repo Maintainers: To accept this application, review their application or assign @SugaretaNajja to this issue.

[oraimoitel]

@oraimoitel has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Good day maintainer can I work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @oraimoitel to this issue.

[drips-wave]

Congratulations, @SugaretaNajja! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on July 30, 2026.

🧑‍💻 @SugaretaNajja: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[grantfox-oss]

🎉 This issue has been marked as completed on GrantFox!

@SugaretaNajja's PR #618 was approved and merged by @mijinummi.

🏆 @SugaretaNajja: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (223 total points). Track your full progress on GrantFox.

👏 Great work, @SugaretaNajja! Keep contributing to MDTechLabs.

[drips-wave]

This issue has been completed by @SugaretaNajja as part of the Stellar Wave Program's 7th Wave 🥳

😎 @SugaretaNajja: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here. You can also Leave a review to share your experience working on this issue.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.