人工智能 链上应用 应用设计与智能合约辅助开发把经验沉淀成下一次的规则在跨界开发 AI 与 Web3 结合的项目时团队常常陷入两种极端要么把大语言模型LLM当成无所不知的“智能程序员”直接将其生成的 Solidity 代码部署上线要么因为缺乏对链上状态安全性的把控在 AI 返回非预期结构时导致智能合约状态紊乱。经历了几个版本的迭代后我们意识到LLM 不应该被视为直接产出代码的终点而是辅助生成、提示词上下文约束与自动化校验流水线中的一个环节。如何将上一次调优、踩坑的经验真正转化为程序可运行、团队可复用的硬性规则是建立稳定 AIWeb3 研发链路的关键。一、 AI 辅助智能合约开发中的断层现象智能合约具有不可篡改与高经济风险的属性。传统软件开发中API 接口报错通常可以通过重新发布热修复补丁来解决但在 Solidity 开发中一次重入漏洞或溢出逻辑就可能引发资金损失。在将大模型引入智能合约辅助开发时常见的链路断层集中在以下三个层面上下文缺失导致的盲目生成模型无法准确识别特定 EVM 链的具体版本限制如 Cancun 升级后的 Transient Storage 特性、OpenZeppelin 最新库函数的 API 变更容易给出过时或存在安全隐患的代码。确定性断言与概率性输出的冲突链上交易需要符合确定的编码和校验规则而 LLM 本质上是概率语言模型。当返回的 JSON 被截断、转义错误或字段类型不符时前端与链上 RPC 的交互会直接失败。缺乏标准化决策记录 (ADR)在提示词工程中调试出的“防止模型生成非 SafeMath 逻辑”等技巧往往只停留在某个开发者的本地 Prompt 记录里无法沉淀为项目构建阶段的硬性 Linting 规则。为解决这些问题需要构建一套包含“领域上下文注入”、“LLM 响应结构化拦截”与“链上防重写规则校验”的闭环链路。二、 架构设计AI Agent 与 Solidity 规则校验流AI 生成或调用合约时其概率性输出必须先经过规范检查器和 AST抽象语法树静态分析才能进入后续链路。在该体系中AI 生成的内容应先经过编译、AST 分析和项目自定义规则检查。规则要随合约类型配置涉及外部转账的路径要检查重入防护权限变更和资金流转要检查相应事件与访问控制。通过检查的代码仍应进入人工审查和测试网验证而不是直接发布。三、工程实现规则约束与智能合约辅助拦截器以下提供一套使用 TypeScript 实现的 AI Web3 交互规则拦截与校验器。代码展示了如何构造带有领域上下文的提示词、捕获 AI 返回结果并使用规则引擎进行安全性校验避免非法代码或请求直接触达链上。// 定义 AI 辅助生成的智能合约描述结构 export interface GeneratedContractSpec { contractName: string; sourceCode: string; abi: unknown[]; securityCheckPassed: boolean; violations: string[]; } // 智能合约规则校验器 export class SmartContractRuleEngine { private forbiddenPatterns: RegExp[] [ /selfdestruct\s*\(/, // 禁用危险的 selfdestruct /tx\.origin/, // 禁用 tx.origin 校验身份 /delegatecall\s*\(/, // 严格限制 delegatecall 盲目调用 /block\.timestamp/ // 标记 timestamp 依赖视场景警示 ]; private requiredPatterns: RegExp[] [ /pragma solidity \^\d\.\d\.\d;/, // 必须指定明确的版本 /contract\s\w/ // 必须包含合约定义 ]; /** * 静态分析 AI 生成的代码是否符合生产规范 */ public validate(code: string): { isValid: boolean; errors: string[] } { const errors: string[] []; // 违规 Pattern 检查 for (const pattern of this.forbiddenPatterns) { if (pattern.test(code)) { errors.push(安全违规: 检测到高危代码片段 - ${pattern.source}); } } // 必须包含的 Pattern 检查 for (const pattern of this.requiredPatterns) { if (!pattern.test(code)) { errors.push(规范缺失: 缺乏必要的代码结构 - ${pattern.source}); } } // 简单检查重入锁 if (code.includes(payable) !code.includes(nonReentrant)) { errors.push(安全警告: 涉及资金转账的函数未使用 nonReentrant 修饰符); } return { isValid: errors.length 0, errors }; } } function isGeneratedContractPayload(value: unknown): value is { contractName: string; sourceCode: string; } { return typeof value object value ! null typeof (value as Recordstring, unknown).contractName string typeof (value as Recordstring, unknown).sourceCode string; } // AI 智能合约生成中继器 export class AIContractRelayer { private ruleEngine: SmartContractRuleEngine; constructor() { this.ruleEngine new SmartContractRuleEngine(); } /** * 构造包含特定领域规则的 Prompt */ private buildPrompt(userRequirement: string): string { return 你是一个专精于 EVM 智能合约安全的资深架构师。 请根据以下需求编写 Solidity 智能合约代码。 遵守以下硬性约束 1. Solidity 版本统一使用 ^0.8.20。 2. 涉及 ERC-20 转账时使用 OpenZeppelin 5.0 的 SafeERC20涉及可重入的外部调用时评估 ReentrancyGuard。 3. 绝对禁止使用 tx.origin 作为鉴权手段。 4. 所有关键状态改变函数必须抛出 Event。 5. 仅输出标准的 JSON 格式{contractName: ..., sourceCode: ...} 用户需求 ${userRequirement} ; } /** * 模拟调用 LLM API 并过滤安全规则 */ public async generateAndVerify(userRequirement: string, mockLlmCall: (prompt: string) Promisestring): PromiseGeneratedContractSpec { const prompt this.buildPrompt(userRequirement); let attempts 0; const maxAttempts 3; while (attempts maxAttempts) { attempts; try { const rawResponse await mockLlmCall(prompt); // 解析 JSON const parsed: unknown JSON.parse(rawResponse); if (!isGeneratedContractPayload(parsed)) { throw new Error(LLM response does not match the contract payload schema); } // 校验生成代码 const validation this.ruleEngine.validate(parsed.sourceCode); if (validation.isValid) { return { contractName: parsed.contractName, sourceCode: parsed.sourceCode, abi: [], // 可接入 solc 编译器生成真实 ABI securityCheckPassed: true, violations: [] }; } console.warn(第 ${attempts} 次生成未通过静态检查违规项:, validation.errors); } catch (err) { console.error(解析 AI 返回数据异常 (Attempt ${attempts}):, err); } } throw new Error(AI 辅助生成终止多次尝试后仍无法产出符合规范的安全代码); } }四、 项目复盘模板把决策沉淀为可落地的工具集很多团队在项目发布后都会组织复盘但大部分复盘纪要最后都沦为了文档库中不被查看的死文本。为了把经验转化为真正的规则建议使用 ADR架构决策记录结合自动化校验的具体规范1. ADR 架构决策记录结构在项目根目录下建立.adr/目录每次 AI 辅助生成或智能合约设计方案调整时记录如下结构# ADR-20260831-01: AI 生成合约的静态检查与安全降级 ## 状态 已通过 (Accepted) ## 上下文 在利用 LLM 辅助生成智能合约质押逻辑时模型偶发性地遗漏 nonReentrant 修饰符或者使用过时的 Transfer() 方式发送 Ether导致合约暴露在重入与 Gas 限制风险下。 ## 决策 1. 所有 LLM 产出的 Solidity 代码不得直接集成至主干分支。 2. 引入 SmartContractRuleEngine 静态正则表达式校验与 Slither 自动化 CI 规则。 3. 建立 AI 提示词上下文仓库将 OpenZeppelin 5.0 的推荐写法作为 Context 默认拼接到请求前缀。 ## 影响 - **正面**: 让明显不符合项目规范的生成结果在合并前暴露出来。 - **负面**: 增加了 CI 检查时间也需要持续维护规则并处理误报。2. 规则沉淀的三步转化法要防止复盘流于形式需要执行以下三步动作文档到配置把“不要在循环里写 SSTORE”这种文字经验转化为 Solidity 静态分析工具如 Solhint / Slither中的自定义 Rule 规则文件。经验到模板将调优成功的提示词打成脚手架模板集成至团队内网的 CLI 工具中确保每个人使用的 Prompt 包含了最新的项目规范。错误到单测每次发现 AI 生成的代码包含缺陷时提取该缺陷的核心逻辑编写一个针对性的 TypeScript/Hardhat 单元测试用例加入到 CI 自动化测试集中。把 AI 生成放在规则检查、测试和人工审查之间团队才能在提高编写效率的同时保留链上代码应有的可验证性和安全边界。