> 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/baslarken-1/quickstart.md).

# Hızlı başlangıç

İlk Solidity sözleşmenizi Rome üzerinde 5 dakikadan kısa sürede dağıtın.

5 dakikadan kısa sürede Rome üzerinde ilk Solidity sözleşmenizi dağıtın. Bu kılavuz şunu hedefler [**Hadrian**](https://docs.rome.builders/tr/aglar/hadrian.md), herkese açık testnet zincirini. [Rubicon](https://docs.rome.builders/tr/aglar/rubicon.md) ana ağ zinciridir; burada gaz gerçek USDC'dir; önce her şeyi bir test zincirinde deneyin.

## Ön koşullar

* [Node.js](https://nodejs.org/) v22.13+
* [MetaMask](https://metamask.io/) tarayıcı uzantısı
* Şuna ayarlanmış bir Solana cüzdanı **Devnet**, yalnızca Solana'dan fonluyorsanız (2. adım). Solana cüzdanından sözleşme çağırmak, Solana v1 işlemlerini imzalayan bir cüzdan gerektirir; bu konu şu bölümde ele alınır [Sözleşmenizi Solana kullanıcılarına açın](https://docs.rome.builders/tr/gelistirici-kilavuzlari/open-to-solana-users.md).

## 1. Hadrian'ı MetaMask'e ekleyin

Bunu elle ekleyin (Ayarlar → Ağlar → Ağ ekle):

| Alan                | Değer                                           |
| ------------------- | ----------------------------------------------- |
| Ağ Adı              | Rome Hadrian                                    |
| RPC URL             | `https://hadrian.testnet.romeprotocol.xyz/`     |
| Zincir Kimliği      | `200010`                                        |
| Para Birimi Sembolü | `USDC`                                          |
| Blok Gezgini        | `https://via-hadrian.testnet.romeprotocol.xyz/` |

## 2. Cüzdanınızı fonlayın

Gaz, zincirin gaz tokenı ile ödenir; Hadrian üzerinde bu USDC'dir. Hadrian'da bu, Circle'ın Solana Devnet USDC'siyle desteklenir (mint `4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU`), bu yüzden devnet SOL gaz değildir. Rome için faucet yoktur. USDC'yi Hadrian'a getirmenin iki yolu vardır:

**Solana'dan** — Solana Devnet USDC'si alın [Circle faucet'i](https://faucet.circle.com/) (Solana Devnet'i seçin) ve Solana ücretleri için biraz devnet SOL alın [Solana faucet'ı](https://faucet.solana.com/), Solana cüzdanınız Devnet'e ayarlı şekilde. Sonra [Rome Bridge](https://docs.rome.builders/tr/rome-uzerindeki-uygulamalar/bridge-api.md) ile Hadrian'ı hedef ve Solana rotasını kullanın; alıcı olarak EVM cüzdanınızın adresini verin; köprü, o EVM cüzdanından Hadrian üzerinde bir talep işlemi imzalamasını ister ve bu da USDC'yi gaz haline getirir.

**Bir EVM zincirinden köprüleyerek** — Ethereum Sepolia üzerinde test USDC'si mint edin [Circle faucet'i](https://faucet.circle.com/), ardından onu Rome'a [Rome Bridge](https://docs.rome.builders/tr/rome-uzerindeki-uygulamalar/bridge-api.md) (CCTP) ile getirin. Kaynak taraftaki işlem için biraz Sepolia ETH'ye ihtiyacınız olacak — şuna bakın [Musluklar](https://docs.rome.builders/tr/kaynaklar/faucets.md) her faucet için.

**Ne kadar?** Rome üzerinde bir yazma işlemi, Ethereum sezgilerinin düşündüğünden daha pahalıdır; çünkü gazın büyük kısmı Solana hesapları oluşturmak için harcanır: daha önce hiç kullanılmamış bir alıcı, yeni bir token hesabı, dağıtılmış bir sözleşme. Kullan `eth_estimateGas`, bunu standart araçlar yapar; 21.000'i asla sabit kodlamayın. Tahmin, hesap oluşturmayı içerir, Rome işlemin gerçekten kullandığı gazı ücretlendirir (Hadrian üzerindeki ölçümlerde bu hiçbir zaman tahminden fazla olmadı), ve SDK'nın `submitRomeTx` tahmini güvenlik payı olarak 1,3 katına çıkarır; bu hiçbir şeye mal olmaz çünkü yalnızca kullanılan gaz ücretlendirilir. En az **0,5 USDC gaz**; 1 USDC rahat bir pay bırakır. İçindeki sayılar [JSON-RPC Desteği](https://docs.rome.builders/tr/referans/json-rpc.md) tek tek yazma işlemlerinin maliyetini gösterir.

Fonlu bir cüzdana rağmen Solana tarafı yatırımı "insufficient SOL" uyarısıyla başarısız olursa, Solana cüzdanınızı Testnet Mode / Devnet olarak ayarlayın (şuna bakın [SSS](https://docs.rome.builders/tr/kaynaklar/faq.md)).

## 3. Bir Hardhat projesi oluşturun

```bash
mkdir rome-hello && cd rome-hello
npx hardhat --init
```

İstendiğinde varsayılanları kabul edin — Hardhat 3, geçerli dizin ve TypeScript + Node Test Runner + viem şablonu — ve bağımlılıkları yüklemesine izin verin. Şablon örnek bir `Counter` sözleşme ve testlerle birlikte gelir; bunlar bu kılavuzu etkilemez.

## 4. Hardhat'ı Rome için yapılandırın

Oluşturulanı düzenleyin `hardhat.config.ts` ve içine Rome ağlarını ekleyin `defineConfig({ ... })`:

```typescript
  networks: {
    hadrian: {
      type: "http",
      chainType: "l1",
      chainId: 200010,
      url: "https://hadrian.testnet.romeprotocol.xyz/",
      accounts: [configVariable("PRIVATE_KEY")],
    },
  },
```

`configVariable("PRIVATE_KEY")` ortamdan çözülür; bu yüzden MetaMask özel anahtarınızı dışa aktarın:

```bash
export PRIVATE_KEY="0xYOUR_PRIVATE_KEY"
```

(Tek kullanımlık bir anahtardan öte bir şey için, araç kutusuyla birlikte gelen şifreli anahtar deposunu tercih edin: `npx hardhat keystore set PRIVATE_KEY`.)

## 5. Bir sözleşme yazın

Oluşturun `contracts/HelloRome.sol`:

```solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.28;

contract HelloRome {
    string public greeting = "Hello from Solana!";
    uint256 public counter;

    event Greeted(address indexed sender, uint256 count);

    function greet() external returns (string memory) {
        counter++;
        emit Greeted(msg.sender, counter);
        return greeting;
    }

    function setGreeting(string calldata _greeting) external {
        greeting = _greeting;
    }
}
```

## 6. Dağıtın

Oluşturun `scripts/deploy.ts`:

```typescript
import hardhat from "hardhat";

async function main() {
  const { viem } = await hardhat.network.connect();
  const publicClient = await viem.getPublicClient();

  const hello = await viem.deployContract("HelloRome");
  console.log("HelloRome deployed to:", hello.address);

  const hash = await hello.write.greet();
  await publicClient.waitForTransactionReceipt({ hash });

  console.log("Counter:", (await hello.read.counter()).toString());
  console.log("Greeting:", await hello.read.greeting());
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});
```

Hadrian'a dağıtın:

```bash
npx hardhat run scripts/deploy.ts --network hadrian
```

Beklenen çıktı (adresiniz farklı olacaktır):

```
HelloRome deployed to: 0x09c437e305eeb698e1776cff23ca16c1bb25aabd
Counter: 1
Greeting: Hello from Solana!
```

Dağıtılan adresi [explorer](https://via-hadrian.testnet.romeprotocol.xyz/) içinde açarak işleminizi görün ve bunu sonuçlandıran Solana işlemi için "Settled in" bağlantısını takip edin. Solidity sözleşmeniz artık Solana üzerinde çalışıyor.

## Sırada Ne Var

* [Solidity'yi dağıtın](https://docs.rome.builders/tr/gelistirici-kilavuzlari/deploy-solidity.md) — Hardhat ve Foundry dağıtımı derinlemesine
* [EVM'den Solana'yı çağırma](https://docs.rome.builders/tr/gelistirici-kilavuzlari/call-solana-from-evm.md) — CPI aracılığıyla Solidity'den Solana programlarını çağırın
* [Mimari](https://docs.rome.builders/tr/baslarken-1/architecture.md) — Rome'un EVM'yi Solana içinde nasıl çalıştırdığı

## Yaygın Hatalar

| Hata                  | Neden                                                            | Çözüm                                                                                                                                   |
| --------------------- | ---------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `yetersiz bakiye`     | Gaz limiti ile gaz fiyatının çarpımı için yeterli gaz tokenı yok | En az 0,5 USDC gaz yükleyin (2. adıma bakın) ile [Rome Bridge](https://docs.rome.builders/tr/rome-uzerindeki-uygulamalar/bridge-api.md) |
| `nonce çok düşük`     | İşlem nonce uyuşmazlığı                                          | Hesabı sıfırlayın (MetaMask → Ayarlar → Gelişmiş → Etkinliği temizle)                                                                   |
| `yürütme geri alındı` | Sözleşme yürütmesi başarısız oldu                                | Sözleşme mantığını kontrol edin; kullanın `eth_call` hata ayıklamak için                                                                |
| Bağlantı zaman aşımı  | RPC'ye ulaşılamıyor                                              | RPC URL'sini doğrulayın                                                                                                                 |


---

# 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/baslarken-1/quickstart.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.
