Implement Timeout-Based Wager Reclaim

[popsman01]

Description
Allow players to reclaim original wagers when reveal deadlines expire while the game remains in committed state.

Motivation
This functionality is a required building block for the Tossd game flow. Without it, dependent features cannot be built or tested correctly.

Requirements and context

• Must be secure, tested, and documented
• Should be efficient and easy to review
• Primary files: Tossd-contract/src/lib.rs

Proposed Solution
Complete the following in a focused PR off feature/timeout-reclaim:

• Implement reclaim_wager
• Add timeout validation logic
• Document timeout assumptions and units

Technical Implementation

Files to modify:

• coinflip-contract/src/lib.rs

Implementation steps:

• Implement reclaim_wager
• Add timeout validation logic
• Document timeout assumptions and units

Branch: feature/timeout-reclaim

Example commit message

feat: implement timeout-based wager reclaim

Acceptance Criteria

• Run tests
• Cover edge cases
• Include test output and safety notes

Guidelines

• Assignment required before starting
• PR description must include: Closes #145

[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

[Kenlachy]

@Kenlachy has applied to work on this issue as part of the Stellar Wave Program's 3rd wave.

I would like to work on this issue because implementing timeout based wager reclaim ensures user funds are not permanently locked when expected outcomes are not fulfilled within a defined time window. This improves fairness, user trust, and system robustness.

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