Fabric private data入门实战

发表于 | 分类于

Hyperledger Fabric private data是1.2版本引入的新特性，fabric private data是 利用旁支数据库（SideDB）来保存若干个通道成员之间的私有数据，从而在通道之上 又提供了一层更灵活的数据保护机制。本文将介绍如何在链码开发中使用fabric private data。

fabric private data arch

fabric private data用例

我们使用Hyperledger Fabric中经典的fabcar案例来展示如何使用私有数据集。initLedger 函数将在我们的数据集中创建10个新车。所有的这些车辆可以被网络中的任何人查看。现在 让我们创建一个私有数据库，而这个数据将只和我们持有的另一个成员车库共享。

fabric private data数据集配置

我们首先需要一个数据集配置文件collections_config.json，它包含了私有数据集名称和 访问策略。访问策略类似于背书策略，这允许我们使用已经存在的策略逻辑，例如OR、AND等。

1
2
3
4
5
6
7
8
9
[
  {
    "name": "carCollection",
    "policy": "OR ('Org1MSP.member','Org2MSP.member')",
    "requiredPeerCount": 0,
    "maxPeerCount": 3,
    "blockToLive":1000000
  }
]

修改链码以支持fabric private data

下面是原始的createCar函数：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
async createCar(stubHelper: StubHelper, args: string[]) {
      const verifiedArgs = await Helpers.checkArgs<any>(args[0], Yup.object()
          .shape({
              key: Yup.string().required(),
              make: Yup.string().required(),
              model: Yup.string().required(),
              color: Yup.string().required(),
              owner: Yup.string().required(),
          }));

      let car = {
          docType: 'car',
          make: verifiedArgs.make,
          model: verifiedArgs.model,
          color: verifiedArgs.color,
          owner: verifiedArgs.owner
      };

      await stubHelper.putState(verifiedArgs.key, car);
}

要把数据加入私有数据集carCollection，我们需要指定目标数据集：

1
await stubHelper.putState(verifiedArgs.key, car, {privateCollection: 'carCollection'});

接下来，要查询车辆的话，我们也需要指定目标私有数据集：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
async queryPrivateCar(stubHelper: StubHelper, args: string[]) {

      const verifiedArgs = await Helpers.checkArgs<any>(args[0], Yup.object()
          .shape({
              key: Yup.string().required(),
          }));
      const car = await stubHelper.getStateAsObject(verifiedArgs.key, {privateCollection: 'carCollection'});

      if (!car) {
          throw new NotFoundError('Car does not exist');
      }

      return car;
}

同样，对于删除和更新操作，都需要指定要操作的目标私有数据集。

fabric private data链码最佳实践

当然，我们的数据中有一部分是Hyperledger Fabric网络中的任何人都看得到的。但是， 其中某些数据是私有的，并且保存在私有数据集中，因此只能被数据集配置文件中定义 的对等节点访问。

我们建议在公开和私有数据集中使用相同的键来保存数据，以便更易于数据的提取操作。

原文：A Beginner’s Guide to SideDBs and Private Data for Hyperledger Fabric Nodejs Chaincode

汇智网翻译整理，转载请标明出处