Smart Contract Specifications
Complete technical specifications for the Riddlen Protocol smart contract ecosystem. These documents detail the implementation of the core protocol mechanics including token economics, reputation systems, airdrop distribution, and automated treasury management.
Core Contracts
RDLN Token Contract
The economic engine of Riddlen Protocol
The RDLN token implements the core utility token with integrated deflationary mechanics and precise allocation management. This ERC-20 contract features:
- 1 billion total supply with transparent allocation tracking
- Integrated burn mechanisms for deflationary economics
- Prize pool management (700M RDLN / 70%)
- Treasury operations (100M RDLN / 10%)
- Airdrop allocation (100M RDLN / 10%)
- Liquidity provision (100M RDLN / 10%)
Key Features: ERC-20 standard, burn tracking, allocation management, gaming integration
RON Reputation System
Soul-bound tokens for merit-based access control
The RON (Riddlen Oracle Network) reputation system implements non-transferable soul-bound tokens that track earned intelligence and gate access to oracle validation tiers. Features include:
- Soul-bound token mechanics (non-transferable)
- Difficulty-weighted reputation awards
- Progressive tier system (Bronze → Platinum)
- Performance bonuses and streak rewards
- Anti-Sybil protection through earned-only access
Key Features: Soul-bound tokens, tiered access, merit-based progression, oracle network integration
RiddlenAirdrop Contract
Two-phase community distribution system
The RiddlenAirdrop contract distributes 100M RDLN tokens across two strategic phases targeting different user segments. This upgradeable contract implements:
- Phase 1: Early adoption rewards (50M RDLN)
- Phase 2: RON reputation rewards (50M RDLN)
- 10,000 RDLN per wallet allocation
- Merit-based qualification criteria
- UUPS upgradeable proxy pattern
Key Features: UUPS upgradeable, dual-phase distribution, merit-based access, pausable operations
TreasuryDrip Contract
Automated treasury distribution with comprehensive safeguards
The RiddlenTreasuryDripAutomated contract provides secure, automated monthly token releases for protocol operations. Production-ready features include:
- Automated monthly releases (1M RDLN base)
- Dynamic scaling (1.0x to 5.0x multiplier)
- Chainlink Automation and Gelato compatibility
- Circuit breaker and timelock protections
- Emergency safeguards and monitoring
Key Features: Automated distribution, security safeguards, automation-ready, failsafe mechanisms
Architecture Overview
Security Patterns
- OpenZeppelin Libraries: Industry-standard security implementations
- Upgradeable Proxies: UUPS pattern for future improvements
- Access Control: Role-based permissions and ownership management
- Reentrancy Guards: Protection against reentrancy attacks
- Pausable Operations: Emergency pause functionality
Testing & Verification
- 200+ Test Cases: Comprehensive test coverage across all contracts
- Gas Optimization: Efficient implementations with gas reporting
- Contract Verification: All contracts verified on PolygonScan
- Integration Testing: Full ecosystem integration validation
Network Deployment
- Polygon Amoy Testnet: Currently deployed and operational
- Chain ID: 80002
- Verification: All contracts verified on Amoy PolygonScan
Additional Resources
Developer Documentation
- Live Testnet Deployment - Current contract addresses
- Frontend Integration Guide - How to integrate with contracts
- GitHub Repository - Complete source code
Protocol Guides
- Tokenomics - Token economics and distribution
- Burning Protocol - Deflationary mechanics
- NFT Mechanics - Weekly riddle system
Last updated: October 2025