GTA 5 ON CHAIN
Syncing GTA V mods with blockchain to power missions, items, and events through on-chain txs.
Problem Statement
Our project brings GTA V fully on-chain by linking in-game actions to blockchain transactions. Using Pyth’s on-chain entropy, we generate provably random outcomes that shape missions, events, and interactions triggered directly from the in-game phone. Every player is identified by their ENS name, which we also use for seamless transfers and in-game operations. Wallet management and peer-to-peer payments are powered by CDP, giving players smooth on-chain control without leaving the game. For commerce inside the world, x402 powers our in-game stores, letting players buy, sell, and interact with on-chain assets natively within the GTA experience.Our in game currency was minted on a Base launch pad. https://flaunch.gg/base/coin/0xa901a7b9897c8d49847834514969a8bcbc1f9b92
Solution
💥 How It’s Made — GTA On-Chain Edition 1️⃣ GTA V Mod (ScriptHookV / FiveM) 🎮📱We build a custom GTA V mod that hooks directly into the game’s scripting layer.It listens for in-game events — especially anything triggered from the in-game phone — and forwards them to our backend bridge.Hooked events include:📱 Phone menu selections👤 Player interactions🎯 Mission triggers🛒 Store purchases🖥️ Custom UI actionsThe mod communicates with a local bridge server (Node.js) over HTTP or WebSockets.2️⃣ Local Bridge Server → On-Chain 🔗💻This local Node.js bridge translates GTA events into blockchain transactions.The bridge handles:📥 Receiving events from the GTA mod✍️ Signing + sending smart contract transactions📖 Reading contract state and returning results🔑 Managing wallet sessions via CDPThis allows players to perform on-chain actions using only the in-game phone.3️⃣ CDP (Wallet Management + P2P Transfers) 🔐💸We use Coinbase Developer Platform (CDP) as the wallet layer.CDP powers:🗝️ Non-custodial wallets for each player🔑 Session keys (no seed phrase popups)🤝 Instant P2P transfers🎮 Fully in-game UX (no browser needed)CDP makes blockchain interaction feel like a native GTA mechanic.4️⃣ ENS Integration 🌐🆔Players log in with their ENS names.ENS is used for:🪪 Player identity🔤 Display names💸 In-game payments (send to felipe.eth instead of 0x...)🧾 Store receipts🎁 Mission rewardsThe bridge resolves ENS → address before sending any transaction.5️⃣ Pyth Entropy for Randomness 🎲⚡We use Pyth on-chain entropy to generate provably random events.This randomness powers:🎯 Mission outcomes💰 Loot drops🧨 Risk-based decisions🐉 Spawns, dice, random eventsBecause it’s on-chain, it’s:🔍 Verifiable🎭 Unpredictable🛡️ Tamper-resistantIt makes missions feel truly blockchain-native.6️⃣ Smart Contracts (Core Logic) 🧩📜Smart contracts handle gameplay logic that needs:🎲 Randomness📊 State tracking💸 Payments🎒 Item ownership🗺️ Mission progress🛒 Store purchasesDeployed on a chain with:⚡ Fast confirmations🪙 Cheap gas🎰 Reliable entropyAll triggered directly from the GTA phone UI.7️⃣ x402 for In-Game Stores 🛍️🔗x402 powers the marketplace/store layer:🛒 Buy/sell digital goods🪙 On-chain item minting💵 Pricing + inventory📦 Auto-delivery to GTA inventoryWe map x402 items → GTA items inside the mod.8️⃣ Game → Blockchain → Game Loop 🔁🚀Here’s a typical flow:📱 Player opens in-game phone➡️ Selects action (store, mission, transfer)🎮 Mod sends event → Bridge🔗 Bridge signs & sends TX📜 Contract executes (randomness, payments, state updates)🧠 Bridge reads results🌍 Mod updates GTA world (loot, mission outcome, purchases)Everything feels instant, even though it’s fully on-chain.
Hackathon
ETHGlobal Buenos Aires
2025
Contributors
- MarouaBoud
2 contributions