Architect Soroban Contract Execution Budget Monitoring and Alert Infrastructure

[temma02]

Description

Build monitoring infrastructure that tracks Soroban contract execution resource budgets (CPU instructions, memory) and alerts when contracts approach or exceed budget limits.

Requirements and Context

• Observability: Execution budget usage must be tracked and alertable
• Testing: Test budget tracking and alert thresholds
• Documentation: Document the execution budget metrics

Suggested Execution

Branch: feat/issue-089-soroban-execution-budget-monitoring

Implement Changes

• Add execution budget tracking to Soroban contract invocations
• Capture CPU instruction count and memory usage per invocation
• Alert when invocations approach the budget limit
• Expose budget metrics for observability

Test and Commit

• Test budget metric capture
• Test alert triggering at threshold
• Document the execution budget metrics

Example Commit Message

feat(soroban): add execution budget monitoring and alerting

- Track CPU instructions and memory per invocation
- Alert when approaching budget limits
- Expose budget metrics for observability

Guidelines

• Capture metrics from Soroban transaction metadata
• Set alert thresholds below hard limits
• Keep monitoring overhead minimal

[Markodiba6399]

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

I would like work on this issue

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

[drips-wave]

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

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