Web3 交易系统
零基础入门

03|资产单位、签名与授权

前一站:Web3 基础 · 下一站:第一次运行

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,订单金额是:

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. 代码与标准入口#

项目源码:链订单与签名 ↗、发售凭证 ↗、登录验签 ↗、结算合约 ↗。

标准阅读: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、库存和防重复校验。

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