Đến nội dung
Tài liệu/Khái niệm cốt lõi

Shadow Ledger

Phân biệt dữ liệu lưu nội bộ, định danh recordRoot và bằng chứng neo trên Base.

Trong trang này

Một định danh cho cả bản ghi

recordRoot ràng buộc header và toàn bộ kỳ dữ liệu của bản ghi. Header chứa thông tin nguồn, nhà máy, múi giờ và registryHash; mỗi kỳ có salt riêng.

Cùng document và salts cho cùng recordRoot. Hai lần ingest độc lập có thể có cùng số liệu nhưng root khác vì salts và metadata khác.

Hai lớp lưu trữ

LớpNội dung
Off-chainDocument, nguồn, salts, snapshot registry, seal và nhật ký.
On-chainrecordRoot, tham chiếu mù, metadata và bằng chứng giao dịch.

Ledger v2 và v3

v2 có khóa theo kỳ và luồng revision. v3 cho phép bản ghi độc lập chồng tháng; contract tự tính periodSlot theo tổ chức, nhà máy, loại bản ghi và tháng, rồi tăng sequence mỗi lần neo.

Bản ghi lịch sử phải được kiểm chứng theo đúng phiên bản ledger và bundle. Có code v3 không đồng nghĩa môi trường đang dùng v3; cần kiểm cấu hình và bằng chứng triển khai trước khi áp dụng hướng dẫn v3.

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.

  • docs/specs/ucy-hash-v2.md
  • contracts/src/ShadowLedger.sol
  • contracts/src/ShadowLedgerV3.sol