> 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/ru/rukovodstva-dlya-razrabotchikov/deploy-solidity.md).

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

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

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

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

* Установлены Node.js v22.13+ (Hardhat) или Foundry
* Пополненный адрес Rome EVM (см. [Быстрый старт](https://docs.rome.builders/ru/nachalo-raboty-1/quickstart.md))
* Ваш закрытый ключ, экспортированный как переменная окружения

```bash
export PRIVATE_KEY="0xYOUR_PRIVATE_KEY"
```

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

| Сеть                  | URL RPC                                     | Идентификатор цепи | Обозреватель                           |
| --------------------- | ------------------------------------------- | ------------------ | -------------------------------------- |
| Hadrian (testnet)     | `https://hadrian.testnet.romeprotocol.xyz/` | `200010`           | `via-hadrian.testnet.romeprotocol.xyz` |
| **Rubicon (mainnet)** | `https://rubicon.mainnet.romeprotocol.xyz/` | `7531`             | `via-rubicon.mainnet.romeprotocol.xyz` |

Газ на каждой сети — это USDC. В Hadrian его можно получить, перебросив тестовый USDC или обернув его из кошелька Solana devnet ([Краны](https://docs.rome.builders/ru/resursy/faucets.md)); в Rubicon — перебросив USDC из Ethereum, Base, Arbitrum, Polygon, Avalanche, Monad или OP, либо из кошелька Solana, с [Мост Rome](https://bridge-api.mainnet.romeprotocol.xyz/). Развертывайте в Rubicon, используя те же артефакты, что и в Hadrian, — отличаются только chain id и адреса обертки.

## Hardhat

### Setup

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

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

### hardhat.config.ts

```typescript
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: {
    hadrian: {
      type: "http",
      chainType: "l1",
      chainId: 200010,
      url: "https://hadrian.testnet.romeprotocol.xyz/",
      accounts: [configVariable("PRIVATE_KEY")],
    },
    rubicon: {
      type: "http",
      chainType: "l1",
      chainId: 7531,
      url: "https://rubicon.mainnet.romeprotocol.xyz/",
      accounts: [configVariable("PRIVATE_KEY")],
    },
  },
});
```

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

### Развернуть

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

### Проверить в блок-эксплорере

```bash
npx hardhat verify --network hadrian 0xCONTRACT_ADDRESS
```

Требуется конфигурация верификатора Sourcify из [Верифицировать контракты](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/verify-contracts.md) в вашем `hardhat.config.ts`.

## Foundry

### Setup

```bash
forge init my-rome-project
cd my-rome-project
```

### Развернуть

```bash
# Тестовая сеть
forge create --rpc-url https://hadrian.testnet.romeprotocol.xyz/ \
  --private-key $PRIVATE_KEY \
  src/Counter.sol:Counter
```

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

```bash
# Чтение
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`](https://github.com/rome-protocol/rome-solidity) репозитория. Он устанавливается из GitHub, а не из npm:

```bash
# Hardhat / npm
npm install github:rome-protocol/rome-solidity

# Foundry
forge install rome-protocol/rome-solidity
# затем в foundry.toml, в разделе [profile.default]:
# remappings = ["@rome-protocol/rome-solidity/=lib/rome-solidity/"]
```

Контракты за пределами `interface.sol` и интерфейсы оракулов (например, ERC-20 wrapper и factory) импортируют OpenZeppelin. С npm он устанавливается как зависимость. В Foundry также выполните `forge install OpenZeppelin/openzeppelin-contracts` и добавьте remapping `@openzeppelin/contracts/=lib/openzeppelin-contracts/contracts/`.

При использовании npm пакет устанавливается как `@rome-protocol/rome-solidity`, поэтому импорт ниже разрешается из `node_modules`. В Foundry remapping позволяет тому же импорту разрешаться из `lib/rome-solidity`.

```solidity
// 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-протокол или уже существующее защищенное приложение. Единственное, чего нет в вашем контракте, — это **одноразового разрешения для wrapper**: пользователь, который перемещает токены SPL-wrapper (wUSDC и подобные) через ваш контракт, должен один раз предоставить wrapper этого токена право перемещать его токены до первого `transferFrom`. Без этого перевод откатывается с ошибкой SPL `0x4`receipt `isEnabled(user)` в wrapper и см. [Одноразовое предоставление разрешения для каждого кошелька](https://docs.rome.builders/ru/klyuchevye-ponyatiya/token-interop.md#one-time-grant-per-wallet); ваш фронтенд отправляет разрешение, ваш контракт не меняется. Два примера production, которые можно форкнуть и развернуть с тем же потоком Hardhat / Foundry, что и выше:

* [**compound-on-rome-comet**](https://github.com/rome-protocol/compound-on-rome-comet) — эталонный Compound v3 (Comet), стандартный Foundry.
* [**rome-aave-v3**](https://github.com/rome-protocol/rome-aave-v3) — эталонный Aave v3.

Оба получают возможность исполнения Solana и композиции CPI без изменений контракта; их пользователи перед первым депозитом выполняют одноразовое разрешение wrapper, описанное выше.

## Газ

Позвольте вашему инструментарию оценивать газ (`eth_estimateGas`; Hardhat, `forge create` и `cast` это умеют) и никогда не задавайте жестко `21000`. В Rome большая часть стоимости записи приходится на создание аккаунтов Solana, например развернутого контракта, нового токен-аккаунта или еще не использовавшегося получателя, и оценка это учитывает. Для вызова, который делает CPI Solana, оценка может оказаться заниженной, поэтому держите запас. Rome списывает фактически использованный газ. По измерениям в Hadrian развертывание контракта размером 10 байт требовало и использовало 1 147 921 gas, а нативный перевод на существующий адрес — 21 000 по оценке и 10 001 по факту. Реальный контракт стоит дороже, поэтому оценивайте свой собственный deploy. На странице [JSON-RPC](https://docs.rome.builders/ru/spravochnik/json-rpc.md#gas-is-solana-derived-estimate-dont-hardcode) есть измеренная таблица.

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

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

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

| Ошибка                                                                      | Причина                                                                          | Исправление                                                                                                                                                                                                                                                                                                                      |
| --------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `недостаточно средств для газа`                                             | На адресе EVM нет газового токена                                                | Hadrian: заведите тестовый USDC через [Мост Rome](https://docs.rome.builders/ru/prilozheniya-v-rome/bridge-api.md) (см. [Быстрый старт](https://docs.rome.builders/ru/nachalo-raboty-1/quickstart.md), шаг 2); Rubicon: заведите реальный USDC через [Rome Bridge в основной сети](https://bridge-api.mainnet.romeprotocol.xyz/) |
| `nonce слишком мал`                                                         | Устаревший nonce в кошельке                                                      | Сбросьте аккаунт MetaMask или укажите nonce вручную                                                                                                                                                                                                                                                                              |
| `выполнение откатилось`                                                     | Логика контракта завершилась ошибкой                                             | Отладьте с помощью `eth_call` или `forge test --fork-url`                                                                                                                                                                                                                                                                        |
| `выполнение откатилось` с ошибкой SPL `0x4` при перемещении wrapper-токенов | Пользователь не сделал одноразовое разрешение wrapper                            | Проверьте `isEnabled(user)` в wrapper и отправьте `approve_spl` один раз ([подробности](https://docs.rome.builders/ru/klyuchevye-ponyatiya/token-interop.md#one-time-grant-per-wallet))                                                                                                                                          |
| `транзакция с заниженной ценой`                                             | Цена газа ниже минимальной                                                       | Увеличьте цену газа в транзакции                                                                                                                                                                                                                                                                                                 |
| Перевод или развертывание завершается сбоем при фиксированном лимите газа   | Жестко заданный лимит, например `21000` ниже стоимости создания аккаунтов Solana | Удалите его и используйте `eth_estimateGas`                                                                                                                                                                                                                                                                                      |

## Что дальше

* [Откройте ваш контракт для пользователей Solana](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/open-to-solana-users.md) — дайте пользователям кошельков Solana вызывать то, что вы только что развернули
* [Вызов Solana из EVM](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/call-solana-from-evm.md) — используйте precompile CPI для взаимодействия с программами Solana
* [Верифицировать контракты](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/verify-contracts.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/ru/rukovodstva-dlya-razrabotchikov/deploy-solidity.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.
