Outcome is a decentralized flight prediction market built on the Stellar network. It allows users to speculate on flight outcomes (e.g., delays, cancellations) using a transparent and trustless blockchain infrastructure, enhanced by institutional-grade AI analysis..

• Prediction Markets: Participate in decentralized markets for flight arrival status.
• AI Risk Assessment: Integrated Llama 3.1 analysis via Groq for real-time trading signals and flight risk reports.
• Real-time Aviation Data: Automated flight tracking and market initialization powered by the AviationStack API.
• LMSR pricing: Logarithmic Market Scoring Rule via MarketMaker / Trading / LMSR (Contracts/src/). A separate OrderBook CLOB also exists; ADR 0001 is undecided and owned by Phase 2.
• Hybrid AMM: Sophisticated Logarithmic Market Scoring Rule (LMSR) for liquidity pricing, paired with a fair cost-based payout mechanism.
• Cross-Chain Relay: Chainlink CCIP-powered relay for cross-chain market operations — see Market Relay Delivery Summary.
• Stellar Network: High-performance, low-fee prediction market trading powered by the Stellar blockchain.
• Connect with Ease: Seamless wallet integration via Particle Network, supporting both social and traditional EOA logins.

• Smart Contracts:
  • Solidity 0.8.20
  • Foundry (Development & Testing)
  • PRBMath (Numerical Stability for AMM)
• Frontend:
  • Next.js 16 (Turbopack)
  • TypeScript & TailwindCSS
  • Groq SDK: AI analysis engine (Llama 3.1 8B/70B)
  • Particle Network: Universal wallet connection
  • Recharts & Framer Motion: Dynamic market visualization and premium UI animations
  • Wagmi & Viem: Type-safe Ethereum interactions

• Node.js (v20+ required)
• Foundry (Forge, Cast, Anvil)
• Git

See CONTRIBUTING.md for install, environment setup, and how to run the Backend, Frontend, and Foundry tests.

git clone https://github.com/Oshioke-Salaki/GateDelay.git
cd GateDelay

cd Contracts
forge build
forge test

cd Backend
npm install
cp .env.example .env
npm run start:dev

With Backend/.env.example copied as .env, NestJS listens on port 4000 (PORT=4000). If PORT is unset, Backend/src/main.ts falls back to 3000. Health: GET http://localhost:4000/api (global prefix api). Related example values: FRONTEND_URL=http://localhost:3000, HEARTBEAT_PORT=4001, RPC_URL=http://127.0.0.1:8545, MONGODB_URI=mongodb://127.0.0.1:27017/gatedelay.

cd Frontend
npm install
# create .env.local — see CONTRIBUTING.md
npm run dev

Next.js defaults to http://localhost:3000. Point NEXT_PUBLIC_BACKEND_URL at the Backend origin (http://localhost:4000 when using .env.example).

Keep this README short. Details live in:

Do not copy the Phase 2 issue list here; start from PHASE_2.md.

• Contracts/: Solidity contracts, Foundry tests, and deployment scripts.
• Backend/: NestJS API (and legacy Express server.js).
• Frontend/: Next.js application, AI routes, and Web3 components.

MIT