Развёртывание контрактов Solidity

Развёртывайте смарт-контракты Solidity на Solana с помощью Hardhat или Foundry — конфигурация сети Rome, пополненные аккаунты и пошаговое развёртывание.

Это руководство описывает развертывание смарт-контрактов Solidity в Rome EVM с использованием Hardhat и Foundry.

Предварительные требования

• Установлен Node.js v22.13+ (Hardhat) или Foundry

• Пополненный адрес Rome EVM (см. Быстрый старт)

• Ваш закрытый ключ, экспортированный как переменная окружения

export PRIVATE_KEY="0xYOUR_PRIVATE_KEY"

Настройка сети

Сеть	URL RPC	Идентификатор цепочки
Локальная	http://localhost:9090	1001
Hadrian (devnet)	https://hadrian.testnet.romeprotocol.xyz/	200010
Martius (testnet)	https://martius.testnet.romeprotocol.xyz/	121214

Hardhat

Настройка

mkdir my-rome-project && cd my-rome-project
npx hardhat --init

Примите значения по умолчанию (Hardhat 3, текущий каталог, шаблон TypeScript + viem); зависимости установятся автоматически.

hardhat.config.ts

import hardhatToolboxViemPlugin from "@nomicfoundation/hardhat-toolbox-viem";
import { configVariable, defineConfig } from "hardhat/config";

export default defineConfig({
  plugins: [hardhatToolboxViemPlugin],
  solidity: {
    profiles: {
      default: { version: "0.8.28" },
      production: {
        version: "0.8.28",
        settings: { optimizer: { enabled: true, runs: 200 } },
      },
    },
  },
  networks: {
    rome_local: {
      type: "http",
      chainType: "l1",
      chainId: 1001,
      url: "http://localhost:9090",
      accounts: [configVariable("PRIVATE_KEY")],
    },
    hadrian: {
      type: "http",
      chainType: "l1",
      chainId: 200010,
      url: "https://hadrian.testnet.romeprotocol.xyz/",
      accounts: [configVariable("PRIVATE_KEY")],
    },
    martius: {
      type: "http",
      chainType: "l1",
      chainId: 121214,
      url: "https://martius.testnet.romeprotocol.xyz/",
      accounts: [configVariable("PRIVATE_KEY")],
    },
  },
});

configVariable("PRIVATE_KEY") разрешается из среды (или из зашифрованного хранилища ключей — npx hardhat keystore set PRIVATE_KEY).

Развернуть

npx hardhat run scripts/deploy.ts --network hadrian

Проверить в обозревателе блокчейна

npx hardhat verify --network martius 0xCONTRACT_ADDRESS

Требуется конфигурация верификатора Sourcify из Проверить контракты в вашем hardhat.config.ts.

Foundry

Настройка

forge init my-rome-project
cd my-rome-project

Развернуть

# Локально
forge create --rpc-url http://localhost:9090 \\
  --private-key $PRIVATE_KEY \\
  src/Counter.sol:Counter

# Devnet
forge create --rpc-url https://hadrian.testnet.romeprotocol.xyz/ \\
  --private-key $PRIVATE_KEY \\
  src/Counter.sol:Counter

Вызов развернутого контракта

# Чтение
cast call 0xCONTRACT_ADDRESS "number()" \\
  --rpc-url https://hadrian.testnet.romeprotocol.xyz/

# Запись
cast send 0xCONTRACT_ADDRESS "increment()" \\
  --rpc-url https://hadrian.testnet.romeprotocol.xyz/ \\
  --private-key $PRIVATE_KEY

Использование Rome Solidity SDK

Для контрактов, взаимодействующих с программами Solana, используйте интерфейсы из публичного rome-solidity репозитория (публикация в npm ожидается):

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.28;

import {ICrossProgramInvocation, IHelperProgram}
    from "@rome-protocol/rome-solidity/contracts/interface.sol";

contract MyRomeContract {
    IHelperProgram constant Helper =
        IHelperProgram(0xFF00000000000000000000000000000000000009);
    ICrossProgramInvocation constant Cpi =
        ICrossProgramInvocation(0xFF00000000000000000000000000000000000008);

    // Передача токена SPL из PDA вызывающего
    function moveSpl(address to, uint64 tokens, bytes32 mint) external {
        Helper.transfer_spl(to, tokens, mint);
    }

    // Вызов любой программы Solana через CPI
    function callSolanaProgram(
        bytes32 programId,
        ICrossProgramInvocation.AccountMeta[] calldata accounts,
        bytes calldata data
    ) external {
        Cpi.invoke(programId, accounts, data);
    }
}

Перенесите существующий протокол

Любой контракт Solidity развертывается в Rome без изменений — контракт соблюдения, протокол DeFi или уже существующее проверенное приложение. Ниже приведены два примера из production, которые можно форкнуть и развернуть с тем же процессом Hardhat / Foundry, что и выше:

• compound-on-rome-comet — канонический Compound v3 (Comet), стандартный Foundry.

• rome-aave-v3 — канонический Aave v3.

Оба получают выполнение в Solana и композиционность CPI без изменений в контракте.

Ограничения развертывания

Ограничение	Лимит	Примечания
Максимальный размер контракта	24 КБ	Как в Ethereum (EIP-170, 24 576 байт)
Лимит размера транзакции	80 КБ на holder	Крупные развертывания прозрачно распределяются по учетным записям holder
Бюджет вычислений	≈1,4 млн CU (атомарно)	Используйте итеративный режим для ресурсоемких контрактов
Версия Solidity	Рекомендуется 0.8.28	Более ранние версии работают, но 0.8.28 соответствует SDK

Распространенные ошибки

Ошибка	Причина	Исправление
недостаточно средств для газа	У EVM-адреса нет токена для газа	Оберните газ через Rome App (см. Быстрый старт)
слишком низкий nonce	Устаревший nonce в кошельке	Сбросьте учетную запись MetaMask или укажите nonce вручную
выполнение отменено	Логика контракта завершилась сбоем	Отладьте с помощью eth_call или forge test --fork-url
транзакция недооценена	Цена газа ниже минимальной	Увеличьте цену газа в транзакции

Что дальше

• Вызывать Solana из EVM — используйте precompile CPI для взаимодействия с программами Solana

• Проверить контракты — опубликуйте исходный код в обозревателе блокчейна