1. 先从普通网站类比#
普通网站登录后,服务器查自己的数据库判断你是谁、余额多少。这个项目的发售网站也有登录会话和 SQL,但钱包资产余额最终来自链上的状态。服务器能记住“你有一份购买资格”,不能仅靠 UPDATE SQL 给钱包增加 MWETH。
区块链可以先理解成按区块组织的共同状态记录。交易依次改变状态;节点按协议检查和执行。这里运行的是本地 Anvil,便于理解交易执行,不涉及部署完整公共网络。
2. 私钥、公钥、地址和钱包#
私钥是控制签名能力的秘密数字。公钥可以由私钥推导,地址按以太坊规则从公钥派生。对初学者来说,先记住:别人可以知道地址,不能知道私钥。
钱包是管理密钥、展示签名请求并发送交易的软件。币并没有作为一个文件装在钱包程序里:原生 ETH 余额是链状态,ERC20 余额由代币合约的状态记录。换一个钱包软件连接同一账户、同一条链,看到的应是同一组链上资产。
项目中的 A/B 演示钱包属于 EOA,即由私钥控制的普通账户。合约账户由合约代码控制,不是另一个随手生成私钥的普通钱包。本项目当前钱包认证支持 EOA,不能直接推断支持所有智能合约钱包。
演示钱包的公开测试私钥由本地 fixture 使用,目的是让你免装扩展验收。它不代表生产环境允许把真实用户密钥放进网页。页面切换 A/B 只是切换本地实验身份。
3. 链、chainId 和 RPC#
链是你连接的状态世界,chainId 是链标识,RPC 是访问节点的接口地址。项目默认 RPC 是 http://127.0.0.1:8545,chainId 是 31337。
可以类比为:RPC 是进入实验室的门,chainId 是实验环境编号,合约地址是实验室里的设备地址。仅知道编号相同,不保证设备和历史相同。重新启动本项目的完整演示会创建新链,即使 chainId 和某些确定性部署地址相同,旧交易和资格也不能继续套用。
因此系统另外使用 dataset 标识本次数据世界,并核对合约、资产、签名者和链域。dataset 是本项目应用层概念,不是以太坊替你自动生成的公共标准。
4. 智能合约和 EVM#
智能合约是部署在链上的程序,Solidity 是本项目使用的编程语言,EVM 是执行字节码的运行环境。可以把合约想成有公开规则和持久状态的程序,不要把它理解成“写完就绝对不会出错的合同”。
FlashSale.purchase 会检查购买人、签名、期限和库存,然后进行收款及交付。任一步出错,整笔调用中的状态变化回滚。交易仍可能消耗 Gas,所以“业务没有买成”不等于“这次链上执行从没发生”。
Settlement.settle 会检查双方订单、签名、额度与数量,再交换两种代币。合约不能主动定时醒来,也不能直接读取网站 PostgreSQL 或 RabbitMQ;外部账户或其他合约调用它时,它才执行。
5. 查询和写入为什么不同#
读代码前再认识三个词。ABI 是合约对外接口及调用编码约定:ethers 需要它把 purchase 和参数编码成节点可执行的 calldata。合约地址告诉你“调用谁”,ABI 告诉工具“怎样调用”。
event 是合约执行时产生的结构化日志,例如 Purchased、Matched。它不是浏览器弹窗,也不会自动向 Go 推送业务成功;项目要通过 RPC 读取并校验对应日志。事件所在区块、交易和字段都要匹配,不能只看事件名字。
mint 是给某地址新增代币余额。本地部署用它准备测试资产,不代表每个 ERC20 都有可供任何人调用的 mint,也不是给普通用户真实充值的实现。
| 操作 | 例子 | 是否改变链状态 | 通常是否需要用户发交易 |
|---|---|---|---|
| 查询 | 查看 balanceOf、allowance |
否 | 否,节点本地执行查询 |
| 离线签名 | 签登录文本、签限价订单 | 本身不改变 | 否,但签名可能授权后续操作 |
| 写入交易 | approve、purchase、链上撤单 |
执行成功时改变 | 是,需要发送者支付 Gas |
查询也消耗节点资源,公共 RPC 服务可能收费或限流,只是它通常不要求查询者为每次读取支付链上 Gas。
6. Gas 和两种余额#
Gas 计量链上执行需要的计算工作,交易发送者以原生币支付费用。本地链里使用测试 ETH;购买商品使用 MUSDT。你可能有足够 MUSDT 却没有测试 ETH,仍然无法发送授权/购买交易。
MWETH 在这里是 MockWETH 测试 ERC20,不要按名称把它自动当作可一比一兑换主网 ETH 的资产。本项目 fixture 会 mint 测试代币,没有主网资产价值证明。
7. 从发交易到确认#
flowchart LR A[钱包构造并签交易] --> B[节点收到广播] B --> C[等待入块] C --> D[receipt 执行状态] D --> E[继续等待配置确认深度] E --> F[后端按链事实更新业务状态] |
交易 hash 是交易的标识,拿到 hash 只能说明你有一个可追踪对象。它可能还未入块,也可能执行失败。receipt 是入块后的执行回执;要检查执行状态,不能只看“查到了 receipt”。
区块会引用父块。分叉切换可能让刚看到的交易暂时离开当前链,这叫重组。多等几个块可以降低短期不稳定影响;本项目的确认深度 2 是本地应用策略,不等于所有链都已经达到协议级最终确定性。
8. 本章怎么对应源码#
- 本地链与测试账户 ↗:Anvil、RPC、钱包和测试资产。
- 发售合约 ↗:从公开函数观察状态变化。
- 链扫描器 ↗:固定块 hash、确认高度和重组检测。
- 钱包适配器 ↗:页面如何连接本地测试身份。
概念可继续参考以太坊官方的账户、交易和 Gas 开发文档;本项目具体行为仍以源码为准。
9. 自测#
问:切换 RPC 后,地址相同就能继续使用原资格吗?
答:不能。地址相同不代表链、合约、活动和 dataset 相同,必须匹配本轮完整配置。
问:为什么已经查到交易 hash,页面还在等?
答:hash 不能证明执行成功;还要观察 receipt、确认深度和后端索引。