feat: implement admin module and update contract test snapshots

[Oluwasuyi-Oluwatimilehin-Daniel]

#closes #569

Pull Request: Diagnostic Pause Reason Codes & Structured Events

This PR improves the debuggability and auditability of the QuickEx contract when operations are paused. It introduces explicit reason codes for global and feature-specific pauses, exposes read-only getters for backends/clients, and emits structured events whenever pause states transition or block an operation.

Key Changes

1. Stable Reason Codes & Storage Mapping

• Introduced the PauseReason enum in types.rs containing stable discriminant values for common pause contexts (SystemMaintenance = 1, SecurityEmergency = 2, FeatureUpgrade = 3, RegulatoryCompliance = 4, OperatorIntervention = 5).
• Added persistent storage mappings for the global pause reason code (GlobalPauseReason) and granular feature-specific pause reasons (FeaturePauseReasons) in storage.rs.

2. Structured Transition & Enforcement Events

Registered three new event schemas in the canonical catalog EVENT_SCHEMAS in events.rs:

• PauseEnabled: Emitted when a pause state is enabled globally or locally on a feature, recording the admin authorizer, whether it is global, the target feature flag, and the reason code.
• PauseDisabled: Emitted when a pause state is lifted.
• PauseEnforced: Emitted inline right before a blocked operation returns a pause error, containing the caller address, blocked action symbol, and the reason code.

3. Administrative Interface & Entrypoint Updates

• Modified administrative functions set_paused, pause_features, and unpause_features in admin.rs to accept the new reason: u32 code argument, persist it, and publish the transition events.
• Exposed view methods get_global_pause_reason(env) and get_feature_pause_reason(env, flag) in lib.rs for clients and backends.
• Hooked all operation pause-checks in lib.rs to emit PauseEnforced events containing the exact active reason code.

4. Tests Modification

• Updated all unit, storage, stealth, role, and upgrade test files to provide reason codes for administrative calls.
• Extended the schema catalog size assertion in test.rs from 21 to 24 schemas.
• Added integration test test_pause_reason_codes_and_events to verify the new get/set flow.
• Refactored test_event_snapshot_contract_paused_schema to search specifically for the ContractPaused topic, preventing mismatch failures from the co-emitted PauseEnabled event.
  #closes

[drips-wave]

@Oluwasuyi-Timilehin Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

[Cedarich]

@Oluwasuyi-Timilehin fix workflow

[Oluwasuyi-Oluwatimilehin-Daniel]

Okay will do

[Oluwasuyi-Oluwatimilehin-Daniel]

@Cedarich I already fixed it

[Cedarich]

@Oluwasuyi-Timilehin

[Oluwasuyi-Oluwatimilehin-Daniel]

@Cedarich sorry, it has been fiixed now

[Cedarich]

@Oluwasuyi-Timilehin

[Oluwasuyi-Oluwatimilehin-Daniel]

@Cedarich it has been fixed

[Cedarich]

Hello 👋 please review this PR the changes made are too much 3000+

[Oluwasuyi-Oluwatimilehin-Daniel]

@Cedarich the ci was failing cause of the formatting, and after formatting those were the files changed

[Cedarich]

Please can we keep the changes here minimal, only necessary changes

[Oluwasuyi-Oluwatimilehin-Daniel]

@Cedarich only the necessary file has been changed

[Cedarich]

@Oluwasuyi-Timilehin

[Oluwasuyi-Oluwatimilehin-Daniel]

@Cedarich it has been fixed

[Cedarich]

@Oluwasuyi-Timilehin

[Cedarich]

@Oluwasuyi-Timilehin

[Oluwasuyi-Oluwatimilehin-Daniel]

@Cedarich

[Cedarich]

@Oluwasuyi-Timilehin

[Oluwasuyi-Oluwatimilehin-Daniel]

@Cedarich