> 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/how-it-works.md).

# So funktioniert es

Verfolge einen Ostia-Block von reth über das Proving bis zu seinem Canton-Commit.

Der Builder läuft ständig. Sobald Transaktionen warten, schneidet er einen Block, lässt ihn beweisen und übermittelt ihn an Canton. Standardmäßig ist im Code jeweils nur ein Block gleichzeitig in Bearbeitung; auf DevNet sind es bis zu zwei, mit einem GPU-Prover. Die Blöcke werden auf Canton weiterhin der Reihe nach bestätigt. Auf DevNet schneidet der Builder einen leeren Block – einen Heartbeat (standardmäßig im Code deaktiviert) –, wenn 60 Sekunden lang kein Block erstellt wurde. So wird auch auf einer ruhigen Chain ungefähr einmal pro Minute ein Block erstellt. Canton entscheidet, ob jeder Block zum nächsten Head der Chain wird. Ein EVM-Block und die Canton-Aktionen, die er aufgezeichnet hat, werden in derselben Transaktion bestätigt.

Diese Seite beschreibt Release `v0.1.0` und, sofern angegeben, was derzeit auf DevNet läuft. [Status](https://docs.rome.builders/de/canton-zk-evm/status.md) nennt den Commit, der auf DevNet läuft. Lies das vollständige [Design](https://github.com/rome-protocol/canton-zk-evm/blob/main/docs/DESIGN.md). Um deine eigene Transaktion durch diese Schritte zu verfolgen, springe zu [Von deiner Transaktion bis zur Finalisierung auf Canton](#from-your-transaction-to-final-on-canton).

```mermaid
flowchart TD
    W["EVM-Transaktionen"] --> Q["Öffentlicher RPC: zeigt nur finale Blöcke"]
    Q --> R["reth erstellt Blöcke bei Bedarf"]
    R --> B["Builder liest Gateway-Aktionen und ermittelt die zugehörigen Canton-Verträge"]
    B -->|"Eine Aktion kann nicht abgewickelt werden: Transaktion auslassen und neu erstellen"| R
    B -->|"Alle Aktionen können abgewickelt werden"| P["ZisK beweist den Block"]
    P --> A["Advance: Block, Beweis und Aktionen in einer Canton-Transaktion"]
    A --> S["Externer Aufruf: Sidecars prüfen Beweis und Gateway-Zustand"]
    S --> D["Daml prüft den Head und wickelt die Aktionen ab"]
    D --> C["Canton bestätigt den Block und seine Aktionen gemeinsam"]
    C --> F["reth markiert den Block als final"]
    F --> Q
    C --> X["Der Explorer-Indexer liest den Blockdatensatz und gleicht ihn mit reth ab"]
```

## Auf dem Head von Canton aufbauen

Wallets senden EVM-Transaktionen an den öffentlichen RPC, der sie an reth weiterleitet. Der RPC zeigt nur Blöcke an, die auf Canton final sind; ein Receipt erscheint also, sobald der Block final ist. Der bereitgestellte Launcher lässt die Peer-Erkennung deaktiviert. reth erstellt einen Block, wenn der Builder einen anfordert.

Zuerst liest der Builder den aktiven `ZkChain` -Vertrag auf Canton. Er setzt den Head, den Safe-Block und den finalisierten Block von reth auf diesen bestätigten Head. Ausstehende Transaktionen wählt er nach Preis aus und hält dabei die Nonce-Reihenfolge jedes Absenders ein. Seit dem 25.10.2026 füllt er den Block anhand des von den Transaktionen verbrauchten Gases, das reth ermittelt, und nicht anhand der angegebenen Gaslimits: Wallets geben oft etwa das Dreifache des tatsächlich verbrauchten Gases an. Würden die angegebenen Limits gezählt, wäre der Block bereits bei etwa einem Drittel seiner Kapazität voll. Ein Block endet am Gaslimit. Auf DevNet bietet der Builder reth normalerweise höchstens 393.216 rohe Byte an Transaktionen an, da der Aufwand des Teilnehmers für einen Block mit dessen Größe steigt. Eine zu große erste Transaktion bietet er dennoch an, damit sie nicht endlos warten muss. Der Builder weist reth an, mit genau dieser expliziten Transaktionsliste einen Block zu erstellen.

Eine EVM-Transaktion, die eine Canton-Aktion erfordert, ruft das Gateway auf. Das Gateway zeichnet eine Aktion auf und integriert sie in einen fortlaufenden Hash für den Block. Der Builder liest die Gateway-Ereignisse in Log-Reihenfolge und ermittelt die für jede Aktion benötigten Canton-Verträge.

Wenn eine Zuteilung nicht mehr besteht, ein Empfänger Auszahlungen noch nicht akzeptiert hat oder ein anderer erforderlicher Vertrag fehlt, lässt der Builder die Transaktion und alle späteren Transaktionen dieses Absenders aus. Er setzt reth auf den Head von Canton zurück und erstellt den Block erneut. Diese Prüfungen erfolgen vor dem Beweisen. In der [README des Builders](https://github.com/rome-protocol/canton-zk-evm/blob/main/builder/README.md) sind die Prüfungen für jede Aktion aufgeführt.

## Den Block beweisen

Der Builder speichert den Block und den Ausführungszeugen von reth. Das Eingabetool kombiniert Block, Zeuge und Genesis-Daten zu den Eingaben für den Prover. ZisK führt den Guest aus, der den Block anhand der festgelegten Regeln der Chain validiert.

Der Prover gibt einen 1.344 Byte großen, umhüllten Beweis zurück, der an den Block-Hash gebunden ist. Der Builder übermittelt `Advance` mit Header, Transaktionen, Beweis, Aktionen sowie den Account- und Storage-Proofs des Gateways am State-Root des Blocks.

## In einer Transaktion prüfen und abwickeln

Jeder bestätigende Teilnehmer führt ein Sidecar aus. Der externe Aufruf von Canton sendet den Block zur `verify`-Prüfung an das Sidecar des Teilnehmers. Es prüft den Beweis, den festgelegten Programmschlüssel und das ZisK-Release, den Hash des Headers und den Root der Transaktionsliste.

Auf Ostia DevNet betreibt Rome den einzigen Teilnehmer, der alle Ostia-Parteien hostet. Daher ist sein Sidecar der einzige Bestätiger, und der Beweis wird von Romes eigenem Node geprüft. Der Synchronizer von Canton ordnet die Blöcke und sieht den Beweis nicht. Das lokale Demo-Netzwerk hat zwei bestätigende Teilnehmer. [Vertrauensmodell und Einschränkungen](https://docs.rome.builders/de/canton-zk-evm/trust-model.md) beschreibt, was sich dadurch ändert.

Daml prüft die Antwort anhand von `ZkChain`: Der Parent muss der aktuelle Head sein, die Nummer muss die nächste sein, und Gaslimit sowie Gasverbrauch müssen innerhalb des Limits liegen. Daml vergleicht die Antworten des Sidecars; den Zero-Knowledge-Beweis selbst verifiziert es nicht.

Daml schreibt dann für jede Aktion eine Zeile anhand der darin genannten Canton-Verträge. ID, Burner und Betrag einer Auszahlung stammen vom Builder; der bewiesene Hash bindet sie an die Aufzeichnung im Block. Die Funktion `legs` prüft die Account- und Storage-Proofs des Gateways, hasht diese Zeilen der Reihe nach und vergleicht das Ergebnis mit dem Gateway-Wert im bewiesenen Zustand. Ein Block ohne Aktionen muss dieselbe Prüfung mit einer leeren Liste bestehen.

Daml wickelt die Aktionen der Reihe nach ab und erstellt das `BlockRecord` und den nächsten `ZkChain`. Canton schreibt diese Änderungen gemeinsam fest. Schlägt eine Prüfung oder Abwicklung fehl, wird nichts festgeschrieben. Indem Canton den einen Zustandsvertrag der Chain verbraucht, wird es zur maßgeblichen Instanz für die Blockreihenfolge. Die vollständige [Daml-Schnittstelle](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/daml/README.md) und [Prüfungen des Sidecars](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/sidecar/README.md).

## Der Vault und die Twins

Neben dem ersten Gateway führt der Chain-Datensatz die EVM-Verträge auf, denen er vertraut – jeweils ein Gateway oder ein Vault – zusammen mit dem Hash ihres Codes. Ein Block enthält die Legs aller registrierten Gateways, und Daml prüft den Code-Hash jedes Gateways anhand des im Block enthaltenen Kontonachweises. Ein Vault hat keine eigenen Legs: Seine Sperrungen und Freigaben sind Gateway-Zahlungen, und Daml vertraut seiner Adresse als Zahlungsempfänger oder -absender. Der Confirmer prüft den Code eines Vaults, bevor er den Eintrag akzeptiert. Ein neuer Eintrag wird hinzugefügt, wie ein Programm geändert wird: Der Betreiber und das Gateway schlagen ihn vor, und der Confirmer akzeptiert ihn.

Der Vault ist ein kleiner Vertrag, der die ERC-20-Token hinter den Canton-Twins verwahrt. Er hat weder Eigentümer noch Schlüssel und kann nicht aktualisiert werden. Eine Sperrung ist eine einfache Gateway- `pay` Zahlung mit dem Vault als Empfänger. Eine Freigabe erfolgt über `release(ref, token, to, amount)`, wobei der Vault über das Gateway gegen eine ID auszahlt, die es bei keiner anderen Zahlungsart geben kann. Canton wickelt die Zahlung nur gegen eine vom Inhaber signierte Einlösungsanfrage ab.

Ein Twin ist ein Canton-Token für einen ERC-20, der von der Gateway-Partei verwaltet wird. Der Chain-Datensatz legt jeden Twin fest: die Token-Adresse, seine Dezimalstellen und den Regelvertrag, der ihn prägt, verbrennt und überträgt. `Advance` prägt einen Twin nur gegen eine Sperrung, die durch den Nachweis festgelegt wurde, und verbrennt ihn nur gegen eine signierte Einlösungsanfrage.

Der Twin-Registrierungsdienst befindet sich neben dem Builder. Ein Zahler teilt ihm vor der Zahlung den Empfänger und eine `ref` mit. Der Dienst antwortet mit der Sperrungs-ID, und der Builder liest dieselben Angaben aus, um die Sperrung an den Block anzuhängen. Außerdem stellt er die Registry-API des Token-Standards für die Twins bereit, sodass eine Wallet, deren Validatoren das Twin-Paket geprüft haben, sie versenden kann. Der Dienst verwahrt keinen Schlüssel und schreibt nichts nach Canton, und `Advance` prüft, ob sich die ID aus den Angaben ergibt. Die Abläufe finden Sie unter [Einzahlungen, Auszahlungen und Zahlungen](https://docs.rome.builders/de/canton-zk-evm/deposits-withdrawals-payments.md#canton-twins-of-erc-20-tokens) .

## Wenn Canton ablehnt

Nachdem Canton den Block festgeschrieben hat, markiert der Builder ihn in reth als final. Lehnt Canton ihn ab, setzt der Builder reth auf Cantons letzten festgeschriebenen Block zurück und sendet die Transaktionen des abgelehnten Blocks zurück in den Pool. Im nächsten Block werden ihre Legs erneut geprüft. Eine Zahlung, deren Zuweisung zurückgenommen wurde, wird ausgelassen. Nach zwei aufeinanderfolgenden abgelehnten Blöcken vermutet der Builder, dass die darin enthaltene Transaktion die Ursache war, und lässt sie während einer Abkühlphase aus.

Geht die Antwort auf die Übermittlung verloren, kann der Befehl trotzdem festgeschrieben worden sein. Bevor der Builder ihn übermittelt, zeichnet er den aktuellen Ledger-Endpunkt auf. Anschließend liest er ab diesem Punkt den Abschlussstatus des Befehls aus. Ein erfolgreicher Abschluss gilt als Festschreibung. Ein fehlgeschlagener Abschluss gilt als Ablehnung.

Cantons Head kann eine Festschreibung bestätigen, aber für sich allein niemals „nicht festgeschrieben“ anzeigen. Liegt kein Abschluss vor, entscheidet der Builder erst dann auf „nicht festgeschrieben“, wenn 300 Sekunden Canton-Zeit vergangen sind (`CZE_RESOLVE_SECONDS`). Bis dahin erstellt er keine Blöcke und lässt reth unverändert. Diese Wiederherstellungsregeln stehen in der [README des Builders](https://github.com/rome-protocol/canton-zk-evm/blob/main/builder/README.md#what-one-run-does).

## Von Ihrer Transaktion bis zum finalen Status auf Canton

1. Sie senden eine Transaktion an den öffentlichen RPC. Dort wartet sie im Pool auf den nächsten Block.
2. Der Builder erstellt einen Block, sobald eine Transaktion wartet und ein Platz frei ist (standardmäßig lässt der Code einen Block gleichzeitig in Bearbeitung; DevNet verarbeitet bis zu zwei). Solange die Chain ausgelastet war, folgte ein neuer Block auf den vorherigen im Median alle 16,6 Sekunden (24 Stunden bis 2026-10-25 01:34 UTC).
3. ZisK erstellt einen Beweis für den Block. Bei der einstündigen Auslastungsmessung am 2026-10-24 dauerte die Beweiserstellung für Blöcke mit 11 bis 100 Transaktionen im Median 9,03 Sekunden.
4. Der Datensatz des Blocks wird zusammen mit seinem Beweis auf Canton festgeschrieben. Diese Festschreibung macht den Block final; anschließend zeigt der öffentliche RPC Ihren Beleg an.

In derselben Stunde dauerte es vom Eingang einer Transaktion beim RPC bis zur finalen Festschreibung ihres Blocks auf Canton im Median 19,5 Sekunden und am 95. Perzentil 27,1 Sekunden. Ein Beleg braucht länger als bei den meisten Chains. Daher benötigen Tools, die darauf warten, ein langes Timeout.

[Messungen](https://docs.rome.builders/de/canton-zk-evm/measurements.md) definiert die einzelnen Zeitintervalle und listet die Durchläufe auf. Öffnen Sie im Explorer Ihre Transaktion und anschließend den zugehörigen Block, um die Canton-Aktualisierung mit dem Datensatz anzuzeigen. [Explorer](https://docs.rome.builders/de/canton-zk-evm/explorer.md) zeigt, wie.


---

# 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/how-it-works.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.
