hackquest logo

APT-Casino-Flow

⚡️The First Fully On-Chain, Autonomous Provably Transparent Casino.

Videos

Description

A couple of days back, I was was on etherscan exploring some transactions and saw an advertisement of https://stake.com/ which was giving 200% bonus on first deposit, I deposited 120 USDT into stake.com they gave 360 USDT as total balance in their controlled custodial wallet and when I started playing casino games I was shocked to see that I was only able to play with $1 per game and was unable to increase the betting amount beyond $1 coz and when I tried to explore and play other games on the platform the issue was persisting, I reached the customer support and got to know that this platform has cheated him under the name of wager limits as I was using the bonus scheme of 200%.

When I asked the customer support to withdraw money they showed a rule list of wager limit, which said that if I wanted to withdraw the deposited amount, then I have to play $12,300 worth of gameplay and this was a big shock for me, as I was explained a maths logic by their live support. Thereby, In the hope of getting the deposited money back, I played the different games of stake.com like roulette, mines, spin wheel, etc, the entire night and lost all the money.

I was very annoyed of that's how APT-Casino was born, which is a combination of GameFi and AI all in one platform where new web3 users can play games, perform gambling, but have a safe, secure, transparent platform that does not scam any of their users. Also, I wanted to address common issues in traditional gambling platforms.

🧩 Problems

The traditional online gambling industry is plagued by several issues, including:

  • Unfair Game Outcomes: 99% of platforms manipulate game results, leading to unfair play.

  • High Fees: Users face exorbitant fees for deposits, withdrawals, and gameplay.

  • Restrictive Withdrawal Policies: Withdrawal limits and conditions often prevent users from accessing their funds.

  • Bonus Drawbacks: Misleading bonus schemes trap users with unrealistic wagering requirements.

  • Lack of True Asset Ownership: Centralised platforms retain control over user assets, limiting their freedom and security.

  • User Adoption of Web2 Users: Bringing users to web3 and complexity of using wallet first time is kinda difficult for web2 users.

  • No Social Layer: No live streaming, no community chat, no collaborative experience.

💡 Solution

APT-Casino addresses these problems by offering:

  • Provably Fair Gaming: Utilising the Flow VRF on-chain randomness module, my platform ensures all game outcomes are 100% transparent and verifiably fair.

commit-reveal-781e7a6a3f33610dc3258192029cbd4d
  • Flexible Withdrawal Policies: Providing users with unrestricted access to their funds.

  • Transparent Bonus Schemes: Clear and clean bonus terms without hidden traps.

  • True Asset Ownership: Decentralised asset management ensures users have full control over their assets.

  • Fully Gasless and Zero Requirement of Confirming Transactions: Users do not require to pay gas fees. It's paid by our treasury address to approve a single transaction — we do it all, they can just play as if they are playing in their web2 platforms.

  • Live Streaming Integration: Built with Livepeer, enabling real-time game streams, tournaments, and live dealer interaction.

  • On-Chain Chat: Supabase + Socket.IO + wallet-signed messages ensure verifiable, real-time communication between players.

  • ROI Share Links: Every withdrawal (profit or loss) generates a shareable proof-link that renders a dynamic card (similar to Binance Futures PnL cards) when posted on X.

⚙️ Key Features

  • On-Chain Randomness: Utilizing Flow VRF on-chain randomness module to ensure provably fair game outcomes.

355232251-6880e1cb-769c-4272-8b66-686a90abf3be
  • Decentralized Asset Management: Users retain full control over their funds through secure and transparent blockchain transactions.

  • User-Friendly Interface: An intuitive and secure interface for managing funds, placing bets, and interacting with games.

  • Diverse Game Selection: A variety of fully on-chain games, including roulette, mines, plinko, and spin wheel. As a (POC) Proof of Concept, developed fully on-chain 4 games but similar model can be applied to introduce the new casino games to the platform.

  • Fully Gasless and Zero Requirement of Confirming Transactions: Users do not require to pay gas fees. It's paid by our treasury address to approve a single transaction — we do it all, they can just play as if they are playing in their web2 platforms.

  • Real-Time Updates: Live game state and balance updates.

  • Event System: Comprehensive event tracking for all game actions.

  • Social Layer: Live streaming, on-chain chat, and NFT-based player profiles.

🧩 Architecture

Screenshot 2025-11-01 at 1 39 57 AM
  • Frontend: Next.js (App Router), React 18, Tailwind, MUI, Three.js

  • Wallet/Chain: Flow Client Library (FCL) + wagmi + RainbowKit

  • Smart Contracts: Solidity

  • Randomness: Flow VRF

  • State: Redux Toolkit + React Query

  • Social: Livepeer for streaming, Supabase + Socket.io for real-time chat

APT Casino is a fully decentralized casino platform that leverages Flow blockchain's unique architecture to deliver a transparent, secure, and user-friendly gambling experience. Built with Flow's native features including Flow Client Library (FCL), Solidity smart contracts, and Flow Testnet infrastructure, APT Casino addresses critical issues in traditional online gambling platforms through blockchain transparency and provably fair game mechanics.

🔗 Built on Flow Testnet

This project is deployed and operational on Flow Testnet. All smart contract interactions, wallet connections, and transactions use Flow's network infrastructure.

