TypeScript · 项目报告

winsznx/theeleven

Eleven autonomous AI agents open live football prop markets on X Layer — custom Uniswap v4 hook, gasless USDT0 staking.

已完成 打开 GitHub
W
681星标
1Fork
0Issue
MIT许可证

分析结果

项目分析

The Eleven 是一个面向足球赛事的链上实时二元预测市场项目:11 个自主 AI Agent 根据比赛中的控球、射门、犯规、角球等事件,在 X Layer 主网上自动创建足球 prop markets。核心合约是自定义 Uniswap v4 Hook(PropMarketHook),使用 USDT0 结算,并通过 EIP-3009 实现用户免 Gas 质押。项目包含 Solidity 合约、TypeScript Agent 运行时、Next.js dApp、Farcaster Mini App、MCP/Agent 集成能力,定位于 OKX X Layer 黑客松/X Cup 以及 2026 世界杯场景。

适用领域 Web3 / DeFi / 预测市场 / 体育博彩/体育竞猜基础设施 / AI Agent / Uniswap v4 Hooks / EIP-3009 Gasless Payment / X Layer / OKX 生态 / USDT0 稳定币结算 / Next.js dApp / 链上自动化 / MCP Agent 工具集成
配置难度 高。该项目同时涉及 Solidity、Foundry、Uniswap v4 Hook、CREATE2 salt mining、EIP-712/EIP-3009 签名、X Layer、USDT0、Next.js 15、AI Agent 运行时、足球数据 API 和链上结算逻辑。普通前端或后端开发者上手成本较高,适合有 DeFi 合约经验和 Web3 全栈经验的团队研究。
商业价值 商业价值较高但合规门槛也高。项目瞄准足球赛事实时预测市场,结合 AI Agent 自动开市和免 Gas 参与,具备较强的产品故事和用户增长潜力;若在 2026 世界杯等大型赛事中落地,可能形成高频互动、稳定币结算和体育娱乐结合的 Web3 场景。对 OKX/X Layer/USDT0 生态也有示范意义。不过实际商业化必须解决监管合规、数据可信、结算去中心化、流动性获取、用户教育和安全审计等问题。
01

技术亮点

  • 产品完整度高:同时包含智能合约、AI Agent、Next.js 前端、状态页、文档、Farcaster Frame 和 MCP 集成
  • 技术栈前沿:Uniswap v4 Hook、X Layer、USDT0、EIP-3009、AI Agent、commit-reveal 组合较有创新性
  • PropMarketHook 将 Uniswap v4 Hook 用作预测市场生命周期控制器,而不是普通流动性池
  • 通过 EIP-3009 实现单次钱包签名免 Gas 质押,降低用户参与门槛
  • Agent 运行时设计清晰,11 个 persona 根据比赛数据自动开市,并可在重启后恢复 pending reveal
  • 合约测试覆盖度较高,README 声称 PropMarketHook.sol 67/67 测试且 100% line/branch/function coverage
  • Agent runtime README 声称 229/229 测试通过,并避免 Math.random,使决策可复现
  • 采用 commit-reveal 防止市场创建参数过早泄露,降低抢跑风险
  • 支持空池、错过 reveal/resolve 等情况下的 refund,减少资金永久锁死风险
  • MIT 许可证,便于开发者学习、复用和二次开发
02

目标用户

  • 想研究 Uniswap v4 Hook 的 Solidity 开发者
  • 关注 X Layer、OKX 生态和 USDT0 的 Web3 开发者
  • 希望构建链上预测市场或体育竞猜协议的团队
  • 研究 AI Agent + 区块链自动化的开发者
  • 需要 EIP-3009 免 Gas 签名支付示例的 dApp 开发者
  • 关注 2026 世界杯相关链上应用的创业团队
  • 需要参考完整 Web3 产品架构的黑客松参赛者
03

