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

# Dari rumah: menjangkau Rome dari chain lain

Biarkan pengguna di chain lain menjangkau aplikasi Rome Anda tanpa meninggalkan rumah — masukkan aset, lakukan tindakan, keluarkan kembali.

Pengguna Anda tidak perlu pindah ke Rome. Dari chain asal mereka — L2 seperti Arbitrum atau Monad, atau Solana — mereka membawa aset masuk, menggunakan aplikasi Rome Anda, lalu membawa aset keluar kembali. Jembatannya on-chain dan diotorisasi oleh tanda tangan milik pengguna sendiri; Anda menghubungkan aplikasi Anda ke sana melalui satu API.

## Cara kerjanya

* **Masuk (home → Rome):** pada rute token gas USDC melalui CCTP, `settle_inbound_bridge_v2` instruksi program Rome mengkredit pengguna, di bawah sebuah **EIP-712** `SettleAuthorization`yang ditandatangani, sehingga tidak ada penyelesai yang istimewa. Rute masuk lainnya tidak menggunakan instruksi atau tanda tangan itu. Wrapper USDC, ETH melalui Wormhole, dan SOL langsung masuk sebagai token wrapper di akun pengguna. USDC Solana pada chain yang token gas-nya adalah USDC memerlukan satu transaksi lagi, yang ditandatangani oleh pengguna, untuk mengubah wrapper menjadi gas. Kutipan memberi tahu Anda tanda tangan apa saja yang dibutuhkan suatu rute.
* **Keluar (Rome → home):** `RomeBridgeWithdraw` (di [`rome-solidity`](https://github.com/rome-protocol/rome-solidity)) membakar aset di Rome. Pengguna kemudian mengklaimnya di chain asal dengan transaksi mereka sendiri.
* **Transportasi:** Circle **CCTP** untuk USDC dan **Wormhole** bridge token untuk ETH. Chain asal Solana menggunakan transfer SPL biasa untuk masuk dan penarikan Rome untuk keluar. Wormhole adalah jalur masuk hanya untuk ETH. Ada rute Wormhole generik hanya untuk keluar, dan setiap aset di dalamnya harus diaktifkan terlebih dahulu oleh operator Rome.
* **Orkestrasi:** off-chain [`rome-bridge-api`](https://github.com/rome-protocol/rome-bridge-api) memberi kutipan rute, memverifikasi transaksi di chain sumber, dan mensponsori biaya settle. Ia tidak memegang dana atau kunci apa pun. Ia hanya dapat memicu apa yang sudah ditandatangani pengguna.

## Bangun itu

API publik tersedia di devnet pada `https://bridge-api.devnet.romeprotocol.xyz`. `GET /v1/routes` mencantumkan setiap rute yang aktif (aset, rail, arah, chain sumber, chain Rome, kecepatan). Panggilan di bawah ini adalah empat panggilan yang sama yang dibungkus SDK dalam `@rome-protocol/sdk/bridge` (`requestQuote`, `registerTransfer`, `getTransfer`, `reportStep`). CLI menjalankan seluruh alur untuk Anda: `rome fund` dan `rome bridge` untuk transfer dan `rome verify --path from-home` untuk perjalanan pulang-pergi, seperti dijelaskan pada halaman [Rome CLI](https://docs.rome.builders/id/produk/rome-cli.md) .

### Bawa aset masuk

1. **Buat kutipan rutenya.** Kirim chain sumber pengguna, aset, jumlah, dan alamat. Chain dikirim sebagai id CAIP-2 seperti `eip155:84532`; `romeChainId` adalah chain Rome Anda. Nama lama `ethereum` dan `solana` masih diterima tetapi tidak lagi disarankan, dan API menandai respons tersebut dengan header `Sunset` . Bentuk lengkap permintaan dan respons ada di [referensi API](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"
     }'
   ```

   Jumlah adalah integer unit dasar dalam bentuk string (`"1000000"` adalah 1 USDC). Jumlah ETH dalam wei dan, saat keluar, harus merupakan kelipatan 10.000.000.000 wei (wrapper memiliki 8 desimal); API menolak yang lebih halus dari itu. Respons mencantumkan `langkah-langkah`. Pengguna menandatangani transaksi dari setiap langkah yang ditandai `userSigns: true`, sesuai urutan langkah: transaksi EVM ada di `unsignedTxs`, instruksi Solana di `unsignedTx`. Tanda tangani persis seperti yang dikembalikan. Langkah tanpa apa pun untuk ditandatangani diselesaikan oleh sponsor setelah Circle atau Wormhole mengesahkan transfer. Klaim keluar adalah pengecualian, dijelaskan di bawah: pengguna yang membuatnya.
2. **Minta pengguna menandatangani.** Untuk kutipan CCTP, itu adalah persetujuan USDC dan pembakaran di chain sumber. Jika kutipan memiliki entri dalam `signatureRequests`, pengguna juga menandatangani EIP-712 itu `SettleAuthorization` setelah hash pembakaran diketahui; isi hash pembakaran dan kirim hasilnya sebagai `userSettleSig` pada panggilan berikutnya. Hanya rute CCTP token gas yang memilikinya. Rute Wormhole ETH, USDC bermaksud wrapper, dan Solana tidak memilikinya.
3. **Daftarkan transfer.** `POST /v1/transfers` dengan `quoteId` dan `step1TxHash`, hash dari transaksi terakhir pada langkah pertama (pembakaran), dalam waktu 15 menit sejak kutipan. Pada rute gas, tambahkan tanda tangan settle sebagai `userSettleSig`. API menolak objek quote lengkap. API memeriksa bahwa transaksi di chain sumber cocok dengan quote yang tersimpan dan mengembalikan transfer `id`.
4. **Polling** `GET /v1/transfers/{id}` setiap beberapa detik sampai `hasilnya` adalah `selesai`, dan tangani `gagal` dan `kedaluwarsa`. Pengguna kemudian didanai di Rome dan dapat menggunakan aplikasi Anda. Transfer yang selesai dapat membawa `catatan` degradasi dengan `degradationReason`jadi periksa itu sebelum Anda memberi tahu pengguna bahwa saldo gas atau wrapper telah tiba.

Chain asal Solana mengikuti bentuk yang sama dengan langkah yang berbeda. Pengguna mengirim transfer SPL ke akun token milik akun Rome mereka. SOL tiba sebagai wrapped SOL setelah satu transfer itu. Pada chain yang token gas-nya adalah USDC, seperti Hadrian, USDC memerlukan langkah kedua: transaksi Rome yang ditandatangani pengguna yang mengubah wrapper yang tiba menjadi gas native. Token SPL lainnya melalui rute `spl-solana-to-rome` yang mengambil mint di `splAsset`.

### Bawa aset keluar kembali

Bridging keluar bukan alur masuk yang dijalankan terbalik. Ia memiliki lebih dari satu tanda tangan, dan pengguna menyelesaikannya di chain asal. Buat kutipannya dengan `direction` disetel ke `from-rome`. `sourceChain` menamai sisi non-Rome sebagai id CAIP-2, dan pembakaran menuju ke chain itu. `destinationChainId` bersifat opsional dan harus sesuai dengannya saat Anda mengirimkannya. Nama lama `ethereum` masih berarti Ethereum Sepolia:

```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"
  }'
```

Untuk USDC melalui CCTP, kutipan mengembalikan dua langkah, dan pengguna menandatangani keduanya:

1. **Di Rome, dua transaksi berurutan.** Yang pertama memberikan `RomeBridgeWithdraw` hak delegasi atas wUSDC milik pengguna di Solana (`approve_spl`). Pemberian ini mencakup tepat jumlah pembakaran ini, jadi kutipan menyertakannya setiap kali dan pengguna menandatanganinya sebelum setiap pembakaran. Yang kedua membakar wUSDC melalui `RomeBridgeWithdraw`yang memulai transfer CCTP. Daftarkan transfer dengan hash pembakaran. Pembakaran itu membelanjakan wUSDC, token yang dinamai kutipan sebagai `burnToken`, bukan USDC gas native. Dana yang masuk sebagai gas bukanlah yang dibakar, jadi untuk perjalanan pulang-pergi bawa USDC masuk dengan `intent: "wrapper"`.
2. **Di chain tujuan, klaim.** Polling `GET /v1/transfers/{id}` sampai langkah 2 `siap`. Kemudian itu membawa `message` dan `attestation`. Pengguna memanggil `receiveMessage(message, attestation)` pada message transmitter milik Circle di chain tujuan (kutipan menamai transmitter dan domain CCTP). Tidak ada yang disponsori di sini, jadi pengguna membutuhkan gas di chain itu. Laporkan hash klaim dengan `POST /v1/transfers/{id}/steps/2`.

ETH keluar dari Rome melalui Wormhole saat ini tidak ditawarkan di Hadrian atau Rubicon. Hadrian hanya mencantumkan ETH melalui Wormhole ke arah Rome. Rubicon tidak mencantumkan rute ETH.

Menarik ke alamat Solana tidak memiliki langkah klaim. USDC adalah satu transaksi Rome yang menarik ke akun Solana milik pengguna. SOL adalah satu langkah Rome dengan tiga transaksi: pemberian delegasi yang sama atas wSOL, pembuatan opsional akun token wSOL milik penerima di Solana (dilewati jika sudah ada), dan penarikan melalui `RomeBridgeWithdraw`.

**Transfer keluar tidak memerlukan langkah aktivasi.** Pembakaran CCTP membuat akun message di Solana, dan akun itu membutuhkan biaya sewa. Akun Solana milik kontrak bridge sendiri membayar sewa itu. Tepat sebelum panggilan CPI-nya, kontrak memanggil `swap_gas_to_lamports`: pembayar biaya Solana pada transaksi tersebut menalangi lamports, dan pengguna dibebankan untuk itu dalam gas pada transaksi pembakaran yang sama. Dompet baru dapat melakukan transfer keluar pertamanya tanpa penyiapan sebelumnya. `RomeBridgeWithdraw` berada pada versi 13.0.0 di Hadrian dan di Rubicon saat ini. Kutipan keluar tidak membawa langkah aktivasi atau top-up, jadi aplikasi Anda tidak perlu memeriksa akun pengguna sebelum kutipan pertama. Transfer masuk juga tidak memerlukan aktivasi. CLI `rome` (0.11.0) masih memiliki pemeriksaan sendiri. `rome bridge --to` (tanpa `--dry-run`) membaca lamports dari akun otoritas eksternal pengguna di Solana. Jika jumlahnya kurang dari 15.000.000, perintah berhenti dan memberi tahu Anda untuk menjalankan `rome activate <chain>`, yang membayar 2 USDC di Hadrian melalui kontrak `SimpleActivator` . `rome verify --path from-home` melakukan pemeriksaan yang sama sebelum memulai. Kontrak tidak memerlukan aktivasi itu.

## Baca kodenya

* [appia](https://github.com/rome-protocol/appia) — aplikasi dari-home: pengguna membawa USDC dari chain asal mereka dan menggunakan DeFi sisi Rome tanpa meninggalkannya.
* [rome-bridge-api](https://github.com/rome-protocol/rome-bridge-api) — orkestrator (kutip → verifikasi → sponsor).

## Langkah berikutnya

* [Mendapatkan pendanaan](https://docs.rome.builders/id/sumber-daya/faucets.md) — jalur bridge yang sama mendanai dompet dev baru.
* [Deploy Solidity](https://docs.rome.builders/id/panduan-pengembang/deploy-solidity.md) — tempatkan aplikasi Anda di Rome.


---

# 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/id/panduan-pengembang/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.
