← COMP5565 全部讲次
L05d · 第 6 周

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 在地址的大小写里藏了一道校验,抄错时多半能被钱包发现。

类比在哪里失效:

  1. 银行付款错了能申诉退款。链上交易一旦确认就撤不回来,签字前看清楚是唯一的保护。
  2. 网店服务器后台可以直接扣款。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 那行为什么要停住等用户同意。

  1. 课件的 Mint Portal 页面用 HTML 写出两个按钮 Connect Wallet 和 Mint/Buy,一个数量输入框(1 到 5),一段显示已连接地址的文字。

  2. 页面通过 CDN 引入 [email protected] 这个库。

  3. 用户点 Connect Wallet,触发 JavaScript 函数 connectwallet(),它被标成 async。

  4. 函数里 await 请求钱包连接。这一行会停住,直到用户在 MetaMask 里点了同意。

  5. 拿到结果后,下一行才把地址显示在页面上。

    DApp 七层竖排架构:HTML 页面、Web3.js、window.ethereum(青绿高亮)、MetaMask、RPC 与交易、以太坊网络、NFT 智能合约,从上到下依次传递

怎么判断

看到一行 JavaScript,问它要不要等网络:

  1. 要等,比如请求钱包、查链上余额、发交易:前面加 await,所在函数标 async。
  2. 不用等,比如读输入框、做乘法:直接写。

意思是: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 的流程,看出网页怎样借钱包拿到地址、建合约对象、再发交易。

  1. 点击 Connect,先检查 window.ethereum 存不存在。不存在说明用户没装钱包。

  2. 用它建一个 Web3 对象:new Web3(window.ethereum)。

  3. await 请求账户 eth_requestAccounts,MetaMask 弹窗请用户批准。

  4. 用户批准后,getAccounts() 取到地址,取第一个 accounts[0]。

  5. 把地址显示在页面上。

  6. 用合约的 ABI(接口描述)和地址 0xF2107DBC2F37ee62E177dFa8Ff1d98Cd79AcAf43 建合约对象。

    连接钱包七步流程:检查 window.ethereum、新建 Web3、await eth_requestAccounts(青绿高亮)、用户批准、取 accounts[0]、显示地址、建合约对象

  7. 点 Mint 时,读输入的数量,用 .call() 取单价 cost(),算出总价,再用 .send({from, value}) 发交易。

怎么判断

遇到一个合约方法调用,问它改不改链上数据:

  1. 只是读,比如取单价、查余额:用 .call(),免费、不弹窗。
  2. 要改,比如 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 在哪换算。

  1. 有了 Provider,就能做只读查询。查当前区块高度:await provider.getBlockNumber(),课件的例子返回 20867675。

  2. 查余额:await provider.getBalance("ethers.eth"),返回的是 wei,一个 bigint。

  3. 换成人能读的 ether:formatEther(balance),得到 '4.085…' 这样的字符串。

  4. 查交易计数:await provider.getTransactionCount("ethers.eth"),也就是这个地址下一笔交易的 nonce。

  5. 要发交易,换 Signer:await signer.sendTransaction({ to: "ethers.eth", value: parseEther("1.0") })。parseEther("1.0") 把 1 ether 换成 wei。

    Provider 与 Signer 对照:左边 Provider 只读,箭头指向 getBlockNumber、getBalance、getTransactionCount;右边 Signer(青绿高亮)背后有私钥,指向 sendTransaction,中间是 MetaMask 弹窗确认

  6. 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 决定。

  1. 取地址,去掉 0x,全部转小写:c361fc33b99f88612257ac8cc2d852a5cee0e217。

  2. 对这 40 个字符的文本做 Keccak-256,哈希前 40 个字符是 068ef4e414cc5da1b7e33553ee285dd6af1e9875。

  3. 逐位对照。地址第 5 位是字母 f,哈希第 5 位是 f,数值 15 ≥ 8,大写成 F。

  4. 地址第 37 位是字母 e,哈希第 37 位是 9,9 ≥ 8,大写成 E。

  5. 地址第 35 位是字母 e,哈希第 35 位是 1,1 < 8,保持小写。

    EIP-55 逐位对照:三行分别是小写地址、Keccak-256 哈希、校验和地址的第 29 到 40 位,第 37 位(青绿高亮)地址 e 对哈希 9,大写成 E

  6. 所有字母位都这样处理,数字位不动,得到 0xc361Fc33b99F88612257ac8cC2d852A5CEe0E217。

