这是一款专为2026年FIFA世界杯打造的开源加密货币体育博彩演示平台,它不是真实赌博网站,而是一个技术完整、界面专业、可本地运行的全栈学习范本。它解决了开发者在构建Web3体育应用时最常遇到的痛点:如何将钱包登录、实时赔率推送、链上签名验证与前端交互流畅整合。项目以教育和工程实践为目的,不涉及真实资金流转,完全合规安全,是理解“区块链+体育+实时数据”融合架构的理想入口。
核心功能
- 一键MetaMask接入:基于EIP-191标准实现安全链下签名登录,无需私钥暴露,体验接近真实Web3身份体系
- 实时赔率与赛况看板:通过WebSocket连接模拟服务器,动态刷新比赛比分、进球时间、盘口变化,还原专业体育博彩的数据流体验
- 可视化投注沙盒:支持创建虚拟投注单(含胜平负、大小球、比分预测等主流足球玩法),所有操作仅在本地内存或模拟数据库中完成
- 自动结算引擎:内置规则驱动的结算逻辑,比赛结束后自动比对结果、计算虚拟盈亏并更新用户账户,代码清晰可扩展
- 现代化前端架构:React 18 + TypeScript + Vite 构建高性能UI,Tailwind CSS 实现响应式足球主题界面,Zustand 管理复杂状态流
- 全栈一体化设计:后端采用Express + Prisma ORM + PostgreSQL(或SQLite),接口规范、数据库迁移友好,便于二次开发与部署
适合哪些人用
这款项目特别适合三类中文技术爱好者:Web3初学者——想亲手体验钱包集成与链下签名的实际流程;全栈开发者——需要参考一个结构清晰、技术栈主流(TS+React+Express+Prisma)的体育类DApp样板;高校学生与课程实践者——可用于区块链选修课、毕业设计或黑客松项目,既有业务场景(世界杯竞猜),又有扎实工程细节(WebSocket通信、状态同步、UI/UX适配)。注意:它不面向普通用户进行真实投注,也不提供任何金融或法律建议。
快速上手
只需5分钟即可本地运行:
- 确保已安装 Node.js(≥18.x)和 Git
- 终端执行:
git clone https://github.com/MstKail/wc2026-crypto-sportsbook.git && cd wc2026-crypto-sportsbook - 安装依赖:
npm install(前端+后端依赖一次性安装) - 启动服务:
npm run dev(自动开启Vite前端 + Express后端) - 打开
http://localhost:5173,点击“Connect Wallet”模拟MetaMask登录,即可浏览赛事、查看赔率、下注并观察结算全过程
如需自定义配置(如更换WebSocket地址或数据库),请查阅项目根目录下的 .env.example 和 prisma/schema.prisma 文件。
项目信息
2026 FIFA World Cup crypto sportsbook | soccer football betting platform | React TypeScript Vite | MetaMask wallet EIP-191 | live WebSocket odds score
330
Stars
1.3k
Forks
TypeScript
—
TypeScript|330 Star|MIT 协议|GitHub 项目地址
这是一个把世界杯激情、区块链可信机制与现代前端工程完美结合的教学级标杆项目——学得懂、跑得通、改得了、讲得清。





