For the complete documentation index, see llms.txt. This page is also available as Markdown.

Início rápido

Implante seu primeiro contrato Solidity na Rome em menos de 5 minutos.

Implante seu primeiro contrato Solidity no Rome em menos de 5 minutos. Este guia é voltado para Hadrian, a chain da testnet pública. Rubicon é a chain da mainnet, onde o gas é USDC real; tente tudo primeiro em uma chain de teste.

Pré-requisitos

  • Node.js v22.13+

  • MetaMask extensão do navegador

  • Uma carteira Solana configurada para Devnet, apenas se você financiar a partir da Solana (etapa 2). Chamar contratos de uma carteira Solana precisa de uma que assine transações Solana v1, o que é abordado em Abra seu contrato para usuários Solana.

1. Adicione Hadrian ao MetaMask

Adicione manualmente (Configurações → Redes → Adicionar rede):

Campo
Valor

Nome da rede

Rome Hadrian

URL de RPC

https://hadrian.testnet.romeprotocol.xyz/

ID da cadeia

200010

Símbolo da moeda

USDC

Explorador de blocos

https://via-hadrian.testnet.romeprotocol.xyz/

2. Financie sua carteira

O gas é pago no token de gas da chain, que é USDC no Hadrian. No Hadrian, ele é lastreado pelo USDC da Solana Devnet da Circle (mint 4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU), então o SOL da devnet não é gas. Não existe faucet do Rome. Duas maneiras de obter USDC no Hadrian:

Da Solana — obtenha USDC da Solana Devnet no faucet da Circle (escolha Solana Devnet) e um pouco de SOL da devnet para taxas da Solana no faucet da Solana, com sua carteira Solana configurada para Devnet. Em seguida, use o Rome Bridge com Hadrian como destino e sua rota Solana, com o endereço da sua carteira EVM como destinatário; a bridge pede que essa carteira EVM assine uma transação de claim no Hadrian, que transforma o USDC em gas.

Ao fazer bridge de uma chain EVM — faça mint de USDC de teste no Ethereum Sepolia no faucet da Circle, depois traga-o para Rome com o Rome Bridge (CCTP). Você vai precisar de um pouco de ETH de Sepolia para a transação do lado de origem — veja Faucets para cada faucet.

Quanto? Uma write no Rome custa mais do que a intuição sobre Ethereum sugere, porque a maior parte do gas paga pela criação de contas Solana: um destinatário que nunca foi usado, uma nova conta de token, um contrato implantado. Use eth_estimateGas, o que as ferramentas padrão fazem, e nunca codifique 21.000. A estimativa inclui a criação de conta, o Rome cobra o gas que uma transação realmente usa (em medições no Hadrian isso nunca foi mais do que a estimativa), e o SDK's submitRomeTx aumenta a estimativa em 1,3x como margem, o que não custa nada porque apenas o gas usado é cobrado. Financie pelo menos 0,5 USDC de gas; 1 USDC deixa uma folga confortável. Os números em Suporte a JSON-RPC mostram quanto custam escritas individuais.

Se um depósito do lado da Solana falhar com um aviso de "insufficient SOL" apesar de a carteira estar financiada, coloque sua carteira Solana em Testnet Mode / Devnet (veja o FAQ).

3. Crie um projeto Hardhat

Aceite os padrões quando solicitado — Hardhat 3, o diretório atual e o template TypeScript + Node Test Runner + viem — e deixe que ele instale as dependências. O template vem com um exemplo Counter contrato com testes; eles não interferem neste guia.

4. Configure o Hardhat para Rome

Edite o hardhat.config.ts gerado e adicione as redes Rome dentro de defineConfig({ ... }):

configVariable("PRIVATE_KEY") é resolvido a partir do ambiente, então exporte sua chave privada do MetaMask:

(Para qualquer coisa além de uma chave descartável, prefira o keystore criptografado que vem com a toolbox: npx hardhat keystore set PRIVATE_KEY.)

5. Escreva um contrato

Crie contracts/HelloRome.sol:

6. Faça o deploy

Crie scripts/deploy.ts:

Faça o deploy para o Hadrian:

Saída esperada (seu endereço será diferente):

Abra o endereço implantado no explorer para ver sua transação e siga o link "Settled in" para a transação na Solana que a liquidou. Seu contrato Solidity agora está sendo executado na Solana.

O que vem a seguir

Erros comuns

Erro
Causa
Correção

fundos insuficientes

Gas token insuficiente para o limite de gas multiplicado pelo preço do gas

Financie pelo menos 0,5 USDC de gas (veja a etapa 2) com o Rome Bridge

nonce muito baixo

Incompatibilidade do nonce da transação

Redefina a conta (MetaMask → Configurações → Avançado → Limpar atividade)

execução revertida

Falha na execução do contrato

Verifique a lógica do contrato; use eth_call para depurar

Tempo limite de conexão

RPC inacessível

Verifique a URL do RPC

Atualizado

Isto foi útil?