> 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/rome-academy/05-call-solana-from-solidity.md).

# 5. Вызывайте Solana из Solidity

Используйте прекомпилированные контракты CPI и Helper Rome, чтобы читать аккаунты Solana, создавать токен-аккаунты и вызывать программы Solana из контракта Solidity.

В Rome контракт на Solidity может читать аккаунты Solana и вызывать программы Solana в рамках одной транзакции. Вы прочитаете баланс токенов Solana, создадите токен-аккаунт и узнаете, как выполнять вызов программы.

## Чему вы научитесь

* Что такое precompile в Rome и какие три из них вы будете использовать чаще всего.
* Чью подпись видит программа Solana, когда ваш контракт вызывает её.
* Как читать состояние Solana и создавать токен-аккаунт из Solidity.
* Правила, которые определяют, сработает ли вызов Solana: объявленные аккаунты, один режим выполнения, только атомарно.

## Перед началом

* Завершите [4. Как Rome выполняет ваш код](https://docs.rome.builders/ru/rome-academy/04-how-rome-runs-your-code.md). Здесь важны атомарный бюджет и лимит в 64 аккаунта.
* Убедитесь, что ваш кошелёк Hadrian пополнен и что ваша конфигурация деплоя из урока 3 работает. Список кранов приведён в [Краны](https://docs.rome.builders/ru/resursy/faucets.md).
* Установите интерфейсы Rome Solidity из `rome-solidity` репозитория, как описано в [Разверните Solidity](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/deploy-solidity.md#using-the-rome-solidity-sdk).

## Precompiles — это дверь

Precompile — это фиксированный адрес, который выполняет нативный код вместо байткода. В Ethereum есть несколько таких адресов, например `ecrecover`. Rome добавляет precompile, задача которых — обеспечить доступ к Solana. Вы вызываете их как любой другой контракт, через интерфейс.

Вы будете использовать три:

| Пре-компиляция | Что он даёт вам                                                                                            |
| -------------- | ---------------------------------------------------------------------------------------------------------- |
| CpiProgram     | `invoke` и `invoke_signed` для вызова любой программы Solana, а также только для чтения аккаунтов Solana   |
| HelperProgram  | Готовые операции с токенами и аккаунтами: создание токен-аккаунта, перевод SPL-токенов, вычисление адресов |
| Система        | Вычисление PDA и преобразование в base58                                                                   |

Адреса находятся в [Справочник пре-компиляций](https://docs.rome.builders/ru/spravochnik/precompiles.md) и [Адреса контрактов](https://docs.rome.builders/ru/spravochnik/contract-addresses.md). Вам не нужно вводить их вручную. Импорт `interface.sol` из `rome-solidity` даёт вам готовые константы с именами `CpiProgram`, `HelperProgram` и `SystemProgram`.

## Кто подписывает

Когда ваш контракт вызывает precompile, Solana видит собственную идентичность вашего контракта, а не пользователя. У каждого адреса EVM есть производный адрес программы Solana — его PDA внешнего полномочия. Он владеет токен-аккаунтами этого адреса и подписывает от его имени.

Это то же правило, которое вы знаете по ERC-20: контракт не может перемещать активы пользователя, если пользователь не дал на это разрешение. В уроке 6 показано, как пользователь даёт это разрешение в Rome. Правило и три способа удерживать позицию пользователя приведены в [Интеграция программы Solana](https://docs.rome.builders/pages/b053ed7c840645eca285db39f036cae4e7148e31#id-1.-every-evm-address-has-one-solana-identity).

## Шаг 1: сначала чтение, потом запись

Начинайте с чтения. Оно не изменяет состояние и работает в атомарном и итеративном режимах исполнения. Сначала читайте, потом вносите изменения: после выполнения закэшированного вызова чтения в legacy-track остальные чтения в рамках этой транзакции отклоняются.

```solidity
import "@rome-protocol/rome-solidity/contracts/interface.sol";

contract SolanaPeek {
    // Токен-аккаунт, который Rome использует для вызывающей стороны и для газового минта сети
    function myTokenAccount() external view returns (bytes32) {
        return HelperProgram.ata(msg.sender, SystemProgram.mint_id());
    }

    // Баланс вызывающей стороны в этом аккаунте
    function myBalance() external view returns (uint64) {
        return HelperProgram.user_balance(msg.sender, SystemProgram.mint_id());
    }
}
```

Адреса Solana `bytes32` здесь, а не адреса длиной 20 байт. Другие операции чтения, `account_info`, `account_data_at` и `account_u64_at`, позволяют вам просматривать любой аккаунт Solana. См. [Чтение данных аккаунта](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/call-solana-from-evm.md#reading-account-data).

## Шаг 2: используйте помощник

Для типовых задач не требуется вручную собирать инструкцию. Helper создаёт токен-аккаунты, перемещает SPL-токены и lamports, а также преобразует gas в lamports. Сигнатуры приведены в `contracts/interface.sol`, а готовый контракт — в [Перевод lamports](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/call-solana-from-evm.md#transfer-lamports).

```solidity
function createMyAta() external {
    HelperProgram.create_ata(msg.sender, SystemProgram.mint_id());
}
```

Контракт, который вызывает Helper, действует от собственного имени. Токены, которые он перемещает, принадлежат ему, а не пользователю.

## Шаг 3: вызовите любую программу Solana

Для программы, которую не покрывают помощники, самостоятельно сформируйте список аккаунтов и байты инструкции и вызовите `invoke`. Каждый аккаунт — это pubkey плюс два флага: signer и writable. Данные инструкции — это то, что ожидает целевая программа, обычно Borsh.

Полный контракт приведён в [Вызов пользовательских программ Solana](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/call-solana-from-evm.md#calling-custom-solana-programs). `invoke_signed` добавляет salt-ированные суб-PDA, если целевой программе требуется больше одного подписанта от вашего контракта. Чтобы получить адрес PDA внутри Solidity, используйте `find_program_address` в precompile System; см. [Вычисление PDA](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/call-solana-from-evm.md#pda-derivation).

## Правила, по которым определяется, сработает ли это

* **Объявляйте каждый аккаунт.** Solana требует полный список аккаунтов до запуска вызова. Прокси находит его, сначала эмулируя вашу транзакцию, поэтому каждый аккаунт должен выводиться из входных данных, которые есть у контракта. Общее число должно оставаться в пределах лимита в 64 адреса.
* **Соблюдайте атомарность.** Вызов, который выполняет CPI в legacy-track, не может выполняться итеративно. Он должен укладываться в одну атомарную транзакцию, поэтому ограничивайте каждое действие одним перемещением токена и одной CPI.
* **Выберите один режим.** В Rome есть два семейства precompile, которые изменяют состояние Solana: legacy (`CpiProgram`, `HelperProgram`, `Вывод`) и cached ( `...Cached` набор). Одна транзакция использует одно семейство. Только legacy-track может вызывать пользовательскую программу. Ознакомьтесь с таблицей в [Интеграция программы Solana](https://docs.rome.builders/pages/b053ed7c840645eca285db39f036cae4e7148e31#id-4.-one-track-per-contract-and-per-transaction).
* **Держите глубину небольшой.** Ваш вызов программы Solana использует уровни CPI, и каждая программа, которую она вызывает далее, делает то же самое. Лимит глубины в Solana невелик. [Ограничения](https://docs.rome.builders/ru/klyuchevye-ponyatiya/constraints.md#cpi-constraints) объясняет эти уровни.
* **Никаких обратных вызовов в Rome.** CPI не может указывать на программу Rome или вызывать её. Он не может указывать на плательщика комиссии Solana, кроме как в обычной инструкции System transfer.

## Проверьте себя

Добавьте `createMyAta` в `SolanaPeek` и разверните его в Hadrian. Затем:

1. Вызовите `myTokenAccount` и `myBalance` с помощью вызова чтения с адреса вашего кошелька.
2. Отправьте транзакцию, которая вызывает `createMyAta`.
3. Откройте транзакцию в обозревателе Hadrian. См. [Через обозреватель](https://docs.rome.builders/ru/prilozheniya-v-rome/via.md).

Вы должны увидеть инструкцию Solana, стоящую за вашим вызовом, и её единицы вычисления. Вызов, который достигает Solana, отображает программу Solana в обозревателе, а не только вызов EVM.

<details>

<summary>1. Контракт вызывает <code>HelperProgram.transfer_spl</code>. Чьи токены перемещаются?</summary>

Собственные токены контракта. Подписант — это PDA внешнего полномочия контракта. Чтобы переместить токены пользователя, пользователь должен сначала предоставить право.

</details>

<details>

<summary>2. Почему вызов, который использует <code>invoke</code> должен укладываться в одну атомарную транзакцию?</summary>

CPI в legacy-track отклоняются внутри итеративной транзакции. Если вызову требуется больше одной транзакции Solana, он завершается с ошибкой.

</details>

<details>

<summary>3. Каким чтениям можно доверять в любом режиме исполнения?</summary>

Только для чтения: `account_info`, `account_data_at`, `account_u64_at`, `account_lamports`, `pdas_batch_derive` и чтения Helper, такие как `user_balance`. У них нет побочных эффектов. Выполняйте их до любой закэшированной модификации в той же транзакции.

</details>

## Далее

[6. Токены с обеих сторон](https://docs.rome.builders/ru/rome-academy/06-tokens-on-both-sides.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/rome-academy/05-call-solana-from-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.
