Tiêu chuẩn ICRC-3: Giao diện lịch sử giao dịch (transaction log)

Tóm tắt

Tiêu chuẩn ICRC-3 chỉ định một API để truy cập vào lịch sử giao dịch của sổ sách, có thể được phân tán qua nhiều canister (hay còn gọi là smart contracts).

Động cơ

Tính năng thường được yêu cầu nhiều nhất trong ứng dụng ví token là Hiển thị danh sách các giao dịch trước đó. Tiêu chuẩn ICRC-3 cung cấp một API tối thiểu cho phép truy cập vào các giao dịch trước đó được ghi lại trên một sổ sách tuân thủ tiêu chuẩn ICRC-1.

Những ràng buộc sau đã hướng dẫn thiết kế API:

• Khả năng mở rộng. API phải cho phép sổ sách thêm các loại giao dịch mới mà không làm hỏng các ứng dụng hiện có.
• Giao diện chỉ truy vấn. Các phương thức truy vấn không thay đổi trạng thái của canister, làm đơn giản quá trình kiểm tra canister đáng kể.
• Hiệu suất bộ nhớ. Toàn bộ lịch sử giao dịch có thể không vừa vào bộ nhớ của canister. API đề xuất có thể xử lý trường hợp khi lịch sử giao dịch được chia thành nhiều canister.
• Canister sẽ sử dụng giao diện này nhiều nhất. Giao diện này không phù hợp cho việc xác minh dữ liệu off-chain.

Phương thức hoạt động

icrc3_get_transactions

Trả về danh sách các giao dịch từ khoảng đã chỉ định.

icrc3_get_transactions : (GetTransactionsRequest) -> (GetTransactionsResponse) query;

Sổ sách xác định các giao dịch bằng số thứ tự của chúng. Sổ sách tạo một giao dịch cho mỗi thay đổi trạng thái thành công.

type TxIndex = nat;

Loại giao dịch là một bản ghi có hai trường bắt buộc:

• Trường kind chứa loại giao dịch (icrc1_mint, icrc1_burn, icrc1_transfer, v.v.).
• Trường timestamp chứa thời gian IC khi sổ sách chấp nhận giao dịch. Tất cả các trường khác là tùy chọn và tương ứng với các loại giao dịch khác nhau.

Giá trị của trường kind xác định trường nào trong bản ghi giao dịch có giá trị. Ví dụ, nếu kind = “icrc1_transfer”, thì trường icrc1_transfer chứa chi tiết giao dịch.

Đọc tiếp về phương thức hoạt động và ví dụ: https://github.com/dfinity/ICRC-1/tree/roman-icrc3/standards/ICRC-3

Đọc tiếp: Tiêu chuẩn ICRC-21: Đồng ý cuộc gọi Canister

Quay lại: Tiêu chuẩn ICRC-2: Approve và Transfer From

Vietnam Pham – Click Digital

• If you’d like to invest in blockchain advertising companies, just BUY token Saigon (SGN) at Pancakeswap: https://t.co/KJbk71cFe8 (do not worry about low liquidity)
• Backed by Click Digital Company
• Enhancing blockchain knowledge
• BSC address: 0xa29c5da6673fd66e96065f44da94e351a3e2af65
• Twitter: https://twitter.com/SaigonSGN135
• Staking SGN: http://135web.net