Add a protocol fee update endpoint for admins to change the global fee bps and treasury address

[Chucks1093]

Summary

Updating the protocol fee currently requires a direct contract call. A POST /admin/protocol/fee endpoint that submits a timelock proposal for the fee change and tracks it server-side would route the update through the required 48-hour delay automatically.

Scope

• Add POST /admin/protocol/fee with { feeBps: number, treasuryAddress: string } body requiring a valid admin JWT
• Validate feeBps is between 0 and 1000 and treasuryAddress is a valid Stellar address
• Submit propose_config_change with changeType update_fee and the encoded payload
• Store the pending proposal in the timelock_proposals table with executionNotBefore
• Return the proposalId and executionNotBefore timestamp in the response

Acceptance Criteria

• Timelock proposal created and stored for valid input
• feeBps above 1000 returns 422
• Invalid treasury address returns 422
• Non-admin JWT returns 403
• Response includes proposalId and executionNotBefore

ETA: 12 hours

---

Coordinate on Telegram

[GauravKarakoti]

Allow me to work on this one

[Olowodarey]

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

Hello, I’m Darey Olowo, a frontend and smart contract developer with experience building and shipping reliable features. I’d like to take on this issue and deliver a solid solution within 24 hours.

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

[crookdev11]

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

Hey maintainer I would like to work on this issue

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

[aishagbadamosi]

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

Hi Mantainer please assign

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

[Stanley-Owoh]

@Stanley-Owoh has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Good day maintainer please assign this issue to me thank you

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

[Mona-i]

@Mona-i has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hello maintainer

I would love to work on this issue.

Please assign.

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

[bytebinders]

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

I would like to work on this

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

[Ahbiz]

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

Hello maintainer, i would love to work on this issue

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

[Akpamgbo]

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

Hey Chief, can i take on this issue please, I am good at this work.

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

[drips-wave]

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

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

[drips-wave]

This issue has been completed by @Akpamgbo as part of the Stellar Wave Program's 8th Wave 🥳

😎 @Akpamgbo: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here. You can also Leave a review to share your experience working on this issue.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.