[Feature]: Partial Milestone Payment Release

[SudiptaPaul-31]

🔍 Problem Statement

Description

Implement secure partial payment releases for milestone-based contracts. This allows clients to approve and release funds for individual milestones while ensuring escrow balance integrity and preventing double spending.

---

Requirements

• Each milestone has an allocated amount — defined at contract creation.
• Client approves individual milestones — approval triggers release of that milestone’s funds.
• Contract releases only that milestone's funds — no excess withdrawal allowed.
• Prevent double spending/double release — enforce idempotency checks.
• Track remaining escrow balance — update after each release.
• Emit contract events — log approvals, releases, and balance updates.

---

Acceptance Criteria

• ✅ Remaining escrow balance is tracked — contract state reflects updated balance after each release.
• ✅ Released amount cannot exceed milestone allocation — strict enforcement of limits.
• ✅ All important actions emit contract events — visible in transaction logs for transparency.
• ✅ Double release attempts are rejected — contract prevents duplicate payouts.
• ✅ Client-only authorization — only the client can approve and trigger milestone releases.
• ✅ Comprehensive contract tests — cover valid releases, invalid attempts, and edge cases.

📈 Expected Impact

High — Would significantly improve user experience

[kosisochukwu1234]

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

Hello, I’ve gone through the requirements and I’m confident I can implement a proper solution that matches the acceptance criteria. Kindly assign this issue to me.

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

[drips-wave]

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

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