Fee Router v2 (Per-Asset + Per-Role + Collector Rotation)

[Cedarich]

Status: Open (Wave 4 – financial)
Labels: Contract, Financial, Admin, wave4
Complexity: High (200 points)
Summary
Upgrade fee handling to support per-asset fees, optional arbiter fees, and rotating the fee collector address without disrupting existing escrows.
Tasks

• Extend fee config to include per-asset fee bps and optional role splits.
• Implement fee routing logic that handles XLM + SAC tokens consistently.
• Add admin entry point to rotate collector address safely.
• Add tests for fee calculation and routing across asset types.
  Acceptance Criteria
• Fees are always deducted exactly as configured and never exceed expected bounds.
• Collector rotation affects new payouts without breaking old escrows.
• Tests cover XLM and SAC scenarios.

---

[Pee-pheelips]

@Pee-pheelips has applied to work on this issue as part of the Stellar Wave Program's 4th wave.

Hi, I'd love to work on this issue, my name is Paul. I am a fullstack web3 engineer with 4 years of experience building Web and mobile applications.

I can confidently handle this issue. Here is my portfolio and projects I have handled:

https://Paulfolio-delta.vercel.app
https://www.rown.xyz/
https://ecohotels.com
https://eduvacity.com/
https://www.mollateral.com/

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

[titilayo967]

@titilayo967 has applied to work on this issue as part of the Stellar Wave Program's 4th wave.

Hi Maintainer! I'd like to work on issue #305. I have experience implementing fee routing logic in smart contracts and can extend the fee configuration to support per-asset fees, role-based splits, and safe collector rotation without disrupting existing escrows.

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

[drips-wave]

Congratulations, @titilayo967! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on April 29, 2026.

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