# fabric

**Repository Path**: hyperledger-fabric-gm/fabric

## Basic Information

- **Project Name**: fabric
- **Description**: 区块链二进制
- **Primary Language**: Go
- **License**: Apache-2.0
- **Default Branch**: v1.4.9
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2021-07-22
- **Last Updated**: 2021-08-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<h1 align="center">
  <br>
  Hyperledger Fabric 国密版
  <br>
  <p align="center">
    <a herf="https://ci.blockchain.thoughtworks.cn/blue/organizations/jenkins/fabric-gm%2Ffabric-core/activity/">
      <img src="https://ci.blockchain.thoughtworks.cn/buildStatus/icon?job=fabric-gm%2Ffabric-core" alt="Build Status">
    </a>
    <img src="https://img.shields.io/badge/contributions-welcome-orange.svg" alt="Contributions welcome">
    <img src="https://img.shields.io/badge/Fabric-1.4-blue" alt="Fabric 1.4">
    <img src="https://img.shields.io/badge/GM-enable-green" alt="gm tls enable">
  </p>
</h1>
<h4 align="center">本项目是 Hyperledger Fabric 的国密支持版本。</h4>

## 简介

### 本项目的优势
本项目涵盖 Fabric、Fabric CA 以及 Fabric SDK 的全链路国密改造，主要包括以下功能点：
* 国密 CA 生成和签发

* 应用数据国密加密/签名/解密

* 国密 TLS 的 GRPCS 和 HTTPS 通讯

* 国密密码机的集成（阿里云 KMS 服务）

* 代码修改使用非侵入式的修改，与 Fabric 官方仓库合并更容易

* 支持 Jenkins CI

  

⚠️ 注意

- ​	cryptogen 默认生成非国密的 ecdsa 签名的证书，如果需要生成国密证书，需要加上 --gm 参数，比如

   	`cryptogen generate --gm`

  

- ​	交易 ID 的计算还是原版的 SHA256，并未改为 GMSM3

  ​	对应 fabric 具体的位置在 ComputeTxID 函数中

  ​	对应 go-sdk 具体的位置在 NewHeader 函数中	

  

### 什么是 Hyperledger Fabric？

Hyperledger Fabric 是用于开发解决方案和应用程序的企业级许可分布式分类账本框架，可以去[官网](https://www.hyperledger.org/use/fabric)了解更多。



### 什么是国密(GM)？
国密(GM)算法是[国家密码管理局](https://www.oscca.gov.cn/)发布的、符合[《密码法》](http://www.npc.gov.cn/npc/c30834/201910/6f7be7dd5ae5459a8de8baf36296bc74.shtml)中规定的商用密码的一套密码标准规范。



## 依赖与关联

### 依赖
* 国密实现库：[基于同济 Golang 国密实现库](https://github.com/Hyperledger-TWGC/tjfoc-gm)

### 关联代码库
本代码库为 Fabric Core 的国密化版本，Fabric的其他部分国密化改造如下：
* [国密化 CA](https://gitee.com/hyperledger-fabric-gm/fabric-ca)
* [国密化 Samples](https://gitee.com/hyperledger-fabric-gm/fabric-samples)
* [国密化 SDK](https://gitee.com/hyperledger-fabric-gm/fabric-sdk-go)

## 如何使用
与官方 Fabric 1.4 一致，参考[ Fabric 官方文档](https://wiki.hyperledger.org/display/fabric)。

### 常用命令
* `make native`进行编译

* `make docker`打包 docker 镜像

### 使用镜像

本项目使用[ CI ](https://ci.blockchain.thoughtworks.cn/blue/organizations/jenkins/fabric-gm%2Ffabric-core/activity/)持续编译并测试，并将镜像发表在 dockerhub，可使用镜像：

* [twblockchain/fabric-peer](https://hub.docker.com/r/twblockchain/fabric-peer)
* [twblockchain/fabric-orderer](https://hub.docker.com/r/twblockchain/fabric-orderer)
* [twblockchain/fabric-tools](https://hub.docker.com/r/twblockchain/fabric-tools)
* [twblockchain/fabric-ccenv](https://hub.docker.com/r/twblockchain/fabric-ccenv)

## 关于我们
国密化改造工作主要由 ThoughtWorks 区块链团队完成，想要了解更多/商业合作/联系我们，欢迎访问我们的[官网](https://blockchain.thoughtworks.cn/)。