Web3 初学者先读从零理解整个项目,内容目录见分类入口。本页用于核对已实现范围,不替代逐步教学。
本轮已实现独立链上限量发售,并按用户要求将交易与发售的消息队列统一改为 RabbitMQ。模拟 v0.3 与既有链交易能力继续保留。操作入口见手动验收,测试范围见测试说明和本轮记录。历史报告保留原版本和原始成绩。
已实现#
| 能力 | 源码与边界 |
|---|---|
| 模拟账户、管理员、撮合、分页、维护 | backend/;模拟资金独立 |
| EIP712 订单与链上两币交换 | chaintrade/、Settlement.sol;单写者、FULL 日志、原交易持久化、任务 CAS |
| 链交易历史、事件与对账 | 保留 v0.5 索引/分页/指标;索引不重复结算资金 |
| 固定价 ERC20 发售 | FlashSale.sol;预存库存、固定条款、钱包限购、凭证一次使用、暂停、到期提取 |
| 钱包会话与私有资格 | flashsale/auth.go、http.go;一次性签名挑战、Cookie、Origin、CSRF、数据集隔离 |
| 库存资格事务 | flashsale/store.go;PG 或显式 SQLite;库存/资格/请求键/outbox 同提交 |
| RabbitMQ 分发 | messaging/;持久 quorum 队列、persistent、mandatory、发布确认、手动 ack、断线重连 |
| 持久消费与签名 | inbox/job 先于 ack;固定正文签名,过期资格不复活 |
| 安全过期回收 | 已确认块时间达到 deadline,同块 hash 的 consumed=false;RPC 故障不按本地计时释放 |
| 前端与演示钱包 | 分步操作、余额/库存/倒计时、刷新恢复、交易哈希、真实 Anvil 交易、移动端布局 |
| OpenAPI | api/sale-openapi.json,标准生成 TS 类型,实际 handler 响应契约测试 |
| 原生 Windows 修复 | 安全静态路径、崩溃测试暂停、目录同步适配;Windows 文件 Sync 不等价于 Unix 目录 fsync |
当前运行架构#
flowchart TD U[钱包 / 发售页] --> A[saleserver :8082] A --> R[Redis 准入保护] A --> DB[PG / 本地 SQLite:库存、资格、outbox] DB --> MQ[RabbitMQ 发售队列] MQ --> W[签名 Worker:inbox/job 后 ack] W --> DB DB --> U U --> C[FlashSale:验签、收款、交付] C --> I[独立索引 / 安全回收] I --> DB U --> T[web3server :8081] T --> L[FULL 日志 / 单写者 / 投影 outbox] L --> MQ2[RabbitMQ 结算队列] MQ2 --> TASK[PG / SQLite:raw/hash/nonce] TASK --> S[Settlement:二级市场交换] |
两个服务共用同一链上的 MWETH/MUSDT,各自拥有数据集、状态、连接预算和索引。发售库存不进入撮合 Engine。Redis 是入口预算,RabbitMQ 是传输;均不裁决库存或资金。
一键脚本准备三场活动:10 份首发、最后 1 份、20 秒过期回收演练。每份 0.0001 MWETH,支付 1 MUSDT;钱包 A/B 有本地测试 ETH 和测试币。常规资格 120 秒,确认深度 2。默认 SQLite 模式便于验收,-Middleware 启用 PG/Redis/RabbitMQ。
后续边界#
公共测试网、云实机、真实钱包扩展兼容、独立合约安全审计、长时间容量测试、生产 RabbitMQ 多节点、自动 HA/fencing、快照、同 nonce 替换、完整运营后台仍未完成。每钱包限购不等于每人限购。
历史 Kafka 报告、证据和数据卷不作为 RabbitMQ 成绩,也不自动删除。旧 WEB3_KAFKA_* 已退出当前入口;恢复必须先核对旧 broker 未落库消息、outbox、任务和链。没有在线自动搬运旧 broker 消息的工具。