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

# 7. EVM uygulamanızı Solana cüzdanlarına açın

EVM anahtarı olmadan bir Solana cüzdanından sözleşmenizi kullanılabilir hale getirin; sentetik adresi, ERC-20 değerini, iki imzayı ve atomik bütçeyi kapsar.

Sözleşmeniz zaten MetaMask ile çalışıyor. Şimdi bir Solana cüzdanının, zaten sahip olduğu anahtarla onu çağırmasına izin veriyorsunuz; böylece kullanıcı hiç bir EVM hesabı oluşturmaz. Aynı sözleşmeyi, aynı adres üzerinden, aynı duruma karşı çağırırlar.

## Neler öğreneceksiniz

* Bir Solana cüzdanının nasıl normal bir `msg.sender` olarak Rome üzerinde.
* Bu kursun neden değeri bir ERC-20 yatırımı olarak aldığını ve ne `msg.value` şeyin bir Solana kullanıcısından gerektiğini.
* Bir Solana kullanıcısının her çağrı için neyi imzaladığı ve işlemin nereye gittiği.
* Bir Solana işleminin içine neyin sığdığı ve sığmayan bir çağrıya ne olduğu.
* Hangi `bağımlılıkların` SDK'nın ihtiyaç duyduğu ve her birinin nereden geldiği.

## Başlamadan önce

