🧠 Riddlen Protocol Documentation

The first blockchain protocol that rewards human intelligence over computational power through Proof-of-Solve consensus.

🎯 What is Riddlen?

Riddlen revolutionizes blockchain gaming and oracle networks by creating the first merit-based ecosystem where:

🧠 Intelligence > Capital: Solve riddles to earn governance power
🎮 NFT-as-Game: Interactive experiences vs static collectibles
🏆 Tiered Rewards: First solvers earn 2x more, creating solve urgency
🛡️ Rug-Proof Treasury: Immutable monthly releases with emergency limits
⚡ Soul-Bound Reputation: Non-transferable RON tokens representing earned intelligence

📚 Documentation Sections

🌐 Live Testnet

Currently deployed and operational on Polygon Amoy testnet:

Complete Deployment Guide - Live contract addresses and features
Revolutionary tiered rewards and rug-proof treasury
Testing instructions and verification links

🎮 Frontend Integration

Build on Riddlen with our comprehensive developer guide:

Frontend Integration Guide - Complete integration examples
React components and JavaScript code samples
UI/UX recommendations and testing workflows

📋 Smart Contracts

Core protocol implementation:

Solidity contracts with comprehensive test coverage
OpenZeppelin-based security patterns
Upgradeable proxy architecture

🚀 Quick Start Options

For Users - Try Live Testnet

Get Testnet MATIC: Polygon Faucet
Connect Wallet: MetaMask with Amoy network (Chain ID: 80002)
Start Playing: Visit riddlen.com to solve riddles

For Developers - Integrate with Riddlen

// Connect to live testnet contracts
const CONTRACTS = {
  RDLN: "0x133029184EC460F661d05b0dC57BFC916b4AB0eB",
  RON: "0xD86b146Ed091b59cE050B9d40f8e2760f14Ab635",
  RIDDLE_NFT: "0x529e3076cB9A48D6FAd086abE5d23ea76159e9E3"
}

// See Frontend Integration Guide for complete examples

For Contributors - Join Development

# Clone the complete ecosystem
git clone https://github.com/RiddlenBaba/riddlen.git
cd riddlen/contracts
npm install && npm test

🎯 Revolutionary Features

🎁 Three-Phase Airdrop System (NEW in v6.0)

100M RDLN distributed through innovative three-phase mechanism:

Phase 1: Social Proof - Earn 5,000 RDLN for community engagement
Phase 2: RON Reputation - Passive rewards (2K-5K RDLN) based on reputation tiers
Phase 3: Validation Work - Active earning (500 RDLN per validation) with 25% bonus

Fair Distribution: 15K RDLN global cap per wallet, 10K-15K participants expected

📖 Complete Airdrop Guide

🏆 Tiered Reward System

The first NFT gaming system that rewards speed:

Example: 20 Winners, 1M RDLN Prize Pool
├── Tier 1 (Positions 1-5):   2.0x → ~88,888 RDLN each
├── Tier 2 (Positions 6-15):  1.0x → ~44,444 RDLN each
└── Tier 3 (Positions 16-20): 0.5x → ~22,222 RDLN each

Result: First solver earns 4x more than last solver!

🛡️ Rug-Proof Treasury

Immutable holder protections built into smart contracts:

Fixed 1M RDLN monthly operations releases
Maximum 5M RDLN emergency per year (1-year cooldown)
Autonomous execution (no admin required)
Full transparency via smart contract queries

🔄 Merit-Based Progression

Earn your way to governance power:

EASY Riddles → Earn RON → SOLVER Tier
MEDIUM Riddles → More RON → EXPERT Tier
HARD Riddles → Elite RON → ORACLE Tier
Governance → Vote on protocol decisions

🔮 Oracle Network (NEW in v6.0)

Enterprise data validation powered by human intelligence:

🏢 External Revenue: Companies pay RDLN for trusted data validation
🧠 RON-Based Access: High-reputation validators earn from validation work
⚖️ Consensus Mechanism: Multiple validators ensure accuracy (5 of 7, etc.)
💰 Validator Tiers: Bronze (100 RON) → Silver (1K) → Gold (10K) → Platinum (100K)
🛡️ Slashing Protection: Incorrect validators lose staked RON
📊 Fee Distribution: 50% treasury, 30% buyback/burn, 20% validator bonuses

📖 Oracle Network Guide

🏛️ DAO Governance (NEW in v6.0)

Progressive decentralization with intelligent founder transition:

🗳️ RON-Based Voting: 1 RON = 1 vote (earned, not bought)
👑 Transferable Founder Role: Can be passed to community or dissolved
⏰ Three Phases: Builder → Shared Governance → Full DAO
🔄 Dynamic Thresholds: Proposal requirements halve every 2 years (Era-based)
🛡️ 48-Hour Timelock: Critical changes have built-in review periods

📖 Governance Guide

🎮 Farcaster Frames (NEW in v6.0)

Social gaming integration with 710K+ potential users:

🖼️ 7 Interactive Frames: Play riddles directly in Farcaster feed
⚡ Gasless Onboarding: First 3 mints sponsored for new users
🏆 Victory Sharing: Auto-generate shareable victory frames
📊 Live Leaderboards: Track top solvers in real-time
🎁 Airdrop Integration: Check eligibility and claim via frames

📖 Farcaster Frames Guide

📊 Live Status

🌐 Testnet Contracts (Amoy) - v6.0

🧪 Development Status

200+ tests passing across all v6.0 smart contracts
20/20 airdrop tests completed (4s execution)
Oracle Network integration validated
DAO governance system ready for deployment
Farcaster Frames live with 7 interactive frames
Professional audit planned for v6.0 mainnet deployment

Core Documentation

🌐 Main Website - Try the live application
🎁 Airdrop Guide - Three-phase 100M RDLN distribution
🔮 Oracle Network - Become a validator
🏛️ Governance - DAO and voting system
🎮 Farcaster Frames - Social gaming integration

Developer Resources

🚰 Get Testnet MATIC - Testnet tokens
📋 GitHub Repository - Complete source code
💻 Frontend Integration - Developer guide
🌐 Live Contracts - Testnet deployment
📝 FAQ - Common questions answered

Community

🐦 Twitter Updates - Latest news
💬 Telegram - Official announcements
🔍 PolygonScan - Explore contracts

🤝 Community & Support

💬 Join Our Community

Official Channel: t.me/RiddlenToken - Official announcements
Community Chat: t.me/RiddlenCommunity - General discussion

📋 GitHub Discussions

Announcements - Official updates and releases
Community Creations - Show off your builds
General Discussion - Open conversation
Governance - Protocol proposals and voting
How It Works - Technical explanations
Ideas & Feature Requests - Suggest improvements
Q&A - Get help and answers

🌐 Official Links

Main Repository: github.com/RiddlenBaba/riddlen
Website: riddlen.com
Documentation: riddlen.org (You are here!)
Twitter: @RiddlenToken
Issues: GitHub Issues

🔮 The Vision

“Intelligence matters more than capital.”

Riddlen demonstrates that decentralized systems can effectively harness human collective intelligence while creating meaningful economic incentives. By separating financial tokens (RDLN) from intellectual reputation (RON), we solve fundamental problems in both gaming economies and oracle validation systems.

Join us in building the future where merit drives value! 🧠⚡

Last updated: October 2025 • Riddlen Protocol v6.0