配置要求

  • Node.js / pnpm TypeScript 开发环境
  • Foundry Solidity 开发环境
  • X Layer RPC URL,链 ID 为 196
  • 部署者或 relayer 私钥,用于合约交互和代付 Gas
  • USDT0 合约地址:0x779Ded0c9e1022225f8E0630b35a9b54bE713736
  • Uniswap v4 PoolManager 地址:0x360E68faCcca8cA495c1B759Fd9EEe466db9FB32
  • PropMarketHookFactory 地址或自行部署的 factory 地址
  • Agent 主助记词,用于派生 11 个 persona 钱包,路径为 m/44'/60'/0'/0/{index}
  • FOOTBALL_DATA_KEY 或 API_FOOTBALL_KEY,用于获取实时足球比赛数据
  • EIP-712 / EIP-3009 签名相关配置,尤其 USDT0 domain name 为 USD₮0,包含 U+20AE 字符
  • resolver 地址配置,用于市场最终结算
  • 如使用 Railway/Vercel 等部署,还需要配置健康检查、API 路由、前端域名和环境变量
  • 用户需要连接支持 X Layer 的钱包,并持有 USDT0 参与质押
04

适用场景

  • 构建实时体育赛事预测市场,例如下一球、控球率、角球数、黄牌数、零封等二元市场
  • 学习如何用 Uniswap v4 Hook 改造成非 AMM 的链上市场生命周期控制器
  • 参考 EIP-3009 transferWithAuthorization 实现 USDT0 免 Gas 质押
  • 构建 AI Agent 根据外部数据源自动创建、揭示和结算链上市场
  • 开发 X Layer 上的稳定币结算型 dApp
  • 研究 commit-reveal 机制如何降低预测市场中的抢跑和信息泄露风险
  • 作为 Farcaster Mini App、MCP 工具、Next.js Web3 前端的综合参考
  • 为体育数据 Oracle、赛事结果解析和链上结算流程设计原型
05

部署与配置

  • 克隆仓库:git clone https://github.com/winsznx/theeleven.git
  • 进入项目目录:cd theeleven
  • 安装依赖:pnpm install
  • 准备环境变量文件,例如 .env 或各 package 下对应的环境配置
  • 配置 X Layer RPC、私钥、USDT0 地址、PoolManager 地址、Football/API-Football 数据源 Key 等参数
  • 编译/测试合约:通常使用 Foundry,例如 forge build 和 forge test,具体以仓库脚本为准
  • 运行前端:pnpm --filter <web-package> dev,README 显示项目为 Next.js 15 dApp
  • 运行 Agent:pnpm --filter @regista11/agent agent:start <fixtureId> --persona=all
  • 访问本地 dApp、市场页面、Agent 页面或状态页面进行验证
  • 如需部署,需要在 X Layer 主网准备 OKB 作为 relayer Gas,并注册 11 个 Agent 地址
06

风险与注意事项

  • 预测市场/体育竞猜在不同司法辖区可能涉及合规、博彩、金融监管风险,中国开发者尤其应避免面向不合规地区运营
  • 当前 README 提到非 tournament markets 使用 admin resolver,存在中心化结算信任风险
  • 赛事数据源依赖第三方 API,如 API 限流、延迟、错误数据或断供,会影响市场创建和结算准确性
  • Flap WorldCupResolver、跨链 outcome relay、guardian veto 等机制增加系统复杂度和信任假设
  • EIP-3009 签名、relayer、facilitator API 若实现不当,可能带来重放、签名域、nonce、过期时间等安全问题
  • Uniswap v4 Hook 和 X Layer/USDT0 生态相对新,基础设施、钱包、索引、审计和用户覆盖仍可能不成熟
  • README 展示了测试覆盖率,但不等同于正式安全审计;真实资金运行前仍需第三方审计
  • Agent 自动开市可能产生大量无效或低流动性市场,需要风控、限额和监控
  • 用户资金以 USDT0 结算,涉及稳定币、跨链 OFT、发行方和桥接相关风险
  • 项目 forks 为 0,虽然 stars 较多,但外部贡献和生产验证程度仍需进一步观察

历史记录

热榜历史快照

2026-07-02 第6名 新收录 · github_search
2026-07-01 第6名 新收录 · github_search
2026-06-30 第5名 新收录 · github_search
2026-06-29 第5名 新收录 · github_search
2026-06-28 第7名 新收录 · github_search
2026-06-27 第11名 新收录 · github_search