SC-50: Time-Locked Collateralized Wager Contract with Auto-Forfeit on Timeout

[chinweobtagaz]

Problem Statement

In 1v1 wager matches, players who realize they are losing may refuse to resign or close their browser hoping to tie up funds indefinitely.

Proposed Solution

1. Write a Soroban wager contract with built-in game expiration deadline.
2. If opponent goes offline and match is not settled within deadline + buffer, allow active player to call claim_timeout_victory().
3. Distribute escrowed wager immediately without requiring server signature.

Acceptance Criteria

• Strict ledger timestamp validation preventing premature victory claims.
• Gas-efficient payout logic with minimal storage footprint.
• Full coverage of edge cases (mutual timeout, server outage grace period).

[drips-wave]

@chinweobtagaz This issue could not be added to the Stellar Wave Program because the per-repo points budget would be exceeded (24950 / 25000 points already used). The label has been automatically removed.

The budget resets at the end of each Wave. You can review the remaining budget for your repos on the Orgs & Repos page.

ℹ️ Learn more about points budgets

[Jerry-Tekh]

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

hi maintainer, please . please get me assigned to this issue . I will ensure the implemenrtaion is verified. thank you .

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

[CollinsC1O]

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

I will love to work on this issue and provide implementations that will resolve it

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

[drips-wave]

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

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