Add refund allocation algorithms in tax_withholding_deductions

[godamongstmen897]

Problem & Goal

Define refund distribution pathways in the tax_withholding_deductions module for split-refund claims.

Context & Components

• Target Repository: escrow-contract
• Module/Component: tax_withholding_deductions (Local tax deduction calculator)

Implementation Details

1. Review the existing codebase inside the escrow-contract directory.
2. Locate the source files relating to tax_withholding_deductions.
3. Implement the feature logic/validation rules step-by-step.
4. Ensure code conforms to codebase patterns (lints, formats, types).

Verification & Testing Requirements

• Validation check: Assert correct refund percentages are transferred.
• Add comprehensive test cases matching these validation requirements.
• Ensure all other existing project tests continue to compile and pass.

---

Note: This issue is completely self-contained and does not block or require any other issues to be resolved.

[odesanyataiwo2017-crypto]

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

Hi maintainer, please let me work on this issue.

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

[yellowmam77]

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

Hi Maintainer! I'm a senior developer with experience building high-quality, production-ready software. I'd love to take on this issue and deliver a clean, well-tested solution that aligns with the project's standards. Please assign it to me—I'm ready to get started and contribute effectively.

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

[drips-wave]

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

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