← COMP5565 全部讲次
Lab2b · 第 9 周

Lab2b 在网页上签字、筛选、搜索,再到区块浏览器里找那笔交易

Lab 2 后半:每个按钮背后是哪个链码函数,签字失败报什么错、为什么不上链,CouchDB 富查询怎么改成同时搜名称和描述,Explorer 里多出的区块装了什么。

一句话版

Lab 2 后半把命令行换成网页:详情页签字、新建产品、只看未完成、按关键词搜索,每个按钮背后都是一个链码函数。最后装上区块浏览器 Hyperledger Explorer,看刚才那笔交易落进了哪个区块。网络启动、注册和链码升级在 Lab2a。

先认识这几个词

词 全称 / 读法 一句人话
路由 route,本 Lab 在 routes/ 文件夹 网页服务里「收到这个网址该干什么」的代码
模板 view,本 Lab 用 handlebars 把查询结果填进 HTML 的页面骨架
富查询 rich query 按文档里的字段内容筛选,不只按键查
正则表达式 regular expression,简称 regex 描述「什么样的字符串算匹配」的一套写法
selector 选择器 CouchDB 查询里写筛选条件的那一块
Explorer Hyperledger Explorer 网页版区块浏览器,看区块、交易、节点
链码 chaincode Fabric 对智能合约的叫法,跑在 peer(存账本的节点)上
背书 endorsement peer 先把交易试跑一遍,对结果签名担保

题目地图

Task 在考什么 主要失分点
4 启动网页前端 前端怎样接到链上 网络没起来就启动前端
5 详情页签字 签字 = 一笔交易;权限在哪查 报错只答一种;以为失败也上链
6 新建产品 网页表单背后调的函数 选错发交易的用户
7 只看未完成 富查询按字段筛选 照截图核对,数据对不上
8 搜索 改 CouchDB 正则查询 字段名写成大写;改完没升级链码
9 区块浏览器 交易落进了哪个区块 私钥文件名没填对,连不上

概念卡

1. 网页前端的调用链

人话定义:它回答「网页上点一下按钮,请求走了哪几站」。浏览器把请求发给 Node.js 写的网页服务,服务通过 Fabric SDK 调 peer 上的链码,链码读写 CouchDB 里的世界状态(每个键当前值的那张表)。

例子:打开详情页 localhost:3000/products/2。路由 routes/products.js 收到请求,调链码查键为 2 的产品。查到的结果交给模板 views/products.hbs 渲染成页面。

常见误解

以为网页直接连数据库 → 网页服务只跟链码打交道,CouchDB 由 peer 管,前端碰不到。

试一下:网页上「Pick a User」下拉框选的是什么?

答案

选用钱包里哪个身份发交易。选谁,链码读到的就是谁的证书属性。

回讲义:L07b-1 Chaincode:用 Go 写合约,Submit 和 Evaluate 怎么选

2. 签字就是一笔交易

人话定义:它解释「签字」在链上是什么。Manager 认证产品,就是发一笔把产品阶段加 1 的交易。每笔交易都带发起人的数字签名,所以这笔交易本身就等于签了字。

例子:manager1 给 Macbook Pro 签字后,详情页 Status 从 0 变 1,下面多出一条签名记录。记录写的是 Stage 0:它记的是签字时所处的阶段,表示「批准了第 0 阶段」。

课件里签字后的产品详情页截图:地址栏 localhost:3000/products/2,标题 Name: Macbook Pro,下面依次是 Laptop、Status: 1、Signatures required: 3、Added by: creater1,Signatures 列表里有 Stage: 0 和 Signed By: manager1 两行,底部是 Pick a User 下拉框和紫色 SIGN 按钮
图片来源:COMP5565 Lab 2 DApp Development in Hyperledger Fabric, p.13
常见误解

以为签字失败也会在链上留一笔无效交易 → 权限检查在背书者试算时就做了,查不过拿不到背书,交易到不了排序服务。

试一下:一个最大阶段为 3 的产品,要签几次才算完成?

