> 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/pt-br/canton-zk-evm/devnet.md).

# Ostia DevNet

Detalhes da rede para a Ostia DevNet, com o ID da chain, RPC, explorer, APIs, configuração da carteira, faucet e limites.

A Ostia DevNet é a rede pública da Ostia. Ela é executada na Canton Network DevNet e está ativa desde **2026-10-22**. As ferramentas EVM comuns funcionam nela: carteiras, Foundry, Hardhat, ethers e viem. Esta página contém os valores necessários para se conectar. [Build on Ostia](https://docs.rome.builders/pt-br/canton-zk-evm/build-on-ostia.md) orienta você desde esse ponto até a implantação e verificação de um contrato.

Desde **2026-10-29** a rede também movimenta ativos da Canton nos dois sentidos: tokens ERC-20 têm equivalentes (gêmeos) na Canton, e a Canton Coin pode ser transferida para a Ostia e de volta. Os endereços estão em [Ativos da Canton na DevNet](#canton-assets-on-devnet) abaixo.

## Detalhes da rede

| Configuração                 | Valor                                                                                                   |
| ---------------------------- | ------------------------------------------------------------------------------------------------------- |
| Nome da rede                 | Ostia DevNet                                                                                            |
| ID da chain                  | `770101` (hex `0xbc035`)                                                                                |
| Moeda                        | tROME, 18 casas decimais. Ela não tem valor.                                                            |
| RPC                          | `https://ostia.devnet.romeprotocol.xyz/rpc` (somente HTTP, apenas blocos finalizados)                   |
| Explorador                   | [ostia.devnet.romeprotocol.xyz](https://ostia.devnet.romeprotocol.xyz)                                  |
| API compatível com Etherscan | `https://ostia.devnet.romeprotocol.xyz/api`                                                             |
| API REST                     | `https://ostia.devnet.romeprotocol.xyz/api/...`, descrita pelo documento OpenAPI em `/api/openapi.json` |
| Status e integridade         | `/api/status` e `/api/health` no endereço do explorador                                                 |

O preço do gás é de cerca de 1 gwei, e cada bloco comporta até 60.000.000 de gás. Uma única transação pode consumir no máximo 16.777.216 de gás (2^24), o limite definido pelo hard fork Osaka. Há algumas diferenças em relação ao Ethereum, como `block.prevrandao` ser igual a 0 e a ausência de transações com blobs; consulte [Diferenças em relação ao Ethereum](https://docs.rome.builders/pt-br/canton-zk-evm/evm-differences.md).

## Adicione a uma carteira

No MetaMask ou em outra carteira, adicione uma rede personalizada com estes valores:

| Campo                       | Valor                                       |
| --------------------------- | ------------------------------------------- |
| Nome da rede                | Ostia DevNet                                |
| Novo URL de RPC             | `https://ostia.devnet.romeprotocol.xyz/rpc` |
| ID da chain                 | `770101`                                    |
| Símbolo da moeda            | `tROME`                                     |
| URL do explorador de blocos | `https://ostia.devnet.romeprotocol.xyz`     |

O explorador também pode fazer isso por você. Abra a [página da API](https://ostia.devnet.romeprotocol.xyz/docs/api) e pressione o botão que adiciona a rede à sua carteira.

## Obter tROME

Todo mundo recebe 1 tROME por dia. Desenvolvedores podem receber 100 tROME por meio do subsídio para desenvolvedores, uma vez a cada 7 dias. Acesse a [torneira](https://ostia.devnet.romeprotocol.xyz/faucet), cole seu endereço e solicite. Você também pode fazer a solicitação pelo terminal:

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

Uma solicitação aceita retorna `202` um `ticket`. Consulte `GET /api/faucet/ticket/<ticket>` até que o status seja `final` (ou `failed`). O status passa de `queued` para `sent` para `final`. Use o endereço da sua carteira no lugar de `0xYourAddress`. A torneira oferece:

* 1 tROME por endereço a cada 24 horas;
* uma solicitação por endereço IP a cada 10 minutos;
* no máximo 5.000 pagamentos por hora para todos, somados.

Os pagamentos são enviados em lotes de até 100. Você receberá o seu quando o bloco correspondente for final na Canton, o que leva cerca de 10 a 30 segundos após o envio. Um tROME paga milhares de transações comuns ao preço atual do gás. Os limites da torneira estão na [seção sobre a torneira do README do explorador](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md#the-faucet).

### O subsídio para desenvolvedores

Quem desenvolve e entra com o GitHub recebe 100 tROME em vez de 1. Na página Faucet, digite seu endereço e escolha "Entrar com o GitHub" na linha "Desenvolvendo na Ostia? Entre com o GitHub para receber 100 tROME." A página Bridge oferece a mesma opção em "Obter tROME de teste", para a carteira conectada, desde que ela ainda não tenha tROME; caso contrário, use a página Faucet. O GitHub redireciona você de volta à página Faucet, que acompanha seu subsídio até a finalização, como qualquer solicitação. A página não solicita nenhuma permissão ao GitHub e consulta apenas o número da sua conta e a data de criação.

* A conta do GitHub deve ter pelo menos 30 dias.
* Um subsídio por conta do GitHub e um por endereço a cada 7 dias.
* No máximo 200 subsídios por dia para todos, somados.

O 1 tROME diário continua disponível para todos, com ou sem uma conta do GitHub. A resposta de `GET /api/faucet` mostra se o subsídio está ativo, além do valor e dos limites. As regras estão na seção sobre [o subsídio para desenvolvedores](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md#the-builder-grant) do README do explorador.

### Canton Coin de teste

A página Bridge não tem uma torneira de Canton Coin desde 2026-11-17 (ela atendia apenas à conta Bridge, que foi desativada). Obtenha Canton Coin de teste na sua própria carteira Canton.

## Limitações

O RPC em `/rpc` encaminha as solicitações para a cadeia, com estas diferenças:

* Ele responde a 20 métodos: `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` e `eth_sendRawTransaction`. Qualquer outro método responde `-32601`.
* Não há WebSocket nem `eth_newFilter` ou `eth_subscribe`. Para acompanhar eventos, consulte periodicamente `eth_getLogs`.
* Ele mostra apenas blocos finalizados na Canton. `latest`, `safe`, `pending` e `finalized` todos significam o bloco finalizado mais recente (exceto `eth_getTransactionCount` com `pending`, que conta as transações pendentes para que sua carteira escolha o próximo nonce). Um recibo fica disponível assim que o bloco é finalizado, o que leva cerca de 10 a 30 segundos.
* Cada cliente pode fazer 300 chamadas por minuto. Cada chamada de um lote é contabilizada, e cada lote pode conter no máximo 20 chamadas. O corpo de uma solicitação pode ter até 256 KiB.
* Uma transação cujo nonce é maior que o próximo nonce da conta é rejeitada por haver uma lacuna de nonce. Envie primeiro as transações que faltam.
* Uma transação cujo valor máximo da taxa por gas está abaixo da taxa base atual é rejeitada. Carteiras e ferramentas definem esse valor automaticamente.

As APIs do explorador têm seus próprios limites por cliente e não exigem chaves:

| Interface                             | Limite                                                                                                                                                                                             |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| API REST (`/api/...`)                 | 20 solicitações por segundo, com picos de até 60. Um cliente que exceder o limite recebe `429` com `Retry-After`.                                                                                  |
| API compatível com Etherscan (`/api`) | 10 solicitações por segundo e 600 por minuto. Um cliente que exceder o limite recebe `Max rate limit reached`, como nas respostas do Etherscan.                                                    |
| Verificação de contratos              | 30 por hora. Uma solicitação com mais de cerca de 300 KB recebe `413` (consulte [Desenvolver na Ostia](https://docs.rome.builders/pt-br/canton-zk-evm/build-on-ostia.md#verify-a-large-contract)). |

O [README do explorer](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md#the-public-rpc) na branch principal descreve as regras de RPC em detalhes, incluindo o limite global de chamadas pesadas.

## Uma rede tranquila gera um bloco por minuto

A Ostia gera um bloco assim que há transações aguardando. Quando nenhum bloco é gerado por 60 segundos, ela gera um bloco vazio, um sinal de atividade. Em uma rede ociosa, o construtor inicia esse bloco 60 segundos após registrar o commit anterior; a geração da prova e a liquidação levam mais tempo, portanto uma rede tranquila e saudável não passa mais do que alguns minutos sem um novo bloco. Se algo falhar, o próximo bloco pode atrasar. Antes da manhã de 2026-10-25, não havia sinal de atividade, e uma rede ociosa podia passar horas sem gerar um bloco. Nos períodos tranquilos entre 07:53 e 08:49 UTC daquele dia, os blocos vazios foram gerados com cerca de 75 segundos de intervalo (um minuto de espera, seguido pelo tempo para gerar a prova e confirmar um bloco vazio). Sua transação não espera pelo sinal de atividade: ela entra no próximo bloco gerado, como antes.

Um bloco comporta tantas transações quantas couberem dentro do limite de gas de 60,000,000, contabilizado pelo gas que elas consomem, e do limite de bytes brutos, que é de 393,216 na DevNet. Cerca de 2,857 transferências simples cabem no limite de gas. (Até 2026-10-27, o limite de gas era 30,000,000, comportando 1,428 transferências simples, e o limite de bytes era 196,608 desde 2026-10-25. Os números de throughput em [Medições](https://docs.rome.builders/pt-br/canton-zk-evm/measurements.md) foram obtidos com o limite de gas de 30,000,000 e limites de bytes entre 65,536 e 196,608.)

## Ativos do Canton na DevNet

Desde 2026-10-29, tokens ERC-20 podem existir no Canton como gêmeos, e Canton Coin pode ser transferida para a Ostia e de volta. Você deposita um ERC-20 no cofre, e a parte do Canton que você indicar fica com a mesma quantidade do seu gêmeo, um token CIP-0056 cujo ID do instrumento é `erc20:<token address>`. O resgate queima o gêmeo e devolve o ERC-20 do cofre. Para Canton Coin, uma parte a deposita por meio do gateway e reivindica o token CC na Ostia; queimar CC devolve a Canton Coin. [Depósitos, saques e pagamentos](https://docs.rome.builders/pt-br/canton-zk-evm/deposits-withdrawals-payments.md) contém os fluxos.

| O que                                                                                                                                                                            | Endereço na Ostia DevNet                     |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- |
| Gateway, o contrato que você chama para `pay`, `withdraw` e `claim` (consulte o [README do gateway](https://github.com/rome-protocol/canton-zk-evm/blob/main/gateway/README.md)) | `0xa7E0000000000000000000000000000000000000` |
| Vault                                                                                                                                                                            | `0x69f13a94f986021f1a7650eb611bf9b717aa495a` |
| TKA, um ERC-20 que tem um gêmeo (18 casas decimais)                                                                                                                              | `0xf4b69022b3e6501101600743f17fbe0659dd1af8` |
| WtROME, tROME wrapped, o segundo gêmeo (18 casas decimais)                                                                                                                       | `0xc221fc4af51caa9d198e70e3cb3b8f3d9d2adc64` |
| CC, Canton Coin na Ostia (10 casas decimais; registros anteriores chamam de wCC)                                                                                                 | `0x4db3dea7c13116961fd3e438542ccfcca61a7547` |

A página [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins) do explorer mostra a oferta de cada gêmeo ao lado do que o cofre mantém. O serviço de registro de gêmeos responde em `https://ostia.devnet.romeprotocol.xyz/twin-registry`; ele não mantém nenhuma chave nem grava nada no Canton. Informe um caminho completo: o caminho simples `/twin-registry/` responde `404`. `GET /twin-registry/healthz` retorna o número de gêmeos e dos cofres, e `GET /twin-registry/twin/v1/twins` retorna o token e o ID do instrumento de cada gêmeo, além dos cofres.

O lado Canton de um bloqueio ou resgate precisa de uma parte do Canton que assine. A página Bridge do explorer realiza as operações usando a carteira Canton que você já tem; consulte [Bridge](https://docs.rome.builders/pt-br/canton-zk-evm/bridge.md). A página [Chamadas externas](https://docs.rome.builders/pt-br/canton-zk-evm/explorer.md#external-calls) A visualização mostra como cada bloco é confirmado no Canton.

## Canton na DevNet

O validador da DevNet da Rome, com dois participantes, executa o Splice 0.10.1 com o Canton 3.7.2 desde 2026-11-07. O sincronizador da DevNet executa a versão 37 do protocolo desde 2026-11-18. Os testes da Ostia são executados nas versões 36 e 37 do protocolo.

## Pausas e manutenção

A DevNet tem pausas de vez em quando, e algumas são programadas. A pausa pode ocorrer de uma destas duas formas, dependendo da causa:

* Durante uma **reinicialização da máquina** o RPC fica inacessível e responde com um erro do servidor (um erro 5xx do proxy de front-end).
* Durante uma **pausa do validador ou do sincronizador** o RPC continua respondendo e aceitando transações, mas nenhum bloco é confirmado. Portanto, não há novo bloco final nem recibo até que `/api/health` indique `ok` novamente.

Uma transação aceita pela Ostia antes de uma pausa fica armazenada com os bytes assinados e é enviada novamente após a pausa, por até uma hora. Portanto, aguarde até que `/api/health` indique `ok` antes de reenviá-la.

* **Reinicializações de alguns minutos.** As máquinas da Ostia podem ser reinicializadas sem aviso. Em 2026-11-04, isso aconteceu três vezes; em cada caso, a máquina se recuperou sozinha em cerca de 7 minutos.
* **Atualizações do validador.** O validador da DevNet da Rome é atualizado de tempos em tempos, e a Ostia para de confirmar blocos durante a atualização. A atualização de 2026-11-04 foi programada para durar 15 minutos.
* **2026-11-16: configurações de acesso do validador da DevNet da Rome (09:00 a 10:30 UTC) e atualização do sistema de prova para o ZisK 1.4.0-alpha (13:31 UTC).** A Ostia ficou pausada em ambos os casos. As duas operações foram concluídas, e as transações e a bridge voltaram a funcionar após cada pausa.
* **2026-11-18: atualização do sincronizador da DevNet para a versão 37 do protocolo (14:00 UTC).** A Ostia continuou funcionando durante a atualização; o maior intervalo entre blocos finais foi de 72 s.
* **2026-11-21, das 12:00 às 16:00 UTC:** A Ostia migra para a Canton TestNet. Os blocos ficam pausados durante a migração; tROME, tokens e contratos migram junto com a cadeia. Novo endereço: ostia.testnet.romeprotocol.xyz. O Canton Coin e outros tokens na Ostia lastreados pelo Canton permanecem na DevNet e não são migrados.

Publicamos estas datas e quaisquer alterações nesta página, na página [Status e roteiro](https://docs.rome.builders/pt-br/canton-zk-evm/status.md#upcoming-maintenance) e no [Discord](https://discord.gg/vZ9rnCdNSB).

## Tráfego do Canton: quem paga

Toda transação no Canton usa tráfego. O participante que envia a transação paga por ela, e cada participante que confirma paga pelas confirmações que envia. Na DevNet, o participante da Rome é responsável pelas duas coisas: ele envia e paga o `Advance` de cada bloco e pelas etapas do Canton executadas pelas próprias partes da Rome; além disso, é o único participante que confirma os blocos da Ostia. Hoje, você não paga nada pelo tráfego do Canton. Seu custo é o tROME usado para pagar o gas na Ostia, e o tROME não tem valor.

Um bloco consome cerca de 8,4 KB de tráfego, mais cerca de 100 bytes por transação incluída (medido ao longo de uma hora em 2026-10-24: 15,7 KB para um bloco mediano; consulte [Medições](https://docs.rome.builders/pt-br/canton-zk-evm/measurements.md#what-a-block-costs-on-canton)). Com cerca de 2.200 blocos por dia, isso equivale a aproximadamente 17 a 35 MB por dia. A Rome limita o tráfego do Canton da Bridge por conta e por dia. Esta página não informa um preço por MB, pois ele é definido pela rede Canton, e ainda não foi decidido como o tráfego será pago em uma rede além da DevNet.

## A DevNet pode ser redefinida

A DevNet da Ostia é uma rede de testes. Ela pode ser redefinida, o que inicia uma nova cadeia com o mesmo ID de cadeia, 770101. Não mantenha nela nada que não possa recriar.

Como o ID da cadeia permanece igual, todas as transações assinadas para a cadeia antiga também são válidas na nova. Qualquer pessoa pode reenviar as transações antigas assinadas, com nonces 0, 1, 2 e assim por diante, repetindo na nova cadeia suas implantações e aprovações anteriores, além dos pagamentos públicos do faucet. Não reutilize uma chave importante após uma redefinição e use um novo endereço de implantação. O estado salvo pelas suas ferramentas também é indexado pelo ID da cadeia e fica desatualizado: limpe `deployments/chain-770101`do Hardhat Ignition, `broadcast/<script>/770101`do Foundry e a atividade e o nonce da rede na sua carteira (no MetaMask, acesse Settings, Advanced e a guia Clear activity tab data). Quando possível, anunciamos a redefinição com antecedência nos canais indicados em [Pausas e manutenção](#pauses-and-maintenance).

O que é provado na DevNet e o que não é está em [O que é comprovado e o que não é](https://docs.rome.builders/pt-br/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/pt-br/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.
