Hint Marketplace and Trading Contract

[Mkalbani]

Hint Marketplace and Trading Contract

Location: contracts/hint_marketplace
Labels: smart-contract, soroban, good first issue
Estimated Time: 6 hours
Difficulty: Medium

Description

Implement a marketplace where players can buy, sell, and trade puzzle hints with dynamic pricing.

Tasks

• Design hint listing data structure
• Implement hint creation and listing
• Create dynamic pricing algorithm
• Add buy/sell functions with escrow
• Implement hint quality rating system
• Create creator royalty distribution
• Add hint pack bundles
• Write marketplace flow tests
• Optimize for gas efficiency
• Add listing expiration logic

Acceptance Criteria

• Hints listed and tradable
• Pricing adjusts based on demand
• Escrow holds funds securely
• Royalties paid to creators
• Bundles work correctly
• Contract deployed to testnet

[drips-wave]

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

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

🤠 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

[Bug-Hunter-X]

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

I would like to apply to work on the Hint Marketplace and Trading Contract for the MindFlowInteractive quest-contract repository. I have experience developing and testing smart contracts, including marketplace logic, escrow mechanisms, and gas-efficient designs, and I am comfortable working with Soroban-based contracts. I will design a clean and extensible hint listing data structure, implement secure buy/sell flows with escrow, dynamic demand-based pricing, creator royalty distribution, and quality rating mechanisms. The solution will include support for bundles, listing expiration, and optimized contract logic, along with thorough marketplace flow tests to ensure correctness and security before deploying the contract to testnet.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Bug-Hunter-X to this issue.

[drips-wave]

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

🧑‍💻 @Bug-Hunter-X: 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.

⚠️ Important: When opening a PR, please link it to this issue to ensure it gets tracked accurately.

🤠 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 🌊