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

# Mit Canton bauen

Was Sie auf Ostia jenseits bloßer EVM-Verträge anvisieren können, mit welchen Canton-Bausteinen Sie bauen können und was Sie heute auf DevNet selbst machen können und was Rome ausführt.

Ostia führt gewöhnliche EVM-Verträge aus und ist außerdem mit Canton verbunden. Die an Canton gerichteten Anfragen eines Blocks sind Legs und werden in derselben Canton-Transaktion wie der Block ausgeführt. Diese Seite führt auf, welche Ziele Sie ansteuern können, aus welchen Komponenten sie bestehen und wer sie heute auf DevNet nutzen kann.

Der Code für alle Komponenten befindet sich im offenen Repository  [rome-protocol/canton-zk-evm](https://github.com/rome-protocol/canton-zk-evm) unter der Apache-Lizenz 2.0.

| Ziel                                                             | Beschreibung                                                                      | Heute auf DevNet                                                                                                                                                                                       |
| ---------------------------------------------------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [EVM-Verträge](#evm-contracts)                                   | Solidity-Apps, bereitgestellt mit den Tools, die Sie auch auf Ethereum verwenden. | Das erledigen Sie selbst.                                                                                                                                                                              |
| [Canton Coin in Ihren Verträgen](#canton-coin-in-your-contracts) | Canton Coin als CC ERC-20.                                                        | Das erledigen Sie selbst mit der  [Bridge](https://docs.rome.builders/de/canton-zk-evm/bridge.md).                                                                                                     |
| [Ein EVM-Token auf Canton als Twin](#erc-20-twins-on-canton)     | Ein ERC-20 mit einem Twin, einem CIP-0056-Token.                                  | Rome nutzt dafür WtROME (aus tROME) und TKA. Die Bridge überträgt sie für eine Canton-Wallet, sobald Wallets aktiviert sind. Noch hält keine externe Canton-Wallet Twins. Rome registriert neue Twins. |
| [Zahlungen mit Canton-Parteien](#payments-with-canton-parties)   | Eine ERC-20-Zahlung, die im selben Vorgang eine Canton-Allokation ausführt.       | Rome führt dies mit Testparteien aus; Sie können es nicht selbst auf DevNet nutzen.                                                                                                                    |
| [Ein Canton-Handelsplatz](#a-canton-venue)                       | Eine Daml-App, die einen Canton-Token gegen einen ERC-20 tauscht.                 | Rome betreibt den Handelsplatz; er wurde einmal ausgeführt. Auf DevNet können Sie keinen Handelsplatz betreiben.                                                                                       |
| [Ihr eigenes Netzwerk](#your-own-network)                        | Der gesamte Stack in einem lokalen Canton-Netzwerk.                               | Das erledigen Sie komplett selbst.                                                                                                                                                                     |

## EVM-Verträge

Stellen Sie Ihre Verträge mit Foundry oder Hardhat bereit, verifizieren Sie den Quellcode im Explorer und verbinden Sie sich mit viem oder ethers. [Auf Ostia entwickeln](https://docs.rome.builders/de/canton-zk-evm/build-on-ostia.md) enthält die Schritte und  [Ostia DevNet](https://docs.rome.builders/de/canton-zk-evm/devnet.md#limits) beschreibt die Einschränkungen. ERC-20, ERC-721, ERC-1155, ein berechtigungsbasierter ERC-3643-Token, Uniswap V2 und die Verträge zur Prüfung von TACEO-Merces-Proofs wurden alle auf Ostia ausgeführt. Ein RedStone-Preis-Consumer wurde bereitgestellt und verifiziert.

## Canton Coin in Ihren Verträgen

Canton Coin auf Ostia ist ein gewöhnlicher ERC-20 mit 10 Dezimalstellen unter der Adresse  `0x4db3dea7c13116961fd3e438542ccfcca61a7547`. Jeder Vertrag kann ihn halten und übertragen. Die Verwahrung auf Canton durch das Gateway deckt ihn im Verhältnis eins zu eins; der Explorer zeigt beide nebeneinander unter  [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins)  und unter  `GET /api/twins`.

CC erhalten Sie, indem Sie Canton Coin auf der  [Bridge](https://docs.rome.builders/de/canton-zk-evm/bridge.md) -Seite einzahlen. Durch eine Auszahlung erhalten Sie Canton Coin zurück. Auf der Seite können Sie täglich 20 Canton Coin zum Testen erhalten.

## ERC-20-Twins auf Canton

Sie zahlen einen ERC-20-Token in den Vault ein, und eine Canton-Partei hält dieselbe Menge seines Twins. Der Twin ist ein CIP-0056-Token mit der Instrumenten-ID  `erc20:<token address>`. Bei der Einlösung wird der Twin verbrannt und der ERC-20-Token an eine Ostia-Adresse zurückgezahlt.

**Wer hält heute Twins?** Twins implementieren CIP-0056, aber dadurch erscheinen sie nicht automatisch in jeder Canton-Wallet. Eine Partei kann einen Twin halten, sobald alle Validatoren, auf denen er gehostet wird, die Versionen  `ostia-twin` 0.1.0 und 0.2.0 überprüft haben. Eine Partei, die eine Sperre erhält, muss außerdem einmalig  `TwinAcceptance`signieren. Derzeit erfüllen das nur die von Rome betriebenen Parteien. Noch hält oder versendet keine externe Canton-Wallet Twins.

**Verbinde deine eigene Canton-Wallet: entwickelt, aber noch nicht aktiviert.** Die Bridge-Seite verbindet die Canton-Wallet, die du bereits hast. Das Bridge-Konto, das aus einer Wallet-Signatur erstellt wurde, wurde am 17.11.2026 eingestellt. Die Verbindung wird Wallet für Wallet aktiviert, ohne festen Termin. Sie hängt von drei Dingen ab, über die Wallet-Anbieter und Validatoren entscheiden: Sie prüfen ein Daml-Paket eines Drittanbieters, bevor ihre Wallet es zulässt; einige ihrer Regeln blockieren Paketnamen, die mit `canton-` beginnen (unser Chain-Paket heißt `canton-zk-evm`), und die Validatoren, auf denen die Parteien einer Wallet gehostet werden, müssen die Pakete von Ostia installiert haben. Bis dahin kann keine externe Canton-Wallet auf der Bridge Transaktionen ausführen. Auf DevNet sind die Zwillinge TKA und WtROME, und der Vault befindet sich unter `0x69f13a94f986021f1a7650eb611bf9b717aa495a`.

Der Twin-Registry-Dienst ist erreichbar unter `https://ostia.devnet.romeprotocol.xyz/twin-registry` (zum Beispiel `GET /twin-registry/healthz`). Er verwahrt keine Schlüssel.

| Aufruf                                                                          | Was zurückgegeben wird                                                                                                                                                                                        |
| ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `GET /healthz`                                                                  | Die Zwillinge und die Vaults.                                                                                                                                                                                 |
| `GET /twin/v1/twins`                                                            | Token, Instrument-ID und Vaults jedes Zwillings.                                                                                                                                                              |
| `GET /registry/...`                                                             | Die Registry-API des Tokenstandards: die Metadaten des Zwillings sowie die Transfer- und Allokierungs-Factorys, damit eine Wallet, deren Validatoren das Zwillingspaket geprüft haben, Zwillinge senden kann. |
| `POST /twin/v1/lock-parts` mit `{"receiver": <Canton party id>, "ref": <text>}` | Die Lock-ID und die registrierten Vaults, die der Zahler für einen Lock verwenden kann.                                                                                                                       |

Der Empfänger eines Locks signiert einmal eine `TwinAcceptance` Ohne diese antwortet die Registry mit 409, und der Builder lässt den Lock vor dem Proof aus dem Block heraus, sodass der ERC-20 beim Zahler bleibt. Eine Canton-Wallet, die du mit der Bridge-Seite verbindest, signiert ihre Zustimmung im Opt-in. Der Zahler prüft die Lock-ID selbst und den SHA-256-Hash von `lock,<receiver>,<ref>`und bezieht den Vault aus einer vertrauenswürdigen Quelle.

Du kannst prüfen, ob der Vault dem geprüften Build entspricht. `cast keccak $(cast code 0x69f13a94f986021f1a7650eb611bf9b717aa495a --rpc-url $RPC)` ergibt `0x2fbcf33083dd26a360690a0d8d24cd333997b3c7000d950aa5e564e01460d4da`, denselben Code-Hash, den `GET /api/twins` meldet.

Derzeit registriert nur Rome auf DevNet Zwillinge und Vaults. Wenn du einen Zwilling für deinen eigenen ERC-20 beantragen möchtest, eröffne ein Issue im [Repository](https://github.com/rome-protocol/canton-zk-evm/issues) oder frage im Rome [Discord](https://discord.gg/vZ9rnCdNSB); Rome entscheidet von Fall zu Fall.

## Zahlungen mit Canton-Parteien

Ein EVM-Zahler ruft die `pay`-Funktion des Gateways auf. Der Canton-Zahler und der Zahlungsempfänger haben `DvpTerms` signiert, in denen Allokierung, Zahlungs-ID, EVM-Token, EVM-Zahlungsempfänger und Betrag festgelegt sind. In einer einzigen Canton-Transaktion wird der Block festgeschrieben und die Allokierung ausgeführt, sodass keines der beiden Ergebnisse ohne das andere endgültig ist. Dies lief auf DevNet in den Blöcken 783 und 1471. [Einzahlungen, Auszahlungen und Zahlungen](https://docs.rome.builders/de/canton-zk-evm/deposits-withdrawals-payments.md#tie-a-payment-to-one-allocation) sind dort geregelt.

Auf DevNet führen Romes Testparteien diese Zahlungen aus. Die Bridge-Seite führt sie nicht aus: Sie übernimmt die vier Bridge-Schritte. Um Zahlungen auszuführen, die an eine Allokierung zwischen deinen eigenen Canton-Parteien gebunden sind, betreibe dein eigenes Netzwerk (siehe unten).

## Ein Canton-Handelsplatz

Ein Venue ist eine Daml-App, die einen Handel zwischen einem Canton-Verkäufer und einem EVM-Käufer abwickelt. Die Bestandteile:

* `otc-venue` 0.1.0 in [`apps/otc`](https://github.com/rome-protocol/canton-zk-evm/tree/main/apps/otc) enthält das `TradeOffer`  und das `Trade`. Es hängt nur vom Tokenstandard CIP-0056 ab und nennt keine bestimmte Chain, sodass es von jeder Handelsplattform verwendet werden kann. Die `Trade` zeigt dem Verkäufer in einer Standard-Wallet eine Zuteilungsanfrage an.
* Das Daml-Paket der Chain (0.4.0 und höher, 0.5.0 fest gepinnt) enthält das `VenueTrade`  und das `FundedClaim`. Die Handelsplattform und der Verkäufer signieren für jeden Handel das `VenueTrade` .
* Der Käufer zahlt über das Gateway. Die Zuteilung des Verkäufers wird in derselben Canton-Transaktion wie die Zahlung ausgeführt, und anschließend beansprucht der Käufer den Wrapped Token mit einem `FundedClaim`.

Am 27.10.2026 um 15:55 UTC lief es auf DevNet: Der Canton-Token TKB wurde gegen den ERC-20-Token TKA getauscht. Die Zahlung des Käufers ist in Block 16816 in einem einzigen Canton-Update enthalten, und der Anspruch des Käufers in Block 16823. Eine Zahlung unterhalb des Handelsbetrags wurde aus Block 16834 ausgeschlossen und bewegte nichts. Der Explorer führt Swaps unter [`/swaps`](https://ostia.devnet.romeprotocol.xyz/swaps) auf, und `GET /api/swaps` gibt sie zurück.

Auf DevNet wird der Builder mit der Party der Handelsplattform gestartet, sodass Rome eine Handelsplattform hinzufügt. Die Befehle zum Ausführen eines Swaps finden sich in der Demo des Repositorys – für ein lokales Netzwerk oder eine eigene Instanz. Ein Schritt, bei dem der Verkäufer den Handel vorschlägt, ist für die Zeit vor dem Mainnet-Start geplant.

## Ihr eigenes Netzwerk

[Eigene Ostia-Instanz ausführen](https://docs.rome.builders/de/canton-zk-evm/run-it-locally.md) startet ein lokales Canton-Netzwerk und den gesamten Stack: die Chain, den Prover oder dessen Ersatz, das Gateway und den Explorer. Darin führst du alle oben genannten Komponenten selbst aus, mit Ausnahme von Canton Coin, für das ein Canton-Network-Validator erforderlich ist. Dafür führst du Ostia auf dem Participant deines eigenen Validators aus (siehe [Eigene Ostia-Instanz ausführen](https://docs.rome.builders/de/canton-zk-evm/run-it-locally.md#run-on-an-existing-participant)). Du verwendest deine eigenen Parties und deine eigene Handelsplattform.

Eine Daml-App sieht die Legs, für die sie signiert. Jeder kann sämtliche Legs über `GET /api/legs` im Explorer einsehen.

## Wie es weitergeht

* [Anwendungsfälle](https://docs.rome.builders/de/canton-zk-evm/use-cases.md): Was diese Komponenten heute ermöglichen.
* [Bridge](https://docs.rome.builders/de/canton-zk-evm/bridge.md): die Browserseite für die vier Schritte und zum Senden auf Canton.
* [So funktioniert es](https://docs.rome.builders/de/canton-zk-evm/how-it-works.md): ein Block – von der Transaktion bis zum Canton-Commit.


---

# 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/de/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.
