Advanced Payout & Reward Distribution system

[hman38705]

Description

Developer Goal: Enable users to claim their share of the prize pool after a market is resolved.

Technical Prerequisites:

• Familiarity with sac-token (Stellar Asset Contract) interface.
• Understanding of integer division precision in Rust.

Detailed Requirements:

1. Authority: The claim_winnings function must require the bettor's signature (bettor.require_auth()).
2. Market Validation: Market must be in Resolved state. Errors: ErrorCode::MarketNotFound, ErrorCode::MarketStillActive.
3. No Double Claim: Once claimed, the specific bet record must be deleted or marked as claimed.
4. Math:
   • Payout = (UserBetAmount * NetPrizePool) / WinningOutcomeTotalStaked.
   • NetPrizePool = TotalMarketStaked - (TotalMarketStaked * BaseFee / 10000).

Implementation Guide:

// 1. Get Market and check status
// 2. Fetch Bet using DataKey::Bet(market_id, bettor)
// 3. Calculate Fee using modules::fees::calculate_fee
// 4. Calculate Payout using fixed-point math: 
//    (bet.amount * net_pool) / market.outcome_total_staked[bet.outcome]
// 5. client.transfer(e.current_contract_address(), bettor, payout_amount)
// 6. e.storage().persistent().remove(&bet_key)

Security Guardrails:

• Reentrancy: Perform all storage deletions before calling the token transfer.
• Division by Zero: Handle cases where WinningOutcomeTotalStaked is 0 (though technically impossible if a bet exists).
• Rounding: Always round down for payouts to ensure the contract never tries to send more than it has.

Verification Checklist:

• Function claim_winnings implemented in bets.rs.
• Integration test simulates 3 winners with different amounts claiming correctly.
• Attempting to claim twice results in an error.
• git checkout -b features/issue-1-advanced-payout-rewards
• Pr Request create your pr against develop branch

---

[drips-wave]

This issue has been added to the Stellar Wave Program and is worth 200 Points.

🧑‍💻 Interested in contributing? Apply to work on this issue on Drips Wave, earn points, and receive rewards.

Warning

Only applications submitted via the apply link above will be considered. Please do not apply by commenting on the issue or opening a PR directly.

🤠 Repo maintainers: You can manage this issue's Points and Complexity on your Maintainer Dashboard here. Please keep an eye on applications and respond quickly 💙

ℹ️ Learn more about Drips Wave

[Mac-5]

@Mac-5 has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

Hi Maintainer i would love to work on this issue

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

[drips-wave]

Congratulations, @Mac-5! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on February 26, 2026.

🧑‍💻 @Mac-5: 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 issued 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 🌊

[drips-wave]

This issue has been completed by @Mac-5 as part of the Stellar Wave Program's 2nd Wave 🥳

😎 @Mac-5: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here. You can also Leave a review to share your experience working on this issue.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.