📋 Deployed Contract Addresses

Flow Testnet Contracts

Flow Native Contracts

Casino Contracts (Flow Testnet)

🔐 Core Flow Features Used

Flow Client Library (FCL) Integration

  • Seamless wallet connection using Flow's native wallet discovery

  • Gasless transactions via treasury-sponsored flows

  • Flow wallet compatibility (Blocto, Dapper, Ledger Flow, etc.)

  • Solidity Smart Contracts: All game logic implemented in Solidity

  • On-Chain Balance Queries: Real-time FLOW token balance verification via FCL queries

🎲 Key Features

Provably Fair Gaming

  • FLOW VRF Integration: On-chain cryptographic randomness via FLOW VRF

  • Transparent Outcomes: All randomness verifiable on-chain with cryptographic proofs

  • Audit Trail: Every game result permanently stored on-chain

Gasless User Experience

  • Treasury-Sponsored Transactions: Users never pay gas fees

  • Single Transaction Approval: Simplified UX - users just approve once and play

  • Web2-Like Experience: Feels like traditional platforms but with blockchain security

True Asset Ownership

  • User Wallet Control: Funds remain in user's Flow wallet until game execution

  • No Custodial Risk: Platform cannot freeze or seize user funds

  • Instant Withdrawals: No withdrawal limits or approval delays

  • Transparent Balance: Real-time Flow blockchain balance display

Diverse Game Selection

  • Roulette: European layout with batch betting

  • Mines: Pattern-based game with variable risk levels

  • Plinko: Physics-based ball drop mechanics

  • Wheel: Multiple segments with adjustable volatility

Social Layer

  • Live Streaming: Livepeer integration for real-time game streams and tournaments

  • On-Chain Chat: Supabase + Socket.IO with wallet-signed messages for verifiable communication

  • ROI Share Links: Shareable proof-links that render dynamic PnL cards on social platforms

🏗️ Architecture

Flow-Centric Architecture

┌─────────────────────────────────────────────────────────────┐
│                    Frontend (Next.js)                       │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐      │
│  │ Flow Wallet  │  │  Game UI    │  │  Live Chat  │      │
│  │   (FCL)      │  │ (Three.js)  │  │  (Supabase) │      │
│  └──────────────┘  └──────────────┘  └──────────────┘      │
└─────────────────────────────────────────────────────────────┘
                            │
                            ▼
┌─────────────────────────────────────────────────────────────┐
│              Flow Blockchain Integration                      │
│  ┌────────────────────────────────────────────────────┐    │
│  │  Flow Client Library (FCL)                         │    │
│  │  - Wallet Discovery & Connection                   │    │
│  │  - Transaction Signing & Submission                │    │
│  │  - Balance Queries                                 │    │
│  └────────────────────────────────────────────────────┘    │
│                                                              │
│  ┌────────────────────────────────────────────────────┐    │
│  │  Flow Testnet                                      │    │
│  │  - FLOW Token Contracts                            │    │
│  │  - Treasury Wallet (0x2083a55fb16f8f60)           │    │
│  │  - Solidity Smart Contracts                        │    │
│  └────────────────────────────────────────────────────┘    │
└─────────────────────────────────────────────────────────────┘
                            │
                            ▼
┌─────────────────────────────────────────────────────────────┐
│             FLOW VRF                                        │
│  ┌────────────────────────────────────────────────────┐    │
│  │  CasinoEntropyConsumer Contract (Solidity)       │    │
│  │  - Request Entropy                                │    │
│  │  - Receive Callback with Random Value             │    │
│  │  - Emit Events for Game Results                   │    │
│  └────────────────────────────────────────────────────┘    │
└─────────────────────────────────────────────────────────────┘

🎮 Game Execution Flow (Flow Integration)

🚀 Getting Started

Prerequisites

  • Node.js >= 18.0.0

  • npm or yarn

  • Metamask/ Flow wallet (Blocto, Dapper, or other FCL-compatible wallet)

Solidity Smart Contracts

All game logic and VRF integration are implemented using Solidity smart contracts:

  • CasinoEntropyConsumer.sol: Main contract handling VRF requests and game outcomes

  • Treasury Contract: Manages deposits and withdrawals using Solidity

  • Contracts interact with the Flow blockchain through FCL and Flow's transaction system

📹 Demo & Links

Business Model

Screenshot 2025-11-01 at 1 41 30 AM

Roadmap

Screenshot 2025-11-01 at 1 41 40 AM

Phase 1 (Current)

  • ✅ Flow wallet integration with FCL

  • ✅ Flow treasury system

  • ✅ 4 core games (Roulette, Mines, Plinko, Wheel)

Phase 2

  • Deploy Solidity smart contracts on Flow Mainnet

  • Flow Actions integration for automated workflows

  • Flow scheduled transactions for recurring events

  • Expand game catalog

  • Flow-native NFT integration for player profiles

Phase 3

  • In-app tournaments with Flow-based leaderboards

  • SDK for third-party game developers

  • Developer platform for gambling game launchpad

  • Cross-chain bridges for multi-chain support

Progress During Hackathon

Haven't slept from past 4 days.

Tech Stack

Next
Web3
Solidity

Fundraising Status

Not raised any till yet.

Team Leader
AAmaan Sayyad
Sector
SocialFiGamingAI