答案

三次。阶段 0→1→2→3,到 3 时标记为完成,再签会报 Cannot be signed.。

回讲义:L06c Fabric(三):一笔交易的五步,先试算再排队

3. 富查询:按字段内容筛

人话定义:它回答「怎样按名字、按是否完成去找产品」。按键查只能给出某个键或一段键范围;富查询能写条件,比如「completed 为 false 的」「name 里含 Mac 的」。

例子:「只看未完成」背后的条件是 {"selector":{"completed": false}}。搜索背后的条件用了正则:(?i) 表示不分大小写,关键词前后的 .*? 表示前后可以有任意字符。

常见误解

以为 Fabric 的账本都能这样查 → 富查询只在世界状态用 CouchDB 时可用。Fabric 默认的 LevelDB 只支持按键和按键范围查。

试一下:Task 3 加进来的 “testing” 会出现在「只看未完成」的结果里吗?

答案

按道理不会。富查询查的是 CouchDB 里真实存着的文档,“testing” 是查询全部产品时临时拼的,库里没有它。

回讲义:L07b-1 Chaincode:用 Go 写合约,Submit 和 Evaluate 怎么选

4. 区块浏览器里看什么

人话定义:它让你看见「交易真的进了区块」。Explorer 以组织管理员的身份连上 peer,把区块、交易、节点、链码列成网页。

例子:课件截图的主页显示 7 个区块、7 笔交易、2 个节点、1 个链码,channel 叫 mychannel。新建一个产品后刷新,区块数和交易数各加 1。点进那笔交易,能看到调用的链码、发起者所属组织和读写集。

常见误解

以为打开详情页、搜索也会让数字涨 → 只读查询不产生交易,数字不变。

试一下:新建产品那笔交易的写集里有几个键?

答案

两个:新产品自己的键,以及计数器 MaxProductId。

回讲义:L06b Fabric(二):一本账拆成「现在是什么」和「怎么变成这样」

逐题拆解

下面写着「等价环境实测」的结果,来自 Fabric 2.5 官方测试网络(两个组织、CouchDB)加同源链码和同源前端跑出来的结果。它的 Fabric 版本比课程虚拟机新,前端界面文字也被改过,和虚拟机有出入时以虚拟机为准。

Task 4:启动网页前端

在 fabcomp/javascript/myapp 下依次运行 npm install 和 npm start,再用 Chrome 打开 http://localhost:3000。首页有一张新建产品卡片,加上每个产品一张卡。网络要先按 Lab2a 启动好,否则前端连不上链。

Task 5:详情页签字

点 Macbook Pro 的 DETAILED VIEW,在 Pick a User 选 manager1,点 SIGN。页面变成上面那张图。

题目问换其他角色签字报什么错。按同源代码的签字函数,有三道关卡。三种报错都已在等价环境的网页上实测复现:

谁去签 报错 原因
creator1 或 admin User cannot sign product 证书里没有签字属性
上限不够的 Manager User does not have rights to sign. 上限不大于当前阶段
任何 Manager 签已签满的产品 Cannot be signed. 阶段已等于最大阶段

题目问的是其他角色,答第一行:User cannot sign product。网页上的报错前面会带一段 SDK 包装文字,形如 Error: No valid responses from any peers. Errors: ... message=User cannot sign product,关键是末尾这句。签满之后,详情页的签字表单就不再显示了。

一步一步看

目标:让 manager1 和 creator1 轮流签 Macbook Pro,看出签字会在哪里被拦:证书缺签字属性,或者产品已经签满。

