CONTRACTS: Implement Token Royalty System

[truthixify]

Description
Add royalty mechanism to automatically distribute fees to creators and stakeholders when tokens are transferred or sold.

Files to Modify

• contracts/manage_hub/src/royalty.rs - Create royalty module
• contracts/manage_hub/src/types.rs - Add royalty structures
• contracts/manage_hub/src/membership_token.rs - Integrate royalty payments
• contracts/manage_hub/src/lib.rs - Add royalty endpoints

Key Changes Required

• Royalty Configuration - Set royalty percentages per token
• Payment Distribution - Automatically distribute royalties on transfers
• Multiple Recipients - Support multiple royalty recipients
• Royalty History - Track all royalty payments
• Update Mechanism - Allow updating royalty configurations
• Query Functions - Add functions to retrieve royalty info

Acceptance Criteria

• Implement set_royalty function with percentage and recipients
• Add automatic royalty calculation on transfers
• Support multiple royalty recipients with different percentages
• Emit RoyaltyPaid events with payment details
• Add get_royalty_info query function
• Implement royalty payment history tracking
• Validate royalty percentages (max 100%)
• Support royalty-free transfers for specific cases

[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

[Queenode]

@Queenode has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

I would like to work on this issue as a full-stack developer . I understand the assignment and the requirements, and I’m confident in the approach needed to deliver the best solution. Kindly assign this task to me.

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

[Uyoxy]

@Uyoxy has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

I’m excited to work on implementing the Token Royalty System! I have experience building smart contract modules and handling automated payment distribution. I can create the royalty module, add the necessary structures, integrate royalty payments into token transfers, and expose endpoints for configuration, ensuring royalties are correctly calculated and distributed to creators and stakeholders.

Looking forward to contributing!

Thanks.

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

[Timi16]

@Timi16 has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

I would love to do this

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