核心用法
本技能提供构建 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 库行为差异 | 充分测试跨合约调用场景 |