> 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/08-open-your-solana-program-to-evm-users.md).

# 8. Откройте свою программу Solana для пользователей EVM

Позвольте пользователям MetaMask вызывать программу, которую вы уже запускаете в Solana, через тонкий контракт Solidity и прекомпилированный контракт CPI, без переноса и без второй копии вашего состояния.

У вас есть работающая программа Solana. Её пользователи используют кошельки Solana. Rome позволяет привлечь к ней вторую аудиторию — людей, у которых есть EVM-кошелёк, например MetaMask, без переписывания программы на Solidity.

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

* Зачем открывать программу Solana для пользователей EVM и что при этом сохраняется.
* Как вызов EVM достигает вашей программы: тонкий контракт на Solidity и precompile CPI.
* Что ваша программа видит как подписанта и как счета.
* Как токены пользователя EVM попадают в вашу программу и возвращаются обратно.
* Ограничения, которые нужно учитывать при проектировании: один трек, одна атомарная транзакция, лимит на счета.

## Сценарий использования

Этот урок основан на сценарии использования из [Что вы можете создать](https://docs.rome.builders/ru/rome-academy/02-what-you-can-build.md): существующее приложение Solana, которому нужны дополнительные пользователи. Подойдёт рынок кредитования, AMM, хранилище, рынок прогнозов или программа конфиденциальности.

Аудитория EVM велика и уже имеет кошельки, инструменты и привычки. Если перенести вашу программу на Solidity, вам придётся поддерживать две кодовые базы и разделять состояние. В Rome вы сохраняете одну программу и одно состояние. Пользователи EVM получают доступ через небольшой контракт на Solidity, а пользователи Solana продолжают вызывать её нативно. Обе стороны торгуют против одних и тех же счетов и одной и той же ликвидности. [Выберите ваше ядро](https://docs.rome.builders/ru/klyuchevye-ponyatiya/choose-your-core.md) называет такую схему (b) — нативное ядро Solana с тонким CPI-роутером.

[rome-dex](https://github.com/rome-protocol/rome-dex) является эталонным вариантом: нативный пул Solana с EVM-роутером перед ним.

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

* Завершите [7. Откройте ваше EVM-приложение для кошельков Solana](https://docs.rome.builders/ru/rome-academy/07-open-to-solana-wallets.md)— та же идея с другой стороны.
* Знайте [5. Вызов Solana из Solidity](https://docs.rome.builders/ru/rome-academy/05-call-solana-from-solidity.md) и [6. Токены с обеих сторон](https://docs.rome.builders/ru/rome-academy/06-tokens-on-both-sides.md). Этот урок объединяет их.
* Разверните свою программу в Solana devnet. Hadrian работает там, поэтому программа должна существовать в этом кластере. См. [Hadrian](https://docs.rome.builders/ru/seti/hadrian.md).

## Путь вкратце

### Шаг 1: поставьте перед своей программой один тонкий контракт

Контракт — это адаптер. В нём нет бизнес-логики. Он проверяет вызывающего, формирует вашу инструкцию и вызывает precompile CPI с `invoke_signed`. Всё остальное остаётся в вашей программе Solana. Механика вызова описана в [Вызов Solana из EVM](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/call-solana-from-evm.md#calling-custom-solana-programs), а интерфейс описан `contracts/interface.sol` в публичном [rome-solidity](https://github.com/rome-protocol/rome-solidity) репозитории.

У вашего адаптера есть три способа хранить позицию пользователя. Руководство сравнивает их в [Три способа хранить позицию пользователя](https://docs.rome.builders/pages/b053ed7c840645eca285db39f036cae4e7148e31#id-2.-three-ways-to-hold-a-users-position):

| Форма                            | Что это                                                               | Подходит для                                              |
| -------------------------------- | --------------------------------------------------------------------- | --------------------------------------------------------- |
| Контракт-адаптер                 | Забирает токены пользователя, вызывает вашу программу от своего имени | Повторно используемая оболочка для программы с депозитами |
| Пользователь вызывает precompile | Подписывает сам пользователь, без контракта                           | Разовые разрешения и простые программы                    |
| Роутер без хранения средств      | Никогда не хранит токены, расходует делегирование пользователя        | Свопы и другие разовые действия                           |

Выбирайте адаптер для хранилища или кредитной программы, а роутер — для свопа.

### Шаг 2: поймите, кого видит ваша программа

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

Поэтому пользователь не является подписантом. Чтобы различать пользователей, адаптер передаёт в данные инструкции индивидуальное значение для каждого пользователя или просит Rome также подписать с помощью salted sub-PDA, вычисленного из адреса пользователя. Затем ваша программа хранит одну позицию на каждый sub-PDA. Правила для подписанта изложены в [У каждого EVM-адреса есть одна Solana-идентичность](https://docs.rome.builders/pages/b053ed7c840645eca285db39f036cae4e7148e31#id-1.-every-evm-address-has-one-solana-identity).

Стройте свою программу так, чтобы она действовала на основе любого подписанта. Тогда она будет одинаково обслуживать и кошелёк Solana, и адаптер.

### Шаг 3: переместите токены пользователя

В Rome USDC пользователя — это один SPL-токен, видимый с двух сторон, как показал урок 6. Баланс пользователя находится в token account, которым владеет его authority. Чтобы позволить адаптеру тратить его, пользователь до депозита предоставляет адаптеру SPL-делегирование. Адаптер переводит токены на token account, которым владеет сам, а затем вызывает вашу программу. На выходе ваша программа выплачивает на token account пользователя, и тот сразу видит это как баланс ERC-20.

Здесь важны две ловушки:

* ERC-20 `transferFrom` Перевод ERC-20 в контракт лишь зачисляет запись в эскроу-реестр обёртки. Контракт не получает token account, с которого можно тратить. Используйте делегирование, а не обёртку.
* У token account один делегат. Ваше разрешение вытесняет разрешение обёртки, и обычные переводы токенов пользователя прекращаются, пока он снова не предоставит разрешение обёртке. Проверьте `isEnabled` после вашего сценария.

Полная последовательность приведена в [Токены на вход, токены на выход](https://docs.rome.builders/pages/b053ed7c840645eca285db39f036cae4e7148e31#id-3.-tokens-in-tokens-out).

### Шаг 4: оставайтесь в пределах ограничений

* **Один трек.** Пользовательский вызов программы — это CPI legacy-track. Транзакция не может смешивать его с вызовами cached-track, поэтому не включайте кэшированную обёртку в эту транзакцию.
* **Только атомарно.** CPI legacy-track не может выполняться в итеративной транзакции. Весь вызов должен уместиться в одну транзакцию Solana — примерно 1,4 млн compute units, 64 адреса и 4 КБ. Ваша программа делит этот вычислительный бюджет с программой Rome.
* **Счета заранее.** Rome эмулирует вызов и включает в транзакцию Solana каждый счёт, к которому обращается. Каждый счёт должен выводиться из входных данных, которыми располагает адаптер. Новый счёт всё равно должен быть указан.
* **Малая глубина.** Ваша программа выполняется на один уровень ниже Rome. Каждая программа, которую она вызывает, использует ещё один уровень.
* **Рента оплачивается пользователем.** Счета, которые создаёт ваша инструкция, оплачиваются за счёт газа пользователя.

Сводите каждое действие к одному перемещению токенов и одному CPI в вашу программу. Всё более крупное разбивайте на две пользовательские транзакции. Ограничения сведены в одну таблицу в [Ограничения](https://docs.rome.builders/ru/klyuchevye-ponyatiya/constraints.md).

## Развернутый пример

Предположим, ваша программа — это хранилище. Пользователь Solana вносит USDC, а позже выводит его. Вы хотите, чтобы пользователи MetaMask делали то же самое.

1. Вы разворачиваете адаптер, который знает идентификатор вашей программы и mint USDC. В конструкторе он создаёт собственную Solana-идентичность и token account для неё.
2. Пользователь MetaMask отправляет одну транзакцию, которая предоставляет адаптеру SPL-делегирование на его USDC.
3. Пользователь вызывает `депозит`. Адаптер переводит USDC на свой собственный token account, затем вызывает вашу программу, указывая в качестве подписантов свой собственный authority и под-PDA с солью для этого пользователя.
4. Ваша программа переводит USDC в своё хранилище и записывает позицию под sub-PDA.
5. Предоставленное адаптером право заменило право обёртки, поэтому ваше приложение читает `isEnabled` в обёртке для пользователя. Оно возвращает `false`, а пользователь отправляет `approve_spl` разрешение обёртке снова. Для следующего депозита потребуется новое разрешение для адаптера.
6. Пользователь вызывает `withdraw`. Адаптер заставляет вашу программу выплатить средства из хранилища напрямую на token account пользователя. Баланс отображается в MetaMask как токен ERC-20.

Ваши пользователи Solana никогда не взаимодействовали с адаптером. Они обращаются к хранилищу напрямую и видят те же итоги. Соответствующий эскиз на Solidity приведён в [Депозит и вывод средств на Solidity](https://docs.rome.builders/pages/b053ed7c840645eca285db39f036cae4e7148e31#id-7.-a-deposit-and-a-withdraw-in-solidity).

Сначала протестируйте на Hadrian. `eth_call` и `eth_estimateGas` Запускается та же эмуляция, которую proxy использует для отправки, поэтому CPI, который там не проходит, не проходит и в сети по той же причине, а revert несёт ошибку вашей программы. После отправки прочитайте Solana-часть транзакции с помощью `rome_solanaTxForEvmTx`. См. [Тестирование](https://docs.rome.builders/pages/b053ed7c840645eca285db39f036cae4e7148e31#id-8.-testing).

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

Возьмите небольшую собственную программу или программу из rome-dex и запишите, без кода:

1. Подписант, которого ваша программа видит при вызове со стороны адаптера.
2. Счета, которые указывает один депозит.
3. Количество перемещений токенов и CPI в этом депозите.

Затем разверните адаптер на Hadrian, пополните token account пользователя, отправьте SPL-право адаптеру и прогоните депозит через `eth_estimateGas` с адресом пользователя в качестве `из`. Оценка должна пройти успешно. Если она завершится неудачей, revert data укажет на ошибку Solana.

<details>

<summary>1. Пользователь MetaMask вносит депозит через ваш адаптер. Кто выступает подписантом для вашей программы?</summary>

PDA внешней authority адаптера, а также любой под-PDA с солью, который указывает адаптер. Не пользователь. Права пользователя исходят из SPL-делегирования, которое он предоставил.

</details>

<details>

<summary>2. Почему бы не забрать USDC пользователя с помощью разрешения обёртки <code>transferFrom</code>?</summary>

Токены оказались бы на эскроу-счёте обёртки и были бы записаны в её реестре. У адаптера не было бы собственного token account, который можно передать вашей программе.

</details>

<details>

<summary>3. Ваш депозит растёт, пока не достигает десяти CPI, и Rome выполняет его итеративно. Что происходит?</summary>

Он завершается неудачей. CPI legacy-track отклоняется в итеративной транзакции. Сведите действие к одному перемещению токенов и одному CPI или разбейте его на две транзакции.

</details>

## Далее

[9. Создайте двухканальное приложение](https://docs.rome.builders/ru/rome-academy/09-build-a-dual-lane-app.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/08-open-your-solana-program-to-evm-users.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.
