Smart Contracts Repository for Quantillon Protocol - Euro-pegged stablecoin ecosystem with dual-pool architecture

This repository contains the complete smart contract implementation for the Quantillon Protocol. All development files are organized in the quantillon-protocol directory.

smart-contracts/
├── quantillon-protocol/          # Main project directory
│   ├── src/                     # Smart contract source code
│   │   ├── core/               # Core protocol contracts
│   │   ├── interfaces/         # Contract interfaces
│   │   ├── libraries/          # Utility libraries
│   │   └── oracle/             # Oracle integration
│   ├── test/                   # Comprehensive test suite
│   ├── scripts/                # Build and deployment scripts
│   ├── docs/                   # Generated documentation
│   ├── lib/                    # External dependencies
│   ├── foundry.toml           # Foundry configuration
│   └── README.md              # Detailed project documentation
└── README.md                   # This file

📁 quantillon-protocol/ - Complete smart contract implementation

• 📄 Source Code - All smart contracts and libraries
• 🧪 Tests - Comprehensive test suite
• 📚 Documentation - Generated documentation
• 🔧 Scripts - Build and deployment scripts

Quantillon Protocol is a comprehensive DeFi ecosystem built around QEURO, a Euro-pegged stablecoin. The protocol features a dual-pool architecture that separates user deposits from hedging operations, enabling efficient yield generation while maintaining stability.

• QEUROToken: Euro-pegged stablecoin with configurable supply cap and rate limiting
• QTIToken: Governance token with vote-escrow mechanics and voting power multipliers
• QuantillonVault: Main vault for overcollateralized QEURO minting
• UserPool: User deposit and staking management with yield distribution
• HedgerPool: EUR/USD hedging operations with margin management
• stQEUROToken: Yield-bearing wrapper token with automatic yield accrual

• Dual-pool architecture separating user deposits from hedging operations
• Role-based access control for all critical operations
• Emergency pause mechanisms for crisis situations
• Upgradeable architecture via UUPS pattern
• Oracle integration for EUR/USD price feeds
• Yield generation through multiple mechanisms

• Foundry (latest version)
• Git

# Clone the repository
git clone https://github.com/quantillon/smart-contracts.git
cd smart-contracts

# Navigate to the main project
cd quantillon-protocol

# Install dependencies and build
forge install
forge build

# Run tests
forge test

cd quantillon-protocol
forge doc --build
forge doc --serve

• QEUROToken - Euro-pegged stablecoin
• QTIToken - Governance token
• QuantillonVault - Main vault
• UserPool - User deposits
• HedgerPool - Hedging operations
• stQEUROToken - Yield-bearing wrapper

cd quantillon-protocol

# Run all tests
forge test

# Run with verbose output
forge test -vvv

# Generate coverage
forge coverage

cd quantillon-protocol

# Format code
forge fmt

# Build contracts
forge build

# Deploy to local network
forge script script/deploy/DeployProtocol.s.sol --rpc-url http://localhost:8545 --broadcast

The protocol includes comprehensive development and analysis tools:

# Code Quality & Analysis
make gas-analysis      # Comprehensive gas optimization analysis
make analyze-warnings  # Analyze and categorize build warnings
make validate-natspec  # Validate NatSpec documentation coverage
make slither          # Security vulnerability analysis

# Documentation & Testing
make docs             # Generate HTML documentation
make test             # Run comprehensive test suite
make coverage         # Generate test coverage report

# Complete Development Pipeline
make all              # Run all checks (build, test, coverage, docs, analysis)

Key Features:

• Gas Analysis: Contract size optimization, function visibility analysis, storage layout optimization
• Warning Analysis: Categorizes build warnings by type with actionable recommendations
• NatSpec Validation: Ensures 100% documentation coverage for security audits
• Security Analysis: Comprehensive vulnerability detection with Slither
• Documentation: Auto-generated HTML documentation from NatSpec comments

• Security Contact: team@quantillon.money
• Security Features: Role-based access control, reentrancy protection, emergency pause mechanisms
• Security Analysis: Integrated Slither analysis with make slither
• Warning Analysis: Comprehensive build warning analysis with make analyze-warnings

For detailed security information, see the main project README.

We welcome contributions! Please see our Contributing Guidelines for details.

1. Fork the repository
2. Create a feature branch
3. Make your changes in the quantillon-protocol directory
4. Add tests and update documentation
5. Submit a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

• Website: quantillon.money
• Documentation: docs.quantillon.money
• X (Twitter): @QuantillonLabs
• Discord: discord.gg/uk8T9GqdE5
• Telegram: @QuantillonLabs

For comprehensive documentation, setup instructions, and development guides, please see:

📁 quantillon-protocol/README.md

Built with ❤️ by the Quantillon Labs team