> 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/aplikasi-di-rome/bloom/lanes.md).

# Dua jalur

Satu deployment token, dua dunia dompet. Kedua jalur menjalankan **kontrak yang sama** dengan **gerbang kepatuhan yang sama** — keduanya hanya berbeda pada siapa yang menandatangani dan bagaimana transaksi mencapai chain.

## Jalur EVM

Perkakas Ethereum standar, tanpa perubahan: dompet menandatangani transaksi EVM, endpoint JSON-RPC chain menerimanya, kontrak token memberlakukan allowlist. Tidak ada yang khusus Bloom untuk diintegrasikan.

Gas Rome dinyatakan dalam USDC, dan operasi tulis biayanya lebih mahal daripada padanannya di Ethereum setiap kali harus membuat akun Solana (pemegang baru, akun token baru). Gunakan `eth_estimateGas`, seperti yang dilakukan tooling standar, dan jangan pernah meng-hardcode 21.000; estimasi sudah mencakup pembuatan akun, dan Rome menagih gas yang benar-benar dipakai. Transfer yang digate juga membayar pemeriksaan allowlist, jadi biayanya lebih mahal daripada transfer biasa dengan ukuran yang sama.

## jalur Solana

Dompet Solana menjalankan kontrak EVM yang sama **secara native — tidak ada kunci EVM di mana pun**. Setiap panggilan adalah transaksi Solana v1 yang dirangkai oleh proxy chain agar dompet menandatanganinya. Tidak ada address lookup table dan tidak ada instruksi compute-budget yang perlu dibuat: proxy itu sendiri yang menetapkan anggaran compute dan heap.

1. **Identitas.** Alamat sisi EVM pengguna adalah *sintetis*: diturunkan secara deterministik sebagai `keccak256(solana_pubkey)[12..32]`. Program Rome EVM menurunkannya on-chain dari penandatangan aktual transaksi — tidak dapat dipalsukan, dan tidak ada kunci privat secp256k1 untuknya, jadi **tanda tangan Solana adalah satu-satunya hal yang dapat menggerakkan alamat ini**.
2. **Otorisasi.** Aplikasi membangun panggilan sebagai payload EIP-1559 yang belum ditandatangani, menggunakan nonce, harga gas, dan estimasi gas yang dibaca dari chain. Dompet menandatangani pesan yang dapat dibaca — tampil sebagai *Otorisasi Rome* diikuti oleh hash dari panggilan — yang membuktikan kunci Solana mengotorisasi payload EVM yang persis ini. Ini adalah prompt pertama, dan proxy tidak akan merangkai panggilan tanpa itu.
3. **Susun.** Aplikasi mengirim payload dan tanda tangan itu ke proxy. Proxy memeriksa tanda tangan, meniru panggilan untuk menemukan akun Solana mana yang disentuh dan mana yang writable, lalu mengembalikan satu transaksi Solana v1. Aplikasi memeriksa pesan yang dikembalikan sebelum meminta dompet menandatanganinya.
4. **Tandatangani dan kirim.** Dompet menandatangani transaksi itu sendiri: prompt kedua, tanda tangan berbeda atas string byte yang berbeda. Aplikasi mengirim transaksi yang sudah ditandatangani langsung ke RPC Solana; pengguna membayar biaya Solana dalam SOL dari dompetnya sendiri.
5. **Konfirmasi.** Transaksi terkonfirmasi di Solana; tampilan EVM menyusul sesaat kemudian, jadi aplikasi menunggu nonce alamat sintetis bergerak sebelum mengirim panggilan berikutnya.

**Dompet harus menandatangani transaksi Solana v1.** Jalur ini gagal tertutup tanpa itu: dompet yang tidak dapat menandatangani transaksi v1 menghentikan panggilan dengan error, dan aplikasi tidak pernah beralih ke format transaksi yang lebih lama. Solflare saat ini menandatangani v1 di devnet; Phantom belum.

### Sebelum panggilan: kas dan grant satu kali

Ada dua hal yang bisa terjadi sebelum panggilan di jalur Solana, dan masing-masing muncul sebagai langkah tersendiri dengan promptnya sendiri:

* **Memindahkan kas masuk.** Panggilan yang membelanjakan wUSDC menariknya dari alamat sintetis, yang tidak menyimpan apa pun saat diam. Jika saldo sintetis kurang dari yang dibutuhkan panggilan, aplikasi terlebih dahulu memindahkan kekurangannya dari akun token USDC milik dompet ke akun sintetis. Ini adalah satu transaksi Solana yang ditandatangani dengan satu prompt, bukan panggilan EVM: pembuatan akun token sintetis secara idempotent, lalu instruksi activate-token-account dari program Rome, yang memindahkan token tanpa menjalankan EVM. Langkah ini dilewati jika alamat sintetis sudah memiliki cukup.
* **Grant wrapper satu kali.** wUSDC adalah wrapper dari token SPL, dan wrapper memindahkan token pengguna sebagai delegat SPL pengguna tersebut. Saat pertama kali alamat sintetis sebuah dompet membelanjakan wUSDC, grant belum ada, dan aplikasi menempatkan sebuah **Izinkan transfer wUSDC** langkah di depan yang lain. Ini satu panggilan seperti yang lain (dua prompt), sekali per dompet. Lihat [Pemberian sekali untuk setiap dompet](https://docs.rome.builders/id/konsep-inti/token-interop.md#one-time-grant-per-wallet).

Jadi, pembelian dari dompet Solana baru adalah urutan singkat: memindahkan kas masuk, mengizinkan transfer wUSDC, menyetujui etalase, membeli.

### Panggilan yang terlalu besar untuk satu transaksi

Transaksi Solana yang atomik memiliki batas tetap: sekitar 1,4 juta unit compute, 64 akun, dan 4 KB di jalur transmisi (lihat [Batasan](https://docs.rome.builders/id/konsep-inti/constraints.md)). Bloom selalu mencoba transaksi langsung yang ditandatangani dompet terlebih dahulu. Hanya ketika proxy menolak panggilan karena tidak muat dalam satu transaksi, aplikasi menyerahkannya ke proxy untuk **meneruskan**, dan tidak pernah sebelumnya:

* **Satu prompt untuk panggilan itu.** Relay menggunakan kembali pesan otorisasi yang sudah ditandatangani dompet untuk percobaan yang ditolak itu, jadi tidak ada prompt identik kedua dan tidak ada transaksi untuk ditandatangani. Proxy merangkai panggilan, mengirimkannya ke Solana (dalam sebanyak transaksi yang diperlukan) dan membayar biaya Solana itu sendiri.
* **Gas Rome diambil dari saldo alamat sintetis.** Panggilan yang di-relay dibayar dalam gas native chain, dalam wei, dari alamat sintetis. Jika saldo itu kurang dari biaya panggilan, aplikasi terlebih dahulu menambahkannya dari dompet, dalam satuan penuh 10^12 wei: satu prompt lagi, biasanya sekali per dompet, seperti grant.
* **Hash tersebut adalah hash transaksi Rome.** Hasil dari panggilan yang di-relay adalah hash transaksi EVM milik proxy, bukan tanda tangan Solana, jadi tidak akan terbuka di explorer Solana; cari di explorer milik chain itu sendiri.

Relay berlaku untuk panggilan apa pun yang oleh proxy dilaporkan terlalu besar untuk satu transaksi, yang di Credit dapat mencakup aksi pasar yang lebih besar. Sebagian besar panggilan, termasuk transfer biasa dan approval, muat dalam satu transaksi dan tidak pernah memakai jalur ini. Mekanisme panggilan yang di-relay dan batasannya ada di [Panggilan yang direlay dan panggilan panjang](https://docs.rome.builders/id/panduan-pengembang/call-evm-from-solana.md#relayed-calls-and-long-calls).

### Prompt per langkah

| Langkah                                                            | Prompt dompet                                                 |
| ------------------------------------------------------------------ | ------------------------------------------------------------- |
| Pindahkan kas masuk (hanya jika kurang)                            | 1                                                             |
| Izinkan transfer wUSDC (sekali per dompet)                         | 2                                                             |
| Panggilan yang muat dalam satu transaksi (approve, beli, transfer) | 2: pesan otorisasi, lalu transaksi                            |
| Panggilan yang harus di-relay                                      | 1, ditambah 1 untuk top-up gas satu kali jika saldonya kurang |

Di halaman aset Invest, dompet Solana menjalani cash-in, grant, approval, dan pembelian dalam satu alur setelah menekan Buy, dan tombol menampilkan "dua prompt dompet" saat setiap langkah menandatangani. Langkah-langkah yang disebutkan ("Transferring your cash") dan jumlah prompt di awal ditampilkan di Trade dan Credit. Dompet EVM juga mendapat satu kali *Izinkan transfer wUSDC* langkah di panel beli.

### Compute yang diukur, dari jalur sebelumnya

Sebelum beralih ke transaksi v1, jalur ini membangun transaksinya sendiri dan mengukur angka-angka ini di Rome devnet, rentang yang diamati di dua chain. Angka-angka tersebut belum diukur ulang pada transaksi v1 yang kini disusun proxy, jadi bacalah sebagai orde besaran, bukan sebagai anggaran:

| Alur jalur Solana                                                        | CU             |
| ------------------------------------------------------------------------ | -------------- |
| Transfer RWA yang digate                                                 | \~339–381 ribu |
| Approve wUSDC                                                            | \~189–191 ribu |
| Pembelian etalase (approve + beli, dua transaksi)                        | \~730–796 ribu |
| Sweep sisi kas ke akun token milik dompet                                | \~42–54 ribu   |
| Transfer nilai biasa                                                     | \~47 ribu      |
| `TestApprover.approve` — penerimaan allowlist, **ditandatangani dompet** | 220,794        |

Batas compute per transaksi Solana adalah 1,4 juta CU. Ukur panggilan Anda sendiri dari `meta.computeUnitsConsumed` (`getTransaction` pada Solana RPC; tanda terima EVM chain tidak memiliki field seperti itu) alih-alih mengasumsikan salah satu dari angka ini.

## Kustodi: mengapa RWA tetap di alamat sintetis

Pertanyaan desain yang harus dijawab setiap aset berizin: *apakah token bisa keluar dari perimeter kepatuhan?* Di jalur Solana jawabannya bersifat struktural, bukan kebijakan:

* **RWA berada di state EVM.** Saldonya adalah storage di dalam akun program Rome EVM. Tidak ada **mint SPL** representasinya sebagai akun token, tidak ada yang native Solana untuk dipindahkan. (Ini disengaja — versi wrapped/mirrored akan menjadi jalan keluar.)
* **Plumbing di sisi Solana tidak bisa menyentuhnya.** Komponen pemindahan aset di jalur ini (`create_ata`, transfer SPL, sweep) beroperasi pada akun token SPL; saldo storage EVM tidak memiliki akun seperti itu. Tidak ada instruksi yang memindahkan saldo EVM ke akun token Solana.
* **Hanya tanda tangan Solana milik pemilik yang mengendalikan alamat sintetis**, dan setiap pergerakan yang dapat diekspresikannya adalah panggilan ke kontrak token — yang menjalankan gerbang allowlist — sehingga transfer ke alamat yang tidak ada di allowlist akan revert secara identik baik ditandatangani oleh kunci EVM maupun kunci Solana.
* **Sisi kas adalah pengecualian yang disengaja.** wUSDC (yield, hasil penjualan) didukung SPL dan *seharusnya* melakukan round-trip: sisi keluar (`transfer_spl`) memindahkannya dari alamat sintetis ke associated token account milik dompet, diverifikasi end-to-end. Aset tetap di perimeter; kas mengalir bebas.

Dua konsekuensi praktis, dinyatakan secara jelas: UI dompet Solana tidak akan menampilkan kepemilikan RWA (tidak ada token SPL untuk ditampilkan) — aplikasi Bloom adalah permukaan posisi; dan kunci Solana yang hilang dipulihkan melalui proses penerbit ([COMPLIANCE.md](https://docs.rome.builders/id/aplikasi-di-rome/bloom/compliance.md#issuer-powers-transfer-agent-shaped)), bukan dengan memindahkan aset di luar jalur — yang memang merupakan sifat yang diinginkan aset berizin.


---

# 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/aplikasi-di-rome/bloom/lanes.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.
