你是否曾为写一个带 LLM 能力的链上应用而头疼?既要处理智能合约逻辑,又要对接大模型 API、设计前端交互、编写测试用例……开发流程冗长且容易出错。GenLayer 官方推出的 genlayer-project-boilerplate 正是为此而生——它不是普通模板,而是一套开箱即用的「AI+区块链」全栈开发套件,内置足球博彩游戏示例,覆盖合约编写、AI 集成、多层测试、前端搭建与 CI/CD 全流程,帮你把开发时间从数周压缩到几小时。
核心功能
- 开箱即用的 AI 智能合约示例:内置「足球投注合约」完整实现,合约可直接调用 LLM 进行比赛结果推理、赔率动态计算等复杂决策,真正实现“链上 AI”逻辑闭环
- 双模测试体系:支持超快的 Direct Mode 测试(内存级模拟 Web/LLM 调用,单测仅需毫秒级),也支持真实的 端到端集成测试(直连 GenLayer Studio 环境),兼顾开发效率与生产可靠性
- 合约静态安全检查:集成专属 lint 工具,提前识别链上重入、LLM 输入注入、Gas 异常等 AI 合约高频风险点,防患于未然
- 生产级 Next.js 15 前端:TypeScript + TanStack Query + Radix UI 全栈标配,已预置钱包连接、合约交互、LLM 结果可视化等模块,所见即所得
- 一键式 CI/CD 流水线:GitHub Actions 配置就绪,提交代码自动触发 lint 检查 + Direct 测试,保障每次合并都稳定可靠
- 标准化部署支持:提供清晰的配置模板(
genlayer.config.ts)和一键部署脚本,适配 GenLayer Studio 发布流程,告别手动配置烦恼
适合哪些人用
如果你是以下角色之一,这个脚手架将极大提升你的开发效率:区块链开发者(想快速验证 AI 合约创意,无需从零搭环境);AI 应用工程师(希望让大模型能力上链、获得不可篡改执行与透明激励);Web3 创业者或 MVP 团队(需要两周内上线可演示的 AI+DeFi 或预测市场类原型);以及高校研究者与课程教师(用于教学演示“智能合约如何安全调用 LLM”,附带完整测试与工程规范)。
快速上手
只需三步即可启动本地开发:
- 确保系统已安装 Python ≥ 3.12,并全局安装 GenLayer CLI:
npm install -g @genlayer/cli - 克隆模板并初始化项目:
git clone https://github.com/genlayerlabs/genlayer-project-boilerplate.git my-ai-dapp && cd my-ai-dapp && npm install - 启动全栈服务:
npm run dev(自动运行合约本地节点 + Next.js 前端),打开 http://localhost:3000 即可体验足球投注 DApp,并在contracts/目录下修改智能合约逻辑,所有变更实时生效
详细文档与 Discord 技术支持入口见项目 README,Telegram 和 X(原 Twitter)官方账号也持续更新最佳实践。
项目信息
genlayerlabs/genlayer-project-boilerplate
GitHub
16.2k
今日 +430 stars today
Stars
810
Forks
TypeScript
MIT
编程语言:TypeScript|GitHub Star 数:16,250|开源协议:MIT|GitHub 项目地址
这是目前中文社区最成熟、最易上手的 AI 原生智能合约开发起点——省掉 80% 的基建时间,让你专注在真正重要的事上:设计有想象力的链上 AI 场景。


