Eventra is an AI decision and execution copilot for DreamDEX Event Contracts on Somnia. It helps a user discover a campaign, choose an AI analyst, understand the evidence behind an UP/DOWN/WAIT decision, and retain wallet control over every on-chain action.
Prediction-market odds answer “what is the market pricing?” but not “is this an executable decision for me?”. Eventra combines:
- DreamDEX campaign state, order-book evidence and settlement timing.
- Live BTC/ETH spot context and explainable technical evidence.
- Model-selectable AI analysis with a visible fee before generation.
- Wallet-controlled DreamDEX execution and position management.
- Verifiable forecast and payment records on Somnia.
Eventra never presents simulated activity as a real transaction.
| Mode | Purpose | Funds |
|---|---|---|
| DreamDEX Live | Uses supported, unexpired DreamDEX campaigns and on-chain quotes | Requires Somnia testnet wallet and TestUSDC |
| Test Arena | Always-available judge flow when DreamDEX has no open campaign | Simulation only; no wallet transaction |
The app automatically scans for eligible DreamDEX campaigns. When none are open, Test Arena remains available so judges can still complete the AI report and order experience.
- Discover — rank available campaigns by data quality, liquidity and time remaining.
- Choose AI — select Eventra Core or a configured external provider.
- Review fee — show the analysis price before report generation.
- Analyze — return Quick Predict, key indicators, AI verdict, confidence, invalidation and deep research.
- Execute — review UP/DOWN price, size and payout; the connected wallet approves the on-chain action.
- Manage — inspect receipts, open orders and positions; request an exit quote when liquidity exists.
- Eventra Core works without an API key and is the reliable hackathon demo path.
- Grok, Surf, DeepSeek, ChatGPT and Claude are selectable product frames. They become executable only when their server-side provider configuration is available.
OPENROUTER_API_KEYenables configured OpenRouter-backed models through the server route. Keys are never exposed throughNEXT_PUBLIC_*variables.
- DreamDEX SDK:
@somnia-chain/markets-sdk0.28.0. - Network: Somnia Shannon testnet, chain ID
50312. - Event Contract data: DreamDEX indexer plus on-chain market verification.
- HTTP RPC:
https://dream-rpc.somnia.network/. - WebSocket RPC:
wss://dream-rpc.somnia.network/ws. - Spot reference: Coinbase public OHLCV; DreamDEX remains the source for Event Contract odds and execution.
Live execution is fail-closed: a campaign must be explicitly supported, unexpired, in the correct on-chain state and included in the configured pool allowlist.
| Contract | Purpose | Somnia Shannon address |
|---|---|---|
DreamPilotGuard |
User policy and EIP-712 advice acceptance | 0xd2fa...EC38 |
ForecastRegistry |
Signed forecast commitments and resolver-attested scores | 0x3a88...2F7e |
EventraAnalysisEscrow |
Pay-on-success AI report fee with expiry refund | 0xc4a0...ec8C |
These contracts complement DreamDEX; they do not replace its order book, collateral, market oracle or settlement.
npm install
cp .env.example .env.local
npm run devOpen http://localhost:3000.
Eventra Core and Test Arena work without paid AI credentials. Configure only the integrations you intend to demonstrate.
npm run typecheck
npm run build
cd contracts && forge test- Eventra provides decision support, not guaranteed returns.
- AI never submits an autonomous order.
- The user reviews and signs wallet actions.
- Test Arena orders are clearly labelled simulations and never appear as on-chain receipts.
- Analysis fees and DreamDEX trading collateral are separate.