> 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/07-open-to-solana-wallets.md).

# 7. Buka aplikasi EVM Anda untuk dompet Solana

Buat kontrak Anda dapat digunakan dari dompet Solana tanpa kunci EVM, mencakup alamat sintetis, nilai ERC-20, dua tanda tangan, dan anggaran atomik.

Kontrak Anda sudah bekerja dengan MetaMask. Sekarang Anda membiarkan dompet Solana memanggilnya dengan kunci yang sudah dimilikinya, sehingga pengguna tidak pernah membuat akun EVM. Mereka memanggil kontrak yang sama, pada alamat yang sama, terhadap state yang sama.

## Apa yang akan Anda pelajari

* Bagaimana dompet Solana menjadi msg.sender biasa `msg.sender` di Rome.
* Mengapa kursus ini mengambil nilai sebagai deposit ERC-20, dan apa `msg.value` yang dibutuhkannya dari pengguna Solana.
* Apa yang ditandatangani pengguna Solana untuk setiap panggilan, dan ke mana transaksi dikirim.
* Apa yang muat dalam satu transaksi Solana, dan apa yang terjadi pada panggilan yang tidak muat.
* Yang `dependensi` yang dibutuhkan SDK dan dari mana masing-masing berasal.

## Sebelum Anda mulai

