Arbitrum Dapp Skill

核心用法

本技能提供构建 Arbitrum dApp 的完整技术栈指导，采用双轨并行策略：

• Stylus Rust 路径：使用 stylus-sdk 编写 WASM 合约，通过 cargo-stylus 工具链完成校验、部署和 ABI 导出，适合追求极致 Gas 优化的场景
• Solidity 路径：基于 Foundry 标准工具链（forge/cast/anvil），兼容既有 EVM 开发生态，适合快速原型和工具链丰富度优先的场景

本地开发闭环：Docker 化的 nitro-devnode 提供预注资账户，支持两种合约栈的本地测试；完成后通过统一环境变量管理迁移至测试网/主网。

前端集成：强制推荐使用 viem + wagmi 组合，避免 ethers.js 等旧方案，确保类型安全和 Tree-shaking 优化。

显著优点

1. 技术选型清晰：决策树直接回答"选 Rust 还是 Solidity"的核心困惑
2. 工程化友好：pnpm workspace 驱动的 Monorepo 结构，天然支持前后端代码复用和统一构建
3. 工具链闭环：从 cargo stylus export-abi 到 forge inspect 的 ABI 导出均有明确指引，解决前后端类型对齐痛点
4. 安全细节到位：反复强调环境变量管理私钥，明确禁止硬编码

潜在局限

• 学习曲线陡峭：开发者需同时掌握 Rust（所有权模型）和 EVM 概念，或至少理解 Stylus-Solidity 互操作边界
• 工具成熟度：cargo-stylus 生态相比 Foundry 仍处早期，部分边缘场景文档覆盖不足
• 网络锁定：Arbitrum 专属优化较多，迁移至其他 L2（Optimism、Base）需重新评估

适合人群

• 已有 Solidity 基础、希望探索 Stylus 高性能合约的进阶开发者
• 需要同时维护 Rust 和 Solidity 合约库的跨栈团队
• 追求现代前端工程体验（Next.js + pnpm + viem）的全栈开发者

常规风险

| 风险类型 | 说明 | 缓解建议 |

|---------|------|---------|

| 私钥泄露 | 开发环境误提交 `.env` 文件 | 使用 `.env.local` + gitignore 模板 |

| ABI 版本漂移 | 合约更新后前端未同步 | 工作区共享 ABI 目录 + CI 校验 |

| 本地/网络状态混淆 | devnode 与测试网配置串用 | 明确 `localhost:8547` vs `arbitrumSepolia` 环境隔离 |

| Stylus 兼容性 | 部分 Solidity 库行为差异 | 充分测试跨合约调用场景 |

核心用法

该 Skill 是一份面向 Arbitrum 生态的纯文档型开发指南，旨在帮助开发者快速构建基于 Arbitrum 的去中心化应用（dApp）。它采用双轨技术栈设计：

• Stylus 路径：使用 Rust + stylus-sdk 编写合约，编译为 WASM 在 Stylus VM 上运行，适合追求极致性能和更低 Gas 成本的场景
• Solidity 路径：使用 Solidity + Foundry 标准工具链，适合需要广泛生态兼容性和快速原型的场景

指南覆盖了完整的开发生命周期：通过 nitro-devnode 搭建本地 Arbitrum 链，使用 cargo-stylus 或 Foundry 进行合约的编译、测试与部署，最终以 React + Next.js + viem/wagmi 构建前端交互界面。项目推荐采用 pnpm monorepo 结构组织多包工程。

显著优点

1. 技术前瞻性：Arbitrum Stylus 是 Layer2 领域首个支持 Rust 智能合约的创新方案，该 Skill 填补了中文/英文社区 Stylus 实战资料的空白
2. 双轨灵活性：不强制技术选型，清晰对比 Stylus 与 Solidity 的适用场景，支持混合架构
3. 工程化完整：从本地节点、合约开发到前端集成形成闭环，提供可执行的代码示例和目录结构规范
4. 安全实践内置：所有代码示例均遵循安全最佳实践——私钥通过环境变量管理、区分网络环境、强调测试网验证
5. 零依赖风险：纯 Markdown 文档形态，无可执行代码和外部 API 调用，杜绝供应链攻击面

潜在缺点与局限性

1. 来源可信度限制：维护者为个人开发者（hummusonrails），非 Arbitrum 官方或知名机构背书，版本更新依赖个人精力
2. 时效性风险：区块链技术迭代迅速，Stylus SDK v0.10+、viem/wagmi 等依赖库的版本升级可能导致示例代码过时
3. 深度不足：作为概览性指南，复杂主题如合约安全审计、高级 Stylus 存储模式、跨链桥接等需参考其他资料
4. 测试覆盖有限：未提供自动化测试套件，用户需自行构建测试策略
5. 社区规模小：Stylus 生态尚处早期，第三方工具、库和 Stack Overflow 问答资源相对匮乏

适合的目标群体

• 已有 Ethereum/Solidity 经验，希望拓展 Layer2 技能树的开发者
• Rust 开发者 寻求进入区块链领域，希望复用现有语言技能
• 性能敏感型项目团队（如高频交易、复杂计算合约），评估 Stylus 的 Gas 优化潜力
• 全栈开发者 需要端到端的 dApp 工程脚手架参考
• 技术研究者 关注 Arbitrum Nitro 技术栈和 WASM 合约虚拟机的前沿实践

使用风险

| 风险类型 | 说明 | 缓解建议 |

|---------|------|---------|

| **技能内容过时** | 工具链版本迭代可能导致命令参数、API 变更 | 结合 Arbitrum 官方文档交叉验证，关注 Skill 仓库更新 |

| **合约安全风险** | 示例代码用于教学，未经生产环境审计 | 部署前进行专业安全审计，使用 Slither/Foundry 模糊测试 |

| **私钥管理失误** | 用户误操作可能暴露私钥 | 严格遵循环境变量方案，使用硬件钱包管理主网资产 |

| **网络配置错误** | 误将主网配置用于开发，或反之 | 使用 `.env` 文件明确区分网络，添加部署前确认提示 |

| **Stylus 生态不成熟** | 调试工具、Gas 估算器、区块浏览器支持度低于 Solidity | 预留额外开发时间缓冲，积极参与 Arbitrum Discord 社区求助 |

| **安装脚本统计** | install.sh 包含可选的匿名安装统计（GoatCounter） | 设置 `ARBITRUM_SKILL_NO_ANALYTICS=1` 环境变量退出统计 |

总体而言，该 Skill 是 Arbitrum 生态中少见的 Stylus 实战资源，适合作为项目启动的参考蓝图，但生产环境应用需结合官方文档和社区最新动态进行验证。