从项目根目录 D:\codex小项目\go\web3 操作。先用默认模式走通,再验收 PG/Redis/RabbitMQ。全部为本地测试资产。
1. 启动#
安装 Go 1.26.9+、Node.js 22.22+(本轮 Node 24.11.1),第一次需要网络下载依赖。Windows 双击根目录 run-sale-windows.cmd,或者在 PowerShell 执行:
powershell -ExecutionPolicy Bypass -File .\scripts\run-sale-windows.ps1
|
脚本在 bin/windows-sale/ 准备独立 Windows npm 依赖,编译合约、前端、后端,启动 Anvil,部署测试代币/Settlement/FlashSale,再启动两个服务;ready 后打开活动页。不会覆盖原目录的 Linux/WSL node_modules。
| 地址 | 用途 |
|---|---|
| http://127.0.0.1:8082/?mode=sale | 活动页 |
| http://127.0.0.1:8081/?mode=web3 | 二级交易台 |
| http://127.0.0.1:8545 | 本地 EVM RPC,chainId=31337 |
| http://127.0.0.1:9092/check | 发售只读对账,differences 应为空 |
| http://127.0.0.1:9092/metrics | 发售积压/索引指标 |
| http://127.0.0.1:8082/health/ready | HTTP 200 表示可分配新资格 |
终端会显示本轮数据目录 bin/sale-dev/<时间戳>/;latest.json 保存最近运行位置。停止使用 Ctrl+C,脚本只停止自己启动的进程。再次整体启动会新建链和数据库,旧目录保留,不能把旧资格用于新链。页面刷新恢复与“重建整条演示链”是不同操作。
2. 正常购买(建议首先验收)#
- 保持终端运行,打开活动页。底部默认显示 SQLite 本地演示 / 本地 outbox。
- 在“操作钱包”选择“演示钱包 A”。不需要安装扩展,签名和转账仍连接真实 Anvil。
- 选“限量首发”:10 份,每份 0.0001 MWETH,价格 1 MUSDT。
- 点“连接并登录”。成功后主按钮变成“领取购买资格”。
- 点领取。可领取从 10 变 9,待支付变 1;等待凭证签发,出现 2 分钟倒计时。
- 点“授权支付 1 份”。等入块后按钮变“确认链上购买”。
- 点购买。提交后显示交易 hash;等待本地出块和深度 2 确认,出现“购买成功,资产已到账”。
- 资产余额增加 0.0001 MWETH,MUSDT 减少 1;待支付归零,已成交为 1。
- 刷新页面,钱包、原资格与确认结果恢复。相同钱包本场不能再领一份。
钱包 A 通常地址 0x7099…79C8,钱包 B 为 0x3C44…93BC。首次余额来自 fixture 测试 mint。正常购买不通过模拟管理员 CREDIT。
3. 购买后进入二级市场#
- 在购买成功区域点“去交易台挂单”。链接保留 A/B 演示钱包选择。
- 点交易台“连接钱包”,可看到刚才对应的钱包和测试资产。
- 方向选“卖出”,价格填 10000,数量填 0.0001,点“签名限价单”;当前每 lot 1 MUSDT,因此这组输入对应单份售价 1 MUSDT。
- 卖单出现 OPEN 且余量 0.0001。fixture 已授权 Settlement;发售授权与交易合约授权是两份独立 allowance。
- 打开第二个标签页 http://127.0.0.1:8081/?mode=web3&demo=1 (如果卖方为 B,这里改 demo=0),连接钱包,方向买入,填写同样的价格/数量并签名。
- 等待任务广播和链确认,两单最终成交,任务 CONFIRMED。历史区可查最终成交与链事件。
价格框表示每枚 MWETH 的 MUSDT 价格,数量框表示 MWETH 数量,和后台 tick/lot 不同。输入 1 和 1 会购买/出售 1 MWETH,不能把“1 份”直接填入这两个框。
4. 最后一份与重复操作#
- 回活动页,A 选“最后 1 份”,登录并领取,不购买。
- 刷新或再点活动,仍是原资格;总量不下降第二次。
- 切钱包 B,重新登录,选同一活动:可领取 0,待支付 1,领取按钮禁用。
- A 的 120 秒资格过期且链核验后,B 可以再领。A 仍不能重复领取。
售罄提示表示资格暂时占满;未支付资格可能回收,不等于全部已经链上成交。
5. 20 秒过期回收#
- A 选“过期回收演练”,领取后不要授权或购买。
- 倒计时结束时页面显示“有效期结束,正在核验”;不可立即认定库存已经释放。
- 保持 Anvil 和服务运行,通常再等几个出块,显示“资格已过期”;可领取恢复 1,待支付恢复 0。
- 切换 B、重新登录,领取同一活动成功。
- 切回 A,原过期资格仍在,本钱包不能再领。
每钱包只能参加一次。若 A/B 都已领过该场,重新整体启动一轮演示,获得全新链和数据。不要手工删除数据库行重置资格。
6. 完整中间件模式(RabbitMQ)#
需要运行中的 Docker Desktop,或 WSL Ubuntu 内的 Docker。默认开发密码仅用于本机;已有 PG/RabbitMQ 卷使用首次初始化的密码,改环境变量不会自动改旧卷密码。
# Docker Desktop 可用时 powershell -ExecutionPolicy Bypass -File .\scripts\run-sale-windows.ps1 -Middleware # 本机使用 WSL Docker 时,先在同一终端设置 $env:SALE_DOCKER_WSL='Ubuntu-22.04' powershell -ExecutionPolicy Bypass -File .\scripts\run-sale-windows.ps1 -Middleware |
先停止上一轮服务,释放 8545/8081/8082/9092。脚本等待 RabbitMQ 健康,创建新的 PG 数据库;WSL 模式保留自己的 Linux 保活子进程。页面底部应显示 PostgreSQL / Redis 已连接 / RabbitMQ 已连接。
重复第 2–5 节。RabbitMQ 管理台 http://127.0.0.1:15672 ,开发账户 exchange / local-web3-password;AMQP 端口 5672。Queues 中可看到 sales-<时间戳>. 和对应 .dead 队列。正常完成后主队列 Ready/Unacked 归零;发售格式错误消息保存在 SQL 隔离表。
需要读到最终断言而不是只看绿色 UI 时,访问 /check:differences=[],outbox_pending=0,sign_jobs_pending=0。确认活动库存等式 total=available+held+confirmed。
7. 常见问题#
| 现象 | 检查与处理 |
|---|---|
| 启动端口被占用 | 停止上轮自己启动的演示;脚本拒绝借用不明已有 RPC |
| Go 下载超时 | 检查网络/工具链;脚本不修改全局代理设置 |
| Foundry 安装在 Windows 失败 | 本入口已禁用 POSIX postinstall,显式装固定 Windows Anvil 包;勿替换为普通 npm ci |
| 登录提示钱包不一致 | 选择正确 A/B 后重新登录;扩展切链/切账户也需重新登录 |
| 一直“恢复资格中” | 查看 8082 健康、刷新页面,确认不是旧数据集;不会在恢复完成前发新资格 |
| 资格到期但库存没回 | 检查确认索引与 RPC;不会用本地时钟强行释放 |
| RabbitMQ/PG 拒绝连接 | 确认 Docker/WSL 仍运行、端口映射和首次卷密码;不能默默改成本地模式 |
| Compose 提示旧 Kafka orphan | 旧卷/容器是历史数据,本入口不删除,当前服务使用 RabbitMQ |
| 页面显示暂停核查 | 深重组或索引矛盾已持久冻结;先保存证据并对账,不手工清 frozen |
| 想重新完整验收 | Ctrl+C 后再次启动;新链、新库、新 dataset,历史目录保留 |
自动验证命令、真实执行证据与尚未覆盖范围见测试说明。公共链、云和真实扩展钱包未作为本地验收前置。