Kiến trúc hệ thống
Các thành phần xử lý dữ liệu, bằng chứng và giao dịch trong monorepo.
Trong trang này
Từ nguồn đến ledger
Issuer dashboard là giao diện vận hành. NestJS API điều phối ingest và quyền truy cập; worker xử lý fetch, xác minh, relay, indexer và giám sát. PostgreSQL giữ trạng thái và log; dữ liệu nguồn/document lưu mã hóa.
packages/hashing định nghĩa bytes và hash. packages/verifier tái tạo bằng chứng độc lập. packages/contracts định nghĩa Zod/API; packages/ingest chứa các parser và mapping thuần, với độ phủ endpoint được công bố riêng.
Nhất quán khi có lỗi
Trạng thái, audit và outbox được ghi cùng transaction. Consumer phải ghi inbox cùng transaction với tác động của nó để xử lý lại không gây mất hoặc nhân đôi hiệu ứng.
Ghi chain theo reserve → ký một lần → lưu raw tx và hash → broadcast → resend cùng tx. Replacement/cancel dùng cùng nonce; receipt finalized quyết định kết quả.
Ranh giới package
Domain và các engine thuần không phụ thuộc NestJS hay DB. App là nơi nối adapters với nghiệp vụ; không có package nào phụ thuộc app.
Tests/CI dùng simulated adapters. Việc triển khai và smoke Base Sepolia là cổng riêng; code đã build hoặc test không chứng minh hệ thống live đang dùng đúng cấu hình.
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/architecture/03-system-architecture.mddocs/architecture/06-event-flow.mdapps/api/src/modules/shadow-ledgerpackages/hashing/srcpackages/verifier/src
