Web3 交易系统
测试与验收

发售系统手动验收

从项目根目录 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. 正常购买(建议首先验收)#

  1. 保持终端运行,打开活动页。底部默认显示 SQLite 本地演示 / 本地 outbox。
  2. 在“操作钱包”选择“演示钱包 A”。不需要安装扩展,签名和转账仍连接真实 Anvil。
  3. 选“限量首发”:10 份,每份 0.0001 MWETH,价格 1 MUSDT。
  4. 点“连接并登录”。成功后主按钮变成“领取购买资格”。
  5. 点领取。可领取从 10 变 9,待支付变 1;等待凭证签发,出现 2 分钟倒计时。
  6. 点“授权支付 1 份”。等入块后按钮变“确认链上购买”。
  7. 点购买。提交后显示交易 hash;等待本地出块和深度 2 确认,出现“购买成功,资产已到账”。
  8. 资产余额增加 0.0001 MWETH,MUSDT 减少 1;待支付归零,已成交为 1。
  9. 刷新页面,钱包、原资格与确认结果恢复。相同钱包本场不能再领一份。

钱包 A 通常地址 0x7099…79C8,钱包 B 为 0x3C44…93BC。首次余额来自 fixture 测试 mint。正常购买不通过模拟管理员 CREDIT。

3. 购买后进入二级市场#

  1. 在购买成功区域点“去交易台挂单”。链接保留 A/B 演示钱包选择。
  2. 点交易台“连接钱包”,可看到刚才对应的钱包和测试资产。
  3. 方向选“卖出”,价格填 10000,数量填 0.0001,点“签名限价单”;当前每 lot 1 MUSDT,因此这组输入对应单份售价 1 MUSDT。
  4. 卖单出现 OPEN 且余量 0.0001。fixture 已授权 Settlement;发售授权与交易合约授权是两份独立 allowance。
  5. 打开第二个标签页 http://127.0.0.1:8081/?mode=web3&demo=1 (如果卖方为 B,这里改 demo=0),连接钱包,方向买入,填写同样的价格/数量并签名。
  6. 等待任务广播和链确认,两单最终成交,任务 CONFIRMED。历史区可查最终成交与链事件。

价格框表示每枚 MWETH 的 MUSDT 价格,数量框表示 MWETH 数量,和后台 tick/lot 不同。输入 1 和 1 会购买/出售 1 MWETH,不能把“1 份”直接填入这两个框。

4. 最后一份与重复操作#

  1. 回活动页,A 选“最后 1 份”,登录并领取,不购买。
  2. 刷新或再点活动,仍是原资格;总量不下降第二次。
  3. 切钱包 B,重新登录,选同一活动:可领取 0,待支付 1,领取按钮禁用。
  4. A 的 120 秒资格过期且链核验后,B 可以再领。A 仍不能重复领取。

售罄提示表示资格暂时占满;未支付资格可能回收,不等于全部已经链上成交。

5. 20 秒过期回收#

  1. A 选“过期回收演练”,领取后不要授权或购买。
  2. 倒计时结束时页面显示“有效期结束,正在核验”;不可立即认定库存已经释放。
  3. 保持 Anvil 和服务运行,通常再等几个出块,显示“资格已过期”;可领取恢复 1,待支付恢复 0。
  4. 切换 B、重新登录,领取同一活动成功。
  5. 切回 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,历史目录保留

自动验证命令、真实执行证据与尚未覆盖范围见测试说明。公共链、云和真实扩展钱包未作为本地验收前置。

— 本篇阅读完毕 —
来源:Web3 交易系统 / docs / 04-testing/sale-acceptance.md 下载原文
输入关键词,在三个知识库中搜索
支持正文检索 · 直接定位章节Esc 关闭