千家信息网

Fabric Node SDK中CouchDB钱包怎么用

发表于:2024-11-21 作者:千家信息网编辑
千家信息网最后更新 2024年11月21日,这篇文章将为大家详细讲解有关Fabric Node SDK中CouchDB钱包怎么用,小编觉得挺实用的,因此分享给大家做个参考,希望大家阅读完这篇文章后可以有所收获。1、Hyperledger Fab
千家信息网最后更新 2024年11月21日Fabric Node SDK中CouchDB钱包怎么用

这篇文章将为大家详细讲解有关Fabric Node SDK中CouchDB钱包怎么用,小编觉得挺实用的,因此分享给大家做个参考,希望大家阅读完这篇文章后可以有所收获。

1、Hyperledger Fabric钱包的类型

有三种类型的钱包:文件系统钱包、内存钱包和CouchDB钱包。

文件系统钱包

文件系统钱包就是一个简单的文件夹,在大多数情况下这是不错的默认选择。在fabric-samples/balance-transfer示例中,使用的就是文件系统钱包。当你运行这个示例代码时,它就会创建一个fabric-client-kv-orgName文件夹并在其中保存所有需要的Fabric身份资料。该配置定义可以参考orgname.yaml

内存钱包

顾名思义,内存钱包就是暂存在应用内存中的钱包。当运行在受限环境中或不需要访问文件系统时可以使用这种钱包,例如在浏览器中。需要提醒的是,这种钱包中的身份资料在应用终止后就没有了。内存钱包的具体文档可以查看这里。

CouchDB钱包

也就是使用CouchDB保存身份资料,在生产环境中这是最常见的选择。

2、Hyperledger Fabric CouchDB钱包

钱包使用两个库来保存证书和私钥:

状态库

状态库用于保存已登记身份的证书,它存储的是一个身份的基本信息:

{  "name": "test",  "mspid": "org1",  "roles": null,  "affiliation": "",  "enrollmentSecret": "",  "enrollment": {    "signingIdentity": "",    "identity": {      "certificate": ""    }  }}

注意:signingIdentity指向私钥和公钥在密码学资料库中的保存地址。

密码学资料库

密码学资料库用于保存身份的私钥和公钥。

3、在Hyperledger Fabric应用中启用CouchDB钱包

首先引入Fabric Node SDK提供的CouchDBKeyValueStore库:

const CDBKVS = require("fabric-client/lib/impl/CouchDBKeyValueStore.js");

然后设置状态库:

let stateStore = await new CDBKVS({  url: "https://:@",  name: ""});const Client = require("fabric-client");const client = Client.loadFromConfig("path of network.yaml");client.setStateStore(stateStore);

其中:

  • < USERNAME>:couchdb的用户名

  • < PASSWORD>:couchdb的密码

  • < URL>:couchdb的URL

  • < DB_NAME>:可选,状态库名。默认的名称为userdb,当指定的状态库 不存在时Fabric Node SDK会自动创建该库

最后设置密码学资料库:

const cryptoSuite = Client.newCryptoSuite();let cryptoKS = Client.newCryptoKeyStore(CDBKVS, {  url: "https://:@",  name: ""});cryptoSuite.setCryptoKeyStore(cryptoKS);client.setCryptoSuite(cryptoSuite);

4、在Balance Transfer示例中使用CouchDB钱包

Balance Transfer是Hyperledger Fabric官方提供的一个示例代码。

首先按照示例说明启动balance transfer网络,该网络包含:

  • 2个CA

  • 1个SOLO排序节点

  • 2个机构共4个对等节点

启动couchdb的docker镜像:

~$ docker run --name couch-userdb -e COUCHDB_USER=admin \                       -e COUCHDB_PASSWORD=password -p 5984:5984 -d couchdb

上面的命令会自动拉取docker hub上的couchdb镜像。

其中CouchDB详情如下:

  • 容器名称: couch-userdb

  • CouchDB用户名:admin

  • CouchDB密码:password

  • URL:localhost:5984

CouchDB连接URL如下:

https://:@ https://admin:password@localhost:5984

然后更新balance-transfer示例中的client配置:打开文件/helper.js,更新其中的getClientForOrg函数:

'use strict';var log4js = require('log4js');var logger = log4js.getLogger('Helper');logger.setLevel('DEBUG');var path = require('path');var util = require('util');var hfc = require('fabric-client');hfc.setLogger(logger);// couchDB config const CDBKVS = require("fabric-client/lib/impl/CouchDBKeyValueStore.js");async function getClientForOrg(userorg, username) {    logger.debug('getClientForOrg - ****** START %s %s', userorg, username)    // get a fabric client loaded with a connection profile for this org    let config = '-connection-profile-path';    // build a client context and load it with a connection profile    // lets only load the network settings and save the client for later    let client = hfc.loadFromConfig(hfc.getConfigSetting('network' + config));    // This will load a connection profile over the top of the current one one    // since the first one did not have a client section and the following one does    // nothing will actually be replaced.    // This will also set an admin identity because the organization defined in the    // client section has one defined    client.loadFromConfig(hfc.getConfigSetting(userorg + config));        //********************** CouchDB configuration **************************************    // set the state store    let stateStore = await new CDBKVS({        url: "https://:@",        name: ""    });    client.setStateStore(stateStore);    // set the cryto store    const cryptoSuite = hfc.newCryptoSuite();    let cryptoKS = hfc.newCryptoKeyStore(CDBKVS, {        url: "https://:@",        name: ""    });    cryptoSuite.setCryptoKeyStore(cryptoKS);    client.setCryptoSuite(cryptoSuite);        //********************** CouchDB configuration END **************************************        if (username) {        let user = await client.getUserContext(username, true);        if (!user) {            throw new Error(util.format('User was not found :', username));        } else {            logger.debug('User %s was found to be registered and enrolled', username);        }    }    logger.debug('getClientForOrg - ****** END %s %s \n\n', userorg, username)    return client;}

我们的修改如下:

  • 13行:Import the CouchDBKeyValueStore....

  • 31-52行: 设置状态库和密码学资料库

在上面的代码中还有一个小改动:

// Client variable is used as hfcvar hfc = require("fabric-client");// Instead of Clientconst Client = require("fabric-client");

然后在balance transfer中注册一个新的用户,一旦注册成功,就可以使用couchdb的api查看状态库和密码学资料库了。

例如,可以使用下面的参数注册一个用户。对于org1,我们使用同一个库org1db用于状态库和密码学资料库:

  • Name: alice

  • Org: org1

  • DBNAME: org1db

  • CouchDB URL: http://admin:password@localhost:5369

打开浏览器访问http://localhost:5369/org1db/_all_docs,可以看到 在org1db中保存的所有文档。

其中0#、1#、2#是admin的证书。

3#是alice保存在状态库中的证书

4#和5#是alice保存在密码学资料库中的公钥和私钥

访问http://localhost:5369/org1db/alice,可以看到alice在状态库中的全部细节:

查看signingIdentity

"signingIdentity":"d37a97a8c2377c21537801ec1a929d81905ae57963a2f6c8ba0308931a7fc791"

现在查看上图中的4#和5#,可以看到是一样的。

可能你还记得,signingIdentity字段是指向保存在密码学资料库中的私钥和公钥的。

关于"Fabric Node SDK中CouchDB钱包怎么用"这篇文章就分享到这里了,希望以上内容可以对大家有一定的帮助,使各位可以学到更多知识,如果觉得文章不错,请把它分享出去让更多的人看到。

0