# 02｜钱包、区块链和智能合约

前一站：[项目全景](01-project-tour.md) · 下一站：[单位、签名和授权](03-assets-signatures.md)

## 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. 从发交易到确认

```mermaid
flowchart LR
    A[钱包构造并签交易] --> B[节点收到广播]
    B --> C[等待入块]
    C --> D[receipt 执行状态]
    D --> E[继续等待配置确认深度]
    E --> F[后端按链事实更新业务状态]
```

交易 hash 是交易的标识，拿到 hash 只能说明你有一个可追踪对象。它可能还未入块，也可能执行失败。receipt 是入块后的执行回执；要检查执行状态，不能只看“查到了 receipt”。

区块会引用父块。分叉切换可能让刚看到的交易暂时离开当前链，这叫重组。多等几个块可以降低短期不稳定影响；本项目的确认深度 2 是本地应用策略，不等于所有链都已经达到协议级最终确定性。

## 8. 本章怎么对应源码

- [本地链与测试账户](../../contracts/scripts/local.mjs)：Anvil、RPC、钱包和测试资产。
- [发售合约](../../contracts/src/FlashSale.sol)：从公开函数观察状态变化。
- [链扫描器](../../flashsale/chain.go)：固定块 hash、确认高度和重组检测。
- [钱包适配器](../../frontend/src/demo-wallet.ts)：页面如何连接本地测试身份。

概念可继续参考以太坊官方的账户、交易和 Gas 开发文档；本项目具体行为仍以源码为准。

## 9. 自测

问：切换 RPC 后，地址相同就能继续使用原资格吗？

答：不能。地址相同不代表链、合约、活动和 dataset 相同，必须匹配本轮完整配置。

问：为什么已经查到交易 hash，页面还在等？

答：hash 不能证明执行成功；还要观察 receipt、确认深度和后端索引。
