[CTR] Implement Emergency Protocol Pause and Global Freeze Mechanism

[Rampop01]

Issue #54

[CTR] Implement Emergency Protocol Pause and Global Freeze Mechanism

🔴 Priority: Critical
Difficulty: Hard
Estimated Effort: 2 days
Relevant Files: contracts/admin/src/pause.rs, contracts/shared/src/guards.rs
Labels: admin, security, priority:critical

Requirements

1. Pause Guard

   • Store a global is_paused: bool flag in the Admin contract's instance storage.
   • Expose pause_protocol() and resume_protocol() callable only by the Admin multisig.
   • Create a require_not_paused(env) guard function in contracts/shared/src/guards.rs that reads the flag and panics with Error::ProtocolPaused if true.
   • Integrate require_not_paused(env) as the first check in ALL state-mutating functions across Escrow, Swap, and Reputation contracts.

2. Testing Requirements

   • Unit test: Call pause_protocol(), then attempt to call fund_escrow() and assert it panics with Error::ProtocolPaused.
   • Unit test: Call resume_protocol() and assert fund_escrow() proceeds normally.

---

[Achievers-sketch]

I can implement a secure global pause mechanism with multisig authorization, shared guards across contracts, comprehensive tests, and safe resume behavior for critical protocol operations.

[Peculiarr7]

Hi! I came across this issue and would love to work on it. I have experience with similar tasks and I'm confident I can investigate, implement a clean solution, and thoroughly test it before submitting a PR. If the issue is still open, I would appreciate it if you could assign it to me. I’ll prioritize this immediately and ensure a reliable solution is delivered as soon as possible. Thank you!