#1052 Implement platform-wide circuit breaker for system outages

[vic-Gray]

Area: backend · Effort: M

What: Add a platform-level circuit breaker that an admin can trigger to halt all deposits and withdrawals across all vaults simultaneously during a critical incident.

Why: When a security incident or smart contract exploit is detected, the operator needs to stop all financial activity instantly across the entire platform, not vault by vault.

Acceptance Criteria:

• POST /admin/platform/circuit-breaker/open halts all deposits and withdrawals globally
• All affected endpoints return a 503 with a message explaining the maintenance window
• POST /admin/platform/circuit-breaker/close restores normal operation
• Circuit breaker state changes are logged in the audit trail with the actor's identity

Hints:

• Store circuit breaker state in Redis for instant cross-instance propagation
• Add a guard that checks the circuit breaker state on every deposit/withdrawal endpoint
• Implement the circuit breaker as a platform feature flag

[mrmoney10010-design]

@mrmoney10010-design has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hi, I'd like to work on this issue.

I plan to implement a platform-wide circuit breaker backed by Redis, add admin endpoints to open and close it, enforce the check across all deposit and withdrawal flows, return 503 responses during shutdown periods, and ensure all state changes are recorded in the audit trail with the acting administrator's identity.

Could this issue be assigned to me?

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

[drips-wave]

Congratulations, @mrmoney10010-design! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on June 30, 2026.

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