Onchain prediction market on Base Sepolia. Users create markets around X (Twitter) metrics, place USDC bets, and markets are automatically resolved via Chainlink CRE workflows.
Live App: https://predictx-sandy.vercel.app/
| Folder | Description | Details |
|---|---|---|
web/ |
Next.js frontend with wagmi/viem, admin panel, and cron-based stats collection | web/README.md |
contracts/ |
Solidity smart contracts (Foundry) - MarketRegistry, BettingPool, MarketResolution | contracts/ |
cre-workflow/ |
Chainlink CRE workflow for automated market resolution via DON consensus | cre-workflow/ |
indexer/ |
Goldsky indexer for BettingPool events on Base Sepolia | indexer/ |
| Contract | Address |
|---|---|
| MarketRegistry | 0x3a428C10D19a41F584E8Ba5F34544D166cbf9131 |
| BettingPool | 0xbC793e9B354Bb247fA059e60B82f4C5Fa9E65239 |
| MarketResolution | 0x0D89d2E889738734584C7A65b03f3f527e9F9094 |
| USDC (Test) | 0x036CbD53842c5426634e7929541eC2318f3dCF7e |
- Admin creates a market tied to an X metric (followers, likes, views, retweets, search count) with a target value and deadline
- Users place USDC bets (Yes/No) on whether the metric will hit the target
- Chainlink CRE workflow automatically resolves markets by fetching X API data with DON consensus and submitting signed reports on-chain
- Goldsky indexes BettingPool events for efficient querying by the web app
- Winners claim their proportional share of the pool
pnpm install
# copy env files and fill in values
cp web/.env.local.example web/.env.local# dev server
pnpm dev
# contract tests
pnpm test:contracts
# deploy contracts
pnpm deploy:contracts
cd cre-workflow/resolve-market
bun install
# simulate and broadcast resolution
cre workflow simulate --target=staging-settings --broadcastSee Chainlink CRE docs for deploying workflows to the DON.
web/.env.local
| Variable | Description |
|---|---|
NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID |
WalletConnect / Reown project ID |
NEXT_PUBLIC_MARKET_REGISTRY |
Deployed MarketRegistry address |
NEXT_PUBLIC_BETTING_POOL |
Deployed BettingPool address |
NEXT_PUBLIC_MARKET_RESOLUTION |
Deployed MarketResolution address |
DATABASE_URL |
Neon Postgres connection string |
TWITTER_BEARER_TOKEN |
X API v2 bearer token |
CRON_SECRET |
Secret for cron job auth |
cre-workflow/.env
| Variable | Description |
|---|---|
CRE_ETH_PRIVATE_KEY |
Private key for CRE workflow |
CRE_TARGET |
Target (staging-settings or production-settings) |
X_API_BEARER_TOKEN |
X API bearer token for DON nodes |