> 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/07-open-to-solana-wallets.md).

# 7. Откройте ваше EVM-приложение для кошельков Solana

Сделайте свой контракт доступным из кошелька Solana без ключа EVM, рассматривая синтетический адрес, значение ERC-20, две подписи и атомарный бюджет.

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

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

* Как кошелёк Solana становится обычным `msg.sender` в Rome.
* Почему этот курс принимает стоимость как депозит в ERC-20, и что `msg.value` требуется от пользователя Solana.
* Что пользователь Solana подписывает для каждого вызова и куда попадает транзакция.
* Что помещается в одну транзакцию Solana и что происходит с вызовом, который не помещается.
* Какие `зависимости` нужны SDK и откуда берётся каждая из них.

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

* Завершите [6. Токены с обеих сторон](https://docs.rome.builders/ru/rome-academy/06-tokens-on-both-sides.md). Этот урок предполагает, что вы знаете, что такое wrapper и почему пользователь даёт ему разрешение один раз.
* У вас есть `HelloRome` развернут в Hadrian из [3. Ваш первый контракт в Hadrian](https://docs.rome.builders/ru/rome-academy/03-first-contract-on-hadrian.md).
* Установите TypeScript SDK, как в [Rome SDK](https://docs.rome.builders/ru/produkty/rome-sdk.md#typescript-sdk-rome-protocol-sdk).
* У вас есть кошелёк Solana, который подписывает транзакции Solana v1, с небольшим количеством SOL в devnet и USDC в devnet. Faucets перечислены в [Краны](https://docs.rome.builders/ru/resursy/faucets.md). Поддержка транзакций v1 различается между кошельками, поэтому сначала проверьте свой. [Сборка приложения с двумя дорожками](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/dual-lane-app.md) в перечне кошельков, проверенных на данный момент.

## Урок

### Шаг 1. Познакомьтесь с синтетическим адресом

У кошелька Solana нет EVM-адреса, поэтому Rome выводит его из его открытого ключа. Результат — синтетический адрес кошелька. Это `msg.sender` его видит ваш контракт, и он имеет собственный nonce и хранилище, как и любой другой аккаунт. Один и тот же кошелёк всегда сопоставляется с одним и тем же адресом.

```javascript
import { syntheticAddress } from "@rome-protocol/sdk";
const from = syntheticAddress(solanaPubkey); // обычный 20-байтный адрес
```

В потоке этого курса синтетический адрес не хранит токены в покое. Они находятся в кошельке Solana пользователя. Этап пополнения переводит их на токенный аккаунт синтетического адреса перед депозитом, и только после этого wrapper `balanceOf(synthetic)` показывает их. Этап вывода возвращает их обратно в кошелёк после снятия. Полную модель читайте в [Вызов EVM из Solana](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/call-evm-from-solana.md#synthetic-addresses).

### Шаг 2. Подготовьте контракт к Solana

Большинству контрактов изменения не нужны. Три правила определяют, относится ли ваш к их числу:

* Принимайте стоимость как ERC-20. Забирайте её с помощью `transferFrom` после `approve`, и возвращайте с помощью `transfer`.
* Указывайте на канонический wrapper для каждого токена. Не разворачивайте свой собственный.
* Сделайте так, чтобы каждый вызов по каналу Solana укладывался в одну транзакцию Solana.

Первое правило — то, на котором обычно спотыкаются. Эта точка входа работает для пользователей MetaMask. Для пользователей Solana в модели пополнения и вывода она не работает, потому что их синтетический адрес не имеет собственного нативного баланса, если вы не пополните его с помощью `fundSyntheticGas`:

```solidity
function deposit() external payable { balanceOf[msg.sender] += msg.value; }
```

Этот вариант работает для обоих, потому что оба канала могут пополнять `transferFrom`:

```solidity
function deposit(uint256 amount) external {
    require(token.transferFrom(msg.sender, address(this), amount));
    balanceOf[msg.sender] += amount;
}
```

Адреса wrapper находятся в [справочнике Contract Addresses](https://docs.rome.builders/ru/spravochnik/contract-addresses.md). [Откройте свой Solidity-контракт для пользователей Solana](https://docs.rome.builders/pages/5531072dac8bc8e0245b2be4c72886d7d5c4c241#id-2.-what-makes-a-contract-solana-ready).

### Шаг 3. Поймите, что подписывает кошелёк

Вызов SDK — это `submitRomeTxV1`. Для каждого вызова proxy формирует одну транзакцию Solana v1. Кошелёк подписывает дважды одним и тем же ключом. Сначала он подписывает понятное сообщение авторизации, в котором указан хэш EVM-транзакции. Затем он подписывает саму транзакцию.

Приложение отправляет подписанную транзакцию в Solana RPC, а не в Rome proxy. Сеть проверяет авторизацию через программу Ed25519 и выполняет ваш вызов от имени синтетического адреса. Пользователь никогда не хранит EVM-ключ.

Перед тем как кошелёк подпишет транзакцию, SDK проверяет, что она содержит именно тот вызов, который авторизовал пользователь. Любое другое содержимое отклоняется. Подробности в [Откройте свой Solidity-контракт для пользователей Solana](https://docs.rome.builders/pages/5531072dac8bc8e0245b2be4c72886d7d5c4c241#id-3.-let-a-solana-wallet-call-it).

### Шаг 4. Подключите канал

SDK нужны пять значений: URL proxy, chain ID, идентификатор программы Rome, подключение к Solana RPC и signer. Четыре описывают сеть. Одно приходит из кошелька.

```javascript
const deps = { connection, proxyUrl, chainId, programId, signer };
const res = await submitRomeTxV1(deps, { to: helloRome, data }); // helloRome: ваш контракт из урока 3; data: ABI-кодированный вызов greet()
```

Для Hadrian возьмите четыре сетевых значения из реестра. Сопоставление приведено в `зависимости` таблице руководства, на которую дана ссылка в шаге 3, а значения находятся в [Hadrian](https://docs.rome.builders/ru/seti/hadrian.md). Урок 11 рассматривает ту же настройку для Rubicon.

Перед первым вызывающимся у нового пользователя переводом стоимости требуются два одноразовых шага. Подготовьте синтетический адрес с помощью `buildCreatePdaCall`, и предоставьте разрешение wrapper, если `isEnabled` равен false. `submitRomeTxV1` не выполняет подготовку за вас. Урок 9 выполняет оба шага по порядку.

### Шаг 5. Оставайтесь в одной транзакции

Вызов по каналу Solana должен помещаться в одну транзакцию Solana: примерно 1,4 млн вычислительных единиц, 64 аккаунта и 4 КБ. Измеряйте с помощью `computeUnitsConsumed` из квитанции Solana, а не EVM `gasUsed`. Запрашивайте транзакцию с `maxSupportedTransactionVersion: 1`; без этого RPC отклонит запрос.

Когда вызов не помещается, composer отклоняет его, а SDK передаёт его proxy для ретрансляции с той же подписью авторизации. Пользователь всё равно видит один запрос. Результат содержит `route: "relay"`. Ретранслируемый вызов расходует нативный gas синтетического адреса, поэтому сначала пополните его с помощью `fundSyntheticGas`. Ретранслируемый вызов, который завершается revert, не вызывает исключение. Проверьте `receipt.status`. Правила описаны в [Ретранслируемые вызовы и длинные вызовы](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/call-evm-from-solana.md#relayed-calls-and-long-calls). Ограничения в одной таблице: [Ограничения](https://docs.rome.builders/ru/klyuchevye-ponyatiya/constraints.md).

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

Ответьте на эти вопросы, затем откройте ответы.

1. Почему `payable` депозит не проходит для пользователя Solana?
2. Сколько подписей кошелёк создаёт за один вызов и что покрывает каждая?
3. Куда отправляется подписанная транзакция?
4. Для вызова требуется больше одной транзакции. Что видит пользователь и кто платит?

<details>

<summary>Ответы</summary>

1. Деньги пользователя — это SPL-токен в его кошельке, который в Rome отображается как wrapper. В модели пополнения и вывода синтетический адрес не имеет нативного баланса, если его не пополнить, поэтому нет `msg.value` чего отправлять.
2. Две. Первая покрывает понятное сообщение авторизации с хэшем EVM-транзакции. Вторая покрывает транзакцию Solana.
3. В Solana RPC, отправленную приложением. Proxy формирует транзакцию и не получает её, кроме случая ретранслируемого вызова.
4. Один запрос на авторизацию. Proxy ретранслирует вызов, и за него платит баланс нативного gas синтетического адреса.

</details>

## Далее

[8. Откройте вашу программу Solana для пользователей EVM](https://docs.rome.builders/ru/rome-academy/08-open-your-solana-program-to-evm-users.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/07-open-to-solana-wallets.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.
