> 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/06-tokens-on-both-sides.md).

# 6. Token di kedua sisi

Bagaimana satu token SPL muncul sebagai pembungkus ERC-20 untuk dompet EVM dan sebagai akun token untuk dompet Solana, serta pemberian satu kali yang memungkinkan kontrak memindahkannya.

Token adalah dasar dari setiap kasus penggunaan di [2. Yang dapat Anda bangun](https://docs.rome.builders/id/rome-academy/02-what-you-can-build.md): pool, vault, atau pasar pinjaman semuanya memindahkan aset yang sama dengan yang disimpan di dompet Solana. Wrapper SPL mengekspos mint SPL melalui antarmuka ERC-20. Untuk token yang disimpan di dompet, wrapper membaca saldo di akun token turunan Rome milik dompet tersebut, sehingga Solana dan Solidity melihat saldo yang sama. Pelajaran ini menjelaskan cara kerjanya dan satu grant yang harus diberikan setiap pengguna sebelum kontrak Anda dapat memindahkan token mereka.

## Yang akan Anda pelajari

* Cara wrapper SPL mengekspos saldo token Solana di dompet melalui metode ERC-20.
* Fungsi factory dan wrapper, serta wrapper yang perlu digunakan.
* Perbedaan token yang disimpan kontrak dan token yang disimpan dompet.
* Grant `approve_spl` satu kali, cara memeriksanya, dan penyebabnya tidak berlaku.

## Sebelum memulai

* Selesai [5. Memanggil Solana dari Solidity](https://docs.rome.builders/id/rome-academy/05-call-solana-from-solidity.md). Anda perlu memahami konsep PDA dengan otoritas eksternal dan precompile Helper.
* Siapkan dompet Hadrian yang telah diisi dana dan kontrak yang sudah di-deploy. Alamat wrapper kanonis tersedia di `tokens.json` milik chain di registry: entri dengan `kind: "spl_wrapper"` dan simbol `wUSDC`. [Hadrian](https://docs.rome.builders/id/jaringan/hadrian.md) menautkan ke folder registry chain.
* Akun token USDC yang Anda buat dengan `createMyAta` di pelajaran 5. Grant ini memerlukan akun tersebut sudah ada.

## Satu saldo, dua tampilan

Setiap alamat EVM memiliki PDA dengan otoritas eksternal di Solana, dan PDA tersebut memiliki akun token alamat itu. Metode ERC-20 wrapper, `balanceOf` membaca akun token dompet secara langsung. `totalSupply` membaca mint.

Di dalam Rome, token SPL dan wrapper ERC-20 milik dompet membaca akun token yang sama. Dompet Solana yang menyimpan USDC dan alamat EVM yang menyimpan USDC sama-sama memegang mint yang sama, dan keduanya bertransaksi melalui akun pool yang sama. Dengan demikian, likuiditas tetap berada di satu tempat di Rome. Ilustrasi dan detailnya tersedia di [Interoperabilitas token](https://docs.rome.builders/id/konsep-inti/token-interop.md#the-shared-state-model).

## Dompet dan kontrak menyimpan token dengan cara berbeda

Saldo bersama berlaku untuk dompet. Kontrak berbeda. Kontrak tidak dapat mengirim grant satu kali yang dijelaskan di bawah atas nama pengguna, sehingga wrapper biasa menyimpan token kontrak di akun token escrow dan mencatat kepemilikan setiap kontrak dalam ledger. Wrapper Token-2022 yang menggunakan hook tidak menyimpan ledger dan menggunakan akun token milik kontrak itu sendiri.

Ada dua konsekuensi:

* Dua wrapper untuk mint yang sama menampilkan saldo dompet yang sama. Saldo kontrak yang ditampilkan bisa berbeda karena masing-masing wrapper memiliki ledger sendiri.
* Untuk pool, vault, dan pasar pinjaman, gunakan wrapper kanonis yang tercantum di registry untuk setiap mint pada setiap chain. Jangan memilih wrapper berdasarkan namanya.

Transfer ke kontrak melalui wrapper akan menambahkan saldo ke ledger tersebut. Transfer itu tidak memberikan akun token yang dapat digunakan kontrak untuk membelanjakan token. Alur yang memerlukan kontrak untuk bertindak di Solana menggunakan jalur yang dijelaskan di [Mengintegrasikan program Solana](https://docs.rome.builders/pages/de3c03c10c2c7172c7cd997fea161c30ba9ca94f#id-3.-tokens-in-tokens-out).

## Factory dan wrapper

`ERC20SPLFactory` men-deploy wrapper untuk mint SPL. Setiap factory hanya mengizinkan satu wrapper untuk setiap mint. Wrapper menyediakan antarmuka ERC-20 lengkap:

* `balanceOf` dan `totalSupply` membaca state Solana.
* `transfer` dan `transferFrom` memindahkan token di Solana.
* `approve` dan `allowance` simpan allowance ERC-20 biasa di penyimpanan EVM, karena akun token tidak memiliki hal semacam itu.

Anda jarang perlu menerapkan wrapper. Rome dan registry sudah menyediakan wrapper kanonis untuk USDC, ETH, dan SOL. Anda hanya menerapkan wrapper ketika menambahkan mint baru. Kedua pemanggilan factory ada di [Factory](https://docs.rome.builders/id/konsep-inti/token-interop.md#the-factory). Factory juga menangani mint Token-2022, tetapi ekstensinya mengubah integrasi: wrapper yang menggunakan hook akan melakukan revert pada `transfer` dan `transferFrom`, dan mint dengan biaya transfer dapat menghasilkan jumlah yang diterima lebih sedikit daripada yang Anda kirim. Baca [Mint Token-2022](https://docs.rome.builders/id/konsep-inti/token-interop.md#token-2022-mints) sebelum menggunakannya di vault Anda.

Jumlah harus muat dalam `uint64`, karena jumlah SPL menggunakan tipe tersebut dan wrapper menolak nilai yang lebih besar. Token gas memiliki jumlah desimal tersendiri, sedangkan saldo gas native menggunakan 18 desimal. Konversi di antara keduanya harus tepat. Token gas di Hadrian dan Rubicon adalah USDC.

## Pemberian izin satu kali

Wrapper memindahkan token pengguna sebagai delegate SPL dari akun token pengguna. Akun token harus mencantumkan delegate tersebut sebelum wrapper dapat memindahkan token apa pun. Pengguna melakukannya sekali untuk setiap wrapper melalui satu pemanggilan, dengan jumlah maksimum:

`approve_spl(wrapper, type(uint64).max, mint)` pada precompile Helper.

Ada empat hal yang penting dalam praktik:

* **Pengguna yang mengirimkannya.** Pemberian izin ditandatangani oleh akun pengguna sendiri dan dikirim langsung ke precompile Helper. Kontrak Anda tidak dapat mengirimkannya atas nama pengguna. Tambahkan langkah "Aktifkan" di antarmuka depan Anda.
* **Ini berlaku untuk semua pengguna.** Dompet MetaMask maupun alamat sintetis dompet Solana memerlukan izin ini untuk setiap wrapper yang tokennya ingin mereka pindahkan.
* **Periksa terlebih dahulu.** Wrapper `isEnabled(user)` mengembalikan `true` setelah izin diberikan. Periksa nilai ini sebelum melakukan transfer, jangan berasumsi.
* **Berikan jumlah maksimum.** `isEnabled` tetap bernilai `true` selama masih ada bagian dari izin yang dibatasi jumlahnya. Izin dengan batas akan menghambat transfer biasa ketika jumlahnya hampir habis, dan aplikasi Anda tidak akan tahu bahwa izin perlu diminta lagi.

Mint yang harus diteruskan adalah `mint_id()` pada wrapper. Contoh implementasi lengkap di sisi antarmuka depan untuk kedua jenis dompet tersedia di [Satu kali: berikan izin kepada wrapper](https://docs.rome.builders/id/panduan-pengembang/dual-lane-app.md#one-time-grant-the-wrapper).

### Cara kerjanya bisa terganggu

Akun token hanya memiliki satu delegate. Jika pengguna memberikan izin kepada bridge atau router, izin tersebut menggantikan izin wrapper, sehingga wrapper berhenti berfungsi untuk pengguna itu. Gejalanya adalah revert dengan kesalahan SPL `0x4`, yaitu ketidakcocokan pemilik. Solusinya adalah memberikan izin kepada wrapper lagi. Jadi, periksa `isEnabled` sebelum alur yang bergantung pada wrapper, bukan hanya sekali saat pendaftaran.

Versi factory yang baru menghadirkan wrapper baru, dan setiap dompet memberikan izin kepada wrapper tersebut dengan cara yang sama.

## Memindahkan token keluar

Karena saldo wrapper sudah merupakan saldo SPL, memindahkan token keluar ke Solana dilakukan dengan transfer SPL.

* Ke dompet Solana lain dari dompet EVM: `transfer_spl` dikirim langsung dari wallet ke precompile Helper, atau `RomeBridgeWithdraw.bridgeOutToSolana`, yang juga memerlukan grant untuk kontrak bridge. Keduanya memerlukan akun token penerima sudah ada.
* Ke wallet yang menandatangani transaksi: `transfer_spl_to_signer`. Aset hanya sampai ke wallet pengguna sendiri melalui jalur Solana yang ditandatangani wallet. Dari MetaMask, penanda tangan adalah pembayar proxy Rome, jadi gunakan dua cara lainnya.
* Untuk token gas, `withdraw_to_ata` dan `deposit_from_ata` mengonversi antara gas native dan token di akun token.

Solgate menghubungkan aset Solana ke rantai EVM AggLayer dalam kedua arah, di mainnet dan testnet. Di testnet, pendaftaran token SPL tidak memerlukan izin. USDC menggunakan CCTP. [Pelajaran 10](https://docs.rome.builders/id/rome-academy/10-from-other-chains.md) kembali membahas alur masuk dan bridge. Daftar metodenya ada di [Deposit dan penarikan](https://docs.rome.builders/id/konsep-inti/token-interop.md#deposit-and-withdraw).

## Uji pemahaman Anda

Di Hadrian, gunakan wallet yang Anda danai:

1. Baca `isEnabled` untuk alamat Anda pada wrapper wUSDC kanonis dari registry.
2. Pastikan akun token USDC Anda sudah ada. Pemanggilan `createMyAta` di pelajaran 5 membuatnya. Jika Anda melewatkannya, bungkus sedikit gas menjadi wUSDC dengan `withdraw_to_ata`, seperti dalam [Aplikasi yang sama dari MetaMask](https://docs.rome.builders/id/panduan-pengembang/dual-lane-app.md#the-same-app-from-metamask).
3. Jika `isEnabled` bernilai `false`, kirim grant `approve_spl` ke precompile Helper. Gunakan kode dalam panduan dua jalur yang ditautkan di atas.
4. Baca `isEnabled` sekali lagi. Nilainya sekarang seharusnya `true`.
5. Temukan transaksi grant Anda melalui [Melalui explorer](https://docs.rome.builders/id/aplikasi-di-rome/via.md). Cari instruksi SPL Token `ApproveChecked` .

<details>

<summary>1. Mengapa dua wrapper untuk satu mint menampilkan saldo wallet yang sama?</summary>

Keduanya membaca akun token wallet di Solana. Wrapper adalah tampilan token SPL, bukan ledger terpisah. Hanya saldo yang disimpan oleh kontrak yang dilacak per wrapper.

</details>

<details>

<summary>2. Seorang pengguna memasok aset ke vault Anda, lalu menggunakan router yang meminta <code>approve_spl</code>miliknya sendiri. Pemanggilan <code>transferFrom</code> Anda berikutnya gagal dengan error SPL 0x4. Mengapa?</summary>

Akun token hanya memiliki satu delegate. Grant untuk router menggantikan grant untuk wrapper. Pengguna harus memberikan grant lagi kepada wrapper, dan aplikasi Anda sebaiknya memeriksa `isEnabled` sebelum transfer.

</details>

<details>

<summary>3. Wrapper pool mana yang Anda gunakan untuk pool likuiditas baru?</summary>

Wrapper kanonis yang ditetapkan registri untuk mint tersebut di chain itu. Saldo yang disimpan kontrak berbeda antarwrapper.

</details>

## Berikutnya

[7. Buka aplikasi EVM Anda ke dompet Solana](https://docs.rome.builders/id/rome-academy/07-open-to-solana-wallets.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/06-tokens-on-both-sides.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.
