DEX Offer Order Tracker

[Kingsman-99]

Description

When the SDK places DEX offers as part of a split payment conversion strategy, it does not track whether those offers have been partially filled, fully consumed, or cancelled. Untracked open offers accumulate on accounts and can cause unexpected balance changes that confuse invoice reconciliation. An offer tracker should monitor outstanding offers, emit fill-progress events, and cancel stale offers automatically.

Technical Context

Add src/offerTracker.ts. Uses @stellar/stellar-sdk Server.offers() with for_account filter, and Server.trades() to detect fills. Operations built with Operation.manageBuyOffer() / Operation.manageSellOffer(). Emits offerFilled, offerPartiallyFilled, and offerCancelled events via src/events.ts. Adds OfferRecord to src/types.ts.

Acceptance Criteria

• OfferTracker.track(offerId: string, accountId: string) registers an offer for monitoring
• Polls Server.trades() at a configurable interval and computes cumulative fill percentage
• Emits offerPartiallyFilled with { filledPercent, remaining } payload and offerFilled on 100% completion
• Automatically submits a cancel (manageSellOffer with amount 0) for offers older than a configurable TTL
• listActive(accountId: string): Promise<OfferRecord[]> returns all currently tracked open offers for an account
• All CI checks (npm test, npm run build, ESLint/TypeScript) pass and the branch has no merge conflicts

---

[Muneerat]

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

Please, I would like to work on this issue

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

[micmusjnr20]

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

Please, I would like to work on this issue

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

[drips-wave]

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

🧑‍💻 @micmusjnr20: 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]

🦊 GrantFox — @micmusjnr20 has been assigned to this issue as part of the Official Campaign | FWC26 campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #501)
2. Your PR will be reviewed by the Stellar-split maintainers

Good luck! Track your progress on GrantFox.