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. Khởi tạo Hierarchy Manager (Quản lý các chuỗi)
manager = HierarchyManager()

# 2. Tạo một sub-chain cho domain cụ thể (ví dụ: chuỗi cung ứng)
# Tham số: tên chuỗi, loại domain (generic, v.v.)
manager.create_sub_chain("supply_chain", "generic")

# 3. Ghi nhận một hoạt động nghiệp vụ (Event) vào Sub-Chain
# Tham số: tên chuỗi, ID thực thể, loại sự kiện, dữ liệu chi tiết
success = manager.start_operation(
    "supply_chain", 
    "PROD-100", 
    "production_start", 
    {"location": "Factory-A", "operator": "user_01"}
)

# 4. Neo bằng chứng (Proof) từ Sub-Chain lên Main Chain
# Điều này giúp bảo chứng tính toàn vẹn của Sub-Chain trên Main Chain
proof_success = manager.submit_proof_to_main_chain("supply_chain")

print(f"Ghi sự kiện: {'Thành công' if success else 'Thất bại'}")
print(f"Neo Proof: {'Thành công' if proof_success else 'Thất bại'}")

Dùng CLI (tuỳ chọn)

hrc --help

Bước tiếp theo