feat: implement custom Stellar token/asset support for bets and payouts

[greatest0fallt1me]

Description:

Allow markets to accept and pay out in a configurable Stellar asset (e.g., USDC, custom token) in addition to or instead of native XLM, using Soroban token interface.

Requirements and Context:

• Must be secure, tested, and documented
• Should allow admin to set allowed token(s) per event or globally
• Should use token transfer and balance for locking and payouts
• Should validate token contract and decimals
• Should emit events with asset info
• Must handle approval/allowance if required by token
• Must not break XLM-native flow if still supported

Suggested Execution:

1. Fork the repo and create a branch

   git checkout -b feature/custom-token-support

2. Implement changes

   • Write contract: src/lib.rs (token parameter in place_bet, payouts)
   • Update tokens module: src/tokens.rs (multi-asset)
   • Update types and storage; add documentation and NatSpec-style comments

3. Test and commit

   • Run tests; cover XLM and custom token; insufficient balance
   • Include test output and security notes

Example Commit Message:

feat: implement custom Stellar token/asset support for bets and payouts

Guidelines:

• Minimum 95 percent test coverage
• Clear documentation
• Timeframe: 96 hours

[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

[Georgechisom]

@Georgechisom has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hi, I love to work on this issue and deliver an excellent result, please help assign it to me.

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

[soma-enyi]

@soma-enyi has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Gm Gm Maintainer!!
I would like to work on this issue!!!

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

[Sobilo34]

@Sobilo34 has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hi! Sobil is here

As a Web3 software engineer with experince in building full start blockchain products, both smart contract and frontend integration. I will do this project if it is assigned to me.

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

[MerlinTheWhiz]

@MerlinTheWhiz has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Can I handle this please, I'd love to implement this

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

[drips-wave]

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

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