如何在Oracle平台的HyperLedger Fabric中上传证书文件？

HyperLedger Fabric本身不适合直接存储PDF这类大文件，核心思路是将证书的哈希值存上链，证书文件本身存在链下共享存储，既保证证书的不可篡改性，又兼顾存储效率。以下是具体实现步骤：

1. 预处理证书文件 #

先计算PDF证书的唯一哈希值（推荐用SHA-256算法），这个哈希会作为证书的“指纹”存到链上。
执行命令生成哈希：

sha256sum duck-health-cert.pdf

得到类似a1b2c3d4...的哈希字符串，后续会用到。

2. 编写链码（智能合约） #

在链码中定义存储证书哈希的数据结构，并实现上传、查询功能，同时加入权限控制确保只有养鸭场组织能上传。

示例Go语言链码片段：

package main

import (
    "encoding/json"
    "fmt"
    "time"

    "github.com/hyperledger/fabric-contract-api-go/contractapi"
)

type DuckCert struct {
    DuckId       string `json:"duckId"`    // 对应鸭肉的唯一标识
    CertHash     string `json:"certHash"`  // 证书PDF的SHA-256哈希
    UploadOrg    string `json:"uploadOrg"` // 上传证书的组织（养鸭场MSPID）
    Timestamp    string `json:"timestamp"` // 上传时间戳
}

type SmartContract struct {
    contractapi.Contract
}

// UploadCertHash 上传证书哈希到链上，仅养鸭场组织可调用
func (t *SmartContract) UploadCertHash(ctx contractapi.TransactionContextInterface, duckId string, certHash string) error {
    // 获取调用方的组织MSPID
    uploadOrg, err := ctx.GetClientIdentity().GetMSPID()
    if err != nil {
        return fmt.Errorf("failed to get client MSPID: %v", err)
    }
    // 验证调用方是否为养鸭场组织（需替换为实际的养鸭场MSPID）
    if uploadOrg != "DuckFarmMSP" {
        return fmt.Errorf("only DuckFarm organization can upload certificates")
    }
    // 获取交易时间戳
    timestamp := time.Now().Format(time.RFC3339)
    // 构造证书数据
    cert := DuckCert{
        DuckId:       duckId,
        CertHash:     certHash,
        UploadOrg:    uploadOrg,
        Timestamp:    timestamp,
    }
    // 序列化为JSON
    certBytes, err := json.Marshal(cert)
    if err != nil {
        return fmt.Errorf("failed to marshal cert data: %v", err)
    }
    // 存到账本
    return ctx.GetStub().PutState(duckId, certBytes)
}

// QueryCertByDuckId 根据鸭肉ID查询证书哈希
func (t *SmartContract) QueryCertByDuckId(ctx contractapi.TransactionContextInterface, duckId string) (*DuckCert, error) {
    certBytes, err := ctx.GetStub().GetState(duckId)
    if err != nil {
        return nil, fmt.Errorf("failed to read from world state: %v", err)
    }
    if certBytes == nil {
        return nil, fmt.Errorf("no certificate found for duck ID %s", duckId)
    }
    var cert DuckCert
    err = json.Unmarshal(certBytes, &cert)
    if err != nil {
        return nil, fmt.Errorf("failed to unmarshal cert data: %v", err)
    }
    return &cert, nil
}

func main() {
    chaincode, err := contractapi.NewChaincode(&SmartContract{})
    if err != nil {
        fmt.Printf("Error creating duck cert chaincode: %v\n", err)
        return
    }
    if err := chaincode.Start(); err != nil {
        fmt.Printf("Error starting duck cert chaincode: %v\n", err)
    }
}

3. 链下存储证书文件 #

将PDF证书存到所有参与方（养鸭场、客户组织）都能访问的共享存储中：

• 若用Oracle平台，可选择OCI对象存储，设置桶的访问策略：允许养鸭场上传，客户组织仅能下载。
• 也可使用组织间共享的分布式文件系统，确保文件的可用性和访问控制。

4. 证书验证流程 #

消费者（客户组织）验证鸭肉健康时：

1. 通过链码的QueryCertByDuckId函数，根据鸭肉ID获取链上的证书哈希。
2. 从链下存储下载对应的PDF证书。
3. 自行计算下载文件的SHA-256哈希，与链上的哈希对比：
   • 若一致，说明证书未被篡改，鸭肉合格；
   • 若不一致，说明证书可能被修改，存在风险。

关键注意事项 #

• 禁止直接将PDF存链上：链上存储成本高，会导致账本体积快速膨胀，影响Fabric的性能。
• 严格权限控制：链码中必须限制只有养鸭场能上传证书，防止恶意组织篡改数据。
• 链下存储需加密：对PDF证书进行加密存储，仅授权方能解密访问，保障数据隐私。

内容的提问来源于stack exchange，提问作者Jane