> 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/from-home.md).

# Evden: başka bir zincirden Rome'a ulaşın

Başka bir zincirdeki kullanıcıların evlerinden çıkmadan Rome uygulamanıza ulaşmasına izin verin — varlıkları içeri alın, işlem yapın, sonra geri çıkarın.

Kullanıcılarınızın Rome'a taşınması gerekmez. Kendi ana zincirlerinden — Arbitrum veya Monad gibi bir L2 ya da Solana — varlıklarını getirir, Rome uygulamanızı kullanır ve varlıklarını geri çıkarırlar. Köprü zincir üstündedir ve kullanıcının kendi imzasıyla yetkilendirilir; uygulamanızı tek bir API aracılığıyla ona bağlarsınız.

## Nasıl çalışır

* **Gelen (ana zincir → Rome):** CCTP üzerinden gas-token USDC rotasında, `settle_inbound_bridge_v2` Rome programının talimatı, imzalı bir **EIP-712** `SettleAuthorization`, bu yüzden ayrıcalıklı bir uzlaştırıcı yoktur. Diğer gelen rotalar bu talimatı veya imzayı kullanmaz. Wrapper USDC, Wormhole üzerinden ETH ve SOL doğrudan kullanıcının hesabına wrapper token olarak düşer. Gas token'ı USDC olan bir zincirdeki Solana USDC, wrapper'ı gasa dönüştürmek için kullanıcının imzaladığı bir işlem daha gerektirir. Teklif, bir rotanın hangi imzalara ihtiyaç duyduğunu size söyler.
* **Giden (Rome → ana zincir):** `RomeBridgeWithdraw` (içinde [`rome-solidity`](https://github.com/rome-protocol/rome-solidity)) varlığı Rome üzerinde yakar. Kullanıcı ardından bunu ana zincirde kendi işlemiyle talep eder.
* **Taşıma:** Circle **CCTP** USDC için ve **Wormhole** ETH için token köprüsü. Solana ana zincirleri girişte düz SPL transferlerini ve çıkışta bir Rome çekimini kullanır. Wormhole, ETH için yalnızca gelen hattır. Genel bir Wormhole rotası yalnızca çıkış için vardır ve üzerindeki her varlığın önce Rome operatörleri tarafından etkinleştirilmesi gerekir.
* **Orkestrasyon:** zincir dışı [`rome-bridge-api`](https://github.com/rome-protocol/rome-bridge-api) bir rotaya fiyat verir, kaynak zincirdeki işlemi doğrular ve uzlaştırma ücretini üstlenir. Hiçbir fon ya da anahtar tutmaz. Yalnızca kullanıcının zaten imzaladığı şeyi tetikleyebilir.

## Oluşturun

API devnet üzerinde şu adreste herkese açıktır: `https://bridge-api.devnet.romeprotocol.xyz`. `GET /v1/routes` canlı her rotayı listeler (varlık, hat, yön, kaynak zincir, Rome zinciri, hızlar). Aşağıdaki çağrılar, SDK'nın içinde sarmaladığı aynı dört çağrıdır: `@rome-protocol/sdk/bridge` (`requestQuote`, `registerTransfer`, `getTransfer`, `reportStep`). CLI tüm akışı sizin için yürütür: `rome fund` ve `rome bridge` aktarımlar için ve `rome verify --path from-home` gidiş-dönüş için, şu sayfada açıklandığı gibi: [Rome CLI](https://docs.rome.builders/tr/urunler/rome-cli.md) sayfası.

### Varlıkları içeri getirin

1. **Rotaya fiyat verin.** Kullanıcının kaynak zincirini, varlığını, tutarını ve adreslerini gönderin. Zincirler, şu tür CAIP-2 kimlikleri olarak girilir: `eip155:84532`; `romeChainId` sizin Rome zincirinizdir. Eski adlar `ethereum` ve `solana` hala kabul edilir ancak kullanımdan kaldırılmıştır ve API bu yanıtları bir `Sunset` başlığı ile işaretler. Tam istek ve yanıt yapıları [API başvuru dokümanında](https://github.com/rome-protocol/rome-bridge-api/blob/main/docs/API.md).

   ```bash
   curl -X POST https://bridge-api.devnet.romeprotocol.xyz/v1/quote \\
     -H 'Content-Type: application/json' \\
     -d '{
       "asset": "USDC",
       "direction": "to-rome",
       "sourceChain": "eip155:84532",
       "romeChainId": "200010",
       "amount": "1000000",
       "sender": { "ethereum": "0xUSER" },
       "recipient": "0xUSER"
     }'
   ```

   Tutarlar, dizilerde temel birim tamsayılarıdır (`"1000000"` 1 USDC'dir). ETH tutarları wei cinsindendir ve çıkışta 10.000.000.000 wei'nin katı olmalıdır (wrapper 8 ondalık basamağa sahiptir); API daha ince olan her şeyi reddeder. Yanıt, `adımları`. Kullanıcı, `userSigns: true`ile işaretlenmiş her adımın işlemlerini adım sırasına göre imzalar: EVM işlemleri `unsignedTxs`içinde, Solana talimatları ise `unsignedTx`içinde bulunur. Onları tam olarak döndürüldüğü gibi imzalayın. İmzalanacak hiçbir şeyi olmayan adımlar, Circle veya Wormhole transferi onayladıktan sonra sponsor tarafından tamamlanır. Çıkış talebi istisnadır, aşağıda açıklanmıştır: onu kullanıcı oluşturur.
2. **Kullanıcıya imzalatın.** CCTP teklifi için bu, kaynak zincirdeki USDC onayı ve yakımdır. Teklifte signatureRequests içinde bir giriş varsa, kullanıcı burn hash bilindiğinde o EIP-712'yi de imzalar; burn hash'i doldurun ve sonucu bir sonraki çağrıda userSettleSig olarak iletin. Buna yalnızca gas-token CCTP rotası sahiptir. Wormhole ETH, wrapper-intent USDC ve Solana rotalarında bu yoktur. `signatureRequests`içinde bir giriş varsa, kullanıcı burn hash bilindiğinde bu EIP-712'yi de imzalar; `SettleAuthorization` burn hash'i doldurun ve sonucu `userSettleSig` olarak bir sonraki çağrıda iletin. Buna yalnızca gas-token CCTP rotası sahiptir. Wormhole ETH, wrapper-intent USDC ve Solana rotalarında bu yoktur.
3. **Aktarımı kaydedin.** `POST /v1/transfers` ile birlikte teklifin `quoteId` ve `step1TxHash`kullanılır; bu, tekliften sonraki 15 dakika içinde ilk adımdaki son işlemin (yakımın) hash'idir. Gas rotasında uzlaştırma imzasını `userSettleSig`. API tam bir teklif nesnesini reddeder. Kaynak zincirdeki işlemin saklanan teklifle eşleştiğini denetler ve bir transfer `kimliği döndürür.`.
4. **Sorgula** `GET /v1/transfers/{id}` her birkaç saniyede bir `sonuç` şu `tamamlanana`kadar ve `başarısız` ve `süresi dolmuş`olanları yönetin. Kullanıcı daha sonra Rome üzerinde fonlanır ve uygulamanızı kullanabilir. Tamamlanmış bir transfer, bir `bozulma` notu ve bir `degradationReason`içerebilir; bu yüzden kullanıcıya gas veya wrapper bakiyesinin ulaştığını söylemeden önce bunları kontrol edin.

Solana ana zincirleri farklı adımlarla aynı yapıyı izler. Kullanıcı, Rome hesabının token hesabına bir SPL transferi gönderir. SOL, bu tek transferden sonra wrapped SOL olarak gelir. Hadrian gibi gas token'ı USDC olan bir zincirde USDC ikinci bir adım gerektirir: kullanıcının imzaladığı ve inen wrapper'ı yerel gaza dönüştüren bir Rome işlemi. Diğer herhangi bir SPL token `spl-solana-to-rome` rotasından geçer; bu rota mint'i `splAsset`.

### Varlıkları geri çıkarın

Çıkışta köprü kurmak, gelen akışın geriye sarılmış hali değildir. Birden fazla imza içerir ve kullanıcı bunu ana zincirde tamamlar. Rotayı şöyle fiyatlandırın: `direction` olarak `from-rome`. `sourceChain` Rome olmayan tarafı bir CAIP-2 kimliği olarak adlandırır ve yakım o zincire gider. `destinationChainId` isteğe bağlıdır ve gönderdiğinizde bununla eşleşmelidir. Eski ad `ethereum` hala Ethereum Sepolia anlamına gelir:

```bash
curl -X POST https://bridge-api.devnet.romeprotocol.xyz/v1/quote \\
  -H 'Content-Type: application/json' \\
  -d '{
    "asset": "USDC",
    "direction": "from-rome",
    "sourceChain": "eip155:84532",
    "destinationChainId": 84532,
    "romeChainId": "200010",
    "amount": "1000000",
    "sender": { "rome": "0xUSER" },
    "recipient": "0xUSER"
  }'
```

CCTP üzerinden USDC için teklif iki adım döndürür ve kullanıcı her ikisini de imzalar:

1. **Rome üzerinde, sırayla iki işlem.** İlki, Solana'daki kullanıcının wUSDC'si üzerinde vekil hakları verir ( `RomeBridgeWithdraw` approve\_spl`approve_spl`). Bu yetki, bu yakımın tam tutarını kapsar; bu yüzden teklif bunu her seferinde içerir ve kullanıcı her yakımdan önce bunu imzalar. İkincisi, CCTP transferini başlatan `RomeBridgeWithdraw`üzerinden wUSDC'yi yakar. Transferi, yakımın hash'iyle kaydedin. Yakım, teklifin `burnToken`olarak adlandırdığı token olan wUSDC'yi harcar; yerel gas USDC'yi değil. Gas olarak gelen fonlar yakılan şey değildir, bu yüzden gidiş-dönüş için USDC'yi `intent: "wrapper"`.
2. **Hedef zincirde, talep.** Sorgula `GET /v1/transfers/{id}` 2. adım `hazır olana`kadar. Ardından `mesaj` ve `onayını`taşır. Kullanıcı hedef zincirde Circle'ın mesaj ileticisi üzerinde `receiveMessage(message, attestation)` çağırır (teklif, ileticiyi ve CCTP alanını adlandırır). Burada hiçbir şey sponsor edilmez, bu yüzden kullanıcının o zincirde gaza ihtiyacı vardır. Talep hash'ini `POST /v1/transfers/{id}/steps/2`.

Wormhole üzerinden Rome'dan ETH çıkışı bugün Hadrian veya Rubicon'da sunulmuyor. Hadrian, Wormhole üzerinden ETH'yi yalnızca Rome'a doğru listeler. Rubicon'da ETH rotası yoktur.

Bir Solana adresine çekimde talep adımı yoktur. USDC, kullanıcının Solana hesabına çekim yapan tek bir Rome işlemidir. SOL, üç işlemlik tek bir Rome adımıdır: wSOL üzerinde aynı vekil yetkisi verilmesi, alıcının Solana'daki wSOL token hesabının isteğe bağlı oluşturulması (zaten varsa atlanır) ve üzerinden çekim `RomeBridgeWithdraw`.

**Çıkış transferleri için aktivasyon adımı gerekmez.** Bir CCTP yakımı Solana'da bir mesaj hesabı oluşturur ve bu hesabın kira ödemesi gerekir. Köprü sözleşmesinin kendi Solana hesabı bu kirayı öder. CPI çağrısından hemen önce sözleşme `swap_gas_to_lamports`çağırır: işlemin Solana ücret ödeyicisi lamport'ları peşin öder ve kullanıcı bunlar için aynı yakım işleminde gas olarak ücretlendirilir. Yeni bir cüzdan, ilk çıkış transferini önceden herhangi bir kurulum olmadan yapabilir. `RomeBridgeWithdraw` Hadrian ve Rubicon'da bugün 13.0.0 sürümündedir. Çıkış tekliflerinde aktivasyon veya doldurma adımı yoktur; bu nedenle uygulamanızın ilk tekliften önce kullanıcının hesabını kontrol etmesine gerek yoktur. Gelen transferler için de aktivasyon gerekmez.  `rome` CLI'si (0.11.0) yine de kendi kontrolüne sahiptir. `rome bridge --to` (--dry-run olmadan) kullanıcının Solana'daki dış yetkili hesabının lamport'larını okur. 15.000.000'dan az tutuyorsa komut durur ve `--dry-run`çalıştırmanızı söyler. `rome activate <chain>`Bu da Hadrian'da `SimpleActivator` sözleşmesi üzerinden 2 USDC öder. `rome verify --path from-home` başlamadan önce aynı kontrolü yapar. Sözleşmenin bu aktivasyona ihtiyacı yoktur.

## Kodu okuyun

* [appia](https://github.com/rome-protocol/appia) — bir ana-zincir uygulaması: kullanıcılar ana zincirlerinden USDC getirir ve Rome tarafındaki DeFi'yi zinciri terk etmeden kullanır.
* [rome-bridge-api](https://github.com/rome-protocol/rome-bridge-api) — orkestratör (teklif → doğrulama → sponsor).

## Sırada ne var

* [Fonlanma](https://docs.rome.builders/tr/kaynaklar/faucets.md) — aynı köprü yolu yeni bir dev cüzdanı fonlar.
* [Solidity'yi dağıtın](https://docs.rome.builders/tr/gelistirici-kilavuzlari/deploy-solidity.md) — uygulamanızı Rome üzerine koyun.


---

# 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/from-home.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.
