Repository navigation
Implement ProfilerSession with flame-graph-compatible timing output #849
Description
Overview
Build out the ProfilerSession class to capture real timings for all SDK operations and produce output compatible with the speedscope flame graph viewer (JSON format). Essential for diagnosing SDK performance bottlenecks in production.
Requirements
- ProfilerSession wraps a StellarSplitClient and records timing for every method call
- session.start() / session.stop() controls recording
- session.report(): SpeedscopeProfile returns flame-graph-compatible JSON (speedscope format v0.6)
- session.exportJSON(path): writes the report to a file
- Tracks: method name, start time (ms), duration (ms), success/failure, nested RPC call timings
- Tests asserting report structure matches speedscope schema
- Runnable example script examples/profile-session.ts
Acceptance Criteria
- ProfilerSession captures all SDK method timings
- Output matches speedscope v0.6 JSON schema (validated with ajv)
- exportJSON writes valid file
- Example script runs against mock RPC
- npm test passes with zero failures
- TypeScript compiles with zero errors
- ESLint passes with zero errors
Definition of Done
All CI checks must pass before the PR is reviewed.
Activity
flexocode442 commentedon Sep 24, 2026
@flexocode442 has applied to work on this issue as part of the Stellar Wave Program's 9th wave.
ℹ️ Repo Maintainers: To accept this application, review their application or assign @flexocode442 to this issue.
dhikbass commentedon Sep 24, 2026
@dhikbass has applied to work on this issue as part of the Stellar Wave Program's 9th wave.
ℹ️ Repo Maintainers: To accept this application, review their application or assign @dhikbass to this issue.
Abub57 commentedon Sep 24, 2026
@Abub57 has applied to work on this issue as part of the Stellar Wave Program's 9th wave.
ℹ️ Repo Maintainers: To accept this application, review their application or assign @Abub57 to this issue.
Cherry-Olaa commentedon Sep 24, 2026
@Cherry-Olaa has applied to work on this issue as part of the Stellar Wave Program's 9th wave.
ℹ️ Repo Maintainers: To accept this application, review their application or assign @Cherry-Olaa to this issue.
maztah1 commentedon Sep 24, 2026
@maztah1 has applied to work on this issue as part of the Stellar Wave Program's 9th wave.
ℹ️ Repo Maintainers: To accept this application, review their application or assign @maztah1 to this issue.
drips-wave commentedon Sep 24, 2026
Congratulations, @maztah1! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on September 30, 2026.
🧑💻 @maztah1: 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 🌊
fix(profiler): capture nested RPC timings and emit valid speedscope
grantfox-oss commentedon Sep 28, 2026
🎉 This issue has been marked as completed on GrantFox!
@maztah1's PR #949 was approved and merged by @Kingsman-99.
🏆 @maztah1: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (955 total points). Track your full progress on GrantFox.
👏 Great work, @maztah1! Keep contributing to Stellar-split.
drips-wave commentedon Sep 28, 2026
This issue has been completed by @maztah1 as part of the Stellar Wave Program's 9th Wave 🥳
😎 @maztah1: 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.