> 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/05-call-solana-from-solidity.md).

# 5. Solidity'den Solana'yı çağırın

Rome'un CPI ve Helper precompile'larını kullanarak Solana hesaplarını okuyun, token hesapları oluşturun ve bir Solidity sözleşmesinden Solana programlarını çağırın.

Rome üzerinde bir Solidity sözleşmesi, aynı işlemde Solana hesaplarını okuyabilir ve Solana programlarını çağırabilir. Bir Solana token bakiyesini okuyacak, bir token hesabı oluşturacak ve bir program çağrısının nasıl oluşturulacağını öğreneceksiniz.

## Neler öğreneceksiniz

* Rome'da bir ön-derleme nedir ve en çok kullanacağınız üç tanesi hangileridir.
* Sözleşmeniz onu çağırdığında bir Solana programının hangi imzayı gördüğü.
* Solidity'den Solana durumunu nasıl okuyacağınız ve nasıl bir token hesabı oluşturacağınız.
* Bir Solana çağrısının çalışıp çalışmayacağına karar veren kurallar: bildirilen hesaplar, tek iz, yalnızca atomik.

## Başlamadan önce

* Bitir [4. Rome kodunuzu nasıl çalıştırır](https://docs.rome.builders/tr/rome-akademi/04-how-rome-runs-your-code.md). Atomik bütçe ve 64 hesap sınırı burada önemlidir.
* Hadrian cüzdanınızın fonlu olduğundan ve 3. dersteki dağıtım kurulumunuzun çalıştığından emin olun. Faucet'ler listelenmiştir [Musluklar](https://docs.rome.builders/tr/kaynaklar/faucets.md).
* Rome Solidity arayüzlerini şuradan yükleyin `rome-solidity` repo, içinde açıklandığı gibi [Solidity'yi dağıtın](https://docs.rome.builders/tr/gelistirici-kilavuzlari/deploy-solidity.md#using-the-rome-solidity-sdk).

## Ön-derlemeler kapıdır

Bir ön-derleme, bytecode yerine yerel kod çalıştıran sabit bir adrestir. Ethereum'da birkaç tane vardır; örneğin `ecrecover`. Rome, görevi Solana'ya erişmek olan ön-derlemeler ekler. Onları bir arayüz üzerinden, herhangi bir sözleşme gibi çağırırsınız.

Üç tanesini kullanacaksınız:

| Precompile    | Size ne sağlar                                                                                                                    |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| CpiProgram    | `invoke` ve `invoke_signed` herhangi bir Solana programını çağırmak ve ayrıca Solana hesaplarının salt okunur görünümlerini almak |
| HelperProgram | Hazır token ve hesap işlemleri: bir token hesabı oluşturma, SPL tokenleri transfer etme, adres türetme                            |
| Sistem        | PDA türetme ve base58 dönüştürme                                                                                                  |

Adresler [Precompile referansı](https://docs.rome.builders/tr/referans/precompiles.md) ve [Sözleşme adresleri](https://docs.rome.builders/tr/referans/contract-addresses.md). Bunları yazmanız gerekmez. İçe aktarmak `interface.sol` şuradan `rome-solidity` size adlı hazır sabitler sağlar `CpiProgram`, `HelperProgram` ve `SystemProgram`.

## Kim imzalar

Sözleşmeniz bir ön-derlemeyi çağırdığında, Solana kullanıcının değil, sözleşmenizin kendi kimliğini görür. Her EVM adresinin bir Solana program-türetilmiş adresi, yani dış-otorite PDA'sı vardır. Bu adresin token hesaplarına sahip olur ve onun adına imzalar.

Bu, ERC-20'den bildiğiniz aynı kuraldır: kullanıcı izin vermedikçe bir sözleşme bir kullanıcının varlıklarını taşıyamaz. 6. ders, kullanıcının bunu Rome üzerinde nasıl izin verdiğini gösterir. Kural ve bir kullanıcının pozisyonunu tutmanın üç yolu içindedir [Bir Solana programını entegre edin](https://docs.rome.builders/pages/711499edc5d9d151b689cb54591066ae1daac791#id-1.-every-evm-address-has-one-solana-identity).

## Adım 1: Yazmadan önce oku

Okumalarla başlayın. Durumu değiştirmezler ve atomik ve yinelemeli yürütmede çalışırlar. Değiştirmeden önce oku: bir önbelleğe alınmış çağrı çalıştıktan sonra, işlemin geri kalanı için eski iz okumaları reddedilir.

```solidity
import "@rome-protocol/rome-solidity/contracts/interface.sol";

contract SolanaPeek {
    // Rome'un çağıran için ve zincirin gas mint'i için kullandığı token hesabı
    function myTokenAccount() external view returns (bytes32) {
        return HelperProgram.ata(msg.sender, SystemProgram.mint_id());
    }

    // Çağıranın bu hesaptaki bakiyesi
    function myBalance() external view returns (uint64) {
        return HelperProgram.user_balance(msg.sender, SystemProgram.mint_id());
    }
}
```

Solana adresleri `bytes32` burada, 20 baytlık adresler değildir. Diğer okumalar, `account_info`, `account_data_at` ve `account_u64_at`, herhangi bir Solana hesabını incelemenizi sağlar. Bkz. [Hesap verilerini okuma](https://docs.rome.builders/tr/gelistirici-kilavuzlari/call-solana-from-evm.md#reading-account-data).

## Adım 2: bir yardımcı kullanın

Yaygın işler için elle oluşturulmuş bir talimata ihtiyacınız yoktur. Helper, token hesapları oluşturur, SPL tokenleri ve lamportları taşır ve gas ile lamportlar arasında dönüştürme yapar. İmzalar `contracts/interface.sol`, ve örnek bir sözleşme içindedir [Lamport transfer etme](https://docs.rome.builders/tr/gelistirici-kilavuzlari/call-solana-from-evm.md#transfer-lamports).

```solidity
function createMyAta() external {
    HelperProgram.create_ata(msg.sender, SystemProgram.mint_id());
}
```

Helper'ı çağıran bir sözleşme kendi adına hareket eder. Taşıdığı tokenler kullanıcının değil, kendi tokenleridir.

## Adım 3: herhangi bir Solana programını çağırın

Helper'ların kapsamadığı bir program için hesap listesini ve talimat baytlarını kendiniz oluşturun ve `invoke`. Her hesap, bir pubkey ile iki bayraktan, imzacı ve yazılabilirden oluşur. Talimat verisi, hedef programın beklediği her neyse odur; genellikle Borsh.

Tam sözleşme [Özel Solana programlarını çağırma](https://docs.rome.builders/tr/gelistirici-kilavuzlari/call-solana-from-evm.md#calling-custom-solana-programs). `invoke_signed` hedef, sözleşmenizden birden fazla imzacı gerektirdiğinde tuzlanmış alt-PDA'lar ekler. Solidity içinde bir PDA'nın adresini almak için `find_program_address` Sistem ön-derlemesi üzerinde; bkz. [PDA türetme](https://docs.rome.builders/tr/gelistirici-kilavuzlari/call-solana-from-evm.md#pda-derivation).

## Çalışıp çalışmayacağına karar veren kurallar

* **Her hesabı bildirin.** Solana, çağrı çalışmadan önce tam hesap listesini ister. Proxy bunu önce işleminizi öykünerek bulur, bu yüzden her hesap sözleşmenin sahip olduğu girdilerden türetilebilir olmalıdır. Toplam, 64 adres sınırı içinde kalmalıdır.
* **Atomik kalın.** Eski izde bir CPI oluşturan bir çağrı yinelemeli olarak çalışamaz. Tek bir atomik işleme sığmalıdır, bu yüzden her eylemi bir token hareketi ve bir CPI ile sınırlı tutun.
* **Tek bir iz seçin.** Rome, Solana durumunu değiştiren iki ön-derleme ailesine sahiptir: legacy (`CpiProgram`, `HelperProgram`, `Çekme`) ve cached (the `...Cached` kümesi). Bir işlem tek bir aile kullanır. Özel bir programı yalnızca legacy izi çağırabilir. Tablodaki bilgiyi okuyun [Bir Solana programını entegre edin](https://docs.rome.builders/pages/711499edc5d9d151b689cb54591066ae1daac791#id-4.-one-track-per-contract-and-per-transaction).
* **Derinliği sığ tutun.** Bir Solana programına yaptığınız çağrı CPI seviyelerini kullanır ve onun çağırdığı her program da aynı şekilde kullanır. Solana'nın derinlik sınırı düşüktür. [Kısıtlar](https://docs.rome.builders/tr/temel-kavramlar/constraints.md#cpi-constraints) seviyeleri açıklar.
* **Rome'a geri çağrı yok.** Bir CPI, Rome programını adlandıramaz veya çağıramaz. Düz bir System transfer talimatı dışında Solana ücret ödeyicisini adlandıramaz.

## Kendinizi sınayın

Ekle `createMyAta` şuraya `SolanaPeek` ve onu Hadrian'a dağıtın. Sonra:

1. Çağırın `myTokenAccount` ve `myBalance` cüzdan adresinizden bir okuma çağrısıyla.
2. Şunu çağıran bir işlem gönderin: `createMyAta`.
3. İşlemi Hadrian gezgininde açın. Bkz. [Via gezgini](https://docs.rome.builders/tr/rome-uzerindeki-uygulamalar/via.md).

Çağrınızın arkasındaki Solana talimatını ve onun compute unit'lerini görmelisiniz. Solana'ya ulaşan bir çağrı, gezgin'de yalnızca bir EVM çağrısı değil, bir Solana programı gösterir.

<details>

<summary>1. Bir sözleşme çağırır <code>HelperProgram.transfer_spl</code>. Kimin tokenleri hareket eder?</summary>

Sözleşmenin kendi tokenleri. İmzalayan, sözleşmenin dış-otorite PDA'sıdır. Kullanıcının tokenlerini taşımak için kullanıcının önce bir hak vermesi gerekir.

</details>

<details>

<summary>2. Kullanan bir çağrı neden <code>invoke</code> tek bir atomik işleme sığmalıdır?</summary>

Yinelemeli bir işlem içinde legacy-iz CPI'larından gelen çağrılar reddedilir. Çağrı birden fazla Solana işlemi gerektiriyorsa başarısız olur.

</details>

<details>

<summary>3. Hangi okumalara herhangi bir yürütme kipinde güvenebilirsiniz?</summary>

Salt okunur görünümler: `account_info`, `account_data_at`, `account_u64_at`, `account_lamports`, `pdas_batch_derive` ve şu gibi Helper okumaları `user_balance`. Bunların yan etkisi yoktur. Aynı işlemdeki herhangi bir önbelleğe alınmış değişiklikten önce bunları çalıştırın.

</details>

## Sonraki

[6. Her iki tarafta tokenlar](https://docs.rome.builders/tr/rome-akademi/06-tokens-on-both-sides.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/05-call-solana-from-solidity.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.
