Puzzle Factory and Registry Contract

[Mkalbani]

Puzzle Factory and Registry Contract

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

Description

Create a factory contract for deploying and registering puzzle instances with metadata and configuration.

Tasks

• Design puzzle registry data structure
• Implement puzzle creation function
• Add puzzle metadata storage (difficulty, category, creator)
• Create puzzle activation/deactivation
• Implement puzzle enumeration and filtering
• Add creator attribution and royalties
• Create puzzle versioning system
• Write factory pattern tests
• Add access control for puzzle creation
• Implement puzzle deprecation logic

Acceptance Criteria

• Puzzles created and registered correctly
• Metadata stored and queryable
• Creator attribution tracked
• Filtering and enumeration functional
• Access controls enforced
• 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

[Properprogress1]

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

I’d like to work on implementing the Puzzle Factory and Registry contract, as it’s central to deploying, managing, and tracking puzzles securely on-chain.

With my experience in Rust smart contracts and Soroban development, I am well-equipped to design a robust factory pattern that handles puzzle creation, metadata storage, and access control while ensuring scalability and security.

I’ll deliver a solution that:

Implements a puzzle registry with metadata (difficulty, category, creator) and versioning/deprecation logic

Supports activation/deactivation, enumeration, and filtering for easy querying

Tracks creator attribution and royalties correctly

Enforces access controls to protect puzzle creation

Includes comprehensive unit tests and is deployable to the testnet

Outcome:
A production-ready, maintainable, and secure puzzle factory that enables smooth creation, tracking, and management of puzzles while maintaining on-chain integrity and creator accountability.

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

[drips-wave]

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

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