Add gradient-based gas optimization profiling to Soroban contract CI pipeline

[Smartdevs17]

Context

The SubTrackr Soroban smart contracts handle high-frequency subscription operations where gas costs directly impact user transaction fees and contract sustainability. Currently, there is no automated mechanism to detect gas regressions or visualize gas cost trends per contract function across commits.
\

\

Current Limitation

\

• No CI gate for gas cost regressions in contract deploys
  \
• Gas profiles are manually checked during audit only
  \
• No per-function gas attribution or historical trending
  \
• Gas-intensive operations (batch billing, proration) lack optimization benchmarks
  \

\

Expected Outcome

An automated gas profiling pipeline integrated into CI that benchmarks each contract function, tracks historical gas trends, flags regressions exceeding configurable thresholds, and generates stratified call trees identifying optimization opportunities.
\

\

Acceptance Criteria

\

• CI job runs gas benchmarks for every Soroban contract function on PR
  \
• Historical gas cost trending stored and visualized per commit
  \
• Regression gate fails CI if gas exceeds baseline by configurable threshold (e.g., 10%)
  \
• Stratified gas call tree identifies high-cost sub-operations per function
  \
• Script to generate baseline gas snapshot on main branch updates
  \
• Documentation for adding new gas benchmarks and interpreting results
  \
• Integration with GitHub Actions summary annotations
  \

\

Technical Scope

\

• Files: contracts/subscription/src/ (all contract modules), contracts/Cargo.toml, .github/workflows/ci.yml, scripts/gas-benchmark.sh
  \
• APIs: Soroban SDK cost_utils, Stellar RPC simulateTransaction
  \
• Edge cases: Gas cost variance across different Stellar network conditions, large batch operations vs single operations, storage access pattern optimization

[AnnabelJoe]

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

I would like to work on this

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

[Jerry-Tekh]

@Jerry-Tekh has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hi maintainer, please I'll like to take this.

I’ll add gradient-based gas optimization profiling to Smartdevs17/SubTrackr CI: GitHub Actions job in .github/workflows/ci.yml with scripts/gas-benchmark.sh using Soroban cost_utils + Stellar RPC simulateTransaction to benchmark every function in contracts/subscription/src/, store historical trends per commit, fail PRs on >10% regressions, generate stratified call trees, baseline snapshot scripts, and GH summary annotations + docs.

Please assign me

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

[rindicomfort]

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

hi,

Please I’d love to take this issue on. I’m a smart contract and full-stack developer with experience across OnlyDust, Drips Waves

My stack includes Rust, Soroban, Cairo, Solidity, and TypeScript. I can deliver a clean, tested, and well-documented solution within 24 hours of assignment.

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

[drips-wave]

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

🧑‍💻 @rindicomfort: 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 🌊