> 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/canton-zk-evm/deposits-withdrawals-payments.md).

# Setoran, penarikan, dan pembayaran

Bagaimana gateway menghubungkan setoran, penarikan, dan pembayaran EVM ke bagian Canton-nya, serta bagaimana kembar ERC-20 dan Canton Coin bergerak dua arah.

Gateway adalah kontrak EVM yang disertakan dalam genesis chain. Kontrak ini mencatat tindakan yang perlu dilakukan Canton untuk suatu blok. Setiap permintaan merupakan satu leg. Bukti blok mengikat state gateway, termasuk hash leg sesuai urutan pencatatannya.

Deposit, penarikan, dan pembayaran tersedia di Ostia DevNet, yang dijalankan Rome dengan pihak-pihak uji. Fitur-fitur ini pertama kali dijalankan dalam demo lokal pada 2026-10-05. Pada 2026-10-25, token uji Canton, TKB (token uji acuan yang disediakan Splice), didaftarkan ke gateway, dan bentuk terbungkusnya, wTKB, tersedia di Ostia pada `0x294d3049874526910a69f6b61da14d10a8b1b3af`. Sejak 2026-11-08, Anda dapat melakukan deposit dan penarikan Canton Coin sendiri dari halaman [Bridge](https://docs.rome.builders/id/canton-zk-evm/bridge.md) di explorer; lihat [Tersedia di DevNet](#live-on-devnet) di bawah.

Sejak 2026-10-29, gateway juga mendukung aset Canton dua arah: ERC-20 dapat hadir di Canton sebagai kembaran, dan Canton Coin dapat masuk ke Ostia lalu kembali. Lihat [Kembaran token ERC-20 di Canton](#canton-twins-of-erc-20-tokens) dan [Canton Coin](#canton-coin).

Sebagian besar tautan di halaman ini mengarah ke rilis `v0.1.0`; tautan README gateway mengarah ke cabang main. DevNet kini menjalankan kode dari cabang main repositori dengan paket Daml 0.5.0, dan leg mengikuti aturan yang sama. [Status](https://docs.rome.builders/id/canton-zk-evm/status.md) menyebutkan commit. Untuk mengetahui apa yang dapat Anda bangun di atas leg, lihat [Membangun dengan Canton](https://docs.rome.builders/id/canton-zk-evm/build-with-canton.md). Baca [README gateway](https://github.com/rome-protocol/canton-zk-evm/blob/main/gateway/README.md) dan [antarmuka Daml](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/daml/README.md).

| Leg        | Pemanggilan gateway              | Tindakan EVM                                  | Tindakan Canton dalam `Advance`                                                 |
| ---------- | -------------------------------- | --------------------------------------------- | ------------------------------------------------------------------------------- |
| Deposit    | `claim(id, token, amount)`       | Mencetak token terbungkus untuk pemanggil.    | Menjalankan alokasi deposan ke gateway.                                         |
| Penarikan  | `withdraw(token, amount, party)` | Membakar token terbungkus milik pemanggil.    | Membayar token Canton dari penyimpanan gateway kepada pihak yang disebutkan.    |
| Pembayaran | `pay(id, token, to, amount)`     | Mentransfer ERC-20 dari pembayar ke penerima. | Menjalankan alokasi yang ditentukan dalam ketentuan pembayaran yang disepakati. |

## Tersedia di DevNet

Deposit, pembayaran, dan penarikan dijalankan dua kali di DevNet pada 2026-10-25:

| Jalankan                                               | Deposit                                 | Pembayaran                                                                                                                      | Penarikan                                            |
| ------------------------------------------------------ | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| Pertama, 08:08 hingga 08:10 UTC                        | Blok 780: 10 TKB masuk, 10 wTKB keluar. | Blok 783: V membayar 1 WtROME kepada U (tROME terbungkus, ERC-20 di Ostia) sebagai imbalan atas alokasi 10 TKB dari U kepada V. | Blok 784: 4 wTKB dibakar, 4 TKB dibayarkan kepada U. |
| Kedua, 11:31 hingga 11:34 UTC, dengan paket Daml 0.2.0 | Blok 1465.                              | Blok 1471.                                                                                                                      | Blok 1473.                                           |

Setiap leg berada dalam bloknya sendiri. Pada masing-masing leg, catatan blok dan perubahan kepemilikan merupakan satu pembaruan Canton. Setelah eksekusi kedua, suplai wTKB berjumlah 12, yang dapat dibaca siapa pun di Ostia. Eksekusi Rome memeriksa bahwa gateway saat itu menyimpan 12 TKB di Canton, sama dengan suplai tersebut. Sejak 2026-10-25, penjelajah juga menampilkan informasi ini: halaman token wTKB memiliki kartu "Didukung di Canton" dengan jumlah kustodi 12 TKB, di samping suplai 12 wTKB.

U dan V adalah pihak uji yang dibuat dan dijalankan Rome pada participant-nya sendiri, dan Rome menjalankan setiap langkah. Anda dapat melihat leg di penjelajah: buka [`/legs`](https://ostia.devnet.romeprotocol.xyz/legs) untuk melihat daftarnya, atau halaman blok untuk melihat leg yang dibawanya. Penarikan menyebutkan pihak Canton yang menerima pembayaran. wTKB adalah ERC-20 biasa dengan 10 desimal, sehingga suplai dan saldonya ditampilkan seperti token lainnya (lihat [Penjelajah](https://docs.rome.builders/id/canton-zk-evm/explorer.md#legs-and-custody)).

Rome menjalankan setoran, pembayaran, dan penarikan setiap 10 menit, dan kesehatannya dipantau setiap 30 detik.

Untuk menyetor dan menarik Canton Coin sendiri, hubungkan dompet Canton Anda di halaman [Bridge](https://docs.rome.builders/id/canton-zk-evm/bridge.md) pada penjelajah, setelah fitur tersebut diaktifkan untuk dompet Anda. Halaman Bridge juga mengunci tROME dan TKA untuk Canton (gateway `pay` ke dalam vault). Pembayaran lainnya dan setoran TKB di halaman ini dijalankan oleh pihak uji Rome.

## Menyetor token Canton

Penyetor mengalokasikan token Canton kepada gateway, dengan operator sebagai pelaksana. Penyetor menandatangani `DepositRequest` yang mencantumkan ID setoran, alamat EVM yang diizinkan untuk mengklaim, dan alokasi. ID setoran adalah SHA-256 dari `deposit,<depositor's party id>,<label>`, sehingga hanya penyetor yang dapat membuat ID menggunakan pihaknya sendiri.

Alamat EVM tersebut memanggil `claim`. Gateway mencetak token kepada pemanggilnya dan mencatat leg setoran. Penerima memerlukan tROME untuk gas. Builder mencocokkan leg dengan permintaan, token yang terdaftar, dan alokasi.

`Advance` mengeksekusi alokasi ke dalam kustodi gateway dan mengonfirmasi blok yang mencetak token terbungkus. Token terbungkus memiliki 10 desimal, sesuai dengan jumlah Canton. Konversi antara kedua jumlah tersebut tepat, tanpa pembulatan.

## Menarik ke pihak Canton

Pemegang memanggil `withdraw` dengan token terbungkus, jumlah, dan ID pihak Canton lengkap. Gateway membakar token terbungkus dan mencatat penerima dalam leg.

Penerima harus telah menandatangani `WithdrawalAcceptance`. Tanda tangan ini tetap aktif hingga diarsipkan. Builder juga memerlukan kepemilikan instrumen terdaftar yang tidak terkunci dalam jumlah cukup di gateway. Jika syarat-syarat ini tidak terpenuhi, builder tidak menyertakan transaksi tersebut.

`Advance` membayar penerima melalui pabrik transfer pada registri token. Transfer Canton dan blok yang berisi pembakaran token dikonfirmasi secara bersamaan. Builder menyertakan paling banyak satu penarikan untuk satu instrumen per blok, seperti dijelaskan dalam [README builder](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/builder/README.md).

## Mengikat pembayaran ke satu alokasi

Pembayar Canton mengalokasikan token Canton kepada penerima pembayaran Canton. Keduanya menandatangani `DvpTerms` yang mencantumkan alokasi, ID pembayaran, token EVM, penerima pembayaran EVM, dan jumlah. ID pembayaran adalah SHA-256 dari teks UTF-8 `<Canton payer's party id>,<Canton payee's party id>,<label>`, yang ditulis dalam heksadesimal huruf kecil. Ketentuan ini menolak ID lainnya.

Pembayar EVM memberikan persetujuan kepada gateway lalu memanggil `pay` dengan ID, token, penerima, dan jumlah yang disepakati. Gateway memindahkan ERC-20 dari pembayar tersebut ke penerima pembayaran EVM dan mencatat leg pembayaran. Dalam demo, pembayar dikendalikan oleh penerima pembayaran Canton; protokol tidak mewajibkan hubungan tersebut. `Advance` menggunakan ketentuan yang ditandatangani untuk mengeksekusi alokasi dari pembayar Canton kepada penerima pembayaran Canton. Pembayaran ERC-20 dan pembayaran Canton dikonfirmasi secara bersamaan, sehingga tidak ada yang final tanpa yang lain.

Transfer ERC-20 biasa tidak mencatat leg. Bahkan transfer token yang sama kepada penerima pembayaran yang sama dalam blok yang sama tidak dapat menggantikan `pay`. [Alur pembayaran dalam rancangan](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/docs/DESIGN.md#the-flows) menjelaskan pengikatan ini.

## Token kembaran Canton dari ERC-20

Token kembaran adalah bentuk Canton dari ERC-20 yang berada di Ostia. Token ini merupakan token CIP-0056, standar token Canton, dengan ID instrumen `erc20:<token address>`, dan token ini berpindah melalui transfer sesuai standar token antara pihak-pihak yang pesertanya telah memeriksa ostia-twin. Saat ini, artinya akun milik peserta di Rome. Setiap twin berkorespondensi satu-ke-satu dengan ERC-20 yang disimpan vault. TKA dan WtROME (tROME terbungkus) memiliki twin di DevNet.

**Lock.** Anda membayar ERC-20 ke vault melalui gateway biasa `pay`, lalu menyebutkan pihak Canton yang seharusnya memegang twin. Sebelum membayar, Anda memberi tahu layanan registri twin tentang penerima dan sebuah `ref` pilihan Anda; layanan tersebut mengembalikan ID lock, yaitu SHA-256 dari `lock,<receiver>,<ref>`. Blok tersebut mencatat pembayaran ke dalam vault dan, dalam transaksi Canton yang sama, mencetak jumlah twin yang sama untuk penerima. Setelah itu, pasokan twin sama dengan jumlah yang disimpan vault.

**Redeem.** Pemegang menandatangani permintaan redeem di Canton, lalu `release` dipanggil pada vault dengan `ref`yang sama. Vault membayar ERC-20 ke alamat EVM dalam permintaan tersebut, dan twin dibakar di blok yang sama. Canton hanya menyelesaikan release jika ada permintaan redeem yang cocok.

Menurut aturan chain, twin hanya dicetak dalam `Advance`, berdasarkan pembayaran terverifikasi ke vault terdaftar; saat ini, admin twin, yaitu pihak gateway, juga dapat mencetak dan membakar twin secara mandiri. [Model kepercayaan dan batasan](https://docs.rome.builders/id/canton-zk-evm/trust-model.md#what-the-twins-trust) menjelaskan dasar mekanisme tersebut.

| Langkah | Tempat berlangsungnya                                                      | Tindakan Canton dalam `Advance` |
| ------- | -------------------------------------------------------------------------- | ------------------------------- |
| Lock    | Gateway `pay` ke vault.                                                    | Cetak twin untuk penerima.      |
| Redeem  | `release` pada vault, berdasarkan permintaan yang ditandatangani pemegang. | Bakar twin milik pemegang.      |

Pada 2026-10-29, lock sebesar 5 TKA untuk suatu pihak Canton masuk ke blok 28389 dan pihak tersebut memegang 5 twin. Pihak itu mengirim 2 twin kepada pihak kedua di Canton, lalu redeem atas 2 twin tersebut masuk ke blok 28392. Setelahnya, pasokan twin dan saldo vault sama-sama berjumlah 3. Halaman [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins) di explorer menampilkan pasokan setiap twin di samping saldo vault (lihat [Explorer](https://docs.rome.builders/id/canton-zk-evm/explorer.md#twins-and-canton-assets)).

Lock hanya dibuat untuk penerima yang telah menerima twin. Pihak menandatangani persetujuan satu kali untuk menerima twin, dan builder hanya membuat lock untuk pihak yang telah menyetujuinya. Menghubungkan dompet Canton di halaman [Bridge](https://docs.rome.builders/id/canton-zk-evm/bridge.md) menandatangani persetujuan tersebut sebagai bagian dari proses ikut serta, sehingga Anda dapat menjalankan seluruh siklus dengan pihak milik Anda sendiri.

## Canton Coin

Canton Coin masuk ke Ostia melalui deposit gateway yang sama seperti token Canton lainnya. Token terbungkus CC (`0x4db3dea7c13116961fd3e438542ccfcca61a7547`, 10 desimal; catatan terdahulu menyebutnya wCC) terdaftar pada factory yang ditetapkan oleh proxy pemindaian validator. Suatu pihak mengalokasikan Canton Coin ke gateway dan menandatangani permintaan deposit berlabel, penerima mengklaim CC di Ostia, dan penarikan mengembalikan Canton Coin. Canton Coin memerlukan satu input tambahan, yaitu konteks pilihan yang disediakan proxy pemindaian, dan builder mengambilnya sebelum memverifikasi blok.

Pada 2026-10-29, suatu pihak menyetor 5 Canton Coin melalui blok 28473, sehingga pihak tersebut memegang 15, gateway memegang 5, dan pasokan CC berjumlah 5. Penarikan di blok 28474 mengembalikan ketiganya ke nilai semula: 20, 0, dan 0. DevNet tidak mengenakan biaya untuk transfer ini.

## Yang dipastikan oleh proof

Setiap bagian mencatat jenis, ID, token, akun, jumlah, dan pihak Canton jika berlaku. Gateway melakukan hash atas bagian-bagian tersebut secara berurutan. `Advance` memeriksa apakah bagian-bagian yang dilampirkan menghasilkan hash dalam status gateway yang telah dibuktikan. Bagian yang hilang, berlebih, diurutkan ulang, atau diubah akan menyebabkan transaksi gagal. Pemeriksaan ini juga mencakup blok tanpa bagian apa pun.

Membuktikan blok tidak mencadangkan alokasi Cantonnya. Pengirim masih dapat mengambil kembali alokasi tersebut sebelum penyelesaian. Jika itu terjadi setelah pembuktian, Canton menolak `Advance` dan reth kembali ke blok terakhir yang telah dikomit. Blok terbukti yang sama tidak dapat dikirim ulang setelah leg-nya dihapus. Build berikutnya tidak menyertakan pembayaran, seperti yang ditunjukkan pada [run 4](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/demo/README.md#results).

## Batasan token dan kustodi

Siapa yang memegang token Canton dan perilaku token mana yang tidak dicakup oleh gateway dijelaskan dalam [Model kepercayaan dan batasan](https://docs.rome.builders/id/canton-zk-evm/trust-model.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/canton-zk-evm/deposits-withdrawals-payments.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.
