> 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/rukovodstva-dlya-razrabotchikov/open-to-solana-users.md).

# Откройте ваш контракт для пользователей Solana

Разверните контракт Solidity в Rome (тестовая сеть Hadrian, основная сеть Rubicon) и откройте его для кошельков Solana — что требуется контракту, как пользователь кошелька Solana вызывает его, адреса для каждой сети и запуск ch

Одна развертка, два типа пользователей. Контракт в Rome достигается пользователями MetaMask с их EVM-ключом и пользователями Solana-кошельков (например, Solflare) с их ключом Solana — тот же адрес, то же состояние. Эта страница — сквозной путь: развернуть, сделать контракт готовым к Solana, подключить канал Solana в вашем приложении и выпустить в mainnet.

## 1. Разверните в нужной вам сети

Сети Rome — это стандартные цели EVM: Hardhat, Foundry, viem и ethers работают без изменений (полное руководство в [Развертывание Solidity-контрактов](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/deploy-solidity.md)).

| Сеть                                                                         | Идентификатор цепи | RPC                                         | Обозреватель                                                                          | Токен для оплаты газа | Как получить газ                                                                                                                                                                                          |
| ---------------------------------------------------------------------------- | ------------------ | ------------------------------------------- | ------------------------------------------------------------------------------------- | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [**Rubicon**](https://docs.rome.builders/ru/seti/rubicon.md) (основная сеть) | `7531`             | `https://rubicon.mainnet.romeprotocol.xyz/` | [via-rubicon.mainnet.romeprotocol.xyz](https://via-rubicon.mainnet.romeprotocol.xyz/) | USDC                  | Переведите USDC с Ethereum, Base, Arbitrum, Polygon, Avalanche, Monad или OP (CCTP) либо с Solana с помощью [Мост Rome](https://bridge-api.mainnet.romeprotocol.xyz/); он поступает как газ               |
| **Hadrian** (тестовая сеть)                                                  | `200010`           | `https://hadrian.testnet.romeprotocol.xyz/` | [via-hadrian.testnet.romeprotocol.xyz](https://via-hadrian.testnet.romeprotocol.xyz/) | тестовый USDC         | Переведите тестовый USDC из тестовой сети ([Краны](https://docs.rome.builders/ru/resursy/faucets.md)) или оберните его из кошелька Solana devnet в [Приложение Rome](https://app.devnet.romeprotocol.xyz) |

Газ — это USDC с 18 знаками после запятой на стороне EVM; на Rubicon или Hadrian в Rome нет крана. Запись в сеть стоит больше газа, чем подсказывает интуиция по Ethereum, потому что основная часть стоимости — это создание аккаунтов Solana: получатель, который никогда не использовался, новый токен-аккаунт, развернутый контракт. Используйте `eth_estimateGas`то, что делает стандартный инструментарий, и никогда не жёстко задавайте 21 000. По измерениям на Hadrian развертывание контракта размером 10 байт потребовало и использовало 1 147 921 газа, а нативный перевод на адрес, который никогда не использовался, — 1 086 961, против 21 000 для перевода на уже существующий адрес. Rome списывает фактически использованный газ, и в этих измерениях он никогда не превышал оценку. Перед первым развертыванием пополните баланс несколькими USDC. После этого проверьте исходный код в обозревателе ([Верифицировать контракты](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/verify-contracts.md)главный верификатор для mainnet — `https://verify.mainnet.romeprotocol.xyz`).

Разрабатывайте на Hadrian, затем повторно разверните те же артефакты в Rubicon, заменив chain id и адреса mainnet-обёртки; в контракте между сетями ничего не меняется. Rubicon присутствует в публичном реестре начиная с v0.3.0, но `create-rome-app` и `rome-cli` по-прежнему закрепляют реестр v0.2.0, в котором записи Rubicon нет, поэтому они не могут нацелиться на него; для таких инструментов заполните значения вручную из [Rubicon](https://docs.rome.builders/ru/seti/rubicon.md). Газ в Rubicon — это реальные USDC примерно по цене газа Hadrian, умноженной на десять, так что развертывание там стоит реальных денег.

## 2. Что делает контракт готовым к Solana

EVM-идентичность пользователя Solana — это его **синтетический адрес**, `keccak256(solana_pubkey)[12:]`: обычный `msg.sender`, с обычным nonce. Большинству контрактов вообще не требуется никаких изменений. Важны три вещи:

* **Получайте ценность как ERC-20, а не как `msg.value`.** Средства пользователя Solana — это SPL-токены в его кошельке, которые на стороне EVM видны как обёртка токена (`wUSDC`, `wETH`, `wSOL`). Синтетический адрес не хранит ничего в состоянии покоя, а активы пользователя поступают как обёртка, поэтому забирайте их через `transferFrom` после `approve` и возвращайте через `transfer`. Каждый пользователь один раз предоставляет обёртке право SPL delegate до первого забора ([Разово: предоставить права обертке](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/dual-lane-app.md#one-time-grant-the-wrapper)). `payable` точка входа работает только после того, как синтетическому адресу выдан нативный газ (путь ретрансляции — `rome_composeExternalDepositV1`), чего модель «пополнить и собрать» не делает. Существующий хранилище ERC-20, AMM или кредитный рынок уже имеет правильную форму.
* **Используйте канонические обёртки.** У каждой сети по одной обёртке на каждый mint; адреса указаны в [справочнике Contract Addresses](https://docs.rome.builders/ru/spravochnik/contract-addresses.md) (для Hadrian они также есть в публичном [реестре](https://github.com/rome-protocol/rome-registry)). Указывайте эти адреса в конструкторах; не разворачивайте собственные.
* **Учитывайте атомарный бюджет там, где кошелёк подписывает.** Кошелёк Solana подписывает одну транзакцию Solana, поэтому вызов в канале Solana должен в неё помещаться: примерно 1,4 млн compute units, 64 аккаунта, 4 КБ ([Ограничения](https://docs.rome.builders/ru/klyuchevye-ponyatiya/constraints.md)). По измерениям на Hadrian: перевод, approve и поставка в Aave помещаются; swap в Uniswap V3 помещается с небольшим запасом (около 1,24 млн CU); заимствование в Aave не помещается и переходит в путь ретрансляции из следующего раздела. Измеряйте по полю `computeUnitsConsumed`, запрашивая транзакцию с `maxSupportedTransactionVersion: 1` (пути Rome — это транзакции v1; без этого RPC отклонит запрос).

Что вам не нужно: программа Solana, мост, второе развертывание или какой-либо Solidity, специфичный для Rome. Если контракт также вызывает программы Solana через precompile, см. [Вызов Solana из EVM](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/call-solana-from-evm.md).

## 3. Позвольте кошельку Solana вызывать его

EVM-путь вашего приложения не меняется (MetaMask + `submitRomeTx`, или обычные viem/ethers). Для пути Solana есть две формы.

**Канал SDK — одна транзакция Solana v1 на каждый вызов.** [`@rome-protocol/sdk`](https://github.com/rome-protocol/rome-sdk-ts) (`submitRomeTxV1`) делает так, что proxy формирует одну транзакцию Solana v1 для вашего вызова EVM (до 64 аккаунтов и 4 КБ, без address lookup table; в вашем коде нет инструкции ComputeBudget, treasure wallet или обнаружения аккаунтов). Кошелёк подписывает дважды одним и тем же ключом: сначала читаемое сообщение авторизации (`Авторизация Rome` в одной строке, `0x` и хэш EVM-транзакции на следующей), которое сеть проверяет через программу Ed25519, а затем транзакцию. Приложение отправляет подписанную транзакцию в RPC Solana; вызов возвращает хэш EVM-транзакции и её квитанцию. Перед тем как кошелёк подпишет транзакцию, SDK проверяет её: payer — единственный подписант, выполняются только программа Rome и верификатор Ed25519, инструкция Rome содержит ровно тот вызов, который пользователь авторизовал, и приоритетная комиссия отсутствует. Всё остальное отклоняется.

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

Нога пополнения (`buildFundLeg`) и создание токен-аккаунта кошелька перед sweep — это обычные инструкции Solana; `submitSolanaInstructionsV1` отправляет их тоже как транзакции v1, подписанные тем же подписантом-кошельком, без участия proxy. Собственный вызов sweep (`buildSweepLeg`, `HelperProgram.transfer_spl`) проходит через `submitRomeTxV1` как и любой другой, а proxy находит токен-аккаунты. `submitRomeTxV1` не создаёт аккаунт нового синтетического адреса самостоятельно: перед первым вызовом, который двигает ценность, проверьте `isSyntheticProvisioned(...)` и, если значение false, отправьте `buildCreatePdaCall(synthetic)` через `submitRomeTxV1` один раз. Полное пошаговое руководство по депозиту и выводу с кодом находится в [Сборка приложения с двумя дорожками](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/dual-lane-app.md); механика описана в [Вызов EVM из Solana](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/call-evm-from-solana.md). Более ранний `submitRomeTxSolanaLane`, который создаёт устаревшую транзакцию Solana на клиенте, и всё ещё присутствует в SDK как более старый путь.

**Откуда берётся каждое `зависимости` значение.** Объект `зависимости` SDK имеет пять обязательных полей (остальные, например `fetchImpl` и тайм-ауты, являются необязательными). Четыре приходят из сети и одно — из кошелька:

| `зависимости` поле | Откуда это берётся                                                                                               | Геттер реестра (`@rome-protocol/registry` v0.2.0)                                                          |
| ------------------ | ---------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| `proxyUrl`         | RPC URL сети                                                                                                     | `getChain(chainId).rpcUrl`                                                                                 |
| `chainId`          | chain ID сети                                                                                                    | `getChain(chainId).chainId`                                                                                |
| `programId`        | ID программы Rome, на которой работает сеть                                                                      | `getChain(chainId).romeEvmProgramId`                                                                       |
| `подключения`      | Solana RPC для кластера сети, куда отправляется подписанная транзакция (devnet для Hadrian, mainnet для Rubicon) | `getChain(chainId).solana.rpc` (публичный devnet URL для Hadrian); для mainnet используйте собственный RPC |
| `signer`           | кошелька `LaneSigner`, или `Keypair` в скриптах                                                                  | нет                                                                                                        |

Построители нога принимают значения, которых нет в `зависимости`. Их `mint` (называемый `usdcMint` в руководстве) — это mint газа сети Solana, взятый из `getTokens(chainId)` (запись с `kind: "gas"`, поле `mintId`). Адрес обёртки wUSDC не является входом для построителя нога; вы используете его для вызовов ERC-20, и это запись с `kind: "spl_wrapper"` и символом `wUSDC` (поле `address`). Реестр охватывает Hadrian и, начиная с v0.3.0, Rubicon. Чтобы заполнить значения Rubicon вручную, используйте вместо этого: `proxyUrl` `https://rubicon.mainnet.romeprotocol.xyz/`, `chainId` `7531`, `programId` `RomePq9X3iAoTr813HR7uRarafFDUJty6GdiEceYpzX`, `mint` `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`обёртку из таблицы в следующем разделе и Solana mainnet RPC для `подключения`. [Rubicon](https://docs.rome.builders/ru/seti/rubicon.md) содержит полный список.

**Внешние V1-эндпоинты proxy — тот же канал без SDK.** SDK оборачивает атомарный compose, ретрансляцию и внесение газа (`fundSyntheticGas`). Сырые RPC-методы остаются для клиентов, которые не используют SDK, и включают итеративный compose, который SDK не оборачивает. Кошелёк подписывает одно сообщение Ed25519 над вызовом (читаемая форма `Rome authorization\n0x<hash>` или необработанный hash), а proxy либо составляет транзакцию(и) Solana, которые кошелёк должен подписать (`rome_composeUnsignedAtomicV1`, `rome_composeUnsignedIterativeV1` + `rome_submitSignedV1Plan`), либо выполняет всё исполнение самостоятельно с одной подписью кошелька (`rome_relayUnsignedV1`, после `rome_composeExternalDepositV1` (SDK `fundSyntheticGas`) [Поддержка JSON-RPC](https://docs.rome.builders/ru/spravochnik/json-rpc.md)который пополняет баланс газа синтетического адреса; ретранслируемые вызовы расходуют этот баланс, поэтому пополняйте его, когда он уменьшается). Формы методов в [Вызов EVM из Solana](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/call-evm-from-solana.md#the-external-v1-endpoints); правила авторизации — в

В любом случае контракт видит обычную транзакцию от синтетического адреса, а пользователь никогда не хранит EVM-ключ.

## 4. Адреса обёрток для каждой сети

| Сеть             | `wUSDC` обёртка                              | Другие обёртки                                                                                           |
| ---------------- | -------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| Rubicon (7531)   | `0x0952d233b0c254cd375f3bfb3e5869c1a906f9b3` | `wETH` `0x01e8b3573da1d4b7b4b1ce0932cf07c8af0c92e9`, `wSOL` `0xc4e29e0f726a906e93277cbbc37bf27a9848a113` |
| Hadrian (200010) | `0xbce339ba4c3a8de3bb8af1c5539e6ac11da3112d` | `wETH` `0x02aeace038269f9961c93d04dcacd6fb3adfa55f`, `wSOL` `0x39f36444fcb79b3e691544aee2a832ebef54ca9f` |

Нативный газовый токен отображается как `0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee` в списках токенов; это не ERC-20 контракт. Обёртки наследуют знаки после запятой SPL mint, а не 18: wUSDC — 6, wETH — 8, wSOL — 9.

## 5. Чек-лист запуска

1. Развернуто на Hadrian; EVM-путь работает из MetaMask.
2. Каждая точка входа, которая двигает ценность, основана на ERC-20 и указывает на каноническую обёртку сети.
3. Кошелёк Solana, который подписывает транзакции v1 (Solflare сегодня делает это в devnet; Phantom пока нет), завершает полный круг на Hadrian: provision синтетического адреса (`create_pda`один раз) → нога пополнения → grant → approve → вызов → нога sweep, используя канал SDK; либо путь ретрансляции, если вызов итеративный.
4. Значение `computeUnitsConsumed` для каждого вызова в канале Solana считывается из квитанции Solana и укладывается в атомарный бюджет, либо вызов маршрутизируется через ретрансляцию.
5. Предоставление обёртки входит в первый поток внесения средств в вашем приложении для обоих каналов: `isEnabled(user)` проверяется и `approve_spl` отправляется один раз, когда значение false ([Разово: предоставить права обертке](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/dual-lane-app.md#one-time-grant-the-wrapper)).
6. Исходный код верифицирован в обозревателе.
7. Повторно развернуто в Rubicon с адресами mainnet-обёрток. Его `зависимости` значения берутся из реестра (v0.3.0 или новее) либо вручную из [Rubicon](https://docs.rome.builders/ru/seti/rubicon.md). Тот же круг выполняется один раз с реальными средствами, используя кошелёк, который, как вы проверили, подписывает транзакции v1 в mainnet.

## Что дальше

* [Сборка приложения с двумя дорожками](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/dual-lane-app.md) — пример хранилища, шаг за шагом, оба кошелька
* [Вызов EVM из Solana](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/call-evm-from-solana.md) — синтетические адреса, обнаружение аккаунтов, внешние V1-эндпоинты
* [Развертывание Solidity-контрактов](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/deploy-solidity.md) · [Верифицировать контракты](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/verify-contracts.md) · [справочнике Contract Addresses](https://docs.rome.builders/ru/spravochnik/contract-addresses.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/rukovodstva-dlya-razrabotchikov/open-to-solana-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.
