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):
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
Implante Solidity — implantação em profundidade com Hardhat e Foundry
Chamar Solana a partir da EVM — chame programas Solana a partir de Solidity via CPI
Arquitetura — como o Rome executa a EVM dentro da Solana
Erros comuns
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?