> 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/tr/gelistirici-kilavuzlari/open-to-solana-users.md).

# Sözleşmenizi Solana kullanıcılarına açın

Rome'da (Hadrian testnet, Rubicon mainnet) bir Solidity sözleşmesi dağıtın ve onu Solana cüzdanlarına açın — sözleşmenin neye ihtiyacı olduğu, bir Solana cüzdanı kullanıcısının onu nasıl çağırdığı, ağ başına adresler ve bir başlatma ch

Tek dağıtım, iki tür kullanıcı. Roma üzerinde bir sözleşmeye MetaMask kullanıcıları EVM anahtarlarıyla, Solana cüzdanı kullanıcıları (örneğin Solflare) ise Solana anahtarlarıyla ulaşır — aynı adres, aynı durum. Bu sayfa uçtan uca akıştır: dağıtın, sözleşmeyi Solana’ya hazır hale getirin, uygulamanıza Solana kanalını bağlayın ve ana ağda yayınlayın.

## 1. İstediğiniz ağda dağıtın

Rome zincirleri standart EVM hedefleridir: Hardhat, Foundry, viem ve ethers değişmeden çalışır (tam anlatım [Solidity Sözleşmeleri Dağıtma](https://docs.rome.builders/tr/gelistirici-kilavuzlari/deploy-solidity.md)).

| Ağ                                                                     | Zincir Kimliği | RPC                                         | Gezgin                                                                                | Gaz tokeni | Gaz nasıl alınır                                                                                                                                                                              |
| ---------------------------------------------------------------------- | -------------- | ------------------------------------------- | ------------------------------------------------------------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [**Rubicon**](https://docs.rome.builders/tr/aglar/rubicon.md) (ana ağ) | `7531`         | `https://rubicon.mainnet.romeprotocol.xyz/` | [via-rubicon.mainnet.romeprotocol.xyz](https://via-rubicon.mainnet.romeprotocol.xyz/) | USDC       | Ethereum, Base, Arbitrum, Polygon, Avalanche, Monad veya OP’den (CCTP) ya da Solana’dan USDC köprüsü kurun; [Rome Bridge](https://bridge-api.mainnet.romeprotocol.xyz/); gaz olarak yatırılır |
| **Hadrian** (testnet)                                                  | `200010`       | `https://hadrian.testnet.romeprotocol.xyz/` | [via-hadrian.testnet.romeprotocol.xyz](https://via-hadrian.testnet.romeprotocol.xyz/) | test USDC  | Bir testnet’ten test USDC köprüsü kurun ([Musluklar](https://docs.rome.builders/tr/kaynaklar/faucets.md)) ya da [Rome App](https://app.devnet.romeprotocol.xyz)                               |

Solana devnet cüzdanından sarmalayın. Gaz, EVM tarafında 18 ondalıklı USDC’dir; Rubicon veya Hadrian’da bir Rome faucet’i yoktur. Yazma işlemleri, Ethereum sezgisinin düşündüğünden daha fazla gaz tüketir; çünkü maliyetin çoğu Solana hesapları oluşturmaktır: hiç kullanılmamış bir alıcı, yeni bir token hesabı, dağıtılmış bir sözleşme. Kullanın `eth_estimateGas`; bunu standart araçlar zaten yapar ve asla 21.000’i sabitlemeyin. Hadrian üzerinde ölçüldüğünde, 10 baytlık bir sözleşme dağıtımı 1.147.921 gaz tahmin edildi ve kullanıldı; hiç kullanılmamış bir adrese yerel transfer 1.086.961 gaz kullandı; mevcut bir adrese transfer için ise 21.000 gaz kullanıldı. Rome, gerçekte kullanılan gazı ücretlendirir ve bu ölçümlerde tahmin edilenin hiç üzerine çıkmadı. İlk dağıtımdan önce birkaç USDC sağlayın. Sonrasında kaynak kodunu gezginde doğrulayın ([Sözleşmeleri Doğrulayın](https://docs.rome.builders/tr/gelistirici-kilavuzlari/verify-contracts.md)ana ağ doğrulayıcısı `https://verify.mainnet.romeprotocol.xyz`).

Hadrian’da geliştirin, sonra aynı çıktıları zincir kimliği ve ana ağ sarmalayıcı adresleri değiştirilmiş halde Rubicon’a yeniden dağıtın; sözleşmede ağlar arasında hiçbir şey değişmez. Rubicon, v0.3.0’dan itibaren genel registry’dedir, ancak `create-rome-app` ve `rome-cli` hala Rubicon girdisi olmayan registry v0.2.0’ı sabitliyorlar; bu yüzden onu hedefleyemezler; bu araçlar için değerleri [Rubicon](https://docs.rome.builders/tr/aglar/rubicon.md)elle girin. Rubicon’daki gaz, Hadrian’ın gaz fiyatının yaklaşık on katı gerçek USDC’dir; bu yüzden oradaki dağıtım gerçek paraya mal olur.

## 2. Bir sözleşmeyi Solana’ya hazır yapan şey nedir

Bir Solana kullanıcısının EVM kimliği **sentetik adresidir**, `keccak256(solana_pubkey)[12:]`: normal bir `msg.sender`, normal bir nonce ile. Çoğu sözleşmede hiçbir değişiklik gerekmez. Önemli olan üç şey:

* **Değeri ERC-20 olarak alın, değil `msg.value`.** Bir Solana kullanıcısının fonları cüzdanlarındaki SPL token’lardır; EVM tarafında token’ın sarmalayıcısı olarak görünürler (`wUSDC`, `wETH`, `wSOL`). Sentetik, durduğu yerde hiçbir şey tutmaz ve kullanıcının varlıkları sarmalayıcı olarak gelir; bu yüzden `transferFrom` bir `approve` ile çekin `transfer`ile geri verin. Her kullanıcı, ilk çekimden önce sarmalayıcıya SPL delege hakkını bir kez verir ([Tek seferlik: sarmalayıcıya yetki verin](https://docs.rome.builders/tr/gelistirici-kilavuzlari/dual-lane-app.md#one-time-grant-the-wrapper)). Bir `payable` giriş noktası yalnızca sentetiğe yerel gaz verildikten sonra çalışır (aktarma yolunun `rome_composeExternalDepositV1`), ki fonlama-ve-toplama modeli bunu yapmaz. Mevcut bir ERC-20 kasası, AMM ya da borç verme piyasası zaten doğru şekle sahiptir.
* **Kanonik sarmalayıcıları kullanın.** Her zincirin her mint için bir sarmalayıcısı vardır; adresler [Sözleşme Adresleri](https://docs.rome.builders/tr/referans/contract-addresses.md) içindedir (Hadrian’ınki ayrıca genel [kaydında](https://github.com/rome-protocol/rome-registry)de). Oluşturucuları bu adreslere yönlendirin; kendinizinkini dağıtmayın.
* **Cüzdanın imza attığı atomik bütçeye uyun.** Bir Solana cüzdanı bir Solana işlemi imzalar; bu yüzden Solana kanalındaki bir çağrı buna sığmalıdır: yaklaşık 1,4M hesaplama birimi, 64 hesap, 4 KB ([Kısıtlar](https://docs.rome.builders/tr/temel-kavramlar/constraints.md)). Hadrian’da ölçüldüğünde: bir transfer, bir onay ve bir Aave arzı sığdı; bir Uniswap V3 takası az miktarda boşlukla sığdı (yaklaşık 1,24M CU); bir Aave borç alma işlemi ise sığmadı ve bir sonraki bölümdeki aktarma yolunu kullandı. Solana makbuzundaki `computeUnitsConsumed`ile ölçün, işlemi `maxSupportedTransactionVersion: 1` isteyerek (Rome ayakları v1 işlemlerdir; onsuz RPC isteği reddeder).

Gerekmeyen şeyler: bir Solana programı, bir köprü, ikinci bir dağıtım ya da Rome’a özgü herhangi bir Solidity. Sözleşme ayrıca ön derlemeler üzerinden Solana programlarını çağırıyorsa, [EVM'den Solana'yı çağırma](https://docs.rome.builders/tr/gelistirici-kilavuzlari/call-solana-from-evm.md).

## 3. Bir Solana cüzdanının onu çağırmasına izin verin

Uygulamanızın EVM yolu değişmez (MetaMask + `submitRomeTx` ya da düz viem/ethers). Solana yolu için iki şekil vardır.

**SDK kanalı — her çağrı için bir Solana v1 işlemi.** [`@rome-protocol/sdk`](https://github.com/rome-protocol/rome-sdk-ts) (`submitRomeTxV1`) proxy’nin EVM çağrınız için tek bir Solana v1 işlemi oluşturmasını sağlar (64 hesaba ve 4 KB’a kadar, adres arama tablosu olmadan; kodunuzda ComputeBudget instruction, hazine cüzdanı ya da hesap keşfi yoktur). Cüzdan aynı anahtarla iki kez imzalar: önce okunabilir bir yetkilendirme mesajı (`Rome yetkilendirmesi` tek satırda, `0x` ve sonraki satırda EVM işlem hash’i), zincirin Ed25519 programı üzerinden bunu kontrol eder, ardından işlemi. Uygulama imzalanmış işlemi Solana RPC’sine gönderir; çağrı EVM işlem hash’ini ve makbuzunu döndürür. Cüzdan işlemi imzalamadan önce SDK bunu denetler: ücret ödeyen tek imzalayıcıdır, yalnızca Rome programı ve Ed25519 doğrulayıcısı çalışır, Rome instruction kullanıcının yetkilendirdiği çağrıyı tam olarak taşır ve öncelik ücreti yoktur. Bunun dışındaki her şey reddedilir.

Bir çağrı tek bir işleme sığmazsa, oluşturucu bunu reddeder ve SDK aynı yetkilendirme imzasıyla onu aktarması için proxy’ye verir; böylece kullanıcı yine tek bir yetkilendirme istemi görür. Sonuç daha sonra `route: "relay"`içerir. Aktarılan çağrılar ve uzun çağrılar için kurallar [İletilen çağrılar ve uzun çağrılar](https://docs.rome.builders/tr/gelistirici-kilavuzlari/call-evm-from-solana.md#relayed-calls-and-long-calls)dadır. Aktarılan bir çağrı, zincirin yerel gazıyla ödenir; bu yüzden sentetiğin bir gaz bakiyesi gerekir: `fundSyntheticGas(deps, amountWei)` zincirin gaz token’ını (Hadrian ve Rubicon’da USDC) cüzdanın token hesabından ona taşır; bunu tek bir cüzdan imzalı v1 işleminde yapar.

Fonlama ayağı (`buildFundLeg`) ve bir toplama işleminden önce cüzdan token hesabının oluşturulması düz Solana talimatlarıdır; `submitSolanaInstructionsV1` bunları da proxy devreye girmeden, aynı cüzdan imzacısı tarafından imzalanmış v1 işlemleri olarak gönderir. Toplamanın kendi çağrısı (`buildSweepLeg`, `HelperProgram.transfer_spl`ile geçer `submitRomeTxV1` başka herhangi biri gibi, ve proxy token hesaplarını bulur. `submitRomeTxV1` kendi başına yeni bir sentetik hesabı oluşturmaz: ilk değer taşıyan çağrıdan önce `isSyntheticProvisioned(...)` kontrol edin ve `buildCreatePdaCall(synthetic)` içinden `submitRomeTxV1` false ise bir kez gönderin. Kodla tam bir yatırma-ve-çekme anlatımı [Çift hatlı bir uygulama oluşturma](https://docs.rome.builders/tr/gelistirici-kilavuzlari/dual-lane-app.md)dadır; mekanikler [Solana'dan EVM'yi çağırma](https://docs.rome.builders/tr/gelistirici-kilavuzlari/call-evm-from-solana.md). Daha önceki `submitRomeTxSolanaLane`dadır; bu, istemcide eski tip bir Solana işlemi oluşturur ve hâlâ SDK’da eski yol olarak bulunur.

**Her `bağımlılıkların` değerin nereden geldiği.** SDK’nın `bağımlılıkların` nesnesinin beş zorunlu alanı vardır ( `fetchImpl` ve zaman aşımı gibi geri kalanlar isteğe bağlıdır). Dördü zincirden, biri cüzdandan gelir:

| `bağımlılıkların` alan | Kaynağı                                                                                                             | Registry erişici (`@rome-protocol/registry` v0.2.0)                                                                       |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| `proxyUrl`             | zincirin RPC URL’si                                                                                                 | `getChain(chainId).rpcUrl`                                                                                                |
| `chainId`              | zincir kimliği                                                                                                      | `getChain(chainId).chainId`                                                                                               |
| `programId`            | zincirin üzerinde çalıştığı Rome program kimliği                                                                    | `getChain(chainId).romeEvmProgramId`                                                                                      |
| `bağlantı`             | zincirin kümesi için bir Solana RPC’si; imzalı işlemin gönderildiği yer (Hadrian için devnet, Rubicon için mainnet) | `getChain(chainId).solana.rpc` (Hadrian için herkese açık bir devnet URL’si); mainnet için kendinize ait bir RPC kullanın |
| `signer`               | cüzdanın `LaneSigner`ı ya da `Keypair` komut dosyalarında                                                           | yok                                                                                                                       |

Ayak oluşturucular, içinde olmayan değerleri alır `bağımlılıkların`. Onların `mint` (walkthrough’da `usdcMint` olarak adlandırılır) gaz token’ının Solana mint’idir; `getTokens(chainId)` ’den alınır ( `kind: "gas"`, alan `mintId`). wUSDC sarmalayıcı adresi bir ayak oluşturucu girdisi değildir; bunu ERC-20 çağrılarında kullanırsınız ve o, `kind: "spl_wrapper"` ve sembol `wUSDC` ile olan girdidir (alan `address`). Registry Hadrian’ı ve v0.3.0’dan itibaren Rubicon’u kapsar. Rubicon değerlerini elle doldurmak için ise: `proxyUrl` `https://rubicon.mainnet.romeprotocol.xyz/`, `chainId` `7531`, `programId` `RomePq9X3iAoTr813HR7uRarafFDUJty6GdiEceYpzX`, `mint` `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`, bir sonraki bölümdeki tablodan sarmalayıcı ve `bağlantı`. [Rubicon](https://docs.rome.builders/tr/aglar/rubicon.md) için bir Solana mainnet RPC’si kullanın;

**tam listeyi içerir.** Proxy’nin harici V1 uç noktaları — SDK olmadan aynı kanal.`fundSyntheticGas`SDK, atomik oluşturmayı, aktarmayı ve gaz yatırmayı ( `Rome yetkilendirmesi\n0x<hash>` ya da ham hash) sarar. Ham RPC yöntemleri, SDK kullanmayan istemciler için kalır ve bunlar, SDK’nın sarmaladığı iteratif oluşturmayı da içerir. Cüzdan, çağrı üzerinde bir Ed25519 mesajını imzalar (okunabilir biçim`rome_composeUnsignedAtomicV1`, `rome_composeUnsignedIterativeV1` + `rome_submitSignedV1Plan`ya da proxy tüm yürütmeyi tek bir cüzdan imzasıyla kendisi çalıştırır (`rome_relayUnsignedV1`, bir `rome_composeExternalDepositV1` (SDK’nın `fundSyntheticGas`) sentetiğin gaz bakiyesini finanse eder; aktarılan çağrılar bundan harcar, bu yüzden azaldığında doldurun). Yöntem şekilleri [JSON-RPC Desteği](https://docs.rome.builders/tr/referans/json-rpc.md)dadır; yetkilendirme kuralları [Solana'dan EVM'yi çağırma](https://docs.rome.builders/tr/gelistirici-kilavuzlari/call-evm-from-solana.md#the-external-v1-endpoints)dadır. Yinelenen her şey için aktarma yolunu, sığan her şey için SDK kanalını kullanın.

Her iki durumda da sözleşme sentetik adresten gelen normal bir işlem görür ve kullanıcı asla bir EVM anahtarı tutmaz.

## 4. Ağ bazında sarmalayıcı adresleri

| Ağ               | `wUSDC` sarmalayıcı                          | Diğer sarmalayıcılar                                                                                     |
| ---------------- | -------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| Rubicon (7531)   | `0x0952d233b0c254cd375f3bfb3e5869c1a906f9b3` | `wETH` `0x01e8b3573da1d4b7b4b1ce0932cf07c8af0c92e9`, `wSOL` `0xc4e29e0f726a906e93277cbbc37bf27a9848a113` |
| Hadrian (200010) | `0xbce339ba4c3a8de3bb8af1c5539e6ac11da3112d` | `wETH` `0x02aeace038269f9961c93d04dcacd6fb3adfa55f`, `wSOL` `0x39f36444fcb79b3e691544aee2a832ebef54ca9f` |

Yerel gaz token’ı `0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee` olarak token listelerinde görünür; bu bir ERC-20 sözleşmesi değildir. Sarmalayıcılar, SPL mint’inin ondalık sayısını taşır, 18’i değil: wUSDC 6, wETH 8, wSOL 9.

## 5. Yayın kontrol listesi

1. Hadrian’da dağıtıldı; EVM yolu MetaMask’tan çalışıyor.
2. Değer taşıyan her giriş noktası ERC-20 tabanlıdır ve zincirin kanonik sarmalayıcısına yönlendirilmiştir.
3. v1 işlemlerini imzalayan bir Solana cüzdanı (Solflare bugün devnet’te bunu yapıyor; Phantom henüz yapmıyor) Hadrian’da tam gidiş-dönüşü tamamlar: sentetiği sağla (`create_pda`, bir kez) → fonlama ayağı → yetki ver → onayla → çağır → toplama ayağı; SDK kanalını kullanarak ya da çağrı yineleniyorsa aktarma yolunu kullanarak.
4. Her Solana kanalındaki çağrının `computeUnitsConsumed` değeri Solana makbuzundan okunur ve atomik bütçenin altındadır, ya da çağrı aktarma üzerinden yönlendirilir.
5. Sarmalayıcı izni, her iki kanal için de uygulamanızın ilk yatırma akışındadır: `isEnabled(user)` kontrol edilir ve `approve_spl` false ise bir kez gönderilir ([Tek seferlik: sarmalayıcıya yetki verin](https://docs.rome.builders/tr/gelistirici-kilavuzlari/dual-lane-app.md#one-time-grant-the-wrapper)).
6. Kaynak explorer'da doğrulandı.
7. Ana ağ sarmalayıcı adresleriyle Rubicon’a yeniden dağıtıldı. Onun `bağımlılıkların` değerleri registry’den (v0.3.0 veya sonrası) ya da elle [Rubicon](https://docs.rome.builders/tr/aglar/rubicon.md)alınır. Aynı gidiş-dönüş, ana ağda v1 işlemlerini imzaladığını doğruladığınız bir cüzdan kullanılarak gerçek fonlarla bir kez çalıştırılır.

## Sırada ne var

* [Çift hatlı bir uygulama oluşturma](https://docs.rome.builders/tr/gelistirici-kilavuzlari/dual-lane-app.md) — kasanın örneği, adım adım, her iki cüzdan
* [Solana'dan EVM'yi çağırma](https://docs.rome.builders/tr/gelistirici-kilavuzlari/call-evm-from-solana.md) — sentetik adresler, hesap keşfi, harici V1 uç noktaları
* [Solidity Sözleşmeleri Dağıtma](https://docs.rome.builders/tr/gelistirici-kilavuzlari/deploy-solidity.md) · [Sözleşmeleri Doğrulayın](https://docs.rome.builders/tr/gelistirici-kilavuzlari/verify-contracts.md) · [Sözleşme Adresleri](https://docs.rome.builders/tr/referans/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/tr/gelistirici-kilavuzlari/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.
