0xCast

Decentralized Prediction Markets on Bitcoin

Overview

0xCast is a decentralized prediction market platform built on Stacks, enabling users to create and trade on binary outcome markets using STX. Leveraging the security of Bitcoin through Stacks' Proof of Transfer consensus, 0xCast provides a trustless, transparent environment for speculation on crypto and financial events.

Features

Core Platform

• Binary Prediction Markets - Create Yes/No markets on any outcome
• STX-Based Trading - All trades conducted using native STX tokens
• Dynamic Odds - Real-time odds calculated based on pool distribution
• Transparent Resolution - All outcomes resolved on-chain with full transparency
• Automated Payouts - Winners claim rewards through smart contracts

Advanced Features

• Liquidity Pools - AMM-based liquidity provision with LP rewards
• Governance System - On-chain governance with proposals and voting
• Oracle Integration - External data feeds for automated market resolution
• Access Control - Role-based permissions for oracles and administrators
• Dispute Resolution - Community-driven dispute mechanism for contested outcomes

Tech Stack

Smart Contracts (Clarity)

Contract	Description
market-core	Core prediction market logic
access-control	Role-based permissions
market-fees	Fee collection and distribution
governance-token	SIP-010 governance token (CAST)
governance-core	Proposal and voting system
oracle-integration	Price feeds and resolution
liquidity-pool	AMM for market liquidity
liquidity-rewards	LP incentive distribution
oracle-reputation	Oracle performance tracking

Frontend

• React 19 + TypeScript
• Vite for fast builds
• Tailwind CSS for styling
• @stacks/connect for wallet integration
• React Router for navigation

Getting Started

Prerequisites

• Node.js v18+
• Clarinet for contract development
• Stacks Wallet for testing

Installation

# Clone the repository
git clone https://github.com/your-username/0xCast.git
cd 0xCast

# Install frontend dependencies
cd frontend
npm install

# Start development server
npm run dev

Contract Development

# Check contract syntax
clarinet check

# Run tests
clarinet test

# Start local console
clarinet console

Building for Production

cd frontend
npm run build

Deployment

Frontend (Vercel)

The frontend is configured for seamless Vercel deployment:

cd frontend
vercel

Or connect your GitHub repository to Vercel for automatic deployments.

Contracts (Stacks)

# Deploy to testnet
clarinet deployments generate --testnet
clarinet deployments apply --testnet

# Deploy to mainnet
clarinet deployments generate --mainnet
clarinet deployments apply --mainnet

Project Structure

0xCast/
├── contracts/          # Clarity smart contracts
├── tests/              # Contract test files
├── frontend/           # React frontend application
│   ├── src/
│   │   ├── components/ # Reusable UI components
│   │   ├── pages/      # Page components
│   │   ├── hooks/      # Custom React hooks
│   │   ├── utils/      # Helper functions
│   │   └── types/      # TypeScript types
│   └── public/         # Static assets
├── scripts/            # Utility scripts
├── settings/           # Network configurations
└── docs/               # Documentation

Contract Addresses

Network	Contract	Address
Mainnet	market-core	SP31PKQVQZVZCK3FM3NH67CGD6G1FMR17VQVS2W5T

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see LICENSE file for details

Resources

• Stacks Documentation
• Clarity Language Reference
• Stacks Explorer