> 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/rome-academy/10-from-other-chains.md).

# 10. Bawa pengguna dan dana dari chain lain

Bawa pengguna dan dana mereka ke aplikasi Rome Anda dari chain lain dan dari Solana, dengan bridge, API-nya, dan CLI, serta jaga layar aplikasi Anda tetap aktif.

Aplikasi Anda berfungsi untuk kedua jenis dompet. Kini pengguna perlu cara untuk masuk. Sebagian besar memiliki USDC di chain lain atau di Solana, dan mereka tidak seharusnya harus mempelajari Rome terlebih dahulu. Pelajaran ini menggunakan Rome Bridge API untuk membawa USDC dari chain yang didukung, melacak transfer, dan memungkinkan pengguna menarik dana kembali, sambil memastikan aplikasi Anda tetap mutakhir. [2. Yang dapat Anda bangun](https://docs.rome.builders/id/rome-academy/02-what-you-can-build.md) menunjukkan bagaimana hal ini diterapkan.

## Yang akan Anda pelajari

* Bagaimana pengguna di chain lain dapat mengakses aplikasi Rome Anda tanpa meninggalkan lingkungan asalnya.
* Bagaimana USDC pengguna masuk ke Rome dari chain EVM dan Solana.
* Mengapa transfer masuk sebagai gas atau wUSDC, dan cara memilihnya.
* Empat langkah transfer masuk.
* Mengapa keluar dari Rome memerlukan lebih banyak langkah daripada masuk.
* Cara menampilkan status terkini di aplikasi dan memeriksa transfer di explorer.

## Sebelum memulai

* Selesaikan [9. Bangun aplikasi dua jalur](https://docs.rome.builders/id/rome-academy/09-build-a-dual-lane-app.md). Anda memerlukan vault, atau aplikasi apa pun yang ingin diakses pengguna.
* Pastikan Rome CLI sudah terinstal ([Rome CLI + MCP](https://docs.rome.builders/id/produk/rome-cli.md)).
* Siapkan USDC uji di chain sumber serta token native chain sumber untuk membayar biayanya, dari [Faucet](https://docs.rome.builders/id/sumber-daya/faucets.md).

## Pelajaran

### Langkah 1. Pahami dua cara untuk masuk

Dengan Rome Bridge, pengguna Anda datang dari salah satu dari dua tempat. Chain EVM mengirimkan USDC melalui CCTP milik Circle. Dompet Solana mengirimkan SOL atau USDC melalui transfer SPL biasa. Dalam kedua kasus, bridge berlangsung on-chain dan diselesaikan dengan tanda tangan pengguna sendiri. Bridge API off-chain memberikan kuotasi rute, memeriksa transaksi sumber, dan menanggung biaya penyelesaian. API ini tidak menyimpan dana atau kunci apa pun, sehingga hanya dapat memicu tindakan yang telah ditandatangani pengguna.

Chain dan aset yang didukung berbeda antara testnet dan mainnet, jadi baca daftarnya dan jangan berasumsi. Daftarnya ada di [Rome Bridge](https://docs.rome.builders/id/aplikasi-di-rome/bridge-api.md), sedangkan daftar yang aktif tersedia melalui API `/v1/routes`. Pola untuk mengakses aplikasi Anda dari chain asal pengguna dijelaskan di [Dari asal](https://docs.rome.builders/id/panduan-pengembang/from-home.md).

### Langkah 2. Tentukan gas atau wUSDC

Secara default, USDC yang tiba melalui bridge masuk sebagai gas. Gas adalah mata uang yang digunakan pengguna MetaMask untuk membayar biaya. Token yang diterima vault Anda adalah wUSDC. Keduanya merupakan dua bentuk USDC yang sama, dan pengguna dapat menukarkan satu bentuk menjadi bentuk lainnya.

Atur intent dalam kuotasi. Aplikasi yang menerima wUSDC, seperti vault Anda, mengharapkan pengguna masuk sebagai wUSDC. Pengguna yang masuk sebagai gas perlu membungkus sebagian gas terlebih dahulu, seperti dalam pelajaran 9. Pengguna yang berencana keluar lagi memerlukan wUSDC, karena proses bridge keluar membakar wUSDC, bukan gas. Mereka dapat masuk sebagai wUSDC atau membungkus sebagian gas nanti dengan `withdraw_to_ata`.

### Langkah 3. Jalankan transfer masuk

Transfer masuk terdiri dari empat langkah. Subjalur SDK `/bridge` membungkus panggilan API sebagai `requestQuote`, `registerTransfer`, `getTransfer` dan `reportStep`. Versinya `registerTransfer` (v0.4.0) masih mengirim seluruh kuotasi, yang ditolak oleh API aktif. Karena itu, lakukan pendaftaran menggunakan `quoteId` sendiri, seperti yang dilakukan Rome CLI.

1. Minta kuotasi rute. Kirim chain sumber, aset, jumlah, pengirim, dan penerima. Chain dinyatakan sebagai ID CAIP-2, sedangkan jumlah berupa bilangan bulat satuan dasar dalam string.
2. Pengguna menandatangani transaksi pada langkah pertama sesuai urutannya, persis seperti yang dikembalikan. Untuk transfer CCTP, transaksi tersebut adalah persetujuan USDC dan pembakaran. Pada rute gas, pengguna juga menandatangani satu otorisasi penyelesaian EIP-712 setelah Anda mengisi hash pembakaran.
3. Daftarkan transfer. Kirim `quoteId` dari kuotasi dan hash pembakaran sebagai `step1TxHash` ke `POST /v1/transfers` dalam 15 menit sejak kuotasi. Pada rute gas, tambahkan tanda tangan penyelesaian sebagai `userSettleSig`. API memeriksa bahwa transaksi sesuai dengan kuotasi yang tersimpan dan mengembalikan ID transfer.
4. Periksa transfer secara berkala hingga `outcome` bernilai `complete`, dan tangani status `failed` dan `expired`. Transfer yang selesai dapat menyertakan catatan `degradation` , jadi periksa catatan tersebut sebelum memberi tahu pengguna bahwa gas atau wUSDC telah tiba.

Penerimaan di Solana mengikuti pola yang sama dengan langkah yang berbeda. Pengguna mengirim transfer SPL ke akun Rome mereka. Untuk intent gas, USDC di chain yang token gasnya adalah USDC memerlukan satu transaksi tambahan dari pengguna untuk mengubah wrapper menjadi gas. Kuotasi mencantumkan setiap tanda tangan yang diperlukan oleh suatu rute. Bentuk permintaan dan respons: [Dari lingkungan lokal](https://docs.rome.builders/id/panduan-pengembang/from-home.md#bring-assets-in).

### Langkah 4. Jalankan terlebih dahulu melalui CLI

Sebelum menulis kode bridge, jalankan alur ini dengan CLI. `rome fund` membawa USDC sebagai gas, `rome bridge` mengambil intent gas atau wrapper, dan `rome verify --path from-home` membuktikan perjalanan pulang-pergi penuh: bridge masuk, lakukan tindakan di Rome, lalu bridge keluar. Ini memberi Anda referensi yang berfungsi untuk dibandingkan dengan integrasi Anda. Perintah dan flag: [Rome CLI + MCP](https://docs.rome.builders/id/produk/rome-cli.md).

### Langkah 5. Tangani proses penarikan

Bridge keluar bukanlah kebalikan dari alur masuk. Untuk USDC melalui CCTP, pengguna menandatangani dua langkah. Langkah 1 terdiri dari dua transaksi Rome: pemberian izin yang memungkinkan kontrak bridge memindahkan jumlah persis yang akan dibakar, lalu pembakaran. Daftarkan transfer menggunakan hash pembakaran. Langkah 2 adalah klaim. Saat langkah 2 transfer menunjukkan `ready`, transfer tersebut menyertakan pesan dan atestasi, lalu pengguna memanggil `receiveMessage` dengan keduanya di chain tujuan. Tidak ada bagian klaim yang disponsori, jadi pengguna memerlukan gas di sana. Laporkan hash klaim ke API (`reportStep` di SDK). Pemanggilan dan bentuk data: [Kembalikan aset](https://docs.rome.builders/id/panduan-pengembang/from-home.md#take-assets-back-out).

Penarikan ke alamat Solana tidak memiliki langkah klaim. Untuk USDC, penarikan dilakukan melalui satu transaksi Rome ke akun Solana pengguna.

Pemberian izin ini penting bagi aplikasi Anda. Akun token hanya memiliki satu delegasi, sehingga izin bridge menggantikan izin wrapper hingga pengguna memberikan izin wrapper lagi. Periksa `isEnabled` sebelum deposit berikutnya, seperti yang dijelaskan dalam pelajaran 9.

### Langkah 6. Pastikan aplikasi Anda tetap aktif

Endpoint Rome mendukung `eth_subscribe` untuk `newHeads` dan `logs`, di host yang sama dengan RPC HTTPS. Dengan ethers, `provider.on("block")` dan `contract.on(event)` berfungsi seperti di mana pun. Dengan viem, `webSocket` transport tidak meneruskan ID langganan numerik Rome, jadi berikan `poll: true` ke `watchBlocks` dan `watchEvent`, atau gunakan ethers untuk pembaruan push. `newPendingTransactions` tidak pernah menghasilkan apa pun karena Rome tidak memiliki mempool publik. Kode: [Langganan WebSocket](https://docs.rome.builders/id/panduan-pengembang/websocket-subscriptions.md).

Saat membaca riwayat, batasi setiap pemanggilan `eth_getLogs` berdasarkan rentang blok. RPC Rome menolak rentang yang lebih lebar dari sekitar 12.000 blok. Untuk transaksi yang menyentuh Solana, baris "Diselesaikan di" di Via menautkan ke transaksi Solana yang menyelesaikannya, dan penjelajah Solana menampilkan instruksi serta unit komputasinya. Dengan begitu, Anda dapat menjawab pengguna yang bertanya di mana transfer mereka berada. Lihat [Via](https://docs.rome.builders/id/aplikasi-di-rome/via.md) dan [Dukungan JSON-RPC](https://docs.rome.builders/id/referensi/json-rpc.md).

## Solgate: aset Solana dan chain EVM AggLayer

[Solgate](https://docs.rome.builders/id/aplikasi-di-rome/solgate.md) menghubungkan aset Solana ke chain EVM AggLayer dalam kedua arah, di mainnet maupun testnet. USDC menggunakan CCTP. Langkah-langkah di atas menggunakan Rome Bridge API.

Untuk memindahkan token lain atau mengirim pesan, baca [13. Membangun di Solgate](https://docs.rome.builders/id/rome-academy/13-build-on-solgate.md).

## Uji pemahaman Anda

Lakukan satu transfer nyata dan amati prosesnya.

1. Isi dompet Hadrian baru dengan sedikit USDC untuk biaya gas, lalu masukkan lebih banyak USDC menggunakan `rome bridge` dan intent wrapper. Sisakan gas yang cukup untuk persetujuan, pemanggilan vault, dan burn keluar.
2. Baca saldo wUSDC dompet di Hadrian, misalnya dengan `rome call` pada wrapper `balanceOf`. Dengan intent wrapper, aset tiba melalui transaksi Solana bridge (pesan penerimaan Circle), bukan transaksi Rome. Jadi, jangan berharap ada transaksi kedatangan di penjelajah Hadrian.
3. Ulangi transfer melalui API: minta kuotasi, tanda tangani, daftarkan, lalu polling `GET /v1/transfers/{id}` hingga `outcome` menunjukkan `complete`.
4. Jalankan `rome verify hadrian --path from-home` dengan `--from` (chain sumber Anda) dan `--amount` (jumlah kecil, seperti 0,2), lalu baca hasilnya. Proses ini memerlukan waktu sekitar 20 menit.

Kemudian jawab:

* Saldo mana yang digunakan untuk burn USDC keluar, dan bagaimana pengguna bisa mendapatkannya?
* Siapa yang membayar klaim di chain tujuan?

<details>

<summary>Jawaban</summary>

* wUSDC. USDC yang diterima sebagai gas adalah saldo yang berbeda. Pengguna memperoleh wUSDC melalui intent wrapper, atau dengan membungkus sebagian gas menggunakan `withdraw_to_ata`.
* Pengguna. Klaim adalah transaksi di chain tujuan, jadi pengguna memerlukan gas di sana.

</details>

## Berikutnya

[11. Kirim ke Rubicon](https://docs.rome.builders/id/rome-academy/11-ship-to-rubicon.md)


---

# 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/rome-academy/10-from-other-chains.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.
