OracleMart Documentation
Decentralized prediction markets with automated oracle resolution
🎯 OracleMart
Decentralized prediction markets powered by automated oracles
Create markets, place bets, and watch outcomes resolve automatically with Chainlink and UMA Protocol integration.
🚀 Quick Start
📖 Introduction
Understand OracleMart's architecture, features, and how prediction markets work
⚡ Create Market
Learn how to create your first prediction market
💰 Place Bet
Step-by-step guide to placing your first bet
🔌 API Reference
Complete API documentation for developers
✨ Core Features
🤖 Automated Resolution
- Chainlink Integration: Real-time price feeds for financial markets
- UMA Protocol: Dispute resolution and optimistic oracle
- Manual Markets: Commit-reveal pattern for subjective outcomes
- VRF Support: Provably random outcomes for gaming markets
🔐 Security & Reliability
- 161/161 Tests Passing: Comprehensive test coverage
- Security Audited: Professional audit completed
- Reentrancy Protected: Battle-tested security patterns
- Circuit Breakers: Emergency controls for extreme conditions
⚡ Performance
- Real-time Indexing: Sub-second blockchain event processing
- Batch Operations: Efficient multi-market resolutions
- Gas Optimized: Minimal transaction costs
- Scalable Architecture: Handles 100+ events per minute
🏗️ Architecture
📊 Platform Stats
| Metric | Value |
|---|---|
| Network | Sepolia Testnet |
| Contracts Deployed | 4 |
| Test Coverage | 161/161 passing |
| API Endpoints | 12 |
| Resolution Methods | 3 (Oracle, Manual, VRF) |
| Average Resolution Time | Under 60 seconds |
🔗 Smart Contracts
Core Contracts
CoreMarket
Market creation, betting, and claiming logic
ResolutionEngine
Multi-method resolution with consensus
Treasury
Fee collection and ORMT burn management
AutomatedOracle
Chainlink and UMA integration
Contract Addresses (Sepolia)
| Contract | Address |
|---|---|
| CoreMarket | 0x36b5ebE5a161E7d1C7B75aBce457d7066d87e6DB |
| ResolutionEngine | 0xdD2DBd78d4D260321735d45EF32Df965c962Ab7F |
| Treasury | 0x5BCa2465a870bb0E9eaEC70256D747a48aa388E5 |
| AutomatedOracle | 0xc3D6365491A4d83a87351D0323F90bD9d8bFC1Ac |
| ORMT Token | 0x5f3e4a8d1a4e1b8c9a7d6e5f4b3a2c1d0e9f8a7b |
📚 Documentation
For Users
- User Guide - Complete platform walkthrough
- Market Creation - Create prediction markets
- Betting Guide - Place and manage bets
- Claiming Winnings - Collect your rewards
For Developers
- API Reference - Complete REST API documentation
- Smart Contracts - Contract documentation and examples
- Frontend Guide - Next.js app architecture
- Indexer Service - Blockchain event indexing
For Operators
- Deployment Guide - Production deployment instructions
- Security Considerations - Security best practices
- Monitoring - System monitoring and alerting
🛠️ Development Tools
Quick Commands
# Start development server
npm run dev
# Run tests
npm test
# Build for production
npm run build
# Start indexer
cd ../oraclemart-indexer && npm startExternal Links
- NPM Package: @oraclemart/contracts
- Source Code: Coming Soon
- GitHub: Coming Soon
🤝 Community & Support
Get Help
- X (Twitter): @OracleMartHQ
- Telegram: Join our community
- Email: dev@oraclemart.io
Developer Resources
- NPM Package: @oraclemart/contracts
- Documentation: You're here!
- Main App: oraclemart.io
- API Reference: /docs/api
🎯 Getting Started
- Connect Wallet - Use MetaMask or WalletConnect
- Get ORMT Tokens - Required for market creation
- Create Market - Burn 2000 ORMT to create
- Place Bets - Predict outcomes and earn rewards
- Claim Winnings - Automatic payouts after resolution
Ready to dive in? Start with our Introduction guide or jump straight to Creating Your First Market.
🚀 Ready to Get Started?
Join thousands of users creating and predicting on decentralized markets.
🚀 Start Building with OracleMart
Create markets, place bets, and watch outcomes resolve automatically