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 阶段」。
常见误解
以为签字失败也会在链上留一笔无效交易 → 权限检查在背书者试算时就做了,查不过拿不到背书,交易到不了排序服务。
试一下:一个最大阶段为 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。
-
manager1 点 SIGN。上限 3 大于阶段 0,签成,Status 变 1,签字记录写 Stage 0。
-
换 creator1 点 SIGN。证书里没有签字属性,报
User cannot sign product,状态不变,也不上链。 -
manager1 再签两次。Status 到 3,记录是 Stage 0、1、2,产品签满,表单消失。
-
从命令行让 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 两栏,看改查询前后谁会被搜到。
-
原查询只比 name,搜 laptop。三个名字里都没有这个词,结果为空。
-
换成
$or并升级链码,再搜 laptop。Macbook Pro 的描述是 Laptop,命中。 -
同一条查询搜 keyboard。Razer Ornata 的描述含 Keyboard,
(?i)让大小写不影响,命中。
Task 9:区块浏览器
操作步骤:
- 进入 Explorer 的
postgreSQL/db目录,运行sudo -u postgres ./createdb.sh建数据库。 - 打开 Org1 管理员证书目录下的
keystore文件夹,复制私钥文件的文件名。 - 把文件名接到连接配置
first-network.json里adminPrivateKey的路径末尾。 - 回到
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 数字先自己写出来;最后回查两个最容易错的地方:签字失败不上链、字段名写小写。
必背
- 网页前端的调用链:浏览器 → Node.js 网页服务(Fabric SDK)→ peer 上的链码 → CouchDB 世界状态
- Manager 签字就是发一笔把阶段加 1 的交易;签名记录的是签字前的阶段
- 非 Manager 签字报 User cannot sign product;权限检查发生在背书阶段,失败的签字拿不到背书、不进账本
- GetStateByRange 按键范围取;GetQueryResult 做 CouchDB 富查询、按字段内容筛选,LevelDB 不支持富查询
- 按名称或描述搜索用 $or 合并两个 $regex 条件,字段名写小写 name、description
- 写操作(新建、签字)每次产生一笔交易,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 步:三次都通过。阶段 0→1→2→3,到 3 时标记完成。签名记录三条,Stage 依次是 0、1、2。产生 3 笔交易。
- 第 2 步:阶段已等于最大阶段,返回
Cannot be signed.。拿不到背书,不产生交易。 - 第 3 步:creator1 证书没有签字属性,返回
User cannot sign product,同样不产生交易。 - 第 4 步:只剩 Test Product 和 Razer Ornata,Macbook Pro 已完成被筛掉。
- 第 5 步:原版只看名称,Razer Ornata 的名字里没有 keyboard,搜不到。
$or版同时看描述,且不分大小写,搜出 Razer Ornata。 - 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,这一套前后端到时还用得上的可能性很大,虚拟机里的改动先别清。
个人整理的学习笔记,不是官方材料;数字与结论以课件和讲师为准。