* Tamamlayın [6. Her iki tarafta tokenlar](https://docs.rome.builders/tr/rome-akademi/06-tokens-on-both-sides.md). Bu ders, bir wrapper'ın ne olduğunu ve bir kullanıcının neden ona bir kez izin verdiğini bildiğinizi varsayar.
* Sahip olun `HelloRome` Hadrian üzerinde dağıtılmış [3. Hadrian'daki ilk sözleşmeniz](https://docs.rome.builders/tr/rome-akademi/03-first-contract-on-hadrian.md).
* TypeScript SDK'yı yükleyin, şu bölümdeki gibi [Rome SDK](https://docs.rome.builders/tr/urunler/rome-sdk.md#typescript-sdk-rome-protocol-sdk).
* Solana v1 işlemlerini imzalayan bir Solana cüzdanına, biraz devnet SOL ve devnet USDC ile sahip olun. Faucet'ler şu bölümde listelenmiştir [Musluklar](https://docs.rome.builders/tr/kaynaklar/faucets.md). v1 işlemlerine destek cüzdanlar arasında farklılık gösterir, bu yüzden önce sizinkini test edin. [Çift hatlı bir uygulama oluşturma](https://docs.rome.builders/tr/gelistirici-kilavuzlari/dual-lane-app.md) şimdiye kadar kontrol edilen cüzdanları adlandırır.

## Ders

### Adım 1. Sentetik adresle tanışın

Bir Solana cüzdanının EVM adresi yoktur, bu yüzden Rome onun genel anahtarından bir adres türetir. Sonuç, cüzdanın sentetik adresidir. Bu, `msg.sender` sözleşmenizin gördüğü adrestir ve diğer tüm hesaplar gibi kendi nonce'unu ve depolamasını taşır. Aynı cüzdan her zaman aynı adrese eşlenir.

```javascript
import { syntheticAddress } from "@rome-protocol/sdk";
const from = syntheticAddress(solanaPubkey); // sıradan bir 20 baytlık adres
```

Bu kursun akışında sentetik, elde tutulurken token tutmaz. Bunlar kullanıcının Solana cüzdanında başlar. Fonlama ayağı, bir yatırmadan önce bunları sentetikin token hesabına taşır ve ancak o zaman wrapper'ın `balanceOf(synthetic)` bunları göstermesini sağlar. Süpürme ayağı, çekimden sonra bunları cüzdana geri taşır. Tam modeli şu bölümde okuyun [Solana'dan EVM'yi çağırma](https://docs.rome.builders/tr/gelistirici-kilavuzlari/call-evm-from-solana.md#synthetic-addresses).

### Adım 2. Sözleşmeyi Solana'ya hazır hale getirin

Çoğu sözleşme değişiklik gerektirmez. Üç kural, sizinkinin onlardan biri olup olmadığını belirler:

* Değeri bir ERC-20 olarak alın. İle çekin `transferFrom` bir `approve`sonrasında ve ile geri verin `transfer`.
* Her token için kanonik wrapper'ı işaret edin. Kendi token'ınızı dağıtmayın.
* Her Solana-lane çağrısını tek bir Solana işleminin içine sığdırın.

İlk kural en çok sorun çıkaran kuraldır. Bu giriş noktası MetaMask kullanıcıları için çalışır. Solana kullanıcıları için fonla-ve-süpür modelinde başarısız olur, çünkü onlara ile fonlamadığınız sürece sentetikleri yerel bakiyeye sahip olmaz `fundSyntheticGas`:

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

Bu, her iki taraf için de çalışır; çünkü her iki kanal da bir `transferFrom`:

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

Wrapper adresleri şu üzerindedir [Sözleşme Adresleri](https://docs.rome.builders/tr/referans/contract-addresses.md). Solana'ya hazır bir sözleşme için kontroller şu bölümde [Solidity sözleşmenizi Solana kullanıcılarına açın](https://docs.rome.builders/pages/3fce539b99758378f75f34dbaf76734f76e4a163#id-2.-what-makes-a-contract-solana-ready).

### Adım 3. Cüzdanın neyi imzaladığını bilin

SDK çağrısı şöyledir `submitRomeTxV1`. Her çağrı için proxy tek bir Solana v1 işlemi oluşturur. Cüzdan aynı anahtarla iki kez imzalar. İlk olarak, EVM işlem hash'ini adlandıran okunabilir bir yetkilendirme mesajını imzalar. Sonra işlemin kendisini imzalar.

Uygulama, imzalanmış işlemi Rome proxy'sine değil, Solana RPC'sine gönderir. Zincir, yetkilendirmeyi Ed25519 programı aracılığıyla doğrular ve çağrınızı sentetik adres olarak çalıştırır. Kullanıcı hiçbir zaman bir EVM anahtarı tutmaz.

Cüzdan işlemi imzalamadan önce, SDK onun kullanıcının yetkilendirdiği çağrıyı tam olarak taşıdığını kontrol eder. Bunun dışındaki her şey reddedilir. Ayrıntılar şu bölümde [Solidity sözleşmenizi Solana kullanıcılarına açın](https://docs.rome.builders/pages/3fce539b99758378f75f34dbaf76734f76e4a163#id-3.-let-a-solana-wallet-call-it).

### Adım 4. Kanalı bağlayın

SDK'nın beş değere ihtiyacı vardır: bir proxy URL'si, bir zincir kimliği, Rome program kimliği, bir Solana RPC bağlantısı ve bir imzalayıcı. Dördü zinciri tanımlar. Biri cüzdandan gelir.

```javascript
const deps = { connection, proxyUrl, chainId, programId, signer };
const res = await submitRomeTxV1(deps, { to: helloRome, data }); // helloRome: 3. ders sözleşmeniz; data: ABI ile kodlanmış greet() çağrısı
```

Hadrian için, dört zincir değerini kayıttan okuyun. Eşleme şu bölümde `bağımlılıkların` 3. adımda bağlantısı verilen rehberin tablosunda ve değerler şu üzerinde [Hadrian](https://docs.rome.builders/tr/aglar/hadrian.md). 11. ders aynı bağlamayı Rubicon için kapsar.

Yeni bir kullanıcının ilk değer taşıyan çağrısından önce iki tek seferlik adım gelir. Sentetiği ile hazırlayın `buildCreatePdaCall`, ve eğer `isEnabled` false ise wrapper'a izin verin. `submitRomeTxV1` sizin yerinize hazırlamaz. 9. ders ikisini de sırayla çalıştırır.

### Adım 5. Tek bir işlemin içinde kalın

Bir Solana-lane çağrısının tek bir Solana işlemine sığması gerekir: yaklaşık 1.4M hesaplama birimi, 64 hesap ve 4 KB. Şununla ölçün `computeUnitsConsumed` Solana makbuzundan, EVM'den değil `gasUsed`. İşlemi şu ile isteyin `maxSupportedTransactionVersion: 1`; bu olmadan RPC isteği reddeder.

Bir çağrı sığmadığında, oluşturucu onu reddeder ve SDK, aynı yetkilendirme imzasıyla proxy'ye iletmesi için onu proxy'ye verir. Kullanıcı yine yalnızca bir istem görür. Sonuç şunu taşır `route: "relay"`. İletilen bir çağrı, sentetikin yerel gas'ını harcar, bu yüzden önce onu ile doldurun `fundSyntheticGas`. Hata vererek geri dönen bir iletilmiş çağrı exception fırlatmaz. Şunu kontrol edin `receipt.status`. Kurallar şu bölümde [İ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). Tek bir tabloda sınırlar: [Kısıtlamalar](https://docs.rome.builders/tr/temel-kavramlar/constraints.md).

## Kendinizi test edin

Önce bunları cevaplayın, sonra cevapları açın.

1. Bir `payable` yatırımı neden bir Solana kullanıcısı için başarısız olur?
2. Cüzdan her çağrı için kaç imza üretir ve her biri neyi kapsar?
3. İmzalanmış işlem nereye gider?
4. Bir çağrı birden fazla işlem gerektiriyor. Kullanıcı ne görür ve kim öder?

<details>

<summary>Cevaplar</summary>

1. Kullanıcının parası cüzdanındaki bir SPL token'dır ve Rome üzerinde wrapper olarak gösterilir. Sentetik, fonla-ve-süpür modelinde, siz onu fonlamadıkça hiçbir yerel bakiye tutmaz; bu yüzden gönderilecek bir `msg.value` şey yoktur.
2. İki. İlki, EVM işlem hash'ini içeren okunabilir bir yetkilendirme mesajını kapsar. İkincisi Solana işlemini kapsar.
3. Uygulama tarafından gönderilen Solana RPC'ye. Proxy işlemi oluşturur ve iletilen bir çağrı haricinde onu almaz.
4. Tek bir yetkilendirme istemi. Proxy çağrıyı iletir ve sentetikin yerel gas bakiyesi bunun ücretini öder.

</details>

## Sonraki

[8. Solana programınızı EVM kullanıcılarına açın](https://docs.rome.builders/tr/rome-akademi/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/tr/rome-akademi/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.
