> For the complete documentation index, see [llms.txt](https://docs.rome.builders/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rome.builders/vi/canton-zk-evm/explorer.md).

# Trình khám phá

Hướng dẫn về trình khám phá Ostia DevNet đang hoạt động, faucet, các API của nó và kiểm tra bằng chứng trong trình duyệt.

Trình khám phá Ostia hiện đã hoạt động tại [ostia.devnet.romeprotocol.xyz](https://ostia.devnet.romeprotocol.xyz). Công cụ kết hợp dữ liệu EVM của reth với các bản ghi Canton của từng block, mà nó đọc với tư cách bên đọc. Dùng công cụ để tìm block hoặc giao dịch, kiểm tra bằng chứng ngay trên trình duyệt, xác minh hợp đồng, nhận tROME và đọc cùng dữ liệu đó qua API.

Trang này mô tả bản phát hành `v0.1.0` và, ở những chỗ có nêu rõ, phiên bản đang chạy trên DevNet. [Trạng thái](https://docs.rome.builders/vi/canton-zk-evm/status.md) cho biết commit đang chạy trên DevNet. Đọc toàn bộ [README của trình khám phá](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md).

Trình khám phá chỉ đánh dấu một block là final khi bản ghi của block đó đã có trên Canton. Trước thời điểm đó, công cụ hiển thị block từ reth là đang được chứng minh; giao dịch bạn vừa gửi sẽ hiển thị là đang chờ xử lý. Khi không có giao dịch nào đang chờ, trình tạo tạo một block rỗng mỗi phút, vì vậy block mới nhất trên một chuỗi ít hoạt động thường không cũ hơn vài phút. Thời gian trên mọi trang đều theo UTC.

## Giới thiệu các trang

| Trang             | Bạn có thể làm gì tại đó                                                                                                                                                                                                                                                                                                                                                             |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Trang chủ         | Tìm kiếm theo block, giao dịch, địa chỉ hoặc ID bản cập nhật Canton. Xem block final mới nhất, block đang được chứng minh, thời gian đến final, thời gian chứng minh và các block mới nhất. Thanh trạng thái cho biết node EVM, Canton, trình tạo, trình chứng minh, vòi và trình xác minh có hoạt động bình thường hay không. Ô thời gian commit Canton mở trang Lời gọi bên ngoài. |
| Blocks            | Liệt kê các block final, lọc để xem những block có giao dịch, tải CSV xuống và mở một block.                                                                                                                                                                                                                                                                                         |
| Giao dịch         | Liệt kê giao dịch và lọc theo trạng thái chưa final, thất bại hoặc lời gọi hợp đồng. Trang giao dịch hiển thị kết quả, block, bản cập nhật Canton, phí, dữ liệu đầu vào đã giải mã và dòng thời gian gồm bốn giai đoạn finality.                                                                                                                                                     |
| Hợp đồng          | Xem hợp đồng nào đã được xác minh và tần suất sử dụng. Trang hợp đồng hiển thị mã nguồn đã xác minh, ABI, sự kiện và các lời gọi Read và Write. Lời gọi Write được thực hiện qua ví của bạn.                                                                                                                                                                                         |
| Token             | Duyệt token ERC-20, ERC-721 và ERC-1155, cùng danh sách người nắm giữ và giao dịch chuyển. Một thẻ liệt kê các token có nguồn gốc từ Canton, chẳng hạn như wTKB và CC.                                                                                                                                                                                                               |
| Lời gọi bên ngoài | Xem cách từng block được commit trên Canton, mỗi hàng tương ứng với một block, kèm trạng thái, thời gian quyết toán và số lần thử. Liên kết "Lời gọi bên ngoài" ở đầu trang sẽ mở mục này. Xem [Lời gọi bên ngoài](#external-calls).                                                                                                                                                 |
| Thống kê          | Xem thời gian đến final, thời gian chứng minh, thời gian commit Canton, số giao dịch mỗi giây và tỷ lệ thành công trong khoảng 1 giờ, 6 giờ, 24 giờ, 7 ngày hoặc 30 ngày. Thẻ tài sản Canton hiển thị lượng cung của từng tài sản so với lượng mà vault và gateway nắm giữ. Thẻ Lời gọi bên ngoài cho biết tình trạng commit lên Canton.                                             |
| Cặp tài sản       | Xem các tài sản Canton hai chiều tại [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins): lượng cung của từng cặp so với số dư trong vault, cùng các lệnh khóa và đổi lại gần đây.                                                                                                                                                                                               |
| Hoán đổi          | Xem các giao dịch hoán đổi mà một sàn Canton đã thực hiện với EVM tại [`/swaps`](https://ostia.devnet.romeprotocol.xyz/swaps), và mở một giao dịch hoán đổi để xem khoản thanh toán và yêu cầu nhận tài sản.                                                                                                                                                                         |
| Bridge            | Kết nối ví, nhận tROME thử nghiệm và chuyển token giữa Ostia và Canton bằng ví Canton bạn đang có (tính năng được bật lần lượt cho từng ví; trước đó, nút sẽ hiển thị "Sắp ra mắt"). Xem [Bridge](https://docs.rome.builders/vi/canton-zk-evm/bridge.md).                                                                                                                            |
| Vòi               | Yêu cầu tROME hoặc đăng nhập bằng GitHub để nhận khoản tài trợ 100 tROME dành cho nhà phát triển, rồi theo dõi yêu cầu của bạn cho đến khi final.                                                                                                                                                                                                                                    |
| API               | Đọc tài liệu tham khảo API được tạo từ tài liệu OpenAPI. Một nút sẽ thêm Ostia DevNet vào ví của bạn.                                                                                                                                                                                                                                                                                |

Mọi trang, ngoại trừ Trang chủ có ô tìm kiếm riêng, đều có ô tìm kiếm ở phần đầu trang; phím `/` sẽ đưa tiêu điểm vào ô này. Các trang Blocks, Giao dịch, giao dịch và lượt chuyển của một địa chỉ, cũng như lượt chuyển của một token, có thể tải xuống dưới dạng CSV. Các trang nhận luồng dữ liệu trực tiếp, vì vậy block mới sẽ xuất hiện mà không cần tải lại. Có thể mở trang địa chỉ và trang chặng gateway từ các liên kết; địa chỉ cũng có thể được mở qua tìm kiếm. Phần đầu trang không có mục điều hướng đến các trang này.

## Đọc thông tin block

Trang block hiển thị dữ liệu EVM bên cạnh thông tin Canton: ID bản cập nhật, thời gian ghi nhận, cùng đơn vị vận hành và bên xác nhận đã ký bản ghi. Trang so sánh hash block của reth, hash của bản ghi và hash của header được ghi nhận, đồng thời cho biết ba giá trị có khớp nhau hay không. Trang cũng hiển thị khóa chương trình, bản phát hành ZisK và hash block đọc từ bằng chứng, bên cạnh các giá trị mà trình khám phá mong đợi. Giá trị không khớp sẽ được hiển thị màu đỏ.

Bốn ô tóm tắt block bằng các con số: số giao dịch, thời gian chứng minh, thời gian commit Canton (khoảng thời gian từ lúc gửi block đến thời điểm ghi nhận block trên Canton) và khoảng thời gian từ lúc tạo block đến khi đạt final. Các thẻ Canton commit trên Trang chủ và trang Thống kê tính từ lúc gửi đến khi trình tạo nhận được phản hồi từ Canton, nên số liệu ở đó cao hơn ô này. Một bảng "Cách block này đạt trạng thái final" liệt kê các bước cùng thời gian tương ứng.

Block đang được chứng minh vẫn chưa có trên Canton. Trang sẽ nêu rõ điều đó và tự làm mới cho đến khi block đạt trạng thái final. Giao dịch có thể đang chờ xử lý, đang được chứng minh hoặc đã final. Trang block liệt kê các chặng gateway như được ghi nhận trên EVM. `BlockRecord` không chứa thông tin về cách từng leg được tất toán trên Canton, nên trình khám phá không thể hiển thị thông tin đó. Xem [Leg và lưu ký](#legs-and-custody) để xem các leg đang hoạt động trên DevNet.

## Leg và lưu ký

Các leg của gateway đang hoạt động trên DevNet, do Rome chạy với các bên thử nghiệm (xem [Tiền gửi, rút tiền và thanh toán](https://docs.rome.builders/vi/canton-zk-evm/deposits-withdrawals-payments.md)), vì vậy các trang này hiện đã có nội dung. Tuy nhiên, chúng chưa có mục trong phần đầu trang; hãy mở [`/legs`](https://ostia.devnet.romeprotocol.xyz/legs) trực tiếp hoặc theo dõi một leg từ block của nó.

* **Danh sách** tại `/legs` hiển thị mọi leg cùng loại (tiền gửi, thanh toán hoặc rút tiền), block, token, tài khoản và số lượng. Mở một mục để xem trang riêng tại `/leg/<id>`. Một lần rút tiền sẽ nêu tên bên Canton được thanh toán. Vào lúc 11:54 UTC ngày 2026-10-25, danh sách có sáu leg từ hai lượt chạy trong ngày đó (các block 780, 783, 784, 1465, 1471 và 1473).
* **API** cung cấp cùng dữ liệu tại `/api/legs`, `/api/legs/<id>` và `/api/blocks/<number>/legs`.
* **Token bọc** wTKB, tại `0x294d3049874526910a69f6b61da14d10a8b1b3af`, có trang token như mọi ERC-20 khác (10 chữ số thập phân). Nguồn cung của token này là 12 wTKB tại block 1473, và lượt chạy của Rome đã xác nhận gateway nắm giữ 12 TKB trên Canton.
* **Đối chiếu lưu ký với nguồn cung.** Trang của token được bảo chứng trên Canton có thẻ "Được bảo chứng trên Canton": số lượng gateway nắm giữ trên Canton đặt cạnh nguồn cung token bọc, được đọc tại cùng block, và `GET /api/tokens/<address>` cung cấp các số liệu tương tự trong một đối tượng `canton` . Chỉ hiển thị tổng số, không bao giờ hiển thị từng khoản nắm giữ. Dữ liệu lưu ký đã có trên DevNet từ 12:27 UTC ngày 2026-10-25. Vào lúc 12:52 UTC cùng ngày, wTKB ghi nhận lưu ký 12 TKB, được nắm giữ trong hai khoản, so với nguồn cung token bọc là 12 wTKB.

## Twin và tài sản Canton

Trình khám phá hiển thị các tài sản Canton hai chiều (xem [Tiền gửi, rút tiền và thanh toán](https://docs.rome.builders/vi/canton-zk-evm/deposits-withdrawals-payments.md#canton-twins-of-erc-20-tokens)). Mở [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins). Trang này có:

* **Sổ đăng ký.** Các vault được ghi nhận trong hồ sơ trên chuỗi, cùng mã băm của mã nguồn từng vault và các twin mà vault liên kết, kèm số chữ số thập phân của chúng.
* **Thẻ cho từng twin.** Nguồn cung trên Canton đặt cạnh số lượng vault nắm giữ, được đọc tại cùng block, kèm block dùng để kiểm đếm và số lượng khóa cùng quy đổi. Hai số liệu khớp nhau sau mỗi lần khóa và quy đổi.
* **Đối chiếu lưu ký với nguồn cung** cho các token Canton, chẳng hạn wTKB và CC: số lượng gateway nắm giữ trên Canton đặt cạnh nguồn cung token bọc.
* **Các lần khóa và quy đổi gần đây.** Mỗi mục liên kết đến leg, giao dịch, block và bản cập nhật Canton tương ứng.
* **Dịch vụ sổ đăng ký.** Một dòng kèm liên kết đến điểm kiểm tra tình trạng của dịch vụ sổ đăng ký twin.

Thẻ tài sản Canton trên trang Stats hiển thị cùng nguồn cung đối chiếu với số lượng vault và gateway nắm giữ, còn `GET /api/twins` cung cấp toàn bộ trang dưới dạng JSON. Chỉ hiển thị tổng số, không bao giờ hiển thị từng khoản nắm giữ.

## Lời gọi bên ngoài

Mở **Lời gọi bên ngoài** trong phần đầu trang, tại [`/canton`](https://ostia.devnet.romeprotocol.xyz/canton). Ostia ghi nhận mỗi khối dưới dạng một giao dịch Canton. Lời gọi bên ngoài của bên tham gia xác nhận kiểm tra bằng chứng của khối trong chính giao dịch đó; trên DevNet, bên tham gia này là Rome. Trang này cho biết diễn biến của từng lần ghi nhận.

**Phần đầu trang** hiển thị số liệu của toàn bộ các khối:

* số khối đã được ghi nhận;
* tỷ lệ thành công, tức tỷ lệ giữa số lần ghi nhận thành công và tổng số lần thử, đạt 99.99% trên toàn bộ các khối tính đến 2026-11-09;
* thời gian xác nhận, tính theo mức trung bình và p95, trong 24 giờ hoặc 7 ngày gần nhất (tính đến 2026-11-09, trong 24 giờ, lần lượt khoảng 9.1 s và 10.7 s);
* số lần Canton từ chối ghi nhận và số khối được ghi nhận sau khi thử lại;
* số leg được xác nhận, phân theo loại.

**Danh sách** có một hàng cho mỗi khối. Mỗi hàng hiển thị:

* bản cập nhật Canton và khối EVM mà bản cập nhật đó chứa, cùng số giao dịch EVM đã được xác nhận;
* trạng thái: được ghi nhận ngay lần thử đầu tiên hay sau nhiều lần thử hơn, cùng số lần Canton từ chối;
* lựa chọn `Advance` trên hợp đồng `ZkChain` của chuỗi;
* các leg được khối xác nhận, phân theo loại;
* thời gian xác nhận, tính từ lúc bắt đầu tạo bằng chứng cho khối đến thời điểm ghi nhận của Canton, và thời điểm ghi nhận.

Hiển thị tất cả khối hoặc chỉ những khối được ghi nhận ngay lần thử đầu tiên, được thử lại, bị Canton từ chối ít nhất một lần hoặc đã xác nhận các leg. Sắp xếp danh sách từ mới nhất đến cũ nhất hoặc ngược lại. **CSV** tải xuống 1.000 hàng đầu tiên của chế độ xem hiện đang mở, theo thứ tự hiển thị; `GET /api/canton/updates?format=csv&filter=<all|first|retried|refused|legs>&order=<desc|asc>` trả về cùng một tệp.

**Một bản cập nhật** mở một trang có dòng thời gian (khối được tạo, bắt đầu tạo bằng chứng, hoàn tất bằng chứng, gửi đến Canton, được Canton ghi nhận), tất cả lần thử ghi nhận cho đến lần thành công, bước kiểm tra bằng chứng và các leg mà khối đã xác nhận. Phần đối chiếu riêng của explorer giữa bằng chứng và các giá trị được ghim nằm cạnh kết quả kiểm tra. Thông tin được lấy từ bản ghi Canton và nhật ký riêng của trình tạo (trang gắn nhãn thông tin này là "nhật ký trình tạo"); với khối không có trong nhật ký, trang chỉ hiển thị thông tin Canton lưu giữ và lược bỏ phần còn lại.

Các số liệu chính có trên trang **Thống kê** trong thẻ Lời gọi bên ngoài; `GET /api/canton/stats` cung cấp các số liệu đó dưới dạng JSON.

## Kiểm tra bằng chứng ngay trong trình duyệt

Đọc các giá trị từ bằng chứng không đồng nghĩa với việc xác minh bằng chứng. Nhấn Verify sẽ tải xuống bản dựng WebAssembly của hàm `verify` trong sidecar và chạy hàm đó trên bằng chứng, header và các giao dịch đã ghi lại.

Bước kiểm tra xác minh bằng chứng PLONK theo khóa chương trình được ghim và bản phát hành ZisK được ghim. Bước này kiểm tra xem header có băm thành hash của khối đã được chứng minh hay không, và các giao dịch có khớp với gốc giao dịch trong header hay không. Bảng cũng yêu cầu hash khối đó khớp với hash của khối từ reth.

Các giá trị ghim dự kiến được lấy từ phản hồi trạng thái của explorer. Verify chạy bước kiểm tra khối của sidecar; tính năng này không chạy bước kiểm tra riêng `legs` này. Nút bị vô hiệu hóa khi khối đang được chứng minh. Sau khi kiểm tra, bảng hiển thị kết quả, thời lượng và kích thước tải xuống của mô-đun. Thời lượng không tính thời gian tải xuống. Xem [README của trình xác minh trên trình duyệt](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/explorer/verify/README.md).

## Dùng vòi tROME

Vòi cấp 1 tROME cho mỗi yêu cầu, cho bất kỳ ai. tROME là đồng tiền thử nghiệm của Ostia DevNet và không có giá trị. Mở trang Faucet hoặc gửi `POST /api/faucet`. Giới hạn như sau:

* mỗi địa chỉ được yêu cầu một lần trong mỗi 24 giờ;
* mỗi địa chỉ IP được yêu cầu một lần trong mỗi 10 phút;
* 5.000 lượt chi trả mỗi giờ trên tất cả client.

Yêu cầu được đưa vào hàng đợi ngay lập tức và được trả lời bằng một mã phiếu. Faucet xử lý hàng đợi theo từng đợt, tối đa 100 yêu cầu mỗi đợt; khoản chi trả của bạn sẽ đến khi khối chứa giao dịch được xác nhận cuối cùng. `GET /api/faucet/ticket/<id>` cho biết yêu cầu của bạn đang ở đâu. Các giới hạn được lưu trong cơ sở dữ liệu nên việc khởi động lại không đặt lại chúng. Đọc [phần faucet](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md#the-faucet) để biết chi tiết.

**Gói tài trợ cho nhà phát triển.** Nhà phát triển đăng nhập bằng GitHub sẽ nhận được 100 tROME thay vì 1. Nhập địa chỉ của bạn trên trang Faucet rồi chọn "Đăng nhập bằng GitHub" trong dòng "Đang xây dựng trên Ostia? Đăng nhập bằng GitHub để nhận 100 tROME." GitHub sẽ đưa bạn trở lại trang, trang này theo dõi khoản tài trợ của bạn cho đến khi được xác nhận cuối cùng. Tài khoản GitHub phải được tạo ít nhất 30 ngày trước. Mỗi tài khoản GitHub và mỗi địa chỉ được nhận một khoản tài trợ sau mỗi 7 ngày; faucet cấp tối đa 200 khoản tài trợ mỗi ngày cho tất cả mọi người. Trang không yêu cầu GitHub cấp quyền nào. [Ostia DevNet](https://docs.rome.builders/vi/canton-zk-evm/devnet.md#the-builder-grant) có hướng dẫn và các giới hạn.

## Sử dụng API

Cả ba API đều mở và không cần khóa. Giới hạn được áp dụng theo từng client.

| API                                                | Địa chỉ    | Giới hạn                                                           |
| -------------------------------------------------- | ---------- | ------------------------------------------------------------------ |
| JSON-RPC, chỉ khối đã xác nhận cuối cùng, chỉ HTTP | `/rpc`     | 300 lệnh gọi mỗi phút, mỗi lô tối đa 20 lệnh                       |
| REST, được mô tả tại `/api/openapi.json`           | `/api/...` | 20 yêu cầu mỗi giây, tối đa 60 yêu cầu trong các đợt tăng đột biến |
| Tương thích với Etherscan                          | `/api`     | 10 yêu cầu mỗi giây và 600 yêu cầu mỗi phút                        |

RPC không hỗ trợ WebSocket và bộ lọc, vì vậy hãy thăm dò `eth_getLogs`. `GET /api/stream` là luồng dữ liệu trực tiếp mà các trang sử dụng. `GET /api/status` cung cấp thông tin về chuỗi, khóa chương trình được ghim và trạng thái của từng thành phần.

Để xác minh mã nguồn của hợp đồng, hãy dùng `forge verify-contract` với trình xác minh Etherscan:

```sh
forge verify-contract <address> src/Counter.sol:Counter \
  --chain-id 770101 \
  --evm-version london \
  --verifier etherscan \
  --verifier-url https://ostia.devnet.romeprotocol.xyz/api \
  --etherscan-api-key any
```

Dùng cùng phiên bản trình biên dịch, cài đặt trình tối ưu hóa và phiên bản EVM như khi triển khai. Bạn có thể gửi 30 yêu cầu xác minh mỗi giờ. Hợp đồng có nhiều tệp nguồn có thể khiến forge nhận lỗi HTTP 413 vì forge gửi đầu vào theo dạng mã hóa URL, còn proxy phía trước của trình khám phá chỉ nhận được khoảng 300 KB mỗi yêu cầu. Xem [Xác minh hợp đồng lớn](https://docs.rome.builders/vi/canton-zk-evm/build-on-ostia.md#verify-a-large-contract). [Xây dựng trên Ostia](https://docs.rome.builders/vi/canton-zk-evm/build-on-ostia.md) có hướng dẫn triển khai; còn [giới hạn tốc độ](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md#rate-limits) được nêu trong README của trình khám phá.

## Những gì bên đọc có thể xem

Trình khám phá đọc Canton với tư cách là một bên đọc bằng token chỉ đọc. Bên này chỉ quan sát bản ghi khối, không thấy bất kỳ thông tin nào khác trong gói Daml của Ostia. Bên này thấy số thứ tự, hàm băm, hàm băm của khối cha, tiêu đề, giao dịch và bằng chứng của từng bản ghi, ID cập nhật, thời điểm ghi nhận, cùng hai bên ký. Bên này không thể xem yêu cầu nạp tiền, chấp thuận rút tiền hoặc điều khoản thanh toán, vì vậy những thông tin đó không xuất hiện trong trình khám phá.

Số dư của cổng kết nối được lấy từ một client chỉ đọc thứ hai, client này đọc với tư cách là bên cổng kết nối. Client hiển thị các số liệu tổng hợp: thẻ "Được bảo chứng trên Canton", trang `/twins` thẻ tài sản Canton trên trang Thống kê và `GET /api/twins`. Trang này cũng đọc các giao dịch của địa điểm và các yêu cầu đã được cấp vốn đằng sau `/swaps` và `GET /api/swaps`, giữ lại khoản thanh toán, yêu cầu và các cập nhật Canton của chúng, đồng thời loại bỏ các bên Canton của địa điểm và người bán.

Giới hạn của người đọc là giới hạn của chính trình khám phá. Nhà vận hành participant lưu trữ các bên Ostia vẫn có thể xem mọi thứ tại đó; trên DevNet, nhà vận hành đó là Rome, đơn vị chạy participant với tư cách validator Canton DevNet của riêng mình. [Mô hình tin cậy và các giới hạn](https://docs.rome.builders/vi/canton-zk-evm/trust-model.md) giải thích ý nghĩa của điều đó. Verify chạy quy trình kiểm tra của sidecar trong trình duyệt của bạn trên dữ liệu do trình khám phá này cung cấp.

Để tự chạy trình khám phá của riêng bạn cùng với cơ sở dữ liệu, hãy xem [Tự chạy Ostia](https://docs.rome.builders/vi/canton-zk-evm/run-it-locally.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.rome.builders/vi/canton-zk-evm/explorer.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
