Royalty Splitter and Revenue Share Contract

[Mkalbani]

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

Description

Build a contract that automatically splits royalties and revenue among multiple parties based on predetermined percentages.

Tasks

• Design revenue split data structure
• Implement split configuration creation
• Add automatic payment distribution
• Create withdraw mechanism for recipients
• Implement percentage-based splitting
• Add support for dynamic split updates
• Create revenue tracking per recipient
• Write distribution flow tests
• Add minimum threshold for distributions
• Implement emergency withdrawal for stuck funds

Acceptance Criteria

• Splits configured correctly
• Payments distributed automatically
• Recipients can withdraw their share
• Percentages calculated accurately
• Updates handled securely
• 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.

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

[soomtochukwu]

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

GM @Mkalbani, I'd resolve this by building a robust Soroban Royalty Splitter contract that supports dynamic percentage-based revenue/royalty configuration, automatic on-receive distribution, recipient withdrawals, revenue tracking, minimum payout thresholds, secure split updates, emergency fund recovery, thorough tests for all flows, and testnet deployment.

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

[Obiajulu-gif]

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

I would like to implement this Soroban royalty_splitter contract by:
Designing the split config (recipients + bps/percentages, total must equal 100%) and storing it on-chain.
Adding functions to create and update splits securely (admin-only, validation to prevent invalid totals).
Implementing automatic distribution logic: when revenue is deposited, compute each recipient’s share precisely and record it.
Building a withdraw flow so each recipient can claim their accumulated balance safely (no double-withdrawals).
Adding revenue tracking per recipient (total earned, total withdrawn, current withdrawable).
Enforcing a minimum distribution threshold to avoid dust payouts and reduce fees.

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

[bakarezainab]

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

Hi, I would like to work on this issue. I’m a security researcher and I’ve contributed to the Stellar ecosystem with experience in building and auditing smart contracts. I can implement a secure, auditable royalty splitter that distributes revenue based on predefined percentages, with proper validation, access control, and event logging

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

[ritik4ever]

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

Hi, I’d like to take this issue .
I’ve worked on similar projects before and have relevant experience, so I should be able to handle this efficiently.

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

[Akanimoh12]

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

Hi, I'd love to work on this issue. I'm a full-stack developer specializing in web apps and Smart Contracts, with experience in Next.js, TypeScript, Tailwind, and blockchain integrations.I can handle this confidently, here's my portfolio and key projects:

• https://i-predict.vercel.app/
• https://frontend-nine-mocha.vercel.app/
• www.shokoverse.xyz
• https://chessflip-celo.vercel.app/

Active OSS contributor.

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

[Samuel1505]

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

I would like to work on this issue, I'm a software developer writing Rust and soroban, kindly assign me.

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

[gregemax]

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

Hi I’d like to work on this Royalty Splitter Soroban contract.

I’ll implement a percentage-based revenue split with secure configuration, automatic distribution, per-recipient balance tracking, and a withdraw mechanism. The contract will support dynamic split updates, minimum distribution thresholds, and an emergency withdrawal for stuck funds, using safe integer math and proper access control.

I’ll add full distribution-flow tests and deploy the contract to testnet to meet all acceptance criteria.

Happy to start right away

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

[CMI-James]

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

First time contributor to this project, I have read the issue description and I would love to take this on.

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

[beebozy]

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

Hi, maintainner. I have gone through the description and I understand the it nuance.. Can you assign me the issue?

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

[caxtonacollins]

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

I am a full-stack/blockchain developer
i will love to work on and close this issue
please assign

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

[Georgechisom]

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

Hi, Please let me work on this issue, help assign it to me.

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

[Eniola3321]

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

Hi Maintainers,
I’m interested in working on this issue. I’m a backend developer with experience in Node.js, APIs, and Web3/blockchain concepts.
I’ve reviewed the issue and I’m confident I can contribute a clean solution.
Kindly assign it to me if it’s open. Thanks!

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