> 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/06-tokens-on-both-sides.md).

# 6. Токены по обе стороны

Как один SPL-токен отображается как обертка ERC-20 для кошельков EVM и как токен-аккаунт для кошельков Solana, а также как одноразовое разрешение позволяет контрактам перемещать его.

Токены лежат в основе каждого сценария использования в [2. Что можно создать](https://docs.rome.builders/ru/rome-academy/02-what-you-can-build.md): пул, хранилище или рынок кредитования — все они используют один и тот же актив, который хранится в кошельках Solana. Обёртка SPL предоставляет доступ к mint SPL через интерфейс ERC-20. Для токенов, хранящихся в кошельке, обёртка считывает баланс из производного от Rome токенового аккаунта кошелька, поэтому Solana и Solidity видят один и тот же баланс. В этом уроке объясняется, как это работает и какое единственное разрешение должен выдать каждый пользователь, прежде чем ваш контракт сможет перемещать его токены.

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

* Как обёртка SPL предоставляет доступ к балансу токенов кошелька Solana через методы ERC-20.
* Что делают фабрика и обёртка и какую обёртку использовать.
* Чем токены в контрактах отличаются от токенов в кошельках.
* Однократное разрешение `approve_spl` , как его проверить и почему оно перестаёт действовать.

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

* Завершение [5. Вызов Solana из Solidity](https://docs.rome.builders/ru/rome-academy/05-call-solana-from-solidity.md). Вам понадобится разобраться в PDA с внешними полномочиями и прекомпиляции Helper.
* Подготовьте пополненный кошелёк Hadrian и развёрнутый контракт. Канонические адреса обёрток указаны в файле `tokens.json` в реестре: запись с `kind: "spl_wrapper"` и символом `wUSDC`. [Hadrian](https://docs.rome.builders/ru/seti/hadrian.md) ссылка на папку реестра этой сети.
* Аккаунт токена USDC, который вы создали с помощью `createMyAta` в уроке 5. Для выдачи разрешения аккаунт должен существовать.

## Один баланс — два представления

У каждого адреса EVM есть PDA с внешними полномочиями в Solana, которому принадлежат токеновые аккаунты этого адреса. Метод ERC-20-обёртки `balanceOf` напрямую считывает токеновый аккаунт кошелька. `totalSupply` считывает mint.

В Rome токен SPL кошелька и его ERC-20-обёртка считывают данные из одного и того же токенового аккаунта. И кошелёк Solana, в котором хранится USDC, и адрес EVM, в котором хранится USDC, владеют токенами одного mint и торгуют через одни и те же аккаунты пула. Благодаря этому ликвидность в Rome сосредоточена в одном месте. Иллюстрация и подробное описание приведены в разделе [Взаимодействие токенов](https://docs.rome.builders/ru/klyuchevye-ponyatiya/token-interop.md#the-shared-state-model).

## Кошельки и контракты хранят токены по-разному

Общий баланс работает для кошельков, но контракты устроены иначе. Контракт не может выдать от имени пользователя описанное ниже однократное разрешение, поэтому обычные обёртки хранят токены контракта в эскроу-аккаунте токенов и ведут реестр принадлежащих каждому контракту токенов. Обёртки для Token-2022 с хуками не ведут реестр и используют собственный токеновый аккаунт контракта.

Из этого следуют два вывода:

* Две обёртки одного mint показывают одинаковый баланс кошелька. Баланс контракта может различаться, поскольку каждая обёртка ведёт собственный реестр.
* Для пулов, хранилищ и рынков кредитования используйте каноническую обёртку, указанную в реестре для каждого mint в каждой сети. Не выбирайте её по названию.

При переводе через обёртку на контракт токены зачисляются в этот реестр. Контракт не получает токеновый аккаунт, из которого мог бы тратить токены. Для операций, в которых контракту нужно взаимодействовать с Solana, используйте способ, описанный в разделе [Интеграция программы Solana](https://docs.rome.builders/pages/b053ed7c840645eca285db39f036cae4e7148e31#id-3.-tokens-in-tokens-out).

## Фабрика и обёртка

`ERC20SPLFactory` развёртывает обёртку для mint SPL. Каждая фабрика допускает только одну обёртку для каждого mint. Обёртка предоставляет полный интерфейс ERC-20:

* `balanceOf` и `totalSupply` считывают состояние Solana.
* `transfer` и `transferFrom` перемещают токены в Solana.
* `approve` и `allowance` обычные разрешения ERC-20 храните в EVM-хранилище, поскольку у токенового аккаунта такого понятия нет.

Обычно разворачивать обёртку не нужно. Rome и реестр уже содержат канонические обёртки для USDC, ETH и SOL. Разворачивайте свою, только если добавляете новый mint. Оба вызова фабрики описаны в разделе [Фабрика](https://docs.rome.builders/ru/klyuchevye-ponyatiya/token-interop.md#the-factory). Фабрика также поддерживает mint-токены Token-2022, но их расширения меняют интеграцию: обёртка с хуком отклоняет обычные вызовы `transfer` и `transferFrom`, а mint с комиссией за перевод может зачислить меньше токенов, чем вы отправляете. Перед использованием такого mint в хранилище прочитайте раздел [Mint-токены Token-2022](https://docs.rome.builders/ru/klyuchevye-ponyatiya/token-interop.md#token-2022-mints) .

Суммы должны помещаться в `uint64`, поскольку значения SPL Amount имеют этот формат, а обёртка отклоняет всё, что больше. У газового токена своя точность, а балансы нативного газа используют 18 знаков. Преобразование между ними должно быть точным. Газовый токен в Hadrian и Rubicon — USDC.

## Одноразовое разрешение

Обёртка перемещает токены пользователя, выступая делегатом SPL для его токенового аккаунта. Прежде чем обёртка сможет перемещать токены, в токеновом аккаунте должен быть указан этот делегат. Пользователь делает это один раз для каждой обёртки одним вызовом, указав максимальную сумму:

`approve_spl(wrapper, type(uint64).max, mint)` в прекомпиляции Helper.

На практике важны четыре детали:

* **Вызов отправляет пользователь.** Разрешение подписывается аккаунтом самого пользователя и отправляется напрямую в прекомпиляцию Helper. Ваш контракт не может отправить его за пользователя. Добавьте в интерфейс шаг «Включить».
* **Оно нужно всем.** Оно нужно и кошелькам MetaMask, и синтетическим адресам кошельков Solana — для каждой обёртки, чьи токены они хотят перемещать.
* **Сначала проверьте разрешение.** Метод обёртки `isEnabled(user)` возвращает `true` после выдачи разрешения. Перед переводом проверьте его, а не исходите из предположения, что оно есть.
* **Указывайте максимальную сумму.** `isEnabled` остаётся равным `true` пока не израсходована какая-либо часть разрешения с ограниченным лимитом. Когда лимит такого разрешения почти исчерпан, обычные переводы перестают работать, а приложение не узнает, что нужно запросить разрешение снова.

В качестве mint передавайте `mint_id()` из обёртки. Пример реализации для интерфейса, поддерживающей оба типа кошельков, приведён в разделе [Одноразовое действие: выдать разрешение обёртке](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/dual-lane-app.md#one-time-grant-the-wrapper).

### Почему это перестаёт работать

У токенового аккаунта может быть только один делегат. Если пользователь выдаёт разрешение мосту или маршрутизатору, оно заменяет разрешение для обёртки, и та перестаёт работать для этого пользователя. Это проявляется как откат с ошибкой SPL `0x4`, означающей несовпадение владельца. Исправление — снова выдать разрешение обёртке. Поэтому проверяйте `isEnabled` перед каждым процессом, зависящим от обёртки, а не только при регистрации.

При выпуске новой версии фабрики появляется новая обёртка, и каждый кошелёк выдаёт ей разрешение тем же способом.

## Перемещение токенов наружу

Поскольку баланс обёртки уже является балансом SPL, перемещение токена в Solana выполняется как перевод SPL.

* На другой кошелёк Solana с кошелька EVM: `transfer_spl` напрямую из кошелька в прекомпилятор Helper или через `RomeBridgeWithdraw.bridgeOutToSolana`, для которого также требуется разрешение для контракта моста. В обоих случаях аккаунт токена получателя должен существовать.
* На кошелёк, подписавший транзакцию: `transfer_spl_to_signer`. Токены поступят на собственный кошелёк пользователя только при использовании маршрута Solana с подписью кошелька. В MetaMask подписантом выступает прокси-плательщик Rome, поэтому используйте один из двух других способов.
* Для токена газа `withdraw_to_ata` и `deposit_from_ata` обменивают нативный газ на токен в аккаунте токена и обратно.

Solgate обеспечивает переводы активов Solana в сети AggLayer EVM и обратно — как в основной сети, так и в тестовой. В тестовой сети регистрировать SPL-токены может любой желающий. Для USDC используется CCTP. [Урок 10](https://docs.rome.builders/ru/rome-academy/10-from-other-chains.md) возвращается к входящим переводам и мосту. Список методов приведён в разделе [Внесение и вывод средств](https://docs.rome.builders/ru/klyuchevye-ponyatiya/token-interop.md#deposit-and-withdraw).

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

В сети Hadrian используйте пополненный вами кошелёк:

1. Прочитайте значение `isEnabled` для своего адреса в канонической обёртке wUSDC из реестра.
2. Убедитесь, что ваш аккаунт токена USDC существует. Вызов `createMyAta` в уроке 5 создал его. Если вы пропустили этот шаг, оберните небольшое количество газа в wUSDC с помощью `withdraw_to_ata`, как описано в разделе [То же приложение в MetaMask](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/dual-lane-app.md#the-same-app-from-metamask).
3. Если `isEnabled` равно `false`, отправьте разрешение `approve_spl` для прекомпилятора Helper. Используйте код из руководства по двум маршрутам, ссылка на которое приведена выше.
4. Снова прочитайте значение `isEnabled` Теперь оно должно быть равно `true`.
5. Найдите транзакцию выдачи разрешения в [Обозревателе](https://docs.rome.builders/ru/prilozheniya-v-rome/via.md). Найдите инструкцию SPL Token `ApproveChecked` .

<details>

<summary>1. Почему в двух обёртках одного и того же минта отображается одинаковый баланс кошелька?</summary>

Обе обёртки считывают данные аккаунта токена кошелька в Solana. Обёртка — это представление SPL-токена, а не отдельный реестр. Отдельно для каждой обёртки учитываются только балансы, принадлежащие контрактам.

</details>

<details>

<summary>2. Пользователь вносит средства в ваше хранилище, а затем использует маршрутизатор, который запрашивает собственное разрешение <code>approve_spl</code>. Следующий вызов <code>transferFrom</code> завершается ошибкой SPL 0x4. Почему?</summary>

У аккаунта токена может быть только один делегат. Разрешение для маршрутизатора заменило разрешение для обёртки. Пользователь должен снова выдать разрешение обёртке, а ваше приложение должно проверять `isEnabled` перед переводом.

</details>

<details>

<summary>3. Какую обёртку пула вы используете для нового пула ликвидности?</summary>

Каноническую обёртку, указанную в реестре для этого mint в этой сети. Балансы, хранящиеся в контракте, различаются у разных обёрток.

</details>

## Далее

[7. Подключите приложение EVM к кошелькам Solana](https://docs.rome.builders/ru/rome-academy/07-open-to-solana-wallets.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/06-tokens-on-both-sides.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.
