Economics: simulate_payout matches live settlement

[josephchimebuka]

Summary

If simulate_payout (or equivalent) exists, force parity with live settle for UpDown/Precision/fee models. Treat drift as a bug.

Acceptance criteria

• Shared math path or differential tests
• Property tests over random pots
• Documented for frontends

Where

• contracts/src/queries.rs / settlement helpers
• contracts/src/tests/

[yusufadeagbo]

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

May I please work on this?

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

[Ifechuks22]

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

Hi @TevaLabs! I'll refactor simulate_payout and live settlement to share a single, deterministic math path across all payout models. I'll also add property tests over random pots to guarantee zero drift and update frontend docs. Please assign this to me!

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

[Kingsley4867]

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

Please assign to me now or I perish maintainer just help my life this wave and I will work on this ASAP perfectly

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

[devchant]

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

Hey, can I solve this? I intend to approach this by reviewing the existing flow and identifying the best integration points before implementing the required functionality. I'll also include tests and handle edge cases to deliver a robust solution.

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

[drips-wave]

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

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

🎉 This issue has been marked as completed on GrantFox!

@devchant's PR #505 was approved and merged by @josephchimebuka.

🏆 @devchant: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (446 total points). Track your full progress on GrantFox.

👏 Great work, @devchant! Keep contributing to TevaLabs.