> 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/build-with-canton.md).

# Bangun dengan Canton

Apa yang dapat Anda targetkan di Ostia selain kontrak EVM biasa, bagian-bagian Canton yang dapat Anda bangun dengannya, dan mana yang dapat Anda lakukan sendiri di DevNet hari ini serta mana yang dijalankan oleh Rome.

Ostia menjalankan kontrak EVM biasa, dan juga terhubung ke Canton. Permintaan ke Canton dalam sebuah blok disebut leg, dan semuanya di-commit dalam transaksi Canton yang sama dengan blok tersebut. Halaman ini mencantumkan target yang bisa Anda pilih, komponen di balik setiap target, serta siapa yang dapat menggunakannya di DevNet saat ini.

Kode untuk setiap komponen tersedia di repositori terbuka, [rome-protocol/canton-zk-evm](https://github.com/rome-protocol/canton-zk-evm), di bawah Lisensi Apache 2.0.

| Target                                                                | Deskripsinya                                                                 | Ketersediaan saat ini di DevNet                                                                                                                                                                                                            |
| --------------------------------------------------------------------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [Kontrak EVM](#evm-contracts)                                         | Aplikasi Solidity yang di-deploy dengan alat yang Anda gunakan di Ethereum.  | Anda melakukannya sendiri.                                                                                                                                                                                                                 |
| [Canton Coin dalam kontrak Anda](#canton-coin-in-your-contracts)      | Canton Coin sebagai CC ERC-20.                                               | Anda melakukannya sendiri, dengan [Bridge](https://docs.rome.builders/id/canton-zk-evm/bridge.md).                                                                                                                                         |
| [Token EVM di Canton sebagai token kembaran](#erc-20-twins-on-canton) | ERC-20 dengan token kembaran, yaitu token CIP-0056.                          | Rome menjalankannya dengan WtROME (dari tROME) dan TKA. Bridge memindahkannya untuk dompet Canton setelah fitur dompet diaktifkan. Belum ada dompet Canton eksternal yang menyimpan token kembaran. Rome mendaftarkan token kembaran baru. |
| [Pembayaran dengan pihak Canton](#payments-with-canton-parties)       | Pembayaran ERC-20 yang menjalankan alokasi Canton dalam transaksi yang sama. | Rome menjalankannya dengan pihak uji; Anda tidak dapat menjalankannya sendiri di DevNet.                                                                                                                                                   |
| [Venue Canton](#a-canton-venue)                                       | Aplikasi Daml yang menukar token Canton dengan ERC-20.                       | Rome menjalankan venue ini; venue ini pernah dijalankan sekali. Anda tidak dapat menjalankan venue di DevNet.                                                                                                                              |
| [Jaringan Anda sendiri](#your-own-network)                            | Seluruh stack di jaringan Canton lokal.                                      | Anda mengerjakan semuanya sendiri.                                                                                                                                                                                                         |

## Kontrak EVM

Deploy dengan Foundry atau Hardhat, verifikasi sumbernya di penjelajah, lalu hubungkan dengan viem atau ethers. [Build di Ostia](https://docs.rome.builders/id/canton-zk-evm/build-on-ostia.md) berisi langkah-langkahnya dan [Ostia DevNet](https://docs.rome.builders/id/canton-zk-evm/devnet.md#limits) menjelaskan batasannya. ERC-20, ERC-721, ERC-1155, token berizin ERC-3643, Uniswap V2, serta kontrak yang memeriksa proof TACEO Merces semuanya telah dijalankan di Ostia. Consumer harga RedStone telah di-deploy dan diverifikasi.

## Canton Coin dalam kontrak Anda

Canton Coin di Ostia adalah ERC-20 biasa dengan 10 angka desimal, di alamat `0x4db3dea7c13116961fd3e438542ccfcca61a7547`. Kontrak apa pun dapat menyimpan dan mentransfernya. Kustodi gateway di Canton mendukungnya dengan rasio satu banding satu, dan penjelajah menampilkan keduanya berdampingan di [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins) dan di `GET /api/twins`.

Anda memperoleh CC dengan menyetor Canton Coin di halaman [Bridge](https://docs.rome.builders/id/canton-zk-evm/bridge.md) , dan memperoleh kembali Canton Coin dengan menariknya. Halaman ini memberikan 20 Canton Coin uji coba per hari.

## Token kembaran ERC-20 di Canton

Anda membayar ERC-20 ke dalam vault, dan sebuah pihak Canton menyimpan jumlah yang sama dari token kembarannya. Token kembaran ini adalah token CIP-0056 dengan ID instrumen `erc20:<token address>`. Penukaran membakar token kembaran dan mengembalikan ERC-20 ke alamat Ostia.

**Siapa yang menyimpan token kembaran saat ini.** Token kembaran menerapkan CIP-0056, tetapi itu tidak berarti token tersebut akan muncul di setiap dompet Canton. Suatu pihak dapat menyimpan token kembaran setelah setiap validator yang meng-host-nya memverifikasi `ostia-twin` 0.1.0 dan 0.2.0, dan pihak yang menerima penguncian juga harus menandatangani `TwinAcceptance`satu kali. Saat ini, hanya pihak yang dijalankan Rome yang memenuhi persyaratan tersebut. Belum ada dompet Canton eksternal yang menyimpan atau mengirim token kembaran.

**Hubungkan dompet Canton Anda sendiri: sudah dibuat, belum diaktifkan.** Halaman Bridge menghubungkan dompet Canton yang sudah Anda miliki, dan akun Bridge yang dibuat dari tanda tangan dompet telah dihentikan pada 2026-11-17. Penghubungan diaktifkan satu per satu untuk setiap dompet, tanpa tanggal pasti. Proses ini menunggu tiga hal yang diputuskan oleh pembuat dompet dan validator: mereka meninjau paket Daml pihak ketiga sebelum dompet mereka mengizinkannya, beberapa aturan mereka memblokir nama paket yang diawali dengan `canton-` (nama paket chain kami adalah `canton-zk-evm`), dan validator yang menghosting party milik dompet harus memiliki paket Ostia. Sampai saat itu, dompet Canton eksternal tidak dapat melakukan transaksi di Bridge. Di DevNet, token kembar tersebut adalah TKA dan WtROME, dan vault berada di `0x69f13a94f986021f1a7650eb611bf9b717aa495a`.

Layanan registri token kembar tersedia di `https://ostia.devnet.romeprotocol.xyz/twin-registry` (misalnya `GET /twin-registry/healthz`). Layanan ini tidak menyimpan kunci.

| Panggilan                                                                          | Informasi yang diberikan                                                                                                                                                                |
| ---------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `GET /healthz`                                                                     | Token kembar dan vault.                                                                                                                                                                 |
| `GET /twin/v1/twins`                                                               | Token, ID instrumen, dan vault untuk setiap token kembar.                                                                                                                               |
| `GET /registry/...`                                                                | API registri standar token: metadata token kembar serta factory transfer dan alokasi, sehingga dompet yang validatornya telah memeriksa paket token kembar dapat mengirim token kembar. |
| `POST /twin/v1/lock-parts` dengan `{"receiver": <Canton party id>, "ref": <text>}` | ID lock dan vault terdaftar yang dapat digunakan oleh pihak pembayar dalam lock.                                                                                                        |

Penerima lock menandatangani `TwinAcceptance` satu kali. Tanpa tanda tangan ini, registri menjawab 409 dan builder mengeluarkan lock dari blok sebelum pembuktiannya, sehingga ERC-20 tetap berada pada pihak pembayar. Dompet Canton yang Anda hubungkan ke halaman Bridge menandatangani penerimaannya saat memilih ikut serta. Pihak pembayar memeriksa sendiri ID lock, SHA-256 dari `lock,<receiver>,<ref>`, lalu mengambil alamat vault dari sumber tepercaya.

Anda dapat memeriksa apakah vault tersebut adalah build yang telah ditinjau. `cast keccak $(cast code 0x69f13a94f986021f1a7650eb611bf9b717aa495a --rpc-url $RPC)` menghasilkan `0x2fbcf33083dd26a360690a0d8d24cd333997b3c7000d950aa5e564e01460d4da`, yang juga merupakan hash kode yang dilaporkan oleh `GET /api/twins` .

Saat ini, hanya Rome yang mendaftarkan token kembar dan vault di DevNet. Untuk meminta token kembar dari ERC-20 Anda sendiri, buat issue di [repositori](https://github.com/rome-protocol/canton-zk-evm/issues) atau tanyakan di [Discord Rome](https://discord.gg/vZ9rnCdNSB); Rome memutuskan permintaan satu per satu.

## Pembayaran dengan pihak Canton

Pihak pembayar EVM memanggil `pay`. Pihak pembayar dan penerima Canton telah menandatangani `DvpTerms` yang menetapkan alokasi, ID pembayaran, token EVM, penerima EVM, dan jumlahnya. Dalam satu transaksi Canton, blok dikomitkan dan alokasi dieksekusi, sehingga keduanya tidak dapat difinalisasi secara terpisah. Fitur ini dijalankan di DevNet pada blok 783 dan 1471. [Deposit, penarikan, dan pembayaran](https://docs.rome.builders/id/canton-zk-evm/deposits-withdrawals-payments.md#tie-a-payment-to-one-allocation) memuat aturan-aturannya.

Di DevNet, pihak uji Rome menjalankan pembayaran ini. Halaman Bridge tidak menjalankannya: halaman tersebut menjalankan empat transaksi bridge. Untuk menjalankan pembayaran yang terkait dengan alokasi antara party Canton Anda sendiri, jalankan jaringan Anda sendiri (lihat di bawah).

## Venue Canton

Venue adalah aplikasi Daml yang menjalankan transaksi antara penjual Canton dan pembeli EVM. Komponennya:

* `otc-venue` 0.1.0, di [`apps/otc`](https://github.com/rome-protocol/canton-zk-evm/tree/main/apps/otc), menyimpan `TradeOffer` dan `Trade`. Paket ini hanya bergantung pada standar token, CIP-0056, dan tidak menyebutkan rantai tertentu, sehingga dapat digunakan oleh venue mana pun. Paket ini `Trade` menampilkan permintaan alokasi kepada penjual di dompet standar.
* Paket Daml pada rantai (0.4.0 dan versi lebih baru, dengan 0.5.0 yang dikunci) menyimpan `VenueTrade` dan `FundedClaim`. Venue dan penjual menandatangani `VenueTrade` untuk setiap perdagangan.
* Pembeli membayar melalui gateway. Alokasi penjual dieksekusi dalam transaksi Canton yang sama dengan pembayaran, lalu pembeli mengklaim token terbungkus menggunakan `FundedClaim`.

Fitur ini berjalan di DevNet pada 2026-10-27 pukul 15:55 UTC: token Canton TKB ditukar dengan TKA ERC-20. Pembayaran pembeli tercatat di blok 16816, dalam satu pembaruan Canton, dan klaim pembeli tercatat di blok 16823. Pembayaran yang nilainya di bawah jumlah perdagangan tidak disertakan di blok 16834 dan tidak memindahkan apa pun. Penjelajah mencantumkan pertukaran di [`/swaps`](https://ostia.devnet.romeprotocol.xyz/swaps)dan `GET /api/swaps` mengembalikannya.

Di DevNet, builder dimulai dengan party milik venue, sehingga Rome menambahkan sebuah venue. Perintah untuk menjalankan pertukaran tersedia dalam demo repositori, untuk jaringan lokal atau instans yang Anda jalankan sendiri. Langkah saat penjual mengajukan perdagangan direncanakan sebelum peluncuran mainnet.

## Jaringan Anda sendiri

[Jalankan Ostia Anda sendiri](https://docs.rome.builders/id/canton-zk-evm/run-it-locally.md) memulai jaringan Canton lokal dan seluruh stack: rantai, prover atau penggantinya, gateway, dan penjelajah. Di sana, Anda menjalankan sendiri setiap komponen di atas kecuali Canton Coin, yang memerlukan validator Canton Network; untuk itu, jalankan Ostia pada participant validator Anda sendiri (lihat [Jalankan Ostia Anda sendiri](https://docs.rome.builders/id/canton-zk-evm/run-it-locally.md#run-on-an-existing-participant)). Anda menggunakan party dan venue Anda sendiri.

Aplikasi Daml melihat bagian-bagian yang ditandatanganinya. Siapa pun dapat membaca setiap bagian melalui `GET /api/legs` di penjelajah.

## Langkah selanjutnya

* [Kasus penggunaan](https://docs.rome.builders/id/canton-zk-evm/use-cases.md): hal-hal yang dimungkinkan oleh komponen-komponen ini saat ini.
* [Bridge](https://docs.rome.builders/id/canton-zk-evm/bridge.md): halaman browser untuk empat langkah tersebut dan untuk mengirim di Canton.
* [Cara kerjanya](https://docs.rome.builders/id/canton-zk-evm/how-it-works.md): satu blok, dari transaksi hingga komit Canton.


---

# 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/build-with-canton.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.