拿 Macbook Pro(最大阶段 3)把三道关卡各撞一次。签字人是 manager1(上限 3)和 creator1。

  1. manager1 点 SIGN。上限 3 大于阶段 0,签成,Status 变 1,签字记录写 Stage 0。

    签字状态表第 1 帧:manager1 签字后 Status 从 0 变 1,Signatures 记下 Stage 0,未签满,Status 一格被标出

  2. 换 creator1 点 SIGN。证书里没有签字属性,报 User cannot sign product,状态不变,也不上链。

    签字状态表第 2 帧:creator1 签字被拒,报错 User cannot sign product,Status 仍为 1,结果一格被标出

  3. manager1 再签两次。Status 到 3,记录是 Stage 0、1、2,产品签满,表单消失。

    签字状态表第 3 帧:manager1 再签两次后 Status 到 3,三条签字记录 Stage 0、1、2,签满一格被标出

  4. 从命令行让 manager1 再签。阶段已等于最大阶段,报 Cannot be signed.。

    签字状态表第 4 帧:产品已签满时 manager1 从命令行再签,报错 Cannot be signed,结果一格被标出

Task 6:新建产品

首页点 ADD NEW PRODUCT,填 Razer Ornata、Chinese Traditional Keyboard、签名数 3,用户选 creator1,点 CREATE。几秒后跳回首页,多出一张卡,Status 0。这几秒就是一笔写交易走完背书、排序、提交的时间。用户选 admin 或 manager1 会被拒绝,报 User does not have right to perform this action.,不产生区块。

Task 7:只看未完成

点 SHOW INCOMPLETE ONLY,只剩还没签满的产品,按钮变成 SHOW ALL。背后是链码 getIncompleteProducts 的富查询,前端对应 routes/index.js 和 views/index.hbs。

Task 8:搜索

搜索框输入 Mac 回车,只剩 Macbook Pro。同源代码的查询语句:

query = fmt.Sprintf("{\"selector\":{\"name\": {\"$regex\":\"(?i)^.*?%s.*?$\"}}}", keyword)

题目要求改成名称或描述里含关键词都算。用 CouchDB 的 $or 把两个条件并起来,%s 出现两次,keyword 也要传两次:

query = fmt.Sprintf("{\"selector\":{\"$or\":[{\"name\":{\"$regex\":\"(?i)^.*?%s.*?$\"}},{\"description\":{\"$regex\":\"(?i)^.*?%s.*?$\"}}]}}", keyword, keyword)

字段名写小写。存进 CouchDB 的 JSON 字段叫 name、description,写成大写一条都搜不到。改完要 go build,再按 Lab2a 的规则升级链码,否则 peer 跑的还是旧代码。

验证方法:搜 laptop。改之前什么都搜不到,改之后 Macbook Pro 出现,因为它的描述是 Laptop。等价环境实测,改之后 LAPTOP 也能搜到,keyboard 能搜出 Razer Ornata。每升级一次链码,区块数加 3:两个组织各批准一次,再提交一次定义。

一步一步看

目标:对照三个产品的 name 和 description 搜两个词,看出改成 $or 查询后描述里的词也能搜到,而且不分大小写。

账本里有三个产品,逐个对照 name 和 description 两栏,看改查询前后谁会被搜到。

  1. 原查询只比 name,搜 laptop。三个名字里都没有这个词,结果为空。

    搜索对照表第 1 帧:原查询只比 name,搜 laptop 时三个产品都不命中,Macbook Pro 的命中一格被标出

  2. 换成 $or 并升级链码,再搜 laptop。Macbook Pro 的描述是 Laptop,命中。

    搜索对照表第 2 帧:改成 $or 后搜 laptop,Macbook Pro 因描述 Laptop 命中,其余两个不命中,命中一格被标出

  3. 同一条查询搜 keyboard。Razer Ornata 的描述含 Keyboard,(?i) 让大小写不影响,命中。

    搜索对照表第 3 帧:$or 查询搜 keyboard,Razer Ornata 因描述含 Keyboard 命中,命中一格被标出

Task 9:区块浏览器

操作步骤:

  1. 进入 Explorer 的 postgreSQL/db 目录,运行 sudo -u postgres ./createdb.sh 建数据库。
  2. 打开 Org1 管理员证书目录下的 keystore 文件夹,复制私钥文件的文件名。
  3. 把文件名接到连接配置 first-network.json 里 adminPrivateKey 的路径末尾。
  4. 回到 blockchain-explorer 目录运行 ./start.sh,打开 http://localhost:8080,用课件给的账号登录。

