> 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/nachalo-raboty-1/quickstart.md).

# Быстрый старт

Разверните свой первый контракт Solidity в Rome менее чем за 5 минут.

Разверните свой первый контракт Solidity в Rome менее чем за 5 минут. Это руководство предназначено для [**Hadrian**](https://docs.rome.builders/ru/seti/hadrian.md), общедоступной тестовой сети. [Rubicon](https://docs.rome.builders/ru/seti/rubicon.md) — это основная сеть, где газ оплачивается реальным USDC; сначала пробуйте всё в тестовой сети.

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

* [Node.js](https://nodejs.org/) v22.13+
* [MetaMask](https://metamask.io/) расширение браузера
* Кошелёк Solana, настроенный на **Devnet**, только если вы пополняете из Solana (шаг 2). Вызов контрактов из кошелька Solana требует кошелька, подписывающего транзакции Solana v1, что рассматривается в [Откройте ваш контракт для пользователей Solana](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/open-to-solana-users.md).

## 1. Добавьте Hadrian в MetaMask

Добавьте его вручную (Настройки → Сети → Добавить сеть):

| Поле                | Значение                                        |
| ------------------- | ----------------------------------------------- |
| Имя сети            | Rome Hadrian                                    |
| URL RPC             | `https://hadrian.testnet.romeprotocol.xyz/`     |
| Идентификатор цепи  | `200010`                                        |
| Символ валюты       | `USDC`                                          |
| Обозреватель блоков | `https://via-hadrian.testnet.romeprotocol.xyz/` |

## 2. Пополните кошелёк

Газ оплачивается газовым токеном сети, которым в Hadrian является USDC. В Hadrian он обеспечен Solana Devnet USDC от Circle (mint `4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU`), поэтому devnet SOL не является газом. Для Rome нет крана. Есть два способа завести USDC в Hadrian:

**Из Solana** — получите Solana Devnet USDC из [фаусет Circle](https://faucet.circle.com/) (выберите Solana Devnet) и немного devnet SOL для комиссий Solana из [крана Solana](https://faucet.solana.com/), при этом ваш кошелёк Solana должен быть настроен на Devnet. Затем используйте [Мост Rome](https://docs.rome.builders/ru/prilozheniya-v-rome/bridge-api.md) с Hadrian в качестве назначения и его маршрутом Solana, указав адрес вашего EVM-кошелька в качестве получателя; мост попросит этот EVM-кошелёк подписать транзакцию получения в Hadrian, после чего USDC превращается в газ.

**Через мост из EVM-сети** — выпустите тестовый USDC в Ethereum Sepolia с помощью [фаусет Circle](https://faucet.circle.com/), затем перенесите его в Rome с помощью [Мост Rome](https://docs.rome.builders/ru/prilozheniya-v-rome/bridge-api.md) (CCTP). Вам понадобится немного Sepolia ETH для транзакции на стороне источника — см. [Краны](https://docs.rome.builders/ru/resursy/faucets.md) для каждого крана.

**Сколько?** Запись в Rome стоит дороже, чем подсказывает интуиция, поскольку большая часть газа уходит на создание аккаунтов Solana: получателя, который ещё не использовался, нового токен-аккаунта, развернутого контракта. Используйте `eth_estimateGas`, что и делают стандартные инструменты, и никогда не жёстко задавайте 21 000. Оценка включает создание аккаунта, Rome взимает газ, фактически использованный транзакцией (в измерениях на Hadrian он ни разу не превышал оценку), а параметр SDK `submitRomeTx` увеличивает оценку в 1,3 раза в качестве запаса, что ничего не стоит, поскольку взимается только использованный газ. Пополните минимум **0,5 USDC газа**; 1 USDC даёт комфортный запас. Цифры в [Поддержка JSON-RPC](https://docs.rome.builders/ru/spravochnik/json-rpc.md) показывают, сколько стоят отдельные записи.

Если пополнение со стороны Solana завершается предупреждением «insufficient SOL», несмотря на пополненный кошелёк, переведите ваш кошелёк Solana в режим Testnet / Devnet (см. [FAQ](https://docs.rome.builders/ru/resursy/faq.md)).

## 3. Создайте проект Hardhat

```bash
mkdir rome-hello && cd rome-hello
npx hardhat --init
```

При появлении запроса принимайте значения по умолчанию — Hardhat 3, текущий каталог и шаблон TypeScript + Node Test Runner + viem — и дайте ему установить зависимости. Шаблон поставляется с примером `Counter` контракта с тестами; они не мешают этому руководству.

## 4. Настройте Hardhat для Rome

Отредактируйте сгенерированный `hardhat.config.ts` и добавьте сети Rome внутрь `defineConfig({ ... })`:

```typescript
  networks: {
    hadrian: {
      type: "http",
      chainType: "l1",
      chainId: 200010,
      url: "https://hadrian.testnet.romeprotocol.xyz/",
      accounts: [configVariable("PRIVATE_KEY")],
    },
  },
```

`configVariable("PRIVATE_KEY")` берётся из среды, поэтому экспортируйте закрытый ключ MetaMask:

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

(Для чего угодно, кроме одноразового ключа, предпочтительнее зашифрованное хранилище ключей, входящее в комплект toolbox: `npx hardhat keystore set PRIVATE_KEY`.)

## 5. Напишите контракт

Создайте `contracts/HelloRome.sol`:

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

contract HelloRome {
    string public greeting = "Привет из Solana!";
    uint256 public counter;

    event Greeted(address indexed sender, uint256 count);

    function greet() external returns (string memory) {
        counter++;
        emit Greeted(msg.sender, counter);
        return greeting;
    }

    function setGreeting(string calldata _greeting) external {
        greeting = _greeting;
    }
}
```

## 6. Разверните

Создайте `scripts/deploy.ts`:

```typescript
import hardhat from "hardhat";

async function main() {
  const { viem } = await hardhat.network.connect();
  const publicClient = await viem.getPublicClient();

  const hello = await viem.deployContract("HelloRome");
  console.log("HelloRome развернут по адресу:", hello.address);

  const hash = await hello.write.greet();
  await publicClient.waitForTransactionReceipt({ hash });

  console.log("Счётчик:", (await hello.read.counter()).toString());
  console.log("Приветствие:", await hello.read.greeting());
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});
```

Разверните в Hadrian:

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

Ожидаемый вывод (ваш адрес будет отличаться):

```
HelloRome развернут по адресу: 0x09c437e305eeb698e1776cff23ca16c1bb25aabd
Счётчик: 1
Приветствие: Привет из Solana!
```

Откройте развернутый адрес в [explorer](https://via-hadrian.testnet.romeprotocol.xyz/) чтобы увидеть свою транзакцию, и перейдите по ссылке «Settled in» к транзакции Solana, в которой она была завершена. Теперь ваш контракт Solidity работает в Solana.

## Что дальше

* [Разверните Solidity](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/deploy-solidity.md) — развёртывание Hardhat и Foundry в деталях
* [Вызов Solana из EVM](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/call-solana-from-evm.md) — вызов программ Solana из Solidity через CPI
* [Архитектура](https://docs.rome.builders/ru/nachalo-raboty-1/architecture.md) — как Rome выполняет EVM внутри Solana

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

| Ошибка                  | Причина                                                                | Исправление                                                                                                                            |
| ----------------------- | ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `недостаточно средств`  | Недостаточно газового токена для произведения лимита газа на цену газа | Пополните как минимум 0,5 USDC газа (см. шаг 2) с помощью [Мост Rome](https://docs.rome.builders/ru/prilozheniya-v-rome/bridge-api.md) |
| `nonce слишком мал`     | Несоответствие nonce транзакции                                        | Сбросьте счёт (MetaMask → Настройки → Дополнительно → Очистить активность)                                                             |
| `выполнение откатилось` | Выполнение контракта не удалось                                        | Проверьте логику контракта; используйте `eth_call` для отладки                                                                         |
| Тайм-аут соединения     | RPC недоступен                                                         | Проверьте URL RPC                                                                                                                      |


---

# 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/nachalo-raboty-1/quickstart.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.
