Smart contracts & phiên bản
Vai trò contract, commitBatch, markVerified và tương thích ledger.
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àm | Vai trò |
|---|---|
| commitBatch | Ghi các định danh recordRoot; giới hạn theo contract. |
| markVerified | Ràng buộc commitmentId, recordRoot và receiptHash. |
| checkpoint | Neo Merkle root của các head nhật ký tổ chức. |
| registerIssuerWallet | Bind 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.solcontracts/src/ShadowLedgerV3.soldocs/adr/ADR-0034-independent-commits-provisional-months-ledger-v3.md