Explorer 要以管理员身份读区块,所以需要私钥。私钥文件名是生成证书时随机起的,每次重建网络都会变。

最后的练习:先记下主页的区块数和交易数,到网页上新建一个产品,再刷新 Explorer。两个数字各加 1,点进最新区块和那笔交易,对照它的读写集。

课件里的坑

  • [读图提醒] 做完 Task 3 后查询会多一条 “testing”,p.12 的首页截图里没有这张空白卡片。等价环境里首页确实多出这张空卡,不算做错(p.12)。
  • [读图提醒] p.12–13 的截图写着 “Added by: creater1”,是截图里的拼写,注册的名字是 creator1(p.12、p.13)。
  • [读图提醒] p.15–16 的 Fig.13、Fig.14 用的是另一套数据(Razer Naga、iPad Pro 等),界面也多了搜索框,和前面的截图对不上。按你自己的数据核对(p.15、p.16)。
  • [课件有误] p.16 的题目说按 “Name” 或 “Description” 搜。那是 Go 代码里的字段名,CouchDB 里存的是小写 name、description(p.16)。
  • [补充核验] 富查询的结果在提交阶段不会被重新验证,适合用在只读查询里,不宜拿来决定写什么。关键词直接拼进字符串,带引号会破坏 JSON。等价环境实测,搜索框里输入一个双引号,CouchDB 报格式错误,同源网页服务没接住这个错误,直接退出,要重新启动(p.16)。
  • [补充] p.18 截图的 7 个区块从哪来,课件没说。一种对得上的拆法:创世区块、两个组织各设锚节点、各批准一次链码、提交链码定义、初始化写入测试产品。等价环境里网络起好、链码部署并初始化后,区块高度正好是 7。配置和链码部署本身也是交易(p.18)。

课后 10 分钟:考点复习

这 10 分钟怎么用:合上页面,先默写签字的三种报错和各自原因、$or 那条查询语句;再把下面的完整例题一步步推完,每一步的页面变化和 Explorer 数字先自己写出来;最后回查两个最容易错的地方:签字失败不上链、字段名写小写。

必背

  1. 网页前端的调用链:浏览器 → Node.js 网页服务(Fabric SDK)→ peer 上的链码 → CouchDB 世界状态
  2. Manager 签字就是发一笔把阶段加 1 的交易;签名记录的是签字前的阶段
  3. 非 Manager 签字报 User cannot sign product;权限检查发生在背书阶段,失败的签字拿不到背书、不进账本
  4. GetStateByRange 按键范围取;GetQueryResult 做 CouchDB 富查询、按字段内容筛选,LevelDB 不支持富查询
  5. 按名称或描述搜索用 $or 合并两个 $regex 条件,字段名写小写 name、description
  6. 写操作(新建、签字)每次产生一笔交易,Explorer 的区块数和交易数随之增加;只读查询不产生交易

完整例题

账本里有三个产品,最大阶段都是 3,当前阶段都是 0:Test Product、Macbook Pro(描述 Laptop)、Razer Ornata(描述 Chinese Traditional Keyboard)。manager1 的签字上限为 3。此刻 Explorer 显示 10 个区块、10 笔交易,假设每笔交易单独成一个区块。依次操作:(1)manager1 给 Macbook Pro 连签三次;(2)manager1 再签第四次;(3)creator1 去签 Razer Ornata;(4)点 SHOW INCOMPLETE ONLY;(5)用原版搜索函数搜 keyboard,再用改过的 $or 版搜一次。问每一步的结果,以及最后 Explorer 的数字。

  1. 第 1 步:三次都通过。阶段 0→1→2→3,到 3 时标记完成。签名记录三条,Stage 依次是 0、1、2。产生 3 笔交易。
  2. 第 2 步:阶段已等于最大阶段,返回 Cannot be signed.。拿不到背书,不产生交易。
  3. 第 3 步:creator1 证书没有签字属性,返回 User cannot sign product,同样不产生交易。
  4. 第 4 步:只剩 Test Product 和 Razer Ornata,Macbook Pro 已完成被筛掉。
  5. 第 5 步:原版只看名称,Razer Ornata 的名字里没有 keyboard,搜不到。$or 版同时看描述,且不分大小写,搜出 Razer Ornata。
  6. Explorer:只有第 1 步的 3 笔签字是写交易,筛选和搜索都是只读。最后是 13 个区块、13 笔交易。

