Skip to content

Latest commit

 

History

History
132 lines (98 loc) · 3.87 KB

README.md

File metadata and controls

132 lines (98 loc) · 3.87 KB

Hetu Checkpoint

Hetu Checkpoint is a secure and efficient checkpointing system that leverages Byzantine Consistent Broadcast (BCB) and BLS signatures to prevent long-range attacks on blockchain networks.

Overview

Hetu Checkpoint creates secure checkpoints for multiple blocks using a network of validators.
These checkpoints are then anchored to Ethereum, providing an additional layer of security and finality.

Key Features

  • Epoch-based Checkpointing: Divides blockchain into epochs with fixed validator sets
  • BCB Integration: Secure Byzantine Consistent Broadcast for validator coordination
  • BLS Signatures: Efficient aggregated signatures for checkpoint creation
  • Ethereum Anchoring: Checkpoint hashes are recorded on Ethereum
  • Long-range Attack Prevention: Enhanced security through periodic checkpointing

Architecture

Epoch Structure

+--------+--------+--------+--------+
|Block 1 |Block 2 |  ...   |Block N | => Checkpoint Hash => BLS Signatures
+--------+--------+--------+--------+                             |
               |                                                  V
        Hetu Chain Epoch N                                        L1

System Components

  • Validator Network: Distributed network of validators Consensus on checkpoint generation BLS signature aggregation
  • BCB Algorithm: Efficient consistency Broadcast Validator coordination Threshold signature scheme
  • Checkpoint Generation: Aggregates multiple blocks Creates unified checkpoint hash BLS signature verification
  • Ethereum Bridge: Submits checkpoint hashes to Ethereum Provides immutable checkpoint records Enables cross-chain verification

Technical and Security

  • Epoch Configuration: Fixed number of blocks per epoch Consistent validator set within each epoch Configurable epoch parameters
  • BLS Signatures: Efficient signature aggregation Reduced communication overhead Strong cryptographic security
  • BCB Protocol: Byzantine Consistent Broadcast ensures that all honest validators agree on the same checkpoint data, providing a distributed trust model with no single point of failure and threshold-based security.

Building and Running

Prerequisites

  • Go go1.23 or higher
  • Make
  • Docker (optional)

Build from Source

# Build all components
make build

# Build individual components
make build-dispatcher
make build-validator

Running the System

  1. Start the dispatcher first:
# generate key
./build/dispatcher generate-key --output=keys/dispatcher.json

# run a node
./build/dispatcher run --config docs/config/dis_config.yaml --keys=keys/dispatcher.json --log-level=info
  1. Start the validator(s):
# generate key
./build/validator generate-key --output=keys/validator.json

# regist and stake
./build/validator register-and-stake  --config docs/config/val_config.json  --keys keys/validator.json  --amount 500

# run a node
./build/validator --config docs/config/val_config.yaml

Running the Muti-Node

chmod +x ./scripts/start.sh ./scripts/stop.sh
  • Usage examples:
# Start with default 1 validator
./start.sh

# Start with 3 validators
./start.sh -n 3

# Start with custom config directory (Native)
./scripts/start.sh -n 3 -c docs/config -b build -k keys

# Start with custom config directory (docker-compose)
./scripts/start.sh -n 3 -c docs/config -b build -k keys -d

# Stop all processes
./stop.sh

Docker Support

Build and run using Docker:

# Build Docker images
docker-compose build

# Start the system
docker-compose up -d dispatcher
docker-compose up -d validator

Development Setup

# Install dependencies
make deps

# Run tests
make test

# Clean build artifacts
make clean

Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

License

See the LICENSE file for details.