Đến nội dung
Tài liệu/Tham chiếu kỹ thuật

Smart contracts & phiên bản

Vai trò contract, commitBatch, markVerified và tương thích ledger.

Trong trang này

Tách trách nhiệm on-chain

Contract dùng AccessControl và ERC-2771. Ví issuer được bind với orgRef; relayer chi trả giao dịch mà không thay đổi danh tính issuer trong lời gọi được forward hợp lệ.

ISSUER_ROLE ghi commitment; VERIFIER_ROLE ghi kết quả xác minh; CHECKPOINT_ROLE ghi checkpoint. Quyền admin quản lý cấu hình và role; không xem các role này như quyền đọc API.

Các thao tác lõi

HàmVai trò
commitBatchGhi các định danh recordRoot; giới hạn theo contract.
markVerifiedRàng buộc commitmentId, recordRoot và receiptHash.
checkpointNeo Merkle root của các head nhật ký tổ chức.
registerIssuerWalletBind ví với orgRef và cấp quyền issuer.

Kiểm đúng địa chỉ và phiên bản

Bundle v1 đi với ledger v2; bundle v2 trong code hiện tại hỗ trợ ledger v3. v3 có periodAnchorCount và sequence cho lịch sử cùng slot tháng.

Không dùng một địa chỉ ledger suy ra từ bundle làm trust anchor. Xác nhận chainId, địa chỉ và deployment block từ nguồn độc lập; docs này không tự nhận một địa chỉ v3 là đã live.

Nguồn đối chiếu trong monorepo

Nội dung dựa trên mã nguồn; trạng thái live được ghi riêng.

  • contracts/src/ShadowLedger.sol
  • contracts/src/ShadowLedgerV3.sol
  • docs/adr/ADR-0034-independent-commits-provisional-months-ledger-v3.md