架构与开发
请求路径
静态 React/Vite 页面 → 工作流 hooks → 核心解析、分页、模拟和交易构造 → RPC / 钱包。
Sui 读取使用 gRPC-web；BSC 使用 viem 与 JSON-RPC。DeFi 适配器只读，并独立处理各协议的失败。 钱包负责签名。应用没有业务数据库或服务器端钱包。
| 目录 | 职责 |
|---|---|
web/src/pages、components | 页面、计划与回执 |
web/src/hooks | 取消请求、生命周期、执行进度 |
web/src/core | 验证、分页、交易构造、批处理和协议归一化 |
web/src/lib | 格式化、外部浏览器链接、本地存储 |
contracts/dolp_coin | DOLP Faucet |
构建配置
在 web/ 内运行。环境变量是公开的构建时配置，不能存放密钥。
VITE_DEFAULT_NETWORK=testnet npm run build
npm run lint
npm test
可选 RPC 变量：VITE_RPC_SUI_MAINNET、VITE_RPC_SUI_TESTNET、VITE_RPC_BSC_MAINNET、VITE_RPC_BSC_TESTNET。
浏览器 Settings 中的 RPC 覆盖优先于构建默认值。
部署与文档维护
Web 的 dist/ 部署到 Cloudflare Pages；生产与开发项目 分开。
活动链上 ID、Web 发布和回滚流程统一见仓库 DEPLOYMENT.md。
本文档是独立 Docusaurus 站点，源码位于 docs/site/content/。
在 docs/site/ 执行 npm ci && npm run build，输出 build/。
构建会检查内部链接；发布说明见同目录 README.md。