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

# Comece aqui

Um ponto de partida para cada leitor de Ostia, com as ferramentas que você usa e onde procurar, seja para criar apps, validar no Canton, executar um provador, auditar ou rodar sua própria Ostia.

| Quero                                                                     | Comece aqui                                                                                                                                                                 |
| ------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Implantar um app                                                          | [Desenvolvedores de apps](#app-builders)                                                                                                                                    |
| Veja o que você pode criar com Canton e o que já foi executado na DevNet  | [Desenvolver com Canton](https://docs.rome.builders/pt-br/canton-zk-evm/build-with-canton.md) e [Casos de uso](https://docs.rome.builders/pt-br/canton-zk-evm/use-cases.md) |
| Obter uma carteira e moedas de teste                                      | [Usuários](#users)                                                                                                                                                          |
| Obter 100 tROME como desenvolvedor                                        | [A concessão para desenvolvedores](https://docs.rome.builders/pt-br/canton-zk-evm/devnet.md#the-builder-grant)                                                              |
| Transferir tokens entre Ostia e Canton com uma carteira no navegador      | [Bridge](https://docs.rome.builders/pt-br/canton-zk-evm/bridge.md)                                                                                                          |
| Veja como cada bloco é confirmado na Canton                               | [Chamadas externas](https://docs.rome.builders/pt-br/canton-zk-evm/explorer.md#external-calls)                                                                              |
| Saiba como funcionam os tokens ERC-20 espelhados e o Canton Coin          | [Ativos Canton bidirecionais](#two-way-canton-assets)                                                                                                                       |
| Execute o Ostia em um participante Canton ou veja quem confirma os blocos | [Validadores Canton e operadores de participantes](#canton-validators-and-participant-operators)                                                                            |
| Executar um provador                                                      | [Operadores de provadores](#prover-operators)                                                                                                                               |
| Veja o que a prova corrige e o que não corrige                            | [Modelo de confiança e limitações](https://docs.rome.builders/pt-br/canton-zk-evm/trust-model.md)                                                                           |
| Auditar o código                                                          | [Auditores e pesquisadores](#auditors-and-researchers)                                                                                                                      |
| Executar minha própria instância do Ostia                                 | [Execute sua própria instância do Ostia](https://docs.rome.builders/pt-br/canton-zk-evm/run-it-locally.md)                                                                  |

Todo o código está em um único repositório público, [rome-protocol/canton-zk-evm](https://github.com/rome-protocol/canton-zk-evm), sob a licença Apache 2.0. Os links para o código nesta página apontam para a branch principal; [Status](https://docs.rome.builders/pt-br/canton-zk-evm/status.md) indica o commit executado pela DevNet. Os apps estão em [`apps/accounts`](https://github.com/rome-protocol/canton-zk-evm/tree/main/apps/accounts), [`apps/twin`](https://github.com/rome-protocol/canton-zk-evm/tree/main/apps/twin) (com seu [serviço de registro](https://github.com/rome-protocol/canton-zk-evm/tree/main/apps/twin/registry)) e [`apps/otc`](https://github.com/rome-protocol/canton-zk-evm/tree/main/apps/otc). A versão [v0.1.0](https://github.com/rome-protocol/canton-zk-evm/releases/tag/v0.1.0) é a primeira tag, criada antes dos apps.

## Desenvolvedores de apps

Ostia executa contratos EVM por HTTP JSON-RPC na Canton DevNet. Não foi auditado, sua moeda de teste não tem valor e a DevNet pode ser redefinida. A Rome executa o desenvolvedor, o provador e o único participante que confirma. Alguns comportamentos diferem do Ethereum; leia [Diferenças em relação ao Ethereum](https://docs.rome.builders/pt-br/canton-zk-evm/evm-differences.md) primeiro. Contratos desenvolvidos para Osaka ou versões anteriores são executados aqui (`london` é um alvo seguro), seguindo as mesmas etapas de implantação do Ethereum. Consulte os [limites de RPC](https://docs.rome.builders/pt-br/canton-zk-evm/devnet.md#limits) antes de conectar um app existente.

**O que você vai usar**

* Foundry 1.8: `forge create` para implantar, e `forge verify-contract` com a API compatível com Etherscan do explorador.
* Hardhat 2 para fazer o deploy.
* ethers para ler e enviar. O kit de carga mista (`load/mixed`) usa essa configuração. [Build on Ostia](https://docs.rome.builders/pt-br/canton-zk-evm/build-on-ostia.md#viem-and-ethers) também tem uma configuração com viem.
* Uma carteira EVM configurada com os valores da rede ou pelo botão na página de API do explorador.
* Contratos da OpenZeppelin. Tokens ERC-20, ERC-721 e ERC-1155 criados com eles já foram executados na Ostia, assim como um token permissionado ERC-3643 (T-REX) e o Uniswap V2.
* O kit de carga também enviou transferências privadas para os contratos Merces da TACEO. As provas Groth16 foram geradas no cliente e verificadas on-chain. Nenhuma rede MPC foi executada e nada foi liquidado.

A configuração com viem e as etapas para configurar a carteira estão documentadas, mas não foram testadas de ponta a ponta aqui. Outras ferramentas EVM não foram testadas. O RPC não oferece WebSocket, nem `eth_newFilter` nem `eth_subscribe`, então use polling com `eth_getLogs`. Um recibo aparece quando o bloco é finalizado na Canton, o que leva cerca de 10 a 30 segundos.

**Onde procurar**

* [Ostia DevNet](https://docs.rome.builders/pt-br/canton-zk-evm/devnet.md): ID da chain, RPC, valores da carteira, limites, pausas e manutenção.
* [Diferenças em relação ao Ethereum](https://docs.rome.builders/pt-br/canton-zk-evm/evm-differences.md): PREVRANDAO, transações com blobs, tempo de bloco e outros detalhes.
* [Build on Ostia](https://docs.rome.builders/pt-br/canton-zk-evm/build-on-ostia.md): faça o deploy e verifique com Foundry ou Hardhat e, em seguida, conecte-se com viem ou ethers.
* [Explorador](https://docs.rome.builders/pt-br/canton-zk-evm/explorer.md): APIs, verificação de contratos, torneira e página de chamadas externas.
* [A concessão para desenvolvedores](https://docs.rome.builders/pt-br/canton-zk-evm/devnet.md#the-builder-grant): 100 tROME para desenvolvedores que fizerem login com o GitHub.
* [Build with Canton](https://docs.rome.builders/pt-br/canton-zk-evm/build-with-canton.md): twins, Canton Coin, pagamentos com participantes da Canton e um ambiente da Canton.
* [Casos de uso](https://docs.rome.builders/pt-br/canton-zk-evm/use-cases.md): o que funciona hoje na DevNet ou em uma rede própria.
* [Experimente a Ostia](https://github.com/rome-protocol/canton-zk-evm/blob/main/docs/TRY-OSTIA.md): a versão resumida no repositório.
* [load/mixed](https://github.com/rome-protocol/canton-zk-evm/tree/main/load/mixed): o kit que implanta tudo isso. Ele contém os scripts e nossos próprios contratos; as importações de pacotes e uma etapa de busca trazem o restante.

## Usuários

**O que você vai usar**

* Uma carteira com a Ostia DevNet adicionada.
* A torneira de moedas de teste: 1 tROME por endereço ao dia para todos e 100 tROME para desenvolvedores que fizerem login com o GitHub. tROME não tem valor.
* O explorador para encontrar sua transação, verificar o bloco e, em [Chamadas externas](https://docs.rome.builders/pt-br/canton-zk-evm/explorer.md#external-calls), acompanhar como cada bloco é confirmado na Canton.
* A página [Bridge](https://docs.rome.builders/pt-br/canton-zk-evm/bridge.md) para transferir tokens entre a Ostia e a Canton e enviar tokens na Canton usando uma carteira de navegador.

**Onde procurar**

* [Ostia DevNet](https://docs.rome.builders/pt-br/canton-zk-evm/devnet.md#add-it-to-a-wallet): configuração da carteira.
* [Obter tROME](https://docs.rome.builders/pt-br/canton-zk-evm/devnet.md#get-trome): a torneira e [a concessão para desenvolvedores](https://docs.rome.builders/pt-br/canton-zk-evm/devnet.md#the-builder-grant).
* [Explorador](https://docs.rome.builders/pt-br/canton-zk-evm/explorer.md): leia um bloco e verifique sua prova no navegador.
* [Chamadas externas](https://docs.rome.builders/pt-br/canton-zk-evm/explorer.md#external-calls): o commit de Canton de cada bloco, com seu tempo de liquidação.
* [Bridge](https://docs.rome.builders/pt-br/canton-zk-evm/bridge.md): mova tokens entre Ostia e Canton usando a carteira Canton que você já tem.
* [Como funciona](https://docs.rome.builders/pt-br/canton-zk-evm/how-it-works.md#from-your-transaction-to-final-on-canton): o que significa “final”, da sua transação até um bloco de Canton confirmado.

## Ativos Canton bidirecionais

Desde 2026-10-29, os ativos podem ser transferidos nos dois sentidos. Um ERC-20 na Ostia pode ter um token gêmeo na Canton: você o deposita no cofre e uma conta Canton mantém a mesma quantidade; ao resgatar, o ERC-20 é devolvido. Canton Coin chega à Ostia como o token CC e também pode voltar. A página [Bridge](https://docs.rome.builders/pt-br/canton-zk-evm/bridge.md) do explorador permite fazer essas transferências com uma carteira de navegador e a carteira Canton que você já tem, ativando cada uma delas individualmente. Primeiro, obtenha tROME de teste. O explorador mostra o suprimento de cada token gêmeo em comparação com o que está no cofre.

**Onde procurar**

* [Bridge](https://docs.rome.builders/pt-br/canton-zk-evm/bridge.md): a página Bridge, as quatro transferências e os tempos medidos.
* [Depósitos, saques e pagamentos](https://docs.rome.builders/pt-br/canton-zk-evm/deposits-withdrawals-payments.md#canton-twins-of-erc-20-tokens): os fluxos de bloqueio e resgate e a Canton Coin.
* [Ostia DevNet](https://docs.rome.builders/pt-br/canton-zk-evm/devnet.md#canton-assets-on-devnet): os endereços do cofre, dos tokens gêmeos e do token CC, além do serviço de registro de tokens gêmeos.
* [Explorer](https://docs.rome.builders/pt-br/canton-zk-evm/explorer.md#twins-and-canton-assets): a página `/twins` .
* [Desenvolva com Canton](https://docs.rome.builders/pt-br/canton-zk-evm/build-with-canton.md): as chamadas do registro de tokens gêmeos, Canton Coin como ERC-20, pagamentos e o ambiente de negociação OTC.
* [Modelo de confiança e limitações](https://docs.rome.builders/pt-br/canton-zk-evm/trust-model.md#what-the-twins-trust): em que os tokens gêmeos se baseiam.
* [Experimente a Ostia](https://github.com/rome-protocol/canton-zk-evm/blob/main/docs/TRY-OSTIA.md#canton-twins-and-canton-coin-on-devnet): a versão resumida no repositório.

## Validadores Canton e operadores de participantes

Na Ostia, Canton só confirma um bloco depois que um sidecar, junto a um participante confirmador, o verifica. Na DevNet, esse participante é o da Rome. O sidecar executa o verificador e confere a prova, o cabeçalho e a raiz das transações. Se a verificação falhar, o bloco não é confirmado.

Na DevNet, um único participante — o da própria Rome — hospeda todas as partes da Ostia. Seu sidecar é o único confirmador. Atualmente, nenhum outro participante confirma blocos da Ostia DevNet. O validador da Rome executa Splice 0.10.1 com Canton 3.7.2. [Modelo de confiança e limitações](https://docs.rome.builders/pt-br/canton-zk-evm/trust-model.md#local-demo-vs-ostia-devnet) compara essa configuração com um único confirmador à configuração com dois da rede local. Hoje, você pode executar sua própria Ostia em um participante que já opera, usando o modo de participante existente.

**O que você vai usar**

* O sidecar, que Canton aciona por meio da extensão de chamadas externas.
* O verificador usado para conferir a prova encapsulada.
* O pacote Daml que armazena a cadeia e seus blocos.
* Os scripts que configuram a Ostia em um participante que você já executa.

**Onde procurar**

* [sidecar/](https://github.com/rome-protocol/canton-zk-evm/tree/main/sidecar): o serviço chamado por Canton.
* [verifier/](https://github.com/rome-protocol/canton-zk-evm/tree/main/verifier): a verificação da prova, em Rust simples.
* [daml/](https://github.com/rome-protocol/canton-zk-evm/tree/main/daml): o pacote Daml, incluindo `Advance`.
* [network/README.md](https://github.com/rome-protocol/canton-zk-evm/blob/main/network/README.md#running-on-an-existing-participant-the-canton-network): “Executar em um participante existente”.
* [network/external/](https://github.com/rome-protocol/canton-zk-evm/tree/main/network/external): a configuração do participante, o sidecar e os scripts de instalação.
* [Execute sua própria Ostia](https://docs.rome.builders/pt-br/canton-zk-evm/run-it-locally.md#run-on-an-existing-participant): as mesmas etapas descritas nesta documentação.
* [Modelo de confiança e limitações](https://docs.rome.builders/pt-br/canton-zk-evm/trust-model.md#operator-confirmer-and-gateway-authority): o que o operador e o confirmador podem ver e fazer.

## Operadores de provadores

O provador transforma cada bloco em uma prova, que é verificada pelo sidecar do confirmador. Você executa o ZisK com um worker de GPU. O provador da DevNet é uma NVIDIA RTX PRO 6000 Blackwell Server Edition (96 GB) em uma máquina com 48 vCPUs. Na DevNet, a Rome executa esse único provador. Estes scripts servem para executar um provador para sua própria Ostia.

**O que você vai usar**

* `install.sh` para instalar a versão fixada do ZisK e suas chaves.
* `start.sh` para iniciar o coordenador e o worker de GPU.
* `prove-one.sh` para gerar a prova de uma entrada e verificar o resultado.
* O guest é o programa que recebe a prova. A compilação dele é executada em uma pasta fixa, para que você possa verificar se a sua compilação gera o programVK registrado.

**Onde procurar**

* [prover/](https://github.com/rome-protocol/canton-zk-evm/tree/main/prover): os scripts acima, além de `build-guest.sh`.
* [guest/](https://github.com/rome-protocol/canton-zk-evm/tree/main/guest): o guest e como verificar se a sua compilação gera o programVK registrado.
* [Host do prover Ostia](https://docs.rome.builders/pt-br/canton-zk-evm/prover-host.md): requisitos do host, compilação e execução, e reprodução da chave do guest.
* [Medições](https://docs.rome.builders/pt-br/canton-zk-evm/measurements.md): tempos de geração das provas e o hardware usado nas medições.

## Auditores e pesquisadores

**O que você vai usar**

* As regras da cadeia compiladas no guest.
* A verificação da prova e o código de prova de armazenamento.
* O registro de cadeia do Daml e sua `Advance` escolha.
* O contrato do gateway.

**Onde procurar**

* [guest/](https://github.com/rome-protocol/canton-zk-evm/tree/main/guest): o programa que recebe a prova e as regras que ele aplica.
* [verifier/](https://github.com/rome-protocol/canton-zk-evm/tree/main/verifier): a verificação da prova encapsulada.
* [mpt/](https://github.com/rome-protocol/canton-zk-evm/tree/main/mpt): provas de armazenamento Merkle-Patricia.
* [daml/](https://github.com/rome-protocol/canton-zk-evm/tree/main/daml): o registro de cadeia e a `Advance`.
* [gateway/](https://github.com/rome-protocol/canton-zk-evm/tree/main/gateway): o único contrato EVM que informa ao Canton o que um bloco precisa conter.
* [Modelo de confiança e limitações](https://docs.rome.builders/pt-br/canton-zk-evm/trust-model.md) e [O que é provado e o que não é](https://docs.rome.builders/pt-br/canton-zk-evm/what-is-proven.md): o que a prova estabelece e quem verifica cada coisa.
* [docs/DESIGN.md](https://github.com/rome-protocol/canton-zk-evm/blob/main/docs/DESIGN.md) e [SECURITY.md](https://github.com/rome-protocol/canton-zk-evm/blob/main/SECURITY.md): o projeto e como relatar um problema de forma privada.

## Execute sua própria instância do Ostia

[Execute sua própria instância do Ostia](https://docs.rome.builders/pt-br/canton-zk-evm/run-it-locally.md) abrange os testes, uma rede Canton local com GPU e a implantação em um participante Canton existente.


---

# 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/start-here.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.
