L05d Web3 前端:网页借钱包的手去签字
DApp 前端就是普通网页加钱包注入的 window.ethereum;Provider 只读、Signer 能写,EIP-55 用大小写防抄错地址,服务端只能自己拿私钥。
一句话版
DApp 的前端就是一张普通网页,它自己没有私钥,读链靠 Provider,要写链就请钱包里的 Signer 替用户签字。
先认识这几个词
| 词 | 全称 / 读法 | 一句人话 |
|---|---|---|
| DApp | decentralized application,去中心化应用 | 前端是网页、后端是链上合约的应用 |
| MetaMask | 浏览器钱包扩展 | 保管私钥,并把 window.ethereum 注入网页 |
| Provider | 提供者 | 只能读链上数据的连接 |
| Signer | 签名者 | 背后有私钥、能发交易的对象 |
| wei / ether | 以太坊的最小单位 / 常用单位 | 链上按 wei 记账,1 ether 等于 10¹⁸ wei |
| async / await | 异步 / 等待 | 让网页等网络请求回来再往下走的写法 |
| 校验和 | checksum | 附在数据上的检查信息,用来发现抄错 |
一个类比:网页借钱包的手去签字
你在一家网店下单。网店的页面能查库存、算总价,但它碰不到你的银行卡。到付款那一步,页面弹出银行的确认框,你在框里输密码,钱才付出去。
DApp 也是这样分工。网页能读链上数据,这是 Provider 的活。要转账、要 mint,网页把交易交给 MetaMask,MetaMask 弹窗请你确认,再用你的私钥签名发出去,这是 Signer 的活。
收款账号抄错一位,钱就去了别人那里。EIP-55 在地址的大小写里藏了一道校验,抄错时多半能被钱包发现。
类比在哪里失效:
- 银行付款错了能申诉退款。链上交易一旦确认就撤不回来,签字前看清楚是唯一的保护。
- 网店服务器后台可以直接扣款。DApp 的服务端脚本没有钱包可借,只能自己拿着私钥签,私钥就放在服务器上。
从零讲起
1. 网页三件套与异步(补充)
它解决什么问题
DApp 的前端就是普通网页。不知道 HTML、CSS、JavaScript 各管什么,也不知道为什么代码里到处是 async 和 await,后面的连接钱包代码就读不懂。
从哪来(补充)
async / await 是在 ECMAScript 2017 里加进 JavaScript 的(Wikipedia: Async/await)。这种写法更早出现在 F# 2.0(2007 年)和 C# 5(2012 年),JavaScript 是后来跟进的。
直觉
HTML 描述页面上有什么,比如按钮、输入框、一段文字。CSS 管它们长什么样。JavaScript 让页面动起来,响应用户点击。
JavaScript 默认一行接一行同步执行。可是向钱包请求连接、向链上查数据都要等网络回来,可能等好几秒。async 标在函数上,表示它里面有要等的操作;await 标在那个操作前面,表示等它有了结果再执行下一行。
一步一步看
目标:跟着用户点一次 Connect Wallet,看出页面、库、函数各管哪一段,await 那行为什么要停住等用户同意。
-
课件的 Mint Portal 页面用 HTML 写出两个按钮
Connect Wallet和Mint/Buy,一个数量输入框(1 到 5),一段显示已连接地址的文字。 -
页面通过 CDN 引入
web3@4.16.0这个库。 -
用户点
Connect Wallet,触发 JavaScript 函数connectwallet(),它被标成async。 -
函数里
await请求钱包连接。这一行会停住,直到用户在 MetaMask 里点了同意。 -
拿到结果后,下一行才把地址显示在页面上。
怎么判断
看到一行 JavaScript,问它要不要等网络:
- 要等,比如请求钱包、查链上余额、发交易:前面加
await,所在函数标async。 - 不用等,比如读输入框、做乘法:直接写。
意思是:async 函数返回的是一个 Promise,也就是「将来会有结果」的凭证;await 等这个凭证兑现。少写 await,拿到的是凭证本身,不是结果。
常见误解
以为 await 会把整个网页卡住
await 只让当前这个 async 函数暂停,页面的其他部分照常响应。网页在等钱包回复时,用户仍然可以滚动、点别的地方。
试一下
有人写了 const accounts = web3.eth.getAccounts(); 然后直接读 accounts[0],结果是 undefined。缺了什么?
缺了 await。getAccounts 返回的是 Promise,不加 await 拿到的是 Promise 本身,没有 [0] 这一项。应写成 const accounts = await web3.eth.getAccounts();,并把所在函数标成 async。
2. Mint Portal:网页怎么连上钱包
它解决什么问题
网页自己没有私钥,也不直接连以太坊节点。它要先找到用户的钱包,拿到用户同意,才能读地址、发交易。课件用一个 Mint Portal 示例把这条路走了一遍。
直觉
MetaMask 装在浏览器里,会往每个网页里注入一个全局对象 window.ethereum。网页拿它当入口,交给 Web3.js 包一层,就能和链对话。
合约调用分两种。.call() 只读,不改链上数据,不花 gas,也不用签名。.send() 要写链,必须由用户签名,还可能附带转账金额 value。
一步一步看
目标:走一遍 Mint Portal 从点 Connect 到点 Mint 的流程,看出网页怎样借钱包拿到地址、建合约对象、再发交易。
-
点击 Connect,先检查
window.ethereum存不存在。不存在说明用户没装钱包。 -
用它建一个 Web3 对象:
new Web3(window.ethereum)。 -
await请求账户eth_requestAccounts,MetaMask 弹窗请用户批准。 -
用户批准后,
getAccounts()取到地址,取第一个accounts[0]。 -
把地址显示在页面上。
-
用合约的 ABI(接口描述)和地址
0xF2107DBC2F37ee62E177dFa8Ff1d98Cd79AcAf43建合约对象。 -
点 Mint 时,读输入的数量,用
.call()取单价cost(),算出总价,再用.send({from, value})发交易。
怎么判断
遇到一个合约方法调用,问它改不改链上数据:
- 只是读,比如取单价、查余额:用
.call(),免费、不弹窗。 - 要改,比如 mint、转账:用
.send(),MetaMask 弹窗签名、要付 gas。
意思是:Mint Portal 里取单价 cost() 用 call,真正 mint 用 send;send 里的 value 就是要付的总价,以 wei 计。
常见误解
以为 .call() 调用 mint 也能完成铸造
.call() 在节点本地模拟执行,结果不写进链,也没有签名。用 call 调 mint 只能看到「如果执行会怎样」,代币不会真的铸出来。
以为 window.ethereum 是浏览器自带的
它是 MetaMask 这类钱包扩展注入的。用户没装钱包,页面上就没有这个对象,所以第一步要先检查。
试一下
用户点了 Connect,MetaMask 弹窗出来后,用户点了拒绝。上面七步会停在哪一步?
停在第 3 步:await eth_requestAccounts 会以错误结束,后面取地址、显示地址、建合约对象都不会执行。
3. Provider、Signer 与 wei/ether
它解决什么问题
钱包同时提供两种能力:读链和写链。把这两种能力分开,网页才能在不碰私钥的前提下随意读数据,只在要写链时请用户确认。金额在链上和页面上用不同单位,也要会换算。
从哪来(补充)
MetaMask 由 ConsenSys 开发,2016 年以 MIT 许可开源发布,2020 年 9 月推出手机应用(Wikipedia: MetaMask)。Web3 这个词则是以太坊联合创始人 Gavin Wood 在 2014 年提出的(Wikipedia: Web3)。
直觉
Provider 像一张只读的借书证,能查目录、看余额,不能借走任何东西。Signer 背后有私钥,能签名、能发交易。浏览器里网页拿不到原始私钥,所以写链总要经过 MetaMask 弹窗,由用户批准。
链上金额一律用最小单位 wei 记,是个很大的整数。给人看时换成 ether,发交易时再换回 wei。
一步一步看
目标:先用 Provider 查区块、余额和 nonce,再用 Signer 发一笔转账,看出读链写链怎么分工、wei 和 ether 在哪换算。
-
有了 Provider,就能做只读查询。查当前区块高度:
await provider.getBlockNumber(),课件的例子返回 20867675。 -
查余额:
await provider.getBalance("ethers.eth"),返回的是 wei,一个 bigint。 -
换成人能读的 ether:
formatEther(balance),得到'4.085…'这样的字符串。 -
查交易计数:
await provider.getTransactionCount("ethers.eth"),也就是这个地址下一笔交易的 nonce。 -
要发交易,换 Signer:
await signer.sendTransaction({ to: "ethers.eth", value: parseEther("1.0") })。parseEther("1.0")把 1 ether 换成 wei。 -
receipt = await tx.wait()等交易上链,拿到回执。
怎么算
1 ether = 10¹⁸ wei。
意思是:formatEther 把 wei 除以 10¹⁸ 变成 ether,用在「读出来给人看」;parseEther 把 ether 乘以 10¹⁸ 变成 wei,用在「写进交易给链」。两者成对出现,方向相反。
常见误解
以为 Provider 也能发交易,只是麻烦一点
Provider 没有私钥,签不了名,发不了交易。要写链必须通过 Signer。
以为 getBalance 返回的就是 ether
返回的是 wei。直接把这个数显示给用户,会多出 18 位数字,要先用 formatEther 转换。
试一下
getTransactionCount 返回 5,这个地址下一笔交易的 nonce 是多少?它和 Provider 还是 Signer 有关?
下一笔交易的 nonce 是 5(之前发过 5 笔,编号 0 到 4)。这是只读查询,用 Provider 就够。
4. EIP-55:地址大小写里的校验和
它解决什么问题
以太坊地址是 40 个十六进制字符,抄错一位钱就转给了别人,而且撤不回来。EIP-55 在不改变地址长度的前提下,加上一道能发现抄错的校验。
从哪来(补充)
EIP-55 由 Vitalik Buterin 和 Alex Van de Sande 在 2016 年提出。标准里说,平均约有 15 个校验位,随机抄错的地址意外通过校验的概率约 0.0247%。
直觉
十六进制里 a 到 f 写大写写小写都是同一个数。EIP-55 利用这份自由:按地址本身的哈希决定每个字母大写还是小写。抄错一位,哈希整个变掉,大小写模式就对不上,钱包就能报错。数字没有大小写,所以数字位不参与。
一步一步看
目标:给一个地址逐位算 EIP-55 校验和,看出每个字母位大写还是小写,由哈希同一位上的值是否不小于 8 决定。
-
取地址,去掉
0x,全部转小写:c361fc33b99f88612257ac8cc2d852a5cee0e217。 -
对这 40 个字符的文本做 Keccak-256,哈希前 40 个字符是
068ef4e414cc5da1b7e33553ee285dd6af1e9875。 -
逐位对照。地址第 5 位是字母
f,哈希第 5 位是f,数值 15 ≥ 8,大写成F。 -
地址第 37 位是字母
e,哈希第 37 位是9,9 ≥ 8,大写成E。 -
地址第 35 位是字母
e,哈希第 35 位是1,1 < 8,保持小写。 -
所有字母位都这样处理,数字位不动,得到
0xc361Fc33b99F88612257ac8cC2d852A5CEe0E217。
怎么判断
对每一位地址字符问两件事:
- 它是数字还是字母?数字原样不动。
- 是字母的话,哈希对应位的数值是不是 ≥ 8?是就大写,否则小写。
意思是:判断看的是哈希那一位的数值,8 到 f 都算 ≥ 8。哈希位是数字 8 或 9 时,地址字母也要大写。
常见误解
以为哈希位是字母(a 到 f)才大写,是数字就小写
标准看的是数值是否 ≥ 8。按「是不是字母」判断,哈希位是 8 或 9 时会判错。上面第 37 位就是反例:哈希位是数字 9,地址字母仍要大写。
以为用 SHA3-256 也能算出一样的结果
以太坊用的是 Keccak-256,它和最终标准化的 SHA3-256 填充方式不同,输出不同。用错哈希,8 个官方测试向量一个都过不了。
试一下
某地址某一位是数字 7,哈希对应位是 c。这一位要变吗?另一位是字母 b,哈希对应位是 8 呢?
数字 7 不变,数字没有大小写。字母 b 对哈希 8,8 ≥ 8,要大写成 B。
5. 服务端 Web3.py 与私钥
它解决什么问题
有些操作没有用户在浏览器前点按钮,比如水龙头自动转账、代发交易、交易机器人。这时候没有 MetaMask 可借,服务端脚本要自己完成签名。
直觉
Ethers.js 和 web3.js 在网页和服务器上都能用。Python 这边用 Web3.py,经 RPC 接口连节点。没有自己的节点时,可以连 Infura 这类服务商提供的接口。
服务器上没有钱包弹窗,签名只能靠脚本自己持有的私钥。私钥一旦写进脚本,服务器被攻破,钱就没了。这种放在联网机器上的私钥叫热钱包。
一步一步看
目标:跟着一段 Web3.py 脚本连节点、导私钥、装签名中间件,看出没有 MetaMask 时签名能力从哪来、谁来确认。
-
连节点:
web3 = Web3(Web3.HTTPProvider(INFURA_URL)),课件的例子连的是 Holesky 测试网。 -
导入私钥:
account = Account.from_key(PRIVATE_KEY)。 -
装上自动签名的中间件:
web3.middleware_onion.inject(SignAndSendRawMiddlewareBuilder.build(account), layer=0)。 -
之后脚本发交易时,中间件用这个私钥自动签名,不需要任何人点确认。
环境 签名能力从哪来 谁来确认 浏览器 MetaMask 里的 Signer 用户在弹窗里点 服务端 脚本导入的私钥 没有人,脚本自动签 -
私钥要放进环境变量或密钥管理服务,不能写进代码仓库。
怎么判断
拿到一个场景,问「签名的私钥在哪」:
- 在用户浏览器的钱包里:客户端,用户逐笔确认。
- 在服务器的脚本里:服务端,自动签名,要按热钱包对待。
意思是:服务端省掉了人工确认,也省掉了这道防线。连上 Infura 只是借了别人的节点接口,签名能力仍然来自自己导入的私钥。
常见误解
以为连上 Infura 就等于跑了自己的全节点
Infura 是第三方提供的接口,你借用它读链、广播交易,链上数据由它的节点提供。自己没有跑节点。
以为服务端也能弹 MetaMask 让人确认
MetaMask 是浏览器扩展,服务器上没有。服务端签名只能靠脚本自己持有的私钥。
试一下
一个水龙头脚本把私钥直接写在 faucet.py 里并上传到公开仓库。会出什么问题?怎么改?
任何人读到仓库就拿到私钥,能把这个地址的钱全部转走。应把私钥放进环境变量或密钥管理服务,脚本运行时读取,代码和仓库里都不出现私钥。
把它们串起来
DApp 前端就是普通网页,HTML 画按钮,JavaScript 响应点击,网络请求用 async / await 等结果。
网页通过 MetaMask 注入的 window.ethereum 找到钱包。读数据走 Provider,用 .call(),不花钱不弹窗;写数据走 Signer,用 .send(),用户在弹窗里签名。金额在链上是 wei,用 formatEther 和 parseEther 来回换。
转账前,EIP-55 用地址大小写里的校验帮你发现抄错。没有浏览器的服务端只能自己拿私钥签名,私钥要妥善保管。
签名在这一页只是「钱包帮你做的一步」。下一页拆开看签名本身:它到底证明了什么,又为什么会被人反复拿来用。
课件里的坑
- [课件有误] p.50 第 4、5 条把 EIP-55 判据写成「哈希位是字母 A–F 才大写、是数字就小写」;标准看哈希 nibble 数值 ≥ 8,哈希位为 8、9 时地址字母也大写。课件 p.49 示例第 37 位(哈希位 9 → 大写
E)就和这条字面规则矛盾,示例值本身是对的;按 p.50 字面只能通过官方 8 个测试向量中的 2 个(p.49–50) - [措辞提醒] p.50 第 3 步写 “replace”,实际只是把哈希和地址逐位对照,地址字符本身不会被哈希替换(p.50)
- [适用条件] p.52 说 MetaMask 获取链上信息也走 Infura,这是它的默认配置,用户可以换成别的 RPC;连 Infura 也不等于自己跑了全节点(p.52)
课后 10 分钟:考点复习
这 10 分钟怎么用:合上页面,先画出 HTML 到合约的七层数据流;再说出 Provider 和 Signer 各能做什么、formatEther 和 parseEther 各用在哪;最后手算一遍 EIP-55 第 37 位为什么大写。
必背
- Provider 只读链状态,Signer 才能发交易;formatEther 把 wei 读成人能看的 ether,parseEther 把 ether 写成 wei。
- EIP-55 用大小写做约 15-bit 地址校验和:对小写 hex 文本做 Keccak-256,地址字母位对应的哈希 nibble ≥ 8(含 8、9)就大写,数字不变。
- 服务端 Web3.py 不连钱包,必须显式导入私钥;私钥写在脚本里就是热钱包风险。
- MetaMask 向页面注入 window.ethereum;.call() 只读不花 gas,.send() 写链要签名、要付 value。
- Web 1.0 发布文档、单向;Web 2.0 参与式、标准接口;Web 3.0 与区块链交互、连用户钱包、内置金融交易。
课件例题
例 1(课件 p.39–41):Mint Portal 的连接与铸造:见下方完整例题。
例 2(课件 p.49–50):校验和地址的第 37 位
题面:小写地址 0xc361fc33b99f88612257ac8cc2d852a5cee0e217 的 EIP-55 校验和形式是 0xc361Fc33b99F88612257ac8cC2d852A5CEe0E217。第 37 个 hex 字符为什么是大写 E?按 p.50 的字面规则会得到什么?
提示
先对小写文本做 Keccak-256,找哈希第 37 位;再分别用「数值 ≥ 8」和「是不是字母」两种判据去判。
解答
- 去掉
0x后,对 40 个小写 hex 字符组成的文本做 Keccak-256,取哈希前 40 个 hex 字符逐位对照。 - 第 37 位地址字符是字母
e,哈希对应位是9。 - 标准规则看 nibble 的数值,9 ≥ 8,所以大写成
E,与课件 p.49 的示例一致。 - p.50 字面规则写的是「哈希位是字母才大写、是数字就小写」,
9是数字,会得到小写e,和 p.49 示例矛盾。按字面规则,官方 8 个测试向量只能过 2 个。
例 3(课件 p.44):Web 的三个阶段
题面:按课件 p.44 的对比,Web 1.0、2.0、3.0 各有什么特征?各列出代表技术。
提示
从「内容谁来产生」和「能不能直接做金融操作」两个角度区分。
解答
- Web 1.0:发布文档,单向,人工维护,专有接口;技术是 HTML、CSS。
- Web 2.0:活跃内容,参与式,程序之间互相调用,标准接口;技术有 XML、AJAX、SOA、REST、API、JSON、微服务等。
- Web 3.0:与区块链交互,连接用户钱包,内置金融交易;技术是 MetaMask、Ethers.js、Web3.js。
完整例题
题面(课件 p.39–41):Mint Portal 页面有 connectwallet() 和 mint() 两个函数,合约地址是 0xF2107DBC2F37ee62E177dFa8Ff1d98Cd79AcAf43,标价 0.06 Eth each mint。问:(1) connectwallet() 依次做了哪些事?(2) mint() 里哪一步用 .call()、哪一步用 .send(),为什么?(3) 两个函数为什么都标了 async?
解法:
- connectwallet 第一段:检查
window.ethereum,用它新建Web3对象。 - connectwallet 第二段:
await请求eth_requestAccounts,等用户在 MetaMask 里批准;再getAccounts()取accounts[0],显示在页面上。 - connectwallet 第三段:用 ABI 和合约地址
new web3.eth.Contract(Abi, Address)建合约对象,供 mint 使用。 - mint 读单价:读输入框里的数量,用
contract.methods.cost().call()取单价。这是只读操作,不改链上数据,所以用 call,不花 gas、不弹窗。 - mint 发交易:算出
totalAmount(单价乘数量),用contract.methods.mint(account, _mintAmount).send({from, value})发交易。这要写链、要付钱,所以用 send,MetaMask 弹窗请用户签名,value 是总价,单位 wei。 - 为什么 async:请求钱包、取单价、发交易都要等网络或用户回复,函数里要用
await,所以必须标async。
要点:读和写用两种不同的调用。读走 call,免费;写走 send,要用户签名并付 value。
答题格式:按函数分段,每一步写「调用了什么 + 为什么这样调」,最后单独一句回答 async。
变式题
改编自课件 p.39:用户在 Mint Portal 输入数量 3,cost() 返回的单价是 0.06 ether 对应的 wei 数。(1) send 里 value 应该填多少 wei?(2) 如果开发者误把 mint 也写成 .call(),用户会看到什么、链上会发生什么?
提示
1 ether 是 10¹⁸ wei。call 只在节点本地模拟执行,不签名、不上链。
判分点与答案(非官方评分标准)
判分点:① 正确换算 wei;② 指出 call 不弹窗、不上链;③ 指出代币没有铸出、用户没付钱。
(1) 单价 0.06 ether = 60000000000000000 wei,乘 3 得 180000000000000000 wei,即 0.18 ether ✓。
(2) MetaMask 不会弹窗,函数可能返回一个模拟结果。链上什么都没发生:没有交易,代币没有铸出,用户也没付钱 ✓。
闪卡自测
1. Provider 与 Signer 的职责边界?formatEther / parseEther 各干什么?
Provider 只读,Signer 可写;formatEther 读 wei→ether,parseEther 写 ether→wei(p.45–48)。
2. EIP-55 什么时候把地址字母大写?
对小写地址文本做 Keccak-256,地址字母位对应的哈希 nibble ≥ 8(含 8、9)就大写,数字位不动(p.49–50)。
3. True or False: Uppercase in EIP-55 depends on whether the hash character is a letter.
中文:EIP-55 大写与否取决于哈希那一位是不是字母。
False. It depends on the hash nibble’s value (≥ 8); digits in the address never change.(p.50)
4. window.ethereum 从哪来?
由 MetaMask 这类浏览器钱包扩展注入页面(p.45)。
5. 浏览器端与服务端拿签名能力的方式有何不同?
浏览器端由 MetaMask 的 Signer 请用户批准;服务端 Web3.py 不连钱包,要显式导入私钥(p.51–53)。
6. .call() 和 .send() 的区别?
.call() 只读、不花 gas、不签名;.send() 写链、要签名、可附 value(p.39)。
下一讲
L05e 签名与重放:钱包签名到底证明了什么?下一页拆开签名三步,看清谁是签名人,再讲同一张签名为什么会被反复拿来用、合约要怎么防。
个人整理的学习笔记,不是官方材料;数字与结论以课件和讲师为准。