> 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/devnet.md).

# Ostia DevNet

Chi tiết mạng cho Ostia DevNet, bao gồm chain ID, RPC, trình khám phá, API, thiết lập ví, faucet và giới hạn.

Ostia DevNet là mạng Ostia công khai. Mạng này chạy trên Canton Network DevNet và đã hoạt động từ **2026-10-22**. Các công cụ EVM thông thường đều hoạt động trên mạng này: ví, Foundry, Hardhat, ethers và viem. Trang này cung cấp các giá trị bạn cần để kết nối. [Xây dựng trên Ostia](https://docs.rome.builders/vi/canton-zk-evm/build-on-ostia.md) sẽ hướng dẫn bạn từ đó đến một hợp đồng đã triển khai và được xác minh.

Kể từ **2026-10-29** mạng này cũng chuyển tài sản Canton theo cả hai chiều: token ERC-20 tồn tại trên Canton dưới dạng tài sản song sinh, còn Canton Coin có thể chuyển sang Ostia rồi quay lại. Địa chỉ được liệt kê trong mục [Tài sản Canton trên DevNet](#canton-assets-on-devnet) bên dưới.

## Thông tin mạng

| Thiết lập                          | Giá trị                                                                                                    |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| Tên mạng                           | Ostia DevNet                                                                                               |
| ID chuỗi                           | `770101` (hệ thập lục phân `0xbc035`)                                                                      |
| Đơn vị tiền tệ                     | tROME, 18 chữ số thập phân. Đơn vị này không có giá trị.                                                   |
| RPC                                | `https://ostia.devnet.romeprotocol.xyz/rpc` (chỉ HTTP, chỉ các khối đã hoàn tất)                           |
| Trình khám phá                     | [ostia.devnet.romeprotocol.xyz](https://ostia.devnet.romeprotocol.xyz)                                     |
| API tương thích với Etherscan      | `https://ostia.devnet.romeprotocol.xyz/api`                                                                |
| API REST                           | `https://ostia.devnet.romeprotocol.xyz/api/...`, được mô tả trong tài liệu OpenAPI tại `/api/openapi.json` |
| Trạng thái và tình trạng hoạt động | `/api/status` và `/api/health` trên địa chỉ của trình khám phá                                             |

Giá gas vào khoảng 1 gwei và mỗi khối chứa tối đa 60.000.000 gas. Một giao dịch đơn lẻ có thể sử dụng tối đa 16.777.216 gas (2^24), là giới hạn do nhánh Osaka đặt ra. Một số điểm khác Ethereum, chẳng hạn như `block.prevrandao` có giá trị 0 và không hỗ trợ giao dịch blob; xem [Những điểm khác biệt so với Ethereum](https://docs.rome.builders/vi/canton-zk-evm/evm-differences.md).

## Thêm vào ví

Trong MetaMask hoặc ví khác, hãy thêm mạng tùy chỉnh bằng các giá trị sau:

| Trường                  | Giá trị                                     |
| ----------------------- | ------------------------------------------- |
| Tên mạng                | Ostia DevNet                                |
| URL RPC mới             | `https://ostia.devnet.romeprotocol.xyz/rpc` |
| ID chuỗi                | `770101`                                    |
| Ký hiệu tiền tệ         | `tROME`                                     |
| URL trình khám phá khối | `https://ostia.devnet.romeprotocol.xyz`     |

Bạn cũng có thể thêm mạng ngay từ trình khám phá. Mở [trang API](https://ostia.devnet.romeprotocol.xyz/docs/api) rồi nhấn nút thêm mạng vào ví.

## Nhận tROME

Mỗi người nhận 1 tROME mỗi ngày. Nhà phát triển có thể nhận 100 tROME từ khoản tài trợ dành cho nhà phát triển, mỗi 7 ngày một lần. Mở [vòi cấp token](https://ostia.devnet.romeprotocol.xyz/faucet), dán địa chỉ của bạn rồi gửi yêu cầu. Bạn cũng có thể gửi yêu cầu từ terminal:

```sh
curl -X POST https://ostia.devnet.romeprotocol.xyz/api/faucet \
  -H 'content-type: application/json' \
  -d '{"address":"0xYourAddress"}'
```

Yêu cầu được chấp nhận sẽ trả về `202` một `ticket`. Gửi yêu cầu `GET /api/faucet/ticket/<ticket>` cho đến khi trạng thái là `final` (hoặc `failed`). Trạng thái chuyển từ `queued` sang `sent` sang `final`. Thay `0xYourAddress`bằng địa chỉ ví của bạn. Vòi cấp token có các giới hạn sau:

* 1 tROME cho mỗi địa chỉ mỗi 24 giờ;
* mỗi địa chỉ IP được gửi một yêu cầu mỗi 10 phút;
* tối đa 5.000 khoản chi trả mỗi giờ cho tất cả mọi người.

Các khoản chi trả được gửi theo lô, tối đa 100 khoản mỗi lô. Bạn sẽ nhận được token khi khối chứa khoản chi trả của bạn đạt trạng thái cuối cùng trên Canton; quá trình này mất khoảng 10 đến 30 giây sau khi token được gửi. Với mức giá gas hiện tại, một tROME đủ trả phí cho hàng nghìn giao dịch thông thường. Các giới hạn của vòi cấp token được nêu trong [mục vòi cấp token trong README của trình khám phá khối](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md#the-faucet).

### Khoản tài trợ dành 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. Trên trang Faucet, nhập địa chỉ của bạn 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." Trang Bridge cung cấp bước tương tự trong mục "Nhận tROME thử nghiệm", dành cho ví bạn đã kết nối nếu ví đó chưa có tROME; nếu không, hãy dùng trang Faucet. GitHub sẽ đưa bạn trở lại trang Faucet, nơi khoản tài trợ của bạn được theo dõi đến khi đạt trạng thái cuối cùng, như mọi yêu cầu khác. Trang này không yêu cầu GitHub cấp quyền nào và chỉ đọc số thứ tự tài khoản cùng ngày tạo tài khoản của bạn.

* 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 chỉ được nhận một khoản tài trợ và mỗi địa chỉ chỉ được nhận một khoản trong vòng 7 ngày.
* Tối đa 200 khoản tài trợ mỗi ngày cho tất cả mọi người.

Mọi người vẫn nhận được 1 tROME mỗi ngày, dù có tài khoản GitHub hay không. Phản hồi của `GET /api/faucet` cho biết khoản tài trợ có đang được áp dụng hay không, cùng số lượng và các giới hạn. Các quy định được nêu trong [mục khoản tài trợ dành cho nhà phát triển](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md#the-builder-grant) trong README của trình khám phá khối.

### Canton Coin thử nghiệm

Trang Bridge không còn vòi cấp Canton Coin kể từ ngày 2026-11-17 (vòi này chỉ phục vụ tài khoản Bridge, hiện đã ngừng hoạt động). Hãy nhận Canton Coin thử nghiệm trong ví Canton của riêng bạn.

## Giới hạn

RPC tại `/rpc` chuyển tiếp yêu cầu đến chuỗi, với các khác biệt sau:

* RPC phản hồi 20 phương thức: `eth_chainId`, `net_version`, `web3_clientVersion`, `eth_syncing`, `eth_blockNumber`, `eth_getBalance`, `eth_getCode`, `eth_getStorageAt`, `eth_getTransactionCount`, `eth_call`, `eth_estimateGas`, `eth_gasPrice`, `eth_maxPriorityFeePerGas`, `eth_feeHistory`, `eth_getBlockByNumber`, `eth_getBlockByHash`, `eth_getTransactionByHash`, `eth_getTransactionReceipt`, `eth_getLogs` và `eth_sendRawTransaction`. Mọi phương thức khác đều trả lời `-32601`.
* Không có WebSocket, cũng không có `eth_newFilter` hoặc `eth_subscribe`. Để theo dõi sự kiện, hãy thăm dò `eth_getLogs`.
* Phương thức này chỉ hiển thị các khối đã hoàn tất trên Canton. `latest`, `safe`, `pending` và `finalized` đều có nghĩa là khối mới nhất đã hoàn tất (ngoại trừ `eth_getTransactionCount` với `pending`, phương thức này đếm các giao dịch đang chờ để ví chọn nonce tiếp theo). Biên nhận sẽ xuất hiện khi khối chứa giao dịch được hoàn tất, thường mất khoảng 10 đến 30 giây.
* Mỗi ứng dụng khách có thể thực hiện 300 lệnh gọi mỗi phút. Mỗi lệnh gọi trong một lô đều được tính riêng và một lô chứa tối đa 20 lệnh gọi. Nội dung yêu cầu tối đa 256 KiB.
* Giao dịch có nonce lớn hơn nonce tiếp theo của tài khoản sẽ bị từ chối do thiếu nonce trung gian. Hãy gửi các giao dịch còn thiếu trước.
* Giao dịch có mức phí tối đa trên mỗi gas thấp hơn phí cơ sở hiện tại sẽ bị từ chối. Ví và công cụ tự thiết lập mức phí này.

API của trình khám phá có giới hạn riêng, áp dụng theo từng ứng dụng khách và không cần khóa:

| Giao diện                              | Giới hạn                                                                                                                                                                      |
| -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| REST API (`/api/...`)                  | 20 yêu cầu mỗi giây, cho phép tăng đột biến lên 60. Ứng dụng khách vượt giới hạn sẽ nhận được `429` với `Retry-After`.                                                        |
| API 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. Ứng dụng khách vượt giới hạn sẽ nhận được `Max rate limit reached`, giống như phản hồi của Etherscan.                            |
| Xác minh hợp đồng                      | 30 mỗi giờ. Một yêu cầu lớn hơn khoảng 300 KB sẽ bị `413` (xem [Xây dựng trên Ostia](https://docs.rome.builders/vi/canton-zk-evm/build-on-ostia.md#verify-a-large-contract)). |

Tệp [README của explorer](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md#the-public-rpc) trên nhánh chính mô tả đầy đủ các quy tắc RPC, bao gồm giới hạn tổng thể đối với các lệnh gọi nặng.

## Chuỗi yên ắng tạo một khối mỗi phút

Ostia tạo khối ngay khi có giao dịch đang chờ. Nếu không có khối nào được tạo trong 60 giây, hệ thống tạo một khối rỗng như nhịp tim. Trên chuỗi không hoạt động, trình tạo bắt đầu khối đó 60 giây sau khi ghi nhận lần commit trước; thời gian chứng minh và hoàn tất khối cộng thêm vào đó, vì vậy một chuỗi yên ắng nhưng hoạt động tốt sẽ không quá vài phút mà không có khối mới. Nếu có sự cố, khối tiếp theo có thể bị trễ. Trước sáng ngày 2026-10-25, không có nhịp tim và một chuỗi không hoạt động có thể không tạo khối trong nhiều giờ. Trong những khoảng yên ắng từ 07:53 đến 08:49 UTC hôm đó, các khối rỗng được tạo cách nhau khoảng 75 giây (chờ một phút, sau đó là thời gian chứng minh và commit một khối rỗng). Giao dịch của bạn không phải chờ nhịp tim: như trước đây, giao dịch sẽ được đưa vào khối tiếp theo được tạo.

Một khối chứa số giao dịch tối đa có thể nằm trong giới hạn gas 60,000,000, tính theo lượng gas chúng sử dụng, và giới hạn byte thô là 393,216 trên DevNet. Khoảng 2,857 giao dịch chuyển tiền thông thường vừa với giới hạn gas. (Cho đến 2026-10-27, giới hạn gas là 30,000,000, đủ cho 1,428 giao dịch chuyển tiền thông thường; giới hạn byte là 196,608 kể từ 2026-10-25. Các số liệu thông lượng trong [Số liệu đo](https://docs.rome.builders/vi/canton-zk-evm/measurements.md) được thu thập với giới hạn gas 30,000,000 và giới hạn byte từ 65,536 đến 196,608.)

## Tài sản Canton trên DevNet

Kể từ 2026-10-29, token ERC-20 có thể tồn tại trên Canton dưới dạng token song sinh, và Canton Coin có thể được chuyển sang Ostia rồi chuyển ngược lại. Bạn nạp ERC-20 vào kho lưu trữ, còn bên Canton mà bạn chỉ định sẽ giữ lượng token song sinh tương ứng, một token CIP-0056 có mã định danh công cụ là `erc20:<token address>`. Khi quy đổi, token song sinh bị đốt và ERC-20 được trả lại từ kho lưu trữ. Với Canton Coin, một bên gửi coin qua cổng kết nối rồi nhận token CC trên Ostia; khi đốt CC, Canton Coin sẽ được trả lại. [Nạp, rút và thanh toán](https://docs.rome.builders/vi/canton-zk-evm/deposits-withdrawals-payments.md) mô tả các luồng này.

| Mục                                                                                                                                                                        | Địa chỉ trên Ostia DevNet                    |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- |
| Gateway, hợp đồng bạn gọi để thực hiện `pay`, `withdraw` và `claim` (xem [README của gateway](https://github.com/rome-protocol/canton-zk-evm/blob/main/gateway/README.md)) | `0xa7E0000000000000000000000000000000000000` |
| Vault                                                                                                                                                                      | `0x69f13a94f986021f1a7650eb611bf9b717aa495a` |
| TKA, một token ERC-20 có token song sinh (18 chữ số thập phân)                                                                                                             | `0xf4b69022b3e6501101600743f17fbe0659dd1af8` |
| WtROME, tROME được bọc, token song sinh thứ hai (18 chữ số thập phân)                                                                                                      | `0xc221fc4af51caa9d198e70e3cb3b8f3d9d2adc64` |
| CC, Canton Coin trên Ostia (10 chữ số thập phân; các bản ghi trước đây gọi là wCC)                                                                                         | `0x4db3dea7c13116961fd3e438542ccfcca61a7547` |

Trang [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins) của explorer hiển thị nguồn cung của từng token song sinh bên cạnh lượng mà kho lưu trữ nắm giữ. Dịch vụ đăng ký token song sinh phản hồi tại `https://ostia.devnet.romeprotocol.xyz/twin-registry`; dịch vụ này không giữ khóa và không ghi dữ liệu lên Canton. Hãy yêu cầu đường dẫn đầy đủ: đường dẫn trần `/twin-registry/` trả về `404`. `GET /twin-registry/healthz` cho biết số lượng token song sinh và các kho lưu trữ, còn `GET /twin-registry/twin/v1/twins` cho biết token và mã định danh công cụ của từng token song sinh, cùng các kho lưu trữ.

Phía Canton của thao tác khóa hoặc quy đổi cần một bên Canton ký xác nhận. Trang Bridge của explorer thực hiện các thao tác bằng ví Canton bạn đã có; xem [Bridge](https://docs.rome.builders/vi/canton-zk-evm/bridge.md). Trang [Lệnh gọi bên ngoài](https://docs.rome.builders/vi/canton-zk-evm/explorer.md#external-calls) chế độ xem cho biết mỗi khối được xác nhận trên Canton như thế nào.

## Canton trên DevNet

Trình xác thực DevNet của Rome, với hai bên tham gia, chạy Splice 0.10.1 cùng Canton 3.7.2 từ ngày 2026-11-07. Bộ đồng bộ của DevNet chạy phiên bản giao thức 37 từ ngày 2026-11-18. Các bài kiểm thử của Ostia chạy trên phiên bản giao thức 36 và 37.

## Tạm dừng và bảo trì

DevNet thỉnh thoảng tạm dừng, một số lần đã được lên kế hoạch. Tùy nguyên nhân, việc tạm dừng sẽ có một trong hai biểu hiện sau:

* Khi **máy khởi động lại** RPC không thể truy cập và trả về lỗi máy chủ (mã 5xx từ proxy phía trước).
* Khi **trình xác thực hoặc bộ đồng bộ tạm dừng** RPC vẫn phản hồi và tiếp nhận giao dịch, nhưng không có khối nào được xác nhận, vì vậy không có khối cuối mới và cũng không có biên nhận cho đến khi `/api/health` cho biết `ok` trở lại.

Giao dịch mà Ostia đã chấp nhận trước khi tạm dừng được giữ lại cùng các byte đã ký và gửi lại sau đó, trong tối đa một giờ, vì vậy hãy chờ `/api/health` cho biết `ok` rồi mới gửi lại.

* **Khởi động lại trong vài phút.** Máy của Ostia có thể khởi động lại mà không báo trước. Ngày 2026-11-04, đã có ba lần khởi động lại; mỗi lần tự khôi phục sau khoảng 7 phút.
* **Nâng cấp trình xác thực.** Trình xác thực DevNet của Rome được nâng cấp theo định kỳ và Ostia ngừng xác nhận khối trong thời gian đó. Đợt nâng cấp ngày 2026-11-04 dự kiến kéo dài 15 phút.
* **2026-11-16: thay đổi cài đặt truy cập của trình xác thực DevNet của Rome (09:00 đến 10:30 UTC) và nâng cấp hệ thống chứng minh lên ZisK 1.4.0-alpha (13:31 UTC).** Ostia tạm dừng trong cả hai lần. Cả hai việc đã hoàn tất, giao dịch và cầu nối đều hoạt động trở lại sau mỗi lần tạm dừng.
* **2026-11-18: nâng cấp bộ đồng bộ của DevNet lên phiên bản giao thức 37 (14:00 UTC).** Ostia vẫn hoạt động trong suốt quá trình đó; khoảng cách dài nhất giữa các khối cuối là 72 giây.
* **2026-11-21, 12:00 đến 16:00 UTC:** Ostia chuyển sang Canton TestNet. Các khối tạm dừng trong quá trình chuyển; tROME, token và hợp đồng sẽ chuyển cùng chuỗi. Địa chỉ mới: ostia.testnet.romeprotocol.xyz. Canton Coin và các token khác được bảo chứng bởi Canton trên Ostia vẫn ở DevNet và không được chuyển.

Chúng tôi đăng các ngày này và mọi thay đổi tại đây, trên trang [Trạng thái và lộ trình](https://docs.rome.builders/vi/canton-zk-evm/status.md#upcoming-maintenance) và trong [Discord](https://discord.gg/vZ9rnCdNSB).

## Lưu lượng Canton: ai trả phí

Mỗi giao dịch Canton đều sử dụng lưu lượng. Bên gửi giao dịch trả phí cho lưu lượng đó, còn mỗi bên xác nhận trả phí cho các xác nhận mà mình gửi. Trên DevNet, cả hai vai trò đều do bên tham gia của Rome đảm nhiệm: bên này gửi và trả phí cho mỗi `Advance` của khối, cũng như các bước Canton mà các bên của chính Rome thực hiện, đồng thời là bên tham gia duy nhất xác nhận các khối của Ostia. Hiện tại, bạn không phải trả phí lưu lượng Canton. Chi phí của bạn là tROME dùng làm gas trên Ostia, và tROME không có giá trị.

Một khối tiêu tốn khoảng 8,4 KB lưu lượng, cộng thêm khoảng 100 byte cho mỗi giao dịch trong khối (đo trong một giờ vào ngày 2026-10-24: khối ở mức trung vị tiêu tốn 15,7 KB; xem [Số liệu đo](https://docs.rome.builders/vi/canton-zk-evm/measurements.md#what-a-block-costs-on-canton)). Với khoảng 2.200 khối mỗi ngày, tổng cộng là khoảng 17 đến 35 MB mỗi ngày. Rome giới hạn lưu lượng Canton của Cầu nối theo tài khoản và theo ngày. Trang này không đưa ra giá mỗi MB, vì giá do mạng Canton quyết định; cách thanh toán lưu lượng trên mạng ngoài DevNet vẫn chưa được quyết định.

## DevNet có thể được đặt lại

Ostia DevNet là một mạng thử nghiệm. Mạng có thể được đặt lại, tạo ra một chuỗi mới với cùng chain id là 770101. Đừng lưu giữ trên đó bất cứ thứ gì mà bạn không thể tạo lại.

Vì chain id không đổi, mọi giao dịch đã ký cho chuỗi cũ cũng hợp lệ trên chuỗi mới. Bất kỳ ai cũng có thể gửi lại các giao dịch cũ đã ký, với nonce 0, 1, 2, v.v., để lặp lại các lần triển khai và phê duyệt trước đây của bạn trên chuỗi mới, cũng như các khoản chi trả công khai từ vòi. Đừng dùng lại khóa quan trọng sau khi đặt lại, và hãy dùng địa chỉ triển khai mới sau đó. Trạng thái đã lưu của các công cụ cũng được gắn với chain id nên sẽ lỗi thời: hãy xóa dữ liệu của Hardhat Ignition tại `deployments/chain-770101`, của Foundry tại `broadcast/<script>/770101`, cũng như hoạt động và nonce của mạng trong ví của bạn (trong MetaMask, chọn Settings, Advanced, Clear activity tab data). Khi có thể, chúng tôi sẽ thông báo trước về việc đặt lại tại các nơi được liệt kê trong mục [Tạm dừng và bảo trì](#pauses-and-maintenance).

Thông tin về những gì được chứng minh trên DevNet và những gì không được chứng minh nằm tại [Điều gì đã được chứng minh và điều gì chưa](https://docs.rome.builders/vi/canton-zk-evm/what-is-proven.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/devnet.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.
