ARBuilder

ARBuilder 是 Quantum3-Labs 开发的面向 Arbitrum 生态的 AI 驱动开发助手，把自然语言提示转化为可直接使用的链上代码与部署脚本。

【用途】 ARBuilder 主要服务于在 Arbitrum 上构建应用的开发者，覆盖四条开发路径：Stylus 智能合约（Rust）、Arbitrum SDK 的跨链桥接与消息传递实现、全栈 dApp 脚手架，以及 Orbit 链的部署与管理。它通过检索增强生成（RAG）提供上下文感知的代码生成。

【主要能力】 MCP 服务器对外暴露 19 个工具、11 个资源和 5 个提示词模板，供 Cursor／VS Code 等 AI IDE 集成使用。工具分为四组：

1. Stylus 开发（6 个工具）：上下文搜索、代码生成、测试生成、问答助手、工作流指南、代码校验。代码生成基于内置模板（Counter、VendingMachine、SimpleERC20、AccessControl、DeFiVault、StakingRewards、NftRegistry 共 7 个），通过定制已验证的可工作模板而非从零生成，以提高可编译性。测试生成覆盖单元、集成与模糊测试。代码校验基于 Docker 的 cargo check，最多自动修复 3 次，并给出 Stylus 专属错误指引。完整支持 Stylus SDK 0.10.0（alloy 1.0.1、Rust 1.91.0、self.vm() API）。
2. Arbitrum SDK 桥接与消息（3 个工具）：ETH 桥接（L1 <-> L2 存取）、ERC20 桥接（含网关授权）、L1 -> L3 桥接（通过双 retryable 从 L1 直接桥接到 Orbit 链）、跨链消息（L1 -> L2 retryable 票据、L2 -> L1 消息）、消息状态追踪与提款领取。
3. 全栈 dApp 构建（5 个工具）：后端生成（NestJS 或 Express，集成 viem／wagmi）、前端生成（Next.js 14 + wagmi v2 + RainbowKit v2 + DaisyUI）、索引器生成（The Graph 子图）、预言机集成（Chainlink 价格喂价、VRF、Automation、Functions）、整体编排（monorepo 结构脚手架）。支持从 Stylus Rust 代码自动提取 ABI 并注入后端／前端，索引器 schema 与映射、前端 hooks、后端路由均基于 ABI 生成；编译校验使用基于 Docker 的 cargo check 循环自动修复；生成 setup.sh、deploy.sh、start.sh 可执行脚本；环境变量集中标准化（PORT 3001、CORS、BACKEND_URL）。
4. Orbit 链集成（5 个工具加 9 个 TypeScript 模板）：工具如 generate_orbit_config、generate_orbit_deployment、generate_validator_setup、ask_orbit、orchestrate_orbit；模板涵盖链配置、部署 Rollup、部署代币桥、自定义 Gas 代币、验证者管理、治理、节点配置、AnyTrust 配置、编排。基于 @arbitrum/chain-sdk ^0.25.0 与 viem ^1.20.0，支持 prepareChainConfig()、createRollup()、createTokenBridge()、prepareNodeConfig()。部署输出持久化到 deployment.json，后续脚本（代币桥、节点配置）自动串联；防崩溃部署在获取回执前先保存 deployment.json；自定义 Gas 代币会生成带有正确 RollupCreator 地址的 approve-token.ts 及 ERC-20 部署指引。Docker 使用 offchainlabs/nitro-node:v3.9.4-7f582c3 与绑定挂载（./data/arbitrum），不使用 user: root。节点配置后处理恢复被掩码的私钥、在单密钥场景下禁用 staker、修复 DAS URL 双端口问题；Wasm 根检查通过 --validation.wasm.allowed-wasm-module-roots 防止启动崩溃循环；AnyTrust 使用 nitro-node 镜像的 datool keygen 进行 BLS 密钥生成。支持 Rollup 与 AnyTrust 链、自定义 Gas 代币、验证者／批量提交者管理及完整项目脚手架。

