• 📊 Contract Specifications
• 🏗 Project Architecture
• 🛡 Security & Features
• ⚙️ Access Control Matrix

Designed with a modular folder structure for maximum clarity and testing efficiency using the Foundry framework.

• 📂 src/
  • 📄 SisoToken.sol — The core logic (Inherits ERC20, Ownable, Pausable).
• 📂 script/
  • 🚀 DeploySisoToken.s.sol — Automated blockchain deployment via DevOps pipelines.
  • 🪙 MintSisoToken.s.sol — Admin-controlled minting scripts.
  • 🔥 BurnSisoToken.s.sol — Supply reduction & deflationary logic.
  • ⏸️ PauseSisoToken.s.sol — Emergency circuit breaker controls.
• 📂 test/
  • 🧪 SisoToken.t.sol — Invariant, Fuzz, and Unit test suite.

This contract implements a strict Permission Matrix to ensure security while allowing open participation in tokenomics.

We implement the Pausable module to protect the ecosystem during unforeseen events.

graph LR
    Call[User calls Transfer]
    Check{Is Contract Paused?}
    Status_Active[Active State]
    Status_Paused[Paused State]
    
    Call --> Check
    Check -- No --> Status_Active
    Status_Active --> Execute[✅ Execute Transfer]
    
    Check -- Yes --> Status_Paused
    Status_Paused --> Revert[❌ Revert Transaction]
    
    style Status_Active fill:#1a1a1a,stroke:#b298dc
    style Status_Paused fill:#2d1b4e,stroke:#9d4edd,stroke-width:2px

Note: When paused, only view functions remain accessible. State-changing actions (Transfer, Mint, Burn) are strictly blocked.