hyperledger/sawtooth-pbft-engine

Sawtooth PBFT 镜像文档

镜像概述

Sawtooth PBFT是Hyperledger Sawtooth的共识引擎，实现了实用拜占庭容错（Practical Byzantine Fault Tolerance, PBFT）算法。作为基于投票机制的共识协议，它为***网络提供了强安全性和区块最终性，适用于对交易不可逆性和容错能力有严格要求的场景。

核心功能与特性

1. 拜占庭容错

网络在部分节点故障或***行为的情况下，仍能保证活性（liveness）和安全性（safety），前提是网络中连接正常、工作正常且行为诚实的节点比例达到最小值。

2. 非分叉特性

节点提交的区块具有最终性，不同于工作量证明（PoW）或消逝时间证明（PoET）等彩票式共识算法，不存在***分叉风险。

3. 基于领导者机制

由主节点（primary node）负责生成候选区块，从节点（secondary nodes）对主节点生成的区块进行投票。主节点按轮询（循环）顺序更换，确保共识过程的连续性。

4. 通信密集型

节点需通过大量消息交互达成共识、提交区块并维护主节点健康状态，因此对网络通信质量有较高要求。

使用场景与适用范围

• 企业级网络**：适用于**交易、供应链管理、数字资产确权等对安全性和交易最终性有严格要求的场景。
• 封闭管理网络：不支持开放注册，节点的添加和移除需由管理员操作，适合权限可控的私有或联盟链环境。
• 全对等网络架构：要求所有节点必须相互连接（全对等连接），且网络规模至少为4个节点（以满足拜占庭容错条件）。

使用方法与配置说明

基本部署要求

• 网络中至少部署4个节点，以确保拜占庭容错能力。
• 所有节点需配置全对等连接，确保相互通信。
• 节点需由管理员统一管理，通过配置文件或管理接口添加/移除节点。

部署示例

单节点启动（测试环境）

bash
docker run -d \
  --name sawtooth-pbft-node \
  -p 8008:8008 \
  -e SAWTOOTH_PBFT_NODE_ID=node1 \
  -e SAWTOOTH_PBFT_PEERS=node2:8008,node3:8008,node4:8008 \
  docker.xuanyuan.run/hyperledger/sawtooth-pbft:latest

多节点部署（docker-compose示例）

yaml
version: '3'
services:
  node1:
    image: docker.xuanyuan.run/hyperledger/sawtooth-pbft:latest
    ports:
      - "8008:8008"
    environment:
      - SAWTOOTH_PBFT_NODE_ID=node1
      - SAWTOOTH_PBFT_PEERS=node2:8008,node3:8008,node4:8008
    networks:
      - sawtooth-network

  node2:
    image: docker.xuanyuan.run/hyperledger/sawtooth-pbft:latest
    ports:
      - "8009:8008"
    environment:
      - SAWTOOTH_PBFT_NODE_ID=node2
      - SAWTOOTH_PBFT_PEERS=node1:8008,node3:8008,node4:8008
    networks:
      - sawtooth-network

  node3:
    image: docker.xuanyuan.run/hyperledger/sawtooth-pbft:latest
    ports:
      - "8010:8008"
    environment:
      - SAWTOOTH_PBFT_NODE_ID=node3
      - SAWTOOTH_PBFT_PEERS=node1:8008,node2:8008,node4:8008
    networks:
      - sawtooth-network

  node4:
    image: docker.xuanyuan.run/hyperledger/sawtooth-pbft:latest
    ports:
      - "8011:8008"
    environment:
      - SAWTOOTH_PBFT_NODE_ID=node4
      - SAWTOOTH_PBFT_PEERS=node1:8008,node2:8008,node3:8008
    networks:
      - sawtooth-network

networks:
  sawtooth-network:
    driver: bridge

关键配置参数

注意事项

• 生产环境中需确保网络带宽充足，以支持PBFT的通信密集型特性。
• 节点增减需重新配置所有节点的对等列表，并重启网络以确保一致性。
• 节点数量建议为4个或更多，且遵循3f+1规则（f为可容忍的***节点数量）。