> 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/canton-zk-evm/build-on-ostia.md).

# Ostia üzerinde geliştirin

Foundry veya Hardhat ile Ostia DevNet'te bir Solidity sözleşmesi dağıtın, doğrulayın ve viem ya da ethers ile bağlanın.

Ostia bir EVM zinciridir; bu nedenle zaten kullandığınız araçlar burada da çalışır. Bazı farklılıklar vardır; bkz. [Ethereum'dan Farklar](https://docs.rome.builders/tr/canton-zk-evm/evm-differences.md). Bu sayfada bir sözleşmenin nasıl dağıtılacağını ve doğrulanacağını, olayların nasıl okunacağını ve Canton'da işleminizin kesinleştiğini nereden görebileceğinizi anlatıyoruz. Bir miktar tROME içeren bir adrese ihtiyacınız var. [musluk](https://docs.rome.builders/tr/canton-zk-evm/devnet.md#get-trome) 1 tROME verir; ağ ayrıntıları için [Ostia DevNet](https://docs.rome.builders/tr/canton-zk-evm/devnet.md) sayfasına bakın.

## Foundry ile dağıtım

Bu komutlar Foundry 1.8 ile test edilmiştir. Önce `foundryup` (veya `brew upgrade foundry`) komutunu çalıştırın. Bir Foundry projesinde çalışın (`forge init ostia-counter` komutu, içinde bir `Counter` sözleşmesi bulunan bir proje oluşturur) ve fonlanmış anahtarı `PRIVATE_KEY`. `forge init` komutu zaten `[profile.default]` tablosunu `foundry.toml`dosyasına yazar. Dağıtım ve doğrulama işlemlerinin aynı ayarlarla derleme yapması için altına bir satır ekleyin:

```toml
[profile.default]
# ...forge init komutunun yazdığı satırlar olduğu gibi kalır
evm_version = "london"
```

```sh
export RPC=https://ostia.devnet.romeprotocol.xyz/rpc
forge create src/Counter.sol:Counter \
  --rpc-url $RPC --private-key $PRIVATE_KEY --broadcast
```

Şimdiye kadar Ostia'da çalışan örnekler:

| Açıklama                                                                                   | Derleyici            | EVM sürümü |
| ------------------------------------------------------------------------------------------ | -------------------- | ---------- |
| Bu [karma yük kiti](https://github.com/rome-protocol/canton-zk-evm/tree/v0.1.0/load/mixed) | solc 0.8.17          | `london`   |
| Uniswap V2                                                                                 | solc 0.5.16 ve 0.6.6 | `istanbul` |
| TACEO'nun Merces sözleşmeleri                                                              | solc 0.8.37          | `osaka`    |

Ostia zinciri, 2026-10-28 tarihinden bu yana Osaka'ya kadar tüm fork'ları çalıştırıyor. Bu nedenle zincir, şu sınıra kadar herhangi bir EVM hedefi için oluşturulmuş kodu kabul ediyor: `osaka`. Tablodaki hedefler, çalıştırılmış olanlardır; `london` güvenli bir tercihtir. Osaka'dan sonra eklenen bir opcode çalışmaz.

## Foundry ile doğrulama

Gezgin Etherscan API'sini konuşur, bu nedenle `forge verify-contract` Etherscan doğrulayıcısıyla çalışır. API anahtarı herhangi bir metin olabilir.

```sh
forge verify-contract <address> src/Counter.sol:Counter \
  --chain-id 770101 \
  --verifier etherscan \
  --verifier-url https://ostia.devnet.romeprotocol.xyz/api \
  --etherscan-api-key any \
  --watch
```

Gezgin, tek bir istemciden saatte 30 doğrulama isteğini kabul eder. Bu sınırı aşarsanız bekleyip isteği yeniden gönderin. Doğrulanmış bir sözleşmenin kaynak kodu, gezginin sözleşme sayfasında görünür.

## Büyük bir sözleşmeyi doğrulama

Çok sayıda kaynak dosyası olan bir sözleşme, HTTP `413`ile reddedilebilir. Gezginin ön vekil sunucusu istek başına yaklaşık 300 KB kabul eder ve forge girdisini URL kodlamalı gönderir; bu da dosyalardan daha büyüktür. `POST /api/verify` standart JSON ile aynı girdiyi alır ve bu girdi daha küçüktür. Vekil sunucu sınırı her istek için geçerlidir, bu nedenle 300 KB'ı aşan JSON gövdeleri de reddedilir. Kitteki [`verify-large.mjs`](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/load/mixed/scripts/verify-large.mjs) bunu yapar. forge'un gönderemediği Merces sözleşmelerinin 265 KB'lık standart JSON girdisini gönderdi. Kullanmak için önce Foundry projenizden standart JSON'u alın ve kitin klasörüne kopyalayın (deponun klonundaki`load/mixed` klasörüne):

```sh
forge verify-contract <address> <path:Name> --show-standard-json-input > std.json
cp std.json <your clone of canton-zk-evm>/load/mixed/
```

Ardından kitin klasöründe paketleri `npm ci` komutuyla yükleyin ve betiği çalıştırın. Betik, gezgin adresini kitin `config.json`dosyasından alır. (Docker ile `./run.sh node scripts/verify-large.mjs ...` aynı işi yapar.)

```sh
node scripts/verify-large.mjs <address> <path:Name> std.json <compiler> <runs> <evm> <constructor-args|->
```

Derleyici için tam sürüm dizesini verin. solc 0.8.28 ile derlenmiş, iyileştiricisi açık ve 200 çalıştırma ayarlı bir `Counter` sözleşmesi için EVM sürümü `london` ve kurucu bağımsız değişkeni yoksa:

```sh
node scripts/verify-large.mjs 0xC249f8828EAe40Ad6a77178e4de88049ed5e962f \
  src/Counter.sol:Counter std.json v0.8.28+commit.7893614a 200 london -
```

Gezgin, std.json içindeki ayarlarla derleme yapar. forge bu dosyayı foundry.toml dosyanızdan oluşturur; dolayısıyla sözleşme hangi iyileştirici ayarıyla derlenmiş olursa olsun doğrulanır. Betik doğrulama isteğini gönderir, ardından yanıt `GET /api/verify/<guid>` şu değerlerden biri olana kadar sorgular: `Pass` veya `Fail`. Aynı saatte 30 istek sınırı geçerlidir.

## Hardhat ile dağıtım

Bu yönergeler Hardhat 2 içindir (Hardhat 3, ESM yapılandırması gerektirir). Bu adımlar boş bir klasörle başlar ve Node 22 üzerinde Hardhat 2.29 kullanılarak Ostia DevNet'e karşı uygulanmıştır. Fonlanmış anahtarı `PRIVATE_KEY`içinde, başındaki `0x`.

```sh
mkdir ostia-hardhat && cd ostia-hardhat
npm init -y
npm i -D hardhat@2 @nomicfoundation/hardhat-toolbox@hh2
mkdir contracts scripts
```

`npx hardhat init` Sorularını terminalde sorup kendi örnek sözleşmesini oluşturduğundan, üç dosyayı elle oluşturun. Önce sözleşme:

```solidity
// contracts/Counter.sol
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.17;

contract Counter {
    uint256 public number;

    function setNumber(uint256 newNumber) public {
        number = newNumber;
    }

    function increment() public {
        number++;
    }
}
```

Yapılandırma. Buradaki `solidity` sürümü, pragma sürümüyle eşleşiyor:

```js
// hardhat.config.js
require("@nomicfoundation/hardhat-toolbox");

module.exports = {
  solidity: { version: "0.8.17", settings: { evmVersion: "london" } },
  networks: {
    ostia: {
      url: "https://ostia.devnet.romeprotocol.xyz/rpc",
      chainId: 770101,
      accounts: [process.env.PRIVATE_KEY],
      timeout: 120000,
    },
  },
};
```

Dağıtım betiği:

```js
// scripts/deploy.js
const hre = require("hardhat");

async function main() {
  const counter = await hre.ethers.deployContract("Counter");
  await counter.waitForDeployment();
  console.log("Counter deployed to", await counter.getAddress());
}

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

```sh
npx hardhat run scripts/deploy.js --network ostia
```

Şu çıktıyı verir: `Counter deployed to 0x...`. `timeout` her istek için geçerlidir. Dağıtım işlemi ayrıca makbuzunu bekler; makbuz ancak Canton kesinliği sağlandıktan sonra alınır (aşağıya bakın). 2026-10-25 tarihinde yapılan bir testte komut 20 ila 23 saniye sürdü; bunun büyük kısmı bloğun kesinleşmesini beklemekle geçti.

## Hardhat ile doğrulama

Gezgini, yapılandırmaya özel zincir olarak ekleyin; `@nomicfoundation/hardhat-verify`paketini, `hardhat-toolbox` yukarıdaki yapılandırmaya dahil eder. API anahtarı herhangi bir metin olabilir. Arama, daha önce doğrulanmış bir sözleşme kullanılarak Hardhat 2.29.1 ve hardhat-verify 2.1.3 ile kontrol edildi: eklenti özel zinciri buldu, gezginin API'sini sorguladı ve "already verified" yanıtını verdi. Yeni bir gönderim denenmedi; çalışmazsa bize bildirin. Eklenti, ağa özel API anahtarlarıyla ilgili bir kullanımdan kaldırma uyarısı verir. Bu uyarı beklenen bir durumdur: aşağıdaki ağa özel `apiKey` değerini kullanmaya devam edin; çünkü tek dizgili biçim bu zincirde hata verir ("The selected network (ostia) is wrong").

```js
// solidity ve networks ile aynı dizindeki hardhat.config.js
etherscan: {
  apiKey: { ostia: "any" },
  customChains: [
    {
      network: "ostia",
      chainId: 770101,
      urls: {
        apiURL: "https://ostia.devnet.romeprotocol.xyz/api",
        browserURL: "https://ostia.devnet.romeprotocol.xyz",
      },
    },
  ],
},
```

```sh
npx hardhat verify --network ostia <address> <constructor arguments>
```

Dağıtım sırasında kullandığınız `solidity` ayarlarını, `evmVersion`dâhil olmak üzere, aynen koruyun. Gezgini, kendisine verilen ayarlarla derleme yapar. Saatte 30 doğrulama sınırı burada da geçerlidir.

## viem ve ethers

viem zincir tanımı:

```ts
import { createPublicClient, defineChain, http } from "viem";

export const ostia = defineChain({
  id: 770101,
  name: "Ostia DevNet",
  nativeCurrency: { name: "tROME", symbol: "tROME", decimals: 18 },
  rpcUrls: { default: { http: ["https://ostia.devnet.romeprotocol.xyz/rpc"] } },
  blockExplorers: {
    default: { name: "Ostia explorer", url: "https://ostia.devnet.romeprotocol.xyz" },
  },
});

const client = createPublicClient({ chain: ostia, transport: http() });
```

ethers sağlayıcısı:

```js
import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider(
  "https://ostia.devnet.romeprotocol.xyz/rpc",
  { chainId: 770101, name: "ostia-devnet" },
  { polling: true },
);
```

RPC'de WebSocket ve filtreler bulunmadığından, ethers v6'da olayları izlemek için `{ polling: true }` gerekir (`contract.on`veya `provider.on` filtreyle). Makbuz yalnızca blok kesinleştiğinde gelir; bu nedenle zaman aşımı ayarlarken yaklaşık 10 ila 30 saniye süre tanıyın. Bir hesabın işlemlerini sırayla gönderin; bkz. [Ethereum'dan farklar](https://docs.rome.builders/tr/canton-zk-evm/evm-differences.md#nonces-and-the-order-of-sends).

viem'de `multicall` zincirde Multicall3 bulunmasını gerektirir. Ostia'da bu, standart adreste bulunur; bu nedenle zincir tanımına ekleyin: `contracts: { multicall3: { address: "0xcA11bde05977b3631167028862bE2a173976CA11" } }` (bkz. [Ethereum'dan farklar](https://docs.rome.builders/tr/canton-zk-evm/evm-differences.md#the-standard-contracts)).

## Makbuzlar ve olaylar

RPC yalnızca Canton'da kesinleşmiş blokları gösterir. Bir işlem gönderdikten sonra, `eth_getTransactionReceipt` blok kesinleşene kadar, yani yaklaşık 10 ila 30 saniye boyunca sonuç döndürmez. Bir araçta makbuz zaman aşımı ayarlarken kanıtlama ve Canton onayı için süre tanıyın.

WebSocket yoktur ve `eth_subscribe`, ayrıca `eth_newFilter`yoktur. Olayları takip etmek için `eth_getLogs` ile son sorgunuzdan bu yana geçen blok aralığını sorgulayın. Birkaç saniyede bir sorgulama yeterlidir. 2026-10-25 01:34 UTC itibarıyla sona eren 24 saat içinde, zincir yoğunken bloklar arasındaki medyan süre 16,6 saniyeydi; sakin bir zincir ise dakikada bir boş blok oluşturur. Dakikada 300 çağrıyı aşmayın.

## İşleminizi Canton üzerinde görüntüleyin

1. İşleminizi gezginde şu adresten açın: `/tx/<hash>`.
2. İşlemin blok bağlantısını izleyin: `/block/<number>`.
3. Blok sayfası, bloğun kaydını içeren Canton güncellemesini, Canton'un bunu kaydettiği zamanı ve kanıta ilişkin bilgileri gezginin beklediği değerlerle birlikte gösterir.
4. Şu düğmeye basın: **Doğrula**. Tarayıcınız, gezginin sunduğu kanıt, başlık ve işlemler üzerinde kanıt kontrolünü kendisi çalıştırır. Blok için kanıt oluşturulmaya devam edilirken düğme devre dışı görünür.

Aynı verilere API üzerinden de erişilebilir; örneğin: `GET /api/blocks/<number>` ve `GET /api/canton/updates/<update id>`.

## Daha kapsamlı bir örnek

Bu [`load/mixed`](https://github.com/rome-protocol/canton-zk-evm/tree/v0.1.0/load/mixed) klasörü bir dizi sözleşme dağıtır ve bunlar üzerinden karma trafik oluşturur: ERC-20, ERC-721, ERC-1155, bir ERC-3643 izinli token, Uniswap V2 ve TACEO'nun Merces özel transfer sözleşmeleri (bunların kanıtları zincir üzerinde kontrol edilir; hiçbir işlem kesinleştirilmez). [README](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/load/mixed/README.md) dosyasında komutlar bulunur. Kit ayrıca dağıttığı her sözleşmeyi gezginde doğrular. Sunulan yapılandırmayla yaklaşık 12.000 tROME gerekir; bu, faucet'in verdiğinden çok daha fazladır. Bu nedenle kendi Ostia'nızda çalıştırın (bkz. [Kendi Ostia'nızı çalıştırın](https://docs.rome.builders/tr/canton-zk-evm/run-it-locally.md#load-it-with-a-realistic-mix)). Derleyici indirme işlemi yalnızca linux x64 üzerinde çalışır. 2026-10-24 tarihinde yapılan bir çalıştırmada bir saat içinde 13.496 işlem gönderildi ve bunların tümü kesinleşti. [Sonuçlarda](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/load/mixed/RESULTS-2026-10-24.md) nelerin ölçüldüğü ve nelerin çalışmadığı açıklanır.


---

# 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/canton-zk-evm/build-on-ostia.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.
