> 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/rome-academy/03-first-contract-on-hadrian.md).

# 3. Seu primeiro contrato no Hadrian

Conecte uma carteira ao Hadrian, financie-a, implante um contrato com o Hardhat e acompanhe sua transação até a transação da Solana que a liquidou.

Você implanta um pequeno contrato Solidity no Hadrian, a testnet pública de Roma. A implantação é um Hardhat comum. O que há de novo é que você paga gás em USDC, e que o explorador leva você para o lado Solana do que você fez.

## O que você vai aprender

* Como apontar uma carteira e o Hardhat para o Hadrian.
* Por que o gás é USDC e como uma carteira o obtém.
* Por que uma escrita no Rome custa mais gás do que os hábitos de Ethereum sugerem.
* Como ler sua transação no explorador Via e segui-la até a transação Solana que a liquidou.
* Como verificar seu código-fonte para que o explorador o mostre.

## Antes de começar

Você leu [lição 2](https://docs.rome.builders/pt-br/rome-academy/02-what-you-can-build.md), que mostra qual é o primeiro passo para o qual este contrato serve. Tenha isto pronto:

* Node.js na versão que a [Quickstart](https://docs.rome.builders/pt-br/primeiros-passos-1/quickstart.md) lista.
* MetaMask instalado.
* Uma conta nova, ou uma chave descartável. Você exporta a chave privada dela para seu shell, então não use uma chave que contenha fundos reais.
* Uma carteira Solana configurada para Devnet, somente se você for financiar a partir da Solana.

## O caminho

### Etapa 1. Adicione o Hadrian à sua carteira

Hadrian é uma rede EVM padrão. Você a adiciona ao MetaMask manualmente com um nome, URL de RPC, id da chain, símbolo da moeda e URL do explorador. Pegue cada valor da tabela em [Quickstart, etapa 1](https://docs.rome.builders/pages/bebb0094a536a3a8ae302fc10b059daa4372d5e1#id-1.-add-hadrian-to-metamask). Os valores também estão em [Hadrian](https://docs.rome.builders/pt-br/redes/hadrian.md). Defina o símbolo da moeda como `USDC`.

O Hardhat precisa do mesmo id de chain e da mesma URL de RPC. Você os coloca em sua configuração na etapa 3.

### Etapa 2. Financie a carteira

O gás no Hadrian é USDC, lastreado no USDC Devnet da Solana da Circle. SOL não é o token de gás. Não há faucet de Rome. Você obtém USDC de teste em outro lugar e o traz pela Rome Bridge. Um depósito que chega pela bridge aterrissa como gás por padrão. Deixe a opção de recebimento da página da bridge em gás.

Há duas fontes:

* **Do Solana Devnet.** Pegue USDC de devnet no faucet da Circle e um pouco de SOL de devnet para as taxas da Solana. Faça a bridge do USDC com sua rota Solana e informe seu endereço EVM como destinatário. A bridge pede que sua carteira EVM assine uma transação de reivindicação no Hadrian, e isso transforma o USDC em gás.
* **De uma testnet EVM.** Faça o mint de USDC de teste no Ethereum Sepolia e traga-o pela bridge. Você precisa de um pouco de ETH de Sepolia para pagar a transação do lado de origem.

As etapas e os links dos faucets estão em [Quickstart, etapa 2](https://docs.rome.builders/pages/bebb0094a536a3a8ae302fc10b059daa4372d5e1#id-2.-fund-your-wallet), [Financie uma carteira no Hadrian](https://docs.rome.builders/pt-br/redes/hadrian.md#fund-a-wallet) e [Faucets](https://docs.rome.builders/pt-br/recursos/faucets.md). A bridge em si está em [Rome Bridge](https://docs.rome.builders/pt-br/apps-na-rome/bridge-api.md).

Quanto financiar? O Quickstart fornece um valor mínimo e um valor confortável. Leia antes de começar.

Verifique o saldo no MetaMask antes de continuar. Se aparecer zero, a transferência ainda não terminou. A página da bridge mostra cada etapa e o tempo esperado.

### Etapa 3. Crie o projeto Hardhat

Crie um projeto Hardhat 3 com o template TypeScript e viem. Depois adicione uma entrada `hadrian` em `networks` com o id da chain e a URL de RPC da página do Hadrian. A chave privada vem de uma variável de ambiente ou do keystore criptografado do Hardhat. Prefira o keystore para qualquer coisa além de uma chave descartável.

Os comandos exatos e a configuração estão no Quickstart, [etapa 3](https://docs.rome.builders/pages/bebb0094a536a3a8ae302fc10b059daa4372d5e1#id-3.-create-a-hardhat-project) e [etapa 4](https://docs.rome.builders/pages/bebb0094a536a3a8ae302fc10b059daa4372d5e1#id-4.-configure-hardhat-for-rome). [Implantar contratos Solidity](https://docs.rome.builders/pt-br/guias-do-desenvolvedor/deploy-solidity.md#hardhat) mostra o arquivo de configuração completo, e o [mesmo fluxo no Foundry](https://docs.rome.builders/pt-br/guias-do-desenvolvedor/deploy-solidity.md#foundry).

### Etapa 4. Escreva e implante o contrato

O contrato do Quickstart, `HelloRome`, é deliberadamente simples. Ele armazena uma saudação, conta chamadas a `greet()`, e emite um evento. Nada nele é específico de Rome.

Esse é o ponto desta etapa: `HelloRome` é implantado sem alterações. Antes de portar outro contrato, verifique [Limitações conhecidas](https://docs.rome.builders/pt-br/seguranca/known-limitations.md) quanto a opcodes não suportados e diferenças de gás. Escreva-o e então execute o script de implantação contra `hadrian`. O script implanta, chama `greet()` uma vez, e lê o contador e a saudação de volta. Copie ambos do Quickstart, [etapa 5](https://docs.rome.builders/pages/bebb0094a536a3a8ae302fc10b059daa4372d5e1#id-5.-write-a-contract) e [etapa 6](https://docs.rome.builders/pages/bebb0094a536a3a8ae302fc10b059daa4372d5e1#id-6.-deploy).

Quando der certo, você terá um endereço de contrato e um contador de 1.

### Etapa 5. Entenda o custo

A implantação usou muito mais gás do que o mesmo contrato usaria no Ethereum. A maior parte do gás de uma escrita no Rome paga pela criação de contas Solana. Um contrato implantado cria novas contas para seu código e seu armazenamento. O mesmo acontece com uma transferência para um destinatário que nunca foi usado e com uma nova conta de token.

Duas regras se seguem:

* Deixe sua ferramenta estimar o gás com `eth_estimateGas`. O Hardhat, `forge create` e `cast send` faz. `forge script` precisa de `--skip-simulation` para fazer o mesmo.
* Nunca fixe 21.000 em hardcode. Uma escrita que cria contas, como uma implantação ou uma transferência para um endereço nunca usado, falha com um limite tão baixo.

Rome cobra o gás que a transação realmente usa, então uma estimativa alta não custa nada. Mantenha a margem que sua ferramenta adiciona: para uma chamada a um programa Solana, a estimativa pode sair baixa. [Suporte a JSON-RPC](https://docs.rome.builders/pt-br/referencia/json-rpc.md#gas-is-solana-derived-estimate-dont-hardcode) tem números medidos para escritas reais.

### Etapa 6. Leia no explorador

Abra o explorador Via para o Hadrian e procure o endereço do seu contrato. A página dele vincula a transação de criação e lista a `greet()` chamada entre suas transações. O link do explorador está em [Hadrian](https://docs.rome.builders/pt-br/redes/hadrian.md).

Via mostra a visão EVM usual: bloco, remetente, gás usado, logs de eventos. Sua linha "Liquidado em" contém a assinatura da transação Solana que liquidou a sua. Abra esse link. O explorador Solana mostra as instruções dessa transação, os programas com os quais ela interagiu e as unidades de computação que consumiu. [Via Explorer](https://docs.rome.builders/pt-br/apps-na-rome/via.md) explica o que mais o Via mostra.

Leia as unidades de computação ali, não em `gasUsed`. No Rome, `gasUsed` não é uma medida fiel da computação da Solana.

### Etapa 7. Verifique o código-fonte

A verificação publica seu código-fonte e ABI, e então o explorador mostra um selo "Fonte verificada". Rome executa um serviço Sourcify hospedado, então os fluxos padrão de verificação do Hardhat e do Foundry funcionam. Você os aponta para o verificador do Rome e informa o id da chain.

Os endpoints estão em [Endpoint do verificador](https://docs.rome.builders/pt-br/guias-do-desenvolvedor/verify-contracts.md#verifier-endpoint), e a configuração e os comandos estão na [Hardhat](https://docs.rome.builders/pt-br/guias-do-desenvolvedor/verify-contracts.md#hardhat) seção. Use o verificador da testnet para o Hadrian. O verificador da mainnet é uma URL diferente, o que importa na lição 11.

## Teste seus conhecimentos

Seu resultado: abra seu contrato no explorador do Hadrian e veja estes três itens.

* Sua transação de implantação, com a assinatura Solana em "Liquidado em", e as instruções dessa transação Solana no explorador Solana.
* Uma segunda transação, a `greet()` chamada, com um log de evento do endereço do seu contrato. Esse log é o evento `Greeted` ; seu primeiro tópico é o hash de `Greeted(address,uint256)`.
* Um selo "Fonte verificada" no contrato.

Se você estiver travado, os erros comuns estão em [Quickstart](https://docs.rome.builders/pt-br/primeiros-passos-1/quickstart.md#common-errors). O mais comum é `fundos insuficientes`, o que significa que a carteira tem USDC demais para o limite de gás vezes o preço do gás.

Então responda a estas perguntas.

1. Por que um primeiro deploy custa muito mais gás do que no Ethereum?
2. Onde você lê as unidades de computação Solana de uma transação: `gasUsed`, ou na transação Solana para a qual o Via faz o link?
3. O USDC de testnet que você usou vale alguma coisa?

<details>

<summary>Respostas</summary>

1. A maior parte do gás paga pela criação de contas Solana: o contrato, seu armazenamento e quaisquer novas contas de token.
2. A transação Solana. O Via a vincula a partir da linha "Liquidado em", e o explorador Solana mostra suas unidades de computação. `gasUsed` não é um proxy fiel.
3. Não. O Hadrian liquida no Solana Devnet, então seu USDC e SOL não são dinheiro de verdade.

</details>

## Próximo

[Registre seu app na Arena](https://arena.mainnet.romeprotocol.xyz/apps/new) e vincule este contrato Hadrian a ele. O app vai para Building.

[4. Como a Rome executa seu código](https://docs.rome.builders/pt-br/rome-academy/04-how-rome-runs-your-code.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/rome-academy/03-first-contract-on-hadrian.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.