变式题

(一)用上限为 2 的 manager2 去签一个当前阶段为 2 的产品,报什么错?(二)把 $or 版查询里的 keyword, keyword 写成只传一个 keyword,搜索会怎样?(三)manager1 和 manager2 几乎同时给同一个阶段为 0 的产品签字,两笔都拿到了背书。最后产品阶段是几?Explorer 里会看到几笔交易?

提示

(一)对照签字的三道关卡,看它卡在哪一道。(二)格式串里有两个 %s,参数只给一个时,第二个位置填什么?(三)回想 L06d:提交时要核对读集里的版本号,两笔读到的是同一个版本。

参考答案与自检(非官方评分标准)

自检要点:① 判断出卡在「上限不大于当前阶段」那道;② 说出第二个占位符没被填上;③ 说出后一笔版本对不上被判无效,但仍留在区块里。

(一) 产品阶段 2 小于最大阶段 3,过了第一道;上限 2 不大于当前阶段 2,报 User does not have rights to sign.。

(二) Go 的 Sprintf 会把第二个 %s 换成 %!s(MISSING) 这串字符。描述那一半的条件变成匹配一串怪字符,几乎搜不到东西,结果退化成只按名称搜。这个错 go build 不报,go vet 会报,改完先跑一次能提前发现。等价环境实测,这版链码照样能部署,搜索也不报错,只是描述匹配不生效。

(三) 两笔背书时读到的都是版本相同的产品。排序后先提交的那笔有效,阶段变成 1,版本随之更新。后一笔读到的版本已过期,被判无效,写集不生效。最终阶段是 1,Explorer 里能看到两笔交易,其中一笔标为无效。等价环境实测,两笔被排进同一个区块,有效那笔验证码 0,无效那笔标 MVCC_READ_CONFLICT(验证码 11),签名记录里只剩先排的那个 Manager。

闪卡自测

详情页的网址 /products/2 里的 2 是什么?产品在账本里的键。
creator1 去签字报什么错?User cannot sign product:它的证书里没有签字属性。
签字失败会在 Explorer 里多出一笔交易吗?不会。背书阶段就失败了,交易到不了排序服务。
签字后的签名记录为什么写 Stage 0 而不是 1?记录的是签字前的阶段,表示「批准了第 0 阶段」。
世界状态换成 LevelDB,「只看未完成」还能用吗?不能。它靠 CouchDB 富查询,LevelDB 只支持按键和按键范围查。
改完搜索函数后,为什么网页搜索结果没变?大概率是没升级链码,peer 还在跑旧代码;先 go build,再把 sequence 加 1 重新部署。
Explorer 为什么要你复制管理员私钥的文件名?它要以组织管理员身份连 peer 读区块;私钥文件名每次重建网络都随机生成,只能手动填。

下一步

先照完整例题在网页上点一遍,每一步都回 Explorer 看数字有没有按你推的变。然后把 $or 版搜索改进链码、升级、用 laptop 验证。有余力就做变式题(三):开两个浏览器窗口,用两个 Manager 几乎同时给同一个产品签字,在 Explorer 里找那笔被判无效的交易,对照 L06d 的版本号验证规则。Lab 3 的主题仍是 Hyperledger Fabric,这一套前后端到时还用得上的可能性很大,虚拟机里的改动先别清。

下一讲 →
L07a-1 L07a-1 数字证书:网络上怎么证明「这把公钥是我的」

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