【使用方式】 两种方式：

1. 托管服务（零搭建）：在 arbuilder.app 注册获取 API key，加入 MCP 配置即可。免费层每天 100 次 API 调用，无需本地 Python 环境，始终同步最新 Stylus SDK 模式。托管服务还提供 OpenAI 兼容的 Chat Completions API（模型 arbbuilder-chat，基于 openai/gpt-oss-120b via OpenRouter），支持流式与非流式、原生函数调用、思维链透传（reasoning_content）、无状态对话、自动长度续写；限制为 6 次 ReAct 迭代／20 万 token 单轮预算／3.2 万字符工具结果上限；不包含 4 个大型项目脚手架工具（generate_backend、generate_frontend、orchestrate_dapp、orchestrate_orbit），需直接通过 /api/v1/tools/<name> 或 MCP 调用。
2. 自托管（完全控制）：本地运行，自带 API key，无速率限制。需创建 Conda 环境、配置环境变量（复制示例环境文件并填入凭证）、本地生成 ChromaDB 向量数据库（因二进制兼容性问题未包含在仓库中）、验证 MCP 服务器启动。仓库已包含原始数据（data/raw/：文档页 + 精选 GitHub 仓库）与处理后分块（data/processed/）。如需重新抓取最新文档与代码，可选安装 playwright。 配置 IDE：把 MCP 配置写入 Cursor 的 ~/.cursor/mcp.json 或 Claude Desktop 的 claude_desktop_config.json，重启 IDE 后即可让 AI 助手调用 ARBuilder 工具。 典型提问示例：“Generate an ERC20 token contract in Stylus”“How do I deploy a contract to Arbitrum Sepolia?”“Write tests for my counter contract”。生成 Stylus 合约时可传 target_version 以输出指定 SDK 版本代码。

【知识库与数据来源】 sources.json 是本地 Python 流水线与托管 CF Worker 采集的唯一事实来源，含 84 个精选来源（53 个文档页 + 31 个 GitHub 仓库），分 4 个里程碑：Stylus 合约／项目（17 文档 + 19 仓库）、Arbitrum SDK（6 文档 + 5 仓库）、全栈 dApp 构建（30 文档 + 11 仓库）、Orbit SDK（5 个 Python MCP 工具 + 9 个 TypeScript 模板）。数据清洗策略：不使用聚合清单（如 awesome-stylus）以避免过时代码，不接受未验证的社区提交，代码仓库须能以 stylus-sdk >= 0.8.0 编译，SDK 版本按仓库记录，Stylus 仓库统一分叉到 ARBuilder-Forks 以便溯源与抗上游删除。采用多版本策略：按版本分支（如 main 对应 0.10.0，v0.9.0 对应原版本）、分支感知抓取、版本感知生成与检索。流水线实施 3 层过滤去除垃圾数据（vendored crates、自动生成的 TypeChain 文件、十六进制字节码、锁文件、跨仓库重复），详见 docs/DATA_CURATION_POLICY.md。 托管服务内置采集流水线，通过 cron 每 6 小时自动运行，也可在 /admin 手动触发；按来源大小分同步路径（文档与 ≤30 文件的仓库）与异步路径（>30 文件的仓库，经 CF Queue 批量处理）。

【透明度与接口】 arbuilder.app/transparency 公开展示已收录来源、代码模板与统计信息。公开 API（无需认证）：GET /api/public/sources、GET /api/public/templates、GET /api/public/templates?code=true。内部直接 API 位于 /api/v1/tools/*，仅供内部测试，需在 Authorization 头中提供 AUTH_SECRET，不供公开使用，由 CI/CD 与内部验证脚本调用。

【限制与说明】 MCP 服务器提供的是命令知识而非命令执行，由用户控制本机运行内容，避免远程执行的安全风险。托管免费层每天 100 次调用。自托管需自行配置 API key 与本地向量数据库。以上为资料中明确提供的信息；关于具体定价、部署规模、性能指标等未在资料中说明的内容，暂未提供。