> 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/deploy-solidity.md).

# Solidity Sözleşmelerini Dağıtma

Solana üzerinde Hardhat veya Foundry ile Solidity akıllı sözleşmeleri dağıtın — Rome ağ yapılandırması, fonlanmış hesaplar ve adım adım dağıtım.

Bu kılavuz, Hardhat ve Foundry kullanarak Solidity akıllı kontratlarını Rome EVM'e dağıtmayı kapsar.

## Ön koşullar

* Node.js v22.13+ (Hardhat) veya yüklü Foundry
* Fonlanmış bir Rome EVM adresi (bkz. [Hızlı başlangıç](https://docs.rome.builders/tr/baslarken-1/quickstart.md))
* Özel anahtarınız bir ortam değişkeni olarak dışa aktarılmış

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

## Ağ Yapılandırması

| Ağ                    | RPC URL                                     | Zincir Kimliği | Gezgin                                 |
| --------------------- | ------------------------------------------- | -------------- | -------------------------------------- |
| Hadrian (testnet)     | `https://hadrian.testnet.romeprotocol.xyz/` | `200010`       | `via-hadrian.testnet.romeprotocol.xyz` |
| **Rubicon (mainnet)** | `https://rubicon.mainnet.romeprotocol.xyz/` | `7531`         | `via-rubicon.mainnet.romeprotocol.xyz` |

Her ağda gas USDC'dir. Hadrian'da bunu test USDC köprüleyerek veya bir Solana devnet cüzdanından sararak elde edersiniz ([Musluklar](https://docs.rome.builders/tr/kaynaklar/faucets.md)); Rubicon'da ise Ethereum, Base, Arbitrum, Polygon, Avalanche, Monad veya OP'den ya da bir Solana cüzdanından USDC köprüleyerek, ile [Rome Bridge](https://bridge-api.mainnet.romeprotocol.xyz/). Rubicon'a, Hadrian'da test ettiğiniz aynı çıktılarla dağıtın — yalnızca chain id ve wrapper adresleri farklıdır.

## Hardhat

### Kurulum

```bash
mkdir my-rome-project && cd my-rome-project
npx hardhat --init
```

Varsayılanları kabul edin (Hardhat 3, geçerli dizin, TypeScript + viem şablonu); bağımlılıklar otomatik olarak kurulur.

### hardhat.config.ts

```typescript
import hardhatToolboxViemPlugin from "@nomicfoundation/hardhat-toolbox-viem";
import { configVariable, defineConfig } from "hardhat/config";

export default defineConfig({
  plugins: [hardhatToolboxViemPlugin],
  solidity: {
    profiles: {
      default: { version: "0.8.28" },
      production: {
        version: "0.8.28",
        settings: { optimizer: { enabled: true, runs: 200 } },
      },
    },
  },
  networks: {
    hadrian: {
      type: "http",
      chainType: "l1",
      chainId: 200010,
      url: "https://hadrian.testnet.romeprotocol.xyz/",
      accounts: [configVariable("PRIVATE_KEY")],
    },
    rubicon: {
      type: "http",
      chainType: "l1",
      chainId: 7531,
      url: "https://rubicon.mainnet.romeprotocol.xyz/",
      accounts: [configVariable("PRIVATE_KEY")],
    },
  },
});
```

`configVariable("PRIVATE_KEY")` ortamdan (veya şifrelenmiş anahtar deposundan — `npx hardhat keystore set PRIVATE_KEY`).

### Dağıtım

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

### Blok Gezgini'nde Doğrula

```bash
npx hardhat verify --network hadrian 0xCONTRACT_ADDRESS
```

Sourcify doğrulayıcı yapılandırmasına şu dosyadan ihtiyaç duyar: [Sözleşmeleri Doğrulayın](https://docs.rome.builders/tr/gelistirici-kilavuzlari/verify-contracts.md) dosyanızdaki `hardhat.config.ts`.

## Foundry

### Kurulum

```bash
forge init my-rome-project
cd my-rome-project
```

### Dağıtım

```bash
# Test ağı
forge create --rpc-url https://hadrian.testnet.romeprotocol.xyz/ \
  --private-key $PRIVATE_KEY \
  src/Counter.sol:Counter
```

### Dağıtılmış Kontratı Çağır

```bash
# Oku
cast call 0xCONTRACT_ADDRESS "number()" \
  --rpc-url https://hadrian.testnet.romeprotocol.xyz/

# Yaz
cast send 0xCONTRACT_ADDRESS "increment()" \
  --rpc-url https://hadrian.testnet.romeprotocol.xyz/ \
  --private-key $PRIVATE_KEY
```

## Rome Solidity SDK'sini Kullanma

Solana programlarıyla etkileşime giren kontratlar için, herkese açık [`rome-solidity`](https://github.com/rome-protocol/rome-solidity) repo. GitHub'dan kurulur, npm'den değil:

```bash
# Hardhat / npm
npm install github:rome-protocol/rome-solidity

# Foundry
forge install rome-protocol/rome-solidity
# ardından foundry.toml içinde, [profile.default] altında:
# remappings = ["@rome-protocol/rome-solidity/=lib/rome-solidity/"]
```

Şunun ötesindeki kontratlar `interface.sol` ve oracle arayüzleri (örneğin ERC-20 wrapper'ları ve fabrika) OpenZeppelin'i içe aktarır. npm ile bağımlılık olarak gelir. Foundry ile ayrıca şunu da çalıştırın `forge install OpenZeppelin/openzeppelin-contracts` ve şu eşleştirmeyi ekleyin `@openzeppelin/contracts/=lib/openzeppelin-contracts/contracts/`.

npm ile paket şu şekilde kurulur: `@rome-protocol/rome-solidity`, bu nedenle aşağıdaki içe aktarma şuradan çözümlenir: `node_modules`. Foundry ile eşleştirme, aynı içe aktarmanın şuradan çözülmesini sağlar: `lib/rome-solidity`.

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

import {ICrossProgramInvocation, IHelperProgram}
    from "@rome-protocol/rome-solidity/contracts/interface.sol";

contract MyRomeContract {
    IHelperProgram constant Helper =
        IHelperProgram(0xFF00000000000000000000000000000000000009);
    ICrossProgramInvocation constant Cpi =
        ICrossProgramInvocation(0xFF00000000000000000000000000000000000008);

    // Çağıranın PDA'sından bir SPL token aktar
    function moveSpl(address to, uint64 tokens, bytes32 mint) external {
        Helper.transfer_spl(to, tokens, mint);
    }

    // Herhangi bir Solana programını CPI yoluyla çağır
    function callSolanaProgram(
        bytes32 programId,
        ICrossProgramInvocation.AccountMeta[] calldata accounts,
        bytes calldata data
    ) external {
        Cpi.invoke(programId, accounts, data);
    }
}
```

## Mevcut bir protokolü taşıyın

Herhangi bir Solidity kontratı Rome üzerinde değiştirilmeden dağıtılır — bir uyumluluk kontratı, bir DeFi protokolü veya mevcut, sağlamlaştırılmış bir uygulama. Kontratınızda olmayan tek şey **tek seferlik wrapper izni**: SPL-wrapper tokenlarını (wUSDC ve benzerleri) kontratınız üzerinden taşıyan bir kullanıcının, o token'ın wrapper'ına, ilk işlemden önce tokenlarını bir kez taşıma hakkı vermesi gerekir `transferFrom`. Bu olmadan transfer SPL hatasıyla geri alınır `0x4`. Kontrol edin `isEnabled(user)` wrapper üzerinde kontrol edin ve bakın [Cüzdan başına tek seferlik izin](https://docs.rome.builders/tr/temel-kavramlar/token-interop.md#one-time-grant-per-wallet); ön yüzünüz izni gönderir, kontratınız değişmez. Yukarıdaki aynı Hardhat / Foundry akışıyla çatallayıp dağıtabileceğiniz iki üretim örneği:

* [**compound-on-rome-comet**](https://github.com/rome-protocol/compound-on-rome-comet) — kanonik Compound v3 (Comet), standart Foundry.
* [**rome-aave-v3**](https://github.com/rome-protocol/rome-aave-v3) — kanonik Aave v3.

Her ikisi de kontrat değişikliği olmadan Solana yürütmesi ve CPI birlikte çalışabilirliği kazanır; kullanıcıları ilk yatırımdan önce yukarıda açıklanan tek seferlik wrapper iznini verir.

## Gas

Araçlarınızın gas tahmin etmesine izin verin (`eth_estimateGas`; Hardhat, `forge create` ve `cast` hepsi bunu yapar) ve asla sabit kodlamayın `21000`. Rome'da bir yazma işleminin maliyetinin çoğu, dağıtılmış bir kontrat, yeni bir token hesabı veya hiç kullanılmamış bir alıcı gibi Solana hesapları oluşturmaktır ve tahmin bunları içerir. Solana CPI'ları yapan bir çağrıda tahmin düşük çıkabilir, bu yüzden bir pay bırakın. Rome, gerçekte kullanılan gas'ı ücretlendirir. Hadrian'da ölçülen değerlere göre, 10 baytlık bir kontratın dağıtımı için tahmin edilen ve kullanılan gas 1.147.921 idi; mevcut bir adrese yerel bir transfer için ise tahmin 21.000, kullanılan ise 10.001 idi. Gerçek bir kontrat daha pahalıdır, bu yüzden kendi dağıtımınızı tahmin edin.  [JSON-RPC sayfası](https://docs.rome.builders/tr/referans/json-rpc.md#gas-is-solana-derived-estimate-dont-hardcode) ölçülmüş tabloyu içerir.

## Dağıtım Kısıtlamaları

| Kısıt                   | Limit               | Notlar                                                           |
| ----------------------- | ------------------- | ---------------------------------------------------------------- |
| Maksimum kontrat boyutu | 24 KB               | Ethereum ile aynı (EIP-170, 24.576 bayt)                         |
| İşlem boyutu sınırı     | Tutucu başına 80 KB | Büyük dağıtımlar tutucu hesaplar arasında şeffaf biçimde bölünür |
| Hesaplama bütçesi       | \~1,4M CU (atomik)  | Ağır kontratlar için yinelemeli modu kullanın                    |
| Solidity sürümü         | 0.8.28 önerilir     | Daha eski sürümler çalışır ancak 0.8.28 SDK ile uyumludur        |

## Yaygın Hatalar

| Hata                                                                   | Neden                                                                                               | Çözüm                                                                                                                                                                                                                                                                                                                                       |
| ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `gas için yetersiz bakiye`                                             | EVM adresinde gas tokenı yok                                                                        | Hadrian: test USDC'yi şununla köprüleyin [Rome Bridge](https://docs.rome.builders/tr/rome-uzerindeki-uygulamalar/bridge-api.md) (bkz. [Hızlı başlangıç](https://docs.rome.builders/tr/baslarken-1/quickstart.md), 2. adım); Rubicon: gerçek USDC'yi şununla köprüleyin [ana ağda Rome Bridge](https://bridge-api.mainnet.romeprotocol.xyz/) |
| `nonce çok düşük`                                                      | Cüzdanda eski nonce                                                                                 | MetaMask hesabını sıfırlayın veya nonce'u elle belirtin                                                                                                                                                                                                                                                                                     |
| `yürütme geri alındı`                                                  | Kontrat mantığı başarısız oldu                                                                      | Şununla hata ayıklayın `eth_call` veya `forge test --fork-url`                                                                                                                                                                                                                                                                              |
| `yürütme geri alındı` SPL hatasıyla `0x4` wrapper tokenlarını taşırken | Kullanıcı tek seferlik wrapper iznini vermedi                                                       | Kontrol edin `isEnabled(user)` wrapper üzerinde ve gönderin `approve_spl` bir kez ([ayrıntılar](https://docs.rome.builders/tr/temel-kavramlar/token-interop.md#one-time-grant-per-wallet))                                                                                                                                                  |
| `işlem düşük fiyatlandırılmış`                                         | Gas fiyatı minimumun altında                                                                        | İşlemde gas fiyatını artırın                                                                                                                                                                                                                                                                                                                |
| Sabit bir gas limitiyle bir transfer veya dağıtım başarısız olur       | Şunun gibi sabit kodlanmış bir sınır `21000` Solana hesapları oluşturmaya mal olandan daha düşüktür | Bunu kaldırın ve şunu kullanın `eth_estimateGas`                                                                                                                                                                                                                                                                                            |

## Sırada Ne Var

* [Sözleşmenizi Solana kullanıcılarına açın](https://docs.rome.builders/tr/gelistirici-kilavuzlari/open-to-solana-users.md) — Solana cüzdanı kullanıcılarının az önce dağıttığınızı çağırmasına izin verin
* [EVM'den Solana'yı çağırma](https://docs.rome.builders/tr/gelistirici-kilavuzlari/call-solana-from-evm.md) — Solana programlarıyla etkileşime geçmek için CPI ön derlemelerini kullanın
* [Sözleşmeleri Doğrulayın](https://docs.rome.builders/tr/gelistirici-kilavuzlari/verify-contracts.md) — kaynak kodunuzu blok gezginine yayınlayı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/gelistirici-kilavuzlari/deploy-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.