怎么判断

对每一位地址字符问两件事:

  1. 它是数字还是字母?数字原样不动。
  2. 是字母的话,哈希对应位的数值是不是 ≥ 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 时签名能力从哪来、谁来确认。

  1. 连节点:web3 = Web3(Web3.HTTPProvider(INFURA_URL)),课件的例子连的是 Holesky 测试网。

  2. 导入私钥:account = Account.from_key(PRIVATE_KEY)。

  3. 装上自动签名的中间件:web3.middleware_onion.inject(SignAndSendRawMiddlewareBuilder.build(account), layer=0)。

  4. 之后脚本发交易时,中间件用这个私钥自动签名,不需要任何人点确认。

    环境 签名能力从哪来 谁来确认
    浏览器 MetaMask 里的 Signer 用户在弹窗里点
    服务端 脚本导入的私钥 没有人,脚本自动签
  5. 私钥要放进环境变量或密钥管理服务,不能写进代码仓库。

怎么判断

拿到一个场景,问「签名的私钥在哪」:

  1. 在用户浏览器的钱包里:客户端,用户逐笔确认。
  2. 在服务器的脚本里:服务端,自动签名,要按热钱包对待。

意思是:服务端省掉了人工确认,也省掉了这道防线。连上 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 位为什么大写。

必背

  1. Provider 只读链状态,Signer 才能发交易;formatEther 把 wei 读成人能看的 ether,parseEther 把 ether 写成 wei。
  2. EIP-55 用大小写做约 15-bit 地址校验和:对小写 hex 文本做 Keccak-256,地址字母位对应的哈希 nibble ≥ 8(含 8、9)就大写,数字不变。
  3. 服务端 Web3.py 不连钱包,必须显式导入私钥;私钥写在脚本里就是热钱包风险。
  4. MetaMask 向页面注入 window.ethereum;.call() 只读不花 gas,.send() 写链要签名、要付 value。
  5. 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」和「是不是字母」两种判据去判。

解答
  1. 去掉 0x 后,对 40 个小写 hex 字符组成的文本做 Keccak-256,取哈希前 40 个 hex 字符逐位对照。
  2. 第 37 位地址字符是字母 e,哈希对应位是 9。
  3. 标准规则看 nibble 的数值,9 ≥ 8,所以大写成 E,与课件 p.49 的示例一致。
  4. p.50 字面规则写的是「哈希位是字母才大写、是数字就小写」,9 是数字,会得到小写 e,和 p.49 示例矛盾。按字面规则,官方 8 个测试向量只能过 2 个。

例 3(课件 p.44):Web 的三个阶段

题面:按课件 p.44 的对比,Web 1.0、2.0、3.0 各有什么特征?各列出代表技术。

提示

从「内容谁来产生」和「能不能直接做金融操作」两个角度区分。

解答
  1. Web 1.0:发布文档,单向,人工维护,专有接口;技术是 HTML、CSS。
  2. Web 2.0:活跃内容,参与式,程序之间互相调用,标准接口;技术有 XML、AJAX、SOA、REST、API、JSON、微服务等。
  3. 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?

解法:

  1. connectwallet 第一段:检查 window.ethereum,用它新建 Web3 对象。
  2. connectwallet 第二段:await 请求 eth_requestAccounts,等用户在 MetaMask 里批准;再 getAccounts() 取 accounts[0],显示在页面上。
  3. connectwallet 第三段:用 ABI 和合约地址 new web3.eth.Contract(Abi, Address) 建合约对象,供 mint 使用。
  4. mint 读单价:读输入框里的数量,用 contract.methods.cost().call() 取单价。这是只读操作,不改链上数据,所以用 call,不花 gas、不弹窗。
  5. mint 发交易:算出 totalAmount(单价乘数量),用 contract.methods.mint(account, _mintAmount).send({from, value}) 发交易。这要写链、要付钱,所以用 send,MetaMask 弹窗请用户签名,value 是总价,单位 wei。
  6. 为什么 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 签名与重放:钱包签名到底证明了什么?下一页拆开签名三步,看清谁是签名人,再讲同一张签名为什么会被反复拿来用、合约要怎么防。

下一讲 →
L05e L05e 签名与重放:盖了章的支票能兑几次

个人整理的学习笔记,不是官方材料;数字与结论以课件和讲师为准。