# 03｜资产单位、签名与授权

前一站：[Web3 基础](02-web3-basics.md) · 下一站：[第一次运行](04-first-run.md)

## 1. 三种资产先分清

| 名称 | 在项目里做什么 | 小数位 / 单位 |
| --- | --- | --- |
| 本地 ETH | 支付发交易的 Gas | 1 ETH = 10^18 wei |
| MWETH / MockWETH | 发售交付、二级市场买卖的测试 ERC20 | 本项目设置 18 位 |
| MUSDT / MockUSDT | 发售与二级市场的支付测试 ERC20 | 本项目设置 6 位 |

ERC20 是一组代币接口约定。余额通常通过 `balanceOf(address)` 查询，直接转移可调用 `transfer`，允许合约代转先调用 `approve`，合约再调用 `transferFrom`。标准不要求所有代币统一 18 位，本项目的 18/6 是自身资产配置。

小数位是显示换算规则，合约里的数量仍是整数。1 MUSDT 不是整数 1，而是 1,000,000 个最小单位；0.0001 MWETH 是 100,000,000,000,000 个最小单位。实际开发不能用 `float64` 进行资金计算后再四舍五入掩盖误差。

## 2. “1 份”、lot、tick 和页面数字

发售页面领取 `quantity=1` 表示一份购买资格。每份商品的 `quantityLots=1`，本项目 1 lot = 0.0001 MWETH。两种“1”的含义不同：前者是买几份，后者是每份含多少资产单位；当前接口只允许一次领取一份。

二级市场价格是“每 1 MWETH 值多少 MUSDT”，数量是“多少 MWETH”。页面输入卖价 10000、数量 0.0001，订单金额是：

```text
10000 MUSDT/MWETH × 0.0001 MWETH = 1 MUSDT

价格 tick = 0.01 MUSDT/MWETH
10000 ÷ 0.01 = 1000000 ticks
数量 lot = 0.0001 MWETH
0.0001 ÷ 0.0001 = 1 lot

quote 最小单位 = ticks × lots = 1000000
1000000 ÷ 10^6 = 1 MUSDT
```

这组精度让结算金额成为整数乘法。页面的“1 MWETH”不等于发售的“1 份”，不要在二级交易数量框直接填 1 来表示一份。

## 3. 签名是在证明什么

哈希可以先理解成给数据计算一个定长摘要。它不是把私钥加密后放进订单，也不能通过摘要读回原文；同一编码得到同一摘要，字段变化通常得到不同摘要。项目中的订单 ID、交易 hash、区块 hash 各自摘要的对象不同，不能因为都叫 hash 就互相替代。

签名让别人检查“拥有对应私钥的人同意了这份内容”，不需要公开私钥。签名只对特定摘要有意义，字段或上下文改变后，验签就不能按原身份通过。

但“只是签名，没有发交易”不能推导“没有授权后果”。你签下的订单或许可可能被别人提交合约执行。所以要理解签的字段、使用合约、金额和期限。本项目没有让后端保管买家私钥。

## 4. 这个项目里有四种不同的签名场景

| 场景 | 谁签 | 谁检查 | 作用 |
| --- | --- | --- | --- |
| 发售登录挑战 | 用户 A/B | Go 认证服务 | 证明本次登录控制该钱包，创建网站会话 |
| 二级市场限价订单 | 买方、卖方分别签 | Go + Settlement | 授权在价格、数量、期限内交换资产 |
| 发售购买凭证 | 后端配置的 signer | FlashSale | 证明这份固定条款资格由发售服务签发 |
| 链上交易 | 发交易的账户 | 节点和 EVM 执行环境 | 授权发送某次链操作，并按发送账户 nonce 排序 |

最容易误会的是第三行：买家领取资格后拿到的购买凭证是服务端签的，不是买家再给库存签名。买家随后发出的购买交易，才是买家对本次合约调用的授权。

## 5. EIP-191 和 EIP-712 到底是什么

EIP 可以理解为以太坊生态的改进/标准提案。EIP-191 规定签名数据的某些编码格式，本项目登录挑战采用其中常见的个人消息签名前缀路径。登录文本绑定网站、URI、chainId、随机挑战、签发和过期时间；Go 恢复签名地址并一次性消费挑战。

EIP-712 描述结构化数据的哈希和签名方式。相比一个不透明字符串，你可以明确地签“哪个订单、什么价格、多少数量、何时过期”。它还包含域，例如名称、版本、chainId、验证合约地址。

本项目有两个不同的域：交易订单用 `GoExchange` 和 Settlement；发售凭证用 `GoExchangeSale` 和 FlashSale。签名格式本身不自动保证同一条授权只能使用一次：还需要合约的 `filled`、`cancelled`、`settled`、`consumed`、`purchased` 等业务记录共同防重复或超额使用。

Go、Solidity 和 TypeScript 的类型名、字段名、顺序和编码要一致，不能只改一端。学习时先看字段含义，再去追 keccak 和 ABI 编码细节。

## 6. approve 只是额度，不是付款或冻结

A 调用 MUSDT 的 `approve(FlashSale, 1000000)`，意思是允许这个发售合约最多代转 1 MUSDT。授权完成后，A 的 MUSDT 余额可以仍然不变；只有 `purchase` 执行 `transferFrom` 才实际付款。

授权额度按“资产合约、钱包 owner、spender 合约”区分。给 FlashSale 的授权不会自动给 Settlement。演示 fixture 预先准备了部分交易授权，所以有些操作无需再弹出相同步骤，但真实业务必须核对 allowance。

approve 也不保证余额被冻结。用户可以在成交前转走代币或撤销授权，结算合约必须再次验证，Go 的本地 pending 无法阻止链外别处的花费。

## 7. nonce 有两类，不能混用

订单 nonce 是用户签名订单中的业务标识，用于区分订单和防冲突。发送交易 nonce 是以太坊账户交易顺序号；relayer 恢复交易时必须保持原 nonce/raw/hash。

这两者只是都叫 nonce，职责不同。换一个订单 nonce 会产生另一份授权；给同一笔未知广播随便换发送 nonce，可能把同一业务提交两次。

## 8. 代码与标准入口

项目源码：[链订单与签名](../../chaintrade/types.go)、[发售凭证](../../flashsale/types.go)、[登录验签](../../flashsale/auth.go)、[结算合约](../../contracts/src/Settlement.sol)。

标准阅读：`eips.ethereum.org/EIPS/eip-20`、`eips.ethereum.org/EIPS/eip-191`、`eips.ethereum.org/EIPS/eip-712`。本章只解释项目用到的部分，未声称实现完整钱包登录生态、ERC20 Permit 或 EIP-1271 合约钱包支持。

## 9. 自测

问：已授权 1 MUSDT，为什么还要点购买？

答：授权只是让合约有额度可用，购买才检查资格并在一笔交易中收款交货。

问：为什么不能拿另一活动的凭证改 activityId 后使用？

答：activityId 是签名正文的一部分，改字段会改变摘要；还要通过活动配置、buyer、库存和防重复校验。
