Web3 交易系统
零基础入门

04|第一次把项目跑起来

前一站:资产和签名 · 下一站:一次购买的内部过程

1. 今天先达到一个小目标#

先使用默认 SQLite 本地模式:A 买到一份、余额按预期变化、刷新后还能看到结果。第二轮再加入 PG/Redis/RabbitMQ。两种模式都运行真实本地 EVM,区别在链下存储与任务运输,不是一个真买一个假买。

详细操作和最终预期以发售手动验收为准。本章是解释版入口,所有命令都在项目根目录运行,不在本章所在的 docs 文件夹运行。

2. 准备工具#

需要 Windows、PowerShell、Go 1.26.9+、Node.js 22.22+、npm 和浏览器,首次启动需要网络下载依赖。先在终端检查:

Set-Location -LiteralPath 'D:\codex小项目\go\web3'
go version
node --version
npm.cmd --version

项目依赖以 go.mod、两份 package-lock.json 和启动器固定配置为准。不要为了跟教程逐字相同而把依赖手动换成网上最新版本;也不要直接改全局 Go/npm 设置来掩盖单次网络问题。

3. 启动默认模式#

双击根目录 run-sale-windows.cmd,或者:

powershell -ExecutionPolicy Bypass -File .\scripts\run-sale-windows.ps1

看到下载、编译或安装日志是正常的。启动器会准备独立 Windows npm 目录、编译前后端和合约、启动 Anvil、部署代币与两个业务合约、准备活动、启动 Go 服务,等就绪后打开浏览器。首次启动比后续构建慢。

不要在启动中关闭终端。终端是本次演示的控制台,Ctrl+C 用来停止本次脚本创建的进程。脚本不按端口强杀别人已有的服务。

地址 你可以观察什么
http://127.0.0.1:8082/?mode=sale 活动、钱包、资格和购买
http://127.0.0.1:8081/?mode=web3 同链二级市场
http://127.0.0.1:8545 JSON-RPC,不是普通网页
http://127.0.0.1:8082/health/ready 新资格准入是否就绪
http://127.0.0.1:9092/check 发售只读对账

4. 用 A 完成一份购买#

  1. 选演示钱包 A,选择“限量首发”,先确认页面连接的是本轮本地配置。
  2. 点“连接并登录”:钱包签登录文本,网站创建会话,余额还不会因登录改变。
  3. 点“领取购买资格”:可领取从 10 变 9,待支付变 1,等待签名凭证就绪。
  4. 点“授权支付 1 份”:给 FlashSale 使用 MUSDT 的额度,等待授权交易入块。
  5. 点“确认链上购买”:钱包发送 purchase,页面显示交易 hash 并继续等待。
  6. 看到确认成功后核对:MWETH 增 0.0001,MUSDT 减 1,测试 ETH 另有 Gas 消耗;待支付归零,已成交为 1。
  7. 刷新当前页面,应恢复钱包/原资格/结果,而不是给同钱包再发一份。

如果余额原来是 X MWETH 和 Y MUSDT,则成功后是 X+0.0001 和 Y−1。测试 fixture 初始余额不是你投入了真钱,不需要买主网币来完成本实验。

5. 看一次 JSON-RPC 查询#

不需要先安装新工具。另开 PowerShell,在服务仍运行时:

$rpcBody = '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'
Invoke-RestMethod -Method Post -Uri 'http://127.0.0.1:8545' -ContentType 'application/json' -Body $rpcBody
Invoke-RestMethod -Uri 'http://127.0.0.1:9092/check'

eth_chainId 返回十六进制 0x7a69,对应十进制 31337。/check 的稳定结果应没有 differences;刚广播时可能仍有异步滞后,先等待服务追上,不要为了看到空数组而删数据。

也可以打开浏览器开发者工具的 Network,观察 /api/web3/ 请求:登录、资格查询、交易 hash 上报是不同接口。只观察,不在控制台粘贴未知脚本。

6. 再体验二级市场#

A 购买成功后点“去交易台挂单”。卖出价格填 10000、数量填 0.0001,签名限价卖单。再开 B 的交易标签,输入同价同量买单,等待结算任务与链确认。

两边最终看到 FILLED,任务 CONFIRMED,说明购买得到的测试资产已经通过二级市场再次交换。这个环节包含订单签名、Go 撮合和 relayer 结算,和发售购买的直接调用路径不同。完整步骤见验收手册第 3 节。

7. 再切到完整中间件模式#

先 Ctrl+C 停止上一轮,再启动 Docker Desktop 或可用的 WSL Docker:

powershell -ExecutionPolicy Bypass -File .\scripts\run-sale-windows.ps1 -Middleware

如果 Docker 在 WSL Ubuntu 内,先按自己的实际发行版设置:

$env:SALE_DOCKER_WSL='Ubuntu-22.04'
powershell -ExecutionPolicy Bypass -File .\scripts\run-sale-windows.ps1 -Middleware

页面底部应明确显示 PostgreSQL、Redis、RabbitMQ。运行前确认自己有该 WSL 发行版;不要原样假定每台机器都叫 Ubuntu-22.04。完整模式配置失败会报错,不会悄悄回退成本地模式。

8. 刷新和重启是两件事#

刷新页面只是重新读取同一轮状态。完整重启脚本会创建新 Anvil、新数据库和新 dataset。终端显示本轮 bin/sale-dev/<时间戳>/,最近一轮位置记录在 bin/sale-dev/latest.json;旧目录保留用于排查,不能用旧凭证连接新链。

9. 完成本章的验收标准#

你能亲眼核对 A 的购买前后币差、SQL 库存等式、刷新恢复和只读对账;也能说出授权交易与购买交易的区别。此时再读下一章,就能把页面动作对应到后端和合约。

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