SuperAPI AI 工具集

web3-fullstack-packaged-build

编程与开发

查看项目

更新于 11-06 00:49

技能介绍

用途与定位 本技能用于系统化构建复杂的全栈 Web3 应用,通过分层、分阶段的顺序降低耦合、支持增量测试,并确保即使发生工具故障也能产出完整可交付的打包产物。技能以规范文档形式给出,核心要求是“打包交付”为不可跳过的最终阶段。

主要能力与流程 技能将构建过程划分为 7 个阶段:

  1. 项目结构:在写任何代码前先建立完整目录结构,包括 contracts(interfaces、core、libraries、deployment)、frontend(src 下 components、hooks、config、utils 及 public)、scripts(deploy、test)、zk-circuits 和 docs,并提供对应的 mkdir -p 命令一次性创建。
  2. 接口合约先行:在实现逻辑前先定义所有接口合约,划定清晰的 API 边界;需列出要集成的外部协议(如 Aave、Connext、Uniswap),为每个协议所需函数创建接口文件,并为本项目合约的公开 API 创建接口,继续前先验证接口完整性。
  3. 核心合约实现:按依赖顺序实现,依次为库(无状态依赖的工具函数)、基类合约(共享逻辑的抽象合约)、核心合约(实现接口的主业务逻辑)、集成合约(桥接多个协议);示例给出 PrivatePool 合约的存款逻辑。要求一次只实现一个合约,每个合约编译测试后再继续,保持单一职责并记录状态变量与函数。
  4. 前端配置:先搭好前端基础设施,包括网络配置(networks.js,含 chainId、rpcUrl、explorer)、合约地址配置(contracts.js)、ABI 导入;创建 .env.example 模板,设置 Web3 provider(ethers.js、web3.js 或 wagmi),配置钱包连接逻辑,编写通用工具函数。
  5. 组件开发:按顺序构建工具组件(无 Web3 逻辑的按钮、输入框、弹窗)、Web3 包装组件(钱包连接、网络切换)、合约交互组件(调用合约函数的表单)、数据展示组件、页面组件;示例给出基于 wagmi 的 DepositForm 组件。要求定义清晰的 prop 接口、为所有 Web3 交互实现错误处理、为待处理交易添加加载状态、对每个组件单独测试。
  6. 部署脚本:在所有合约完成并测试后编写,按依赖顺序为每个合约创建部署脚本,包含向前端配置保存地址的机制、区块浏览器验证脚本,并记录部署参数与预期输出。
  7. 打包与交付(强制最终步骤):在声明任务完成前必须创建完整 ZIP 存档,命令为 zip -r project-name-deliverable.zip . -x ".git" -x "node_modules/" -x ".env";打包检查清单包括合约已编译验证、前端无错误构建、文档最新,ZIP 包含所有合约与前端源码、部署脚本、配置模板(.env.example)、README 或安装说明,且文件可访问可下载;还需用 unzip -l 验证内容、确认体积合理(完整项目 >100KB)。未创建 ZIP 前不得声明任务完成。

使用方式 按照 7 个阶段依次执行,以目录结构作为进度检查表;每个阶段完成后再进入下一阶段,并在每层进行增量测试。技能以文档和示例代码形式提供操作规范,用户需在具备 Solidity、前端与 Web3 工具链的环境中按步骤实施。

适用场景 适用于需要同时涉及智能合约、前端交互、部署脚本与零知识电路目录的复杂全栈 Web3 项目,尤其是需要清晰接口边界、可增量测试、并要求最终产出可交付压缩包的构建任务。

限制与注意事项 技能未提供具体安装命令、依赖版本、收费或效果数据。其流程依赖工具执行(如 mkdir、zip、编译与部署工具),工具失败时需按说明从上一完成阶段恢复;迭代预算有限时需按比例分配(合约约 40%、前端约 40%、部署约 10%,打包至少保留 2—3 次迭代),达到预算 80% 仍未开始打包时应停止新增功能、完成最小可行实现并立即执行 ZIP 创建。文中示例代码仅作结构示意,实际使用需按项目调整。