Bỏ qua

Bắt đầu nhanh

Tài liệu này tóm tắt các bước tối thiểu để bạn chạy thử HieraChain.

Cài đặt nhanh

Để bắt đầu nhanh nhất, cài đặt HieraChain với tất cả dependencies (bao gồm dev) bằng một trong hai cách:

# Cách 1: Sử dụng uv (khuyên dùng - nhanh nhất)
uv sync

# Cách 2: Sử dụng pip
pip install -e .

Lưu ý: Để biết thêm chi tiết về cài đặt, xem Cài đặt chi tiết.

Khởi động API server

Sau khi cài đặt, bạn có thể khởi chạy server bằng lệnh:

python -m hierachain.api.server

Hoặc sử dụng CLI (nếu đã cài đặt qua pip):

hrc server start

Mặc định server phục vụ tại http://localhost:2661. Mở http://localhost:2661/docs để xem tài liệu OpenAPI và thử endpoint.

Sử dụng nhanh trong Python

Ví dụ tối thiểu bên dưới minh họa cách tạo một Sub-Chain, ghi nhận sự kiện, và gửi bằng chứng lên Main Chain.

from hierachain.hierarchical.hierarchy_manager import HierarchyManager

# 1. Initialize Hierarchy Manager
manager = HierarchyManager()

# 2. Create a sub-chain for a specific domain (e.g., supply chain)
manager.create_sub_chain("supply_chain", "generic")

# 3. Record a business operation (Event) into the Sub-Chain
success = manager.start_operation(
    "supply_chain", 
    "PROD-100", 
    "production_start", 
    {"location": "Factory-A", "operator": "user_01"}
)

# 4. Anchor Proof from Sub-Chain to Main Chain
proof_success = manager.submit_proof_to_main_chain("supply_chain")

print(f"Event recorded: {'Success' if success else 'Failure'}")
print(f"Proof anchored: {'Success' if proof_success else 'Failure'}")

Dùng CLI (tuỳ chọn)

hrc --help

Bước tiếp theo