* Selesaikan [6. Token di kedua sisi](https://docs.rome.builders/id/rome-academy/06-tokens-on-both-sides.md). Pelajaran ini mengasumsikan Anda tahu apa itu wrapper dan mengapa pengguna memberinya izin sekali.
* Miliki `HelloRome` dideploy di Hadrian dari [3. Kontrak pertama Anda di Hadrian](https://docs.rome.builders/id/rome-academy/03-first-contract-on-hadrian.md).
* Instal SDK TypeScript, seperti pada [Rome SDK](https://docs.rome.builders/id/produk/rome-sdk.md#typescript-sdk-rome-protocol-sdk).
* Miliki dompet Solana yang menandatangani transaksi Solana v1, dengan sedikit SOL devnet dan USDC devnet. Faucet tercantum di [Faucets](https://docs.rome.builders/id/sumber-daya/faucets.md). Dukungan untuk transaksi v1 berbeda di setiap dompet, jadi uji dompet Anda terlebih dahulu. [Bangun aplikasi jalur ganda](https://docs.rome.builders/id/panduan-pengembang/dual-lane-app.md) menyebutkan dompet yang telah diperiksa sejauh ini.

## Pelajaran ini

### Langkah 1. Kenali alamat sintetis

Dompet Solana tidak memiliki alamat EVM, jadi Rome menurunkannya dari public key-nya. Hasilnya adalah alamat sintetis dompet itu. Itu adalah `msg.sender` yang dilihat kontrak Anda, dan alamat itu membawa nonce dan storage sendiri seperti akun lainnya. Dompet yang sama selalu dipetakan ke alamat yang sama.

```javascript
import { syntheticAddress } from "@rome-protocol/sdk";
const from = syntheticAddress(solanaPubkey); // alamat biasa 20-byte
```

Dalam alur kursus ini, synthetic tidak menyimpan token saat diam. Token mulai berada di dompet Solana pengguna. Langkah fund memindahkannya ke akun token synthetic sebelum deposit, dan barulah `balanceOf(synthetic)` wrapper menampilkannya. Langkah sweep memindahkannya kembali ke dompet setelah withdraw. Baca model lengkapnya di [Panggil EVM dari Solana](https://docs.rome.builders/id/panduan-pengembang/call-evm-from-solana.md#synthetic-addresses).

### Langkah 2. Jadikan kontrak siap untuk Solana

Sebagian besar kontrak tidak memerlukan perubahan. Tiga aturan menentukan apakah kontrak Anda termasuk di antaranya:

* Terima nilai sebagai ERC-20. Tarik dengan `transferFrom` setelah `approve`, dan kembalikan dengan `transfer`.
* Arahkan ke wrapper resmi untuk setiap token. Jangan deploy milik Anda sendiri.
* Pertahankan setiap panggilan jalur Solana di dalam satu transaksi Solana.

Aturan pertama inilah yang paling menjebak. Titik masuk ini berfungsi untuk pengguna MetaMask. Ini gagal bagi pengguna Solana dalam model fund-and-sweep, karena synthetic mereka tidak memiliki saldo native kecuali Anda mendanainya dengan `fundSyntheticGas`:

```solidity
function deposit() external payable { balanceOf[msg.sender] += msg.value; }
```

Yang ini berfungsi untuk keduanya, karena kedua jalur dapat mendanai sebuah `transferFrom`:

```solidity
function deposit(uint256 amount) external {
    require(token.transferFrom(msg.sender, address(this), amount));
    balanceOf[msg.sender] += amount;
}
```

Alamat wrapper ada di [Contract Addresses](https://docs.rome.builders/id/referensi/contract-addresses.md). Pemeriksaan untuk kontrak yang siap untuk Solana ada di [Buka kontrak Solidity Anda untuk pengguna Solana](https://docs.rome.builders/pages/e2d6ea644af2aaf896c62bae7070b2afbaa0db46#id-2.-what-makes-a-contract-solana-ready).

### Langkah 3. Ketahui apa yang ditandatangani dompet

Panggilan SDK adalah `submitRomeTxV1`. Untuk setiap panggilan, proxy menyusun satu transaksi Solana v1. Dompet menandatangani dua kali dengan kunci yang sama. Pertama, dompet menandatangani pesan otorisasi yang dapat dibaca yang menyebut hash transaksi EVM. Lalu dompet menandatangani transaksinya sendiri.

Aplikasi mengirim transaksi yang telah ditandatangani ke Solana RPC, bukan ke proxy Rome. Rantai memeriksa otorisasi melalui program Ed25519 dan menjalankan panggilan Anda sebagai alamat sintetis. Pengguna tidak pernah memegang kunci EVM.

Sebelum dompet menandatangani transaksi, SDK memeriksa bahwa transaksi itu benar-benar memuat panggilan yang diotorisasi pengguna. Apa pun selain itu akan ditolak. Rinciannya ada di [Buka kontrak Solidity Anda untuk pengguna Solana](https://docs.rome.builders/pages/e2d6ea644af2aaf896c62bae7070b2afbaa0db46#id-3.-let-a-solana-wallet-call-it).

### Langkah 4. Sambungkan jalurnya

SDK memerlukan lima nilai: URL proxy, chain ID, ID program Rome, koneksi RPC Solana, dan signer. Empat nilai mendeskripsikan chain. Satu berasal dari dompet.

```javascript
const deps = { connection, proxyUrl, chainId, programId, signer };
const res = await submitRomeTxV1(deps, { to: helloRome, data }); // helloRome: kontrak pelajaran 3 Anda; data: panggilan greet() yang dienkode ABI
```

Untuk Hadrian, baca empat nilai chain dari registry. Pemetaan ada di `dependensi` tabel panduan yang ditautkan di langkah 3, dan nilainya ada di [Hadrian](https://docs.rome.builders/id/jaringan/hadrian.md). Pelajaran 11 membahas wiring yang sama untuk Rubicon.

Dua langkah satu kali dilakukan sebelum panggilan pertama yang memindahkan nilai dari pengguna baru. Siapkan synthetic dengan `buildCreatePdaCall`, dan berikan izin ke wrapper jika `isEnabled` bernilai false. `submitRomeTxV1` tidak menyiapkannya untuk Anda. Pelajaran 9 menjalankan keduanya secara berurutan.

### Langkah 5. Tetap dalam satu transaksi

Panggilan jalur Solana harus muat dalam satu transaksi Solana: sekitar 1,4 juta compute unit, 64 akun, dan 4 KB. Ukur dengan `computeUnitsConsumed` dari receipt Solana, bukan `gasUsed`. Minta transaksi dengan `maxSupportedTransactionVersion: 1`; tanpa itu RPC menolak permintaan.

Saat sebuah panggilan tidak muat, composer menolaknya dan SDK menyerahkannya ke proxy untuk di-relay dengan tanda tangan otorisasi yang sama. Pengguna tetap melihat satu prompt. Hasilnya memuat `route: "relay"`. Panggilan yang di-relay menghabiskan gas native synthetic, jadi isi dulu dengan `fundSyntheticGas`. Panggilan yang di-relay dan melakukan revert tidak melempar error. Periksa `receipt.status`. Aturannya ada di [Panggilan yang di-relay dan panggilan panjang](https://docs.rome.builders/id/panduan-pengembang/call-evm-from-solana.md#relayed-calls-and-long-calls). Batasan dalam satu tabel: [Batasan](https://docs.rome.builders/id/konsep-inti/constraints.md).

## Uji diri Anda

Jawab ini, lalu buka jawabannya.

1. Mengapa sebuah `payable` deposit gagal untuk pengguna Solana?
2. Berapa banyak tanda tangan yang dihasilkan dompet per panggilan, dan apa yang dicakup masing-masing?
3. Ke mana transaksi yang telah ditandatangani dikirim?
4. Sebuah panggilan memerlukan lebih dari satu transaksi. Apa yang dilihat pengguna, dan siapa yang membayar?

<details>

<summary>Jawaban</summary>

1. Uang pengguna adalah token SPL di dompet mereka, yang ditampilkan di Rome sebagai wrapper. Synthetic tidak menyimpan saldo native dalam model fund-and-sweep kecuali Anda mendanainya, jadi tidak ada `msg.value` untuk dikirim.
2. Dua. Yang pertama mencakup pesan otorisasi yang dapat dibaca dengan hash transaksi EVM. Yang kedua mencakup transaksi Solana.
3. Ke Solana RPC, dikirim oleh aplikasi. Proxy menyusun transaksi dan tidak menerimanya, kecuali untuk panggilan yang di-relay.
4. Satu prompt otorisasi. Proxy me-relay panggilan dan saldo gas native synthetic membayarnya.

</details>

## Berikutnya

[8. Buka program Solana Anda untuk pengguna EVM](https://docs.rome.builders/id/rome-academy/08-open-your-solana-program-to-evm-users.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/07-open-to-solana-wallets.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.
