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.

[gidadoabdullateef5]

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

Hello Maintainer, after reviewing the issue and related code paths, I believe I can implement this feature effectively while adhering to the project's standards and conventions. Kindly assign it to me. I await your swift response, sire

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