[Enhancement] Implement a Dead Letter Queue (DLQ) for failed Escrow release transactions

[Tybravo]

📁 Implementation Directory

backend/src/services/dlqService.ts

🎯 Goal

Allow Admins to manually retry failed blockchain transactions.

📋 Requirements

• Catch unrecoverable transaction failures.\n- Store the transaction payload in a DLQ collection.\n- Provide an Admin endpoint to review and retry them.

🔧 Technical Scope

• Node.js / Express
• TypeScript
• MongoDB / Mongoose
• Stellar Soroban RPC

🌿 Branch

git checkout -b feat/escrow-dlq

✅ Acceptance Criteria

• Using an AI Agent to submit a PR is DISALLOWED.
• Strict Layered Architecture (Non-Negotiable): Implement using the Controller -> Service -> Model pattern.
• Data Source: Response data must be retrieved from the database. No Inline Mock Objects or Hardcoded Values usage for integration.
• Environment: Contributors must use the requested .env credentials to enable implementation with real-life data.
• API Versioning: API Must Be Versioned (e.g., /api/v1/...).
• Production Ready: Code must look production-ready (robust error handling, strong typings).
• Proof of Work: Upload a screenshot of work done (i.e., API Response Success via Postman/Browser, or all unit tests passed successfully).
• PR Content: Must include Closes #[issue_id] with a work done summary.

📌 PR Requirements

• ⚠️ Assignment required before starting — comment on this issue to request assignment.
• PR must comply fully with the CONTRIBUTING.md.
• AI Agent submissions are DISALLOWED and will be closed without review.
• No Inline Mock Objects or Hardcoded Values usage for integration.

[Olasunkanmi975]

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

have a solid understanding of the underlying architecture required for this task and am ready to start testing a solution immediately.

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

[TechBroAfrica]

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

Focused on building trust through consistent, meaningful contributions. I approach every issue with curiosity, attention to detail, and a commitment to delivering clean, maintainable, and well-tested solutions. Driven by impact, not just commits, I value clear communication, effective collaboration with maintainers, continuous learning, and delivering meaningful value to every project I contribute to.

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

[starboytiimz]

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

Hi maintainer, can i be assigned this issue pleasee?

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

[TS-mfon]

@TS-mfon has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

GM

I'm a Blockchain developer

Please can I work on this issue

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

[sadiquhammedabubakar-art]

@sadiquhammedabubakar-art has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hi maintainer this is my job assign it to me let me get it done asap oo

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

[drips-wave]

Congratulations, @starboytiimz! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on August 31, 2026.

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