> 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/status.md).

# Status und Roadmap

Was auf Ostia DevNet live ist, das datierte Änderungsprotokoll und was als Nächstes kommt.

Ostia ist seit dem 22.10.2026 live auf dem Canton Network DevNet. Auf dem DevNet läuft Code aus dem Main-Branch des Repositorys mit dem Daml-Paket 0.5.0 und dem Twin-Paket 0.2.0 auf ZisK 1.4.0-alpha mit einem GPU-Prover. Die neueste Zeile des [Änderungsprotokolls](#changelog) unten nennt den zuletzt bereitgestellten Commit. Dies ist die einzige Seite, auf der er genannt wird; sie wird bei jeder Bereitstellung aktualisiert. Der DevNet-Validator von Rome verwendet Splice 0.10.1 mit Canton 3.7.2. Der Code ist unter der Apache License 2.0 als Open Source verfügbar in [rome-protocol/canton-zk-evm](https://github.com/rome-protocol/canton-zk-evm). Einige Seiten beschreiben die Version [v0.1.0](https://github.com/rome-protocol/canton-zk-evm/tree/v0.1.0) und geben an, wo auf dem DevNet eine neuere Version läuft.

## Was auf dem DevNet live ist

| Bereich                                           | Status auf dem DevNet                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| EVM-Chain (Chain-ID 770101)                       | Live. Deployen Sie Verträge und rufen Sie sie über den [öffentlichen RPC-Endpunkt](https://docs.rome.builders/de/canton-zk-evm/devnet.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Proofs und Canton-Commits                         | Live. Jeder Block wird bewiesen und auf Canton committet.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Explorer, APIs und Vertragsverifizierung          | Live. Siehe [Explorer](https://docs.rome.builders/de/canton-zk-evm/explorer.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Faucet                                            | Live. Alle erhalten alle 24 Stunden 1 tROME pro Adresse. Builder, die sich mit GitHub anmelden, erhalten außerdem einen Builder-Zuschuss von 100 tROME. Siehe [tROME erhalten](https://docs.rome.builders/de/canton-zk-evm/devnet.md#get-trome).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Canton-Einzahlungen, -Auszahlungen und -Zahlungen | Seit dem 25.10.2026 live, mit dem Test-Token TKB (als wTKB gewrappt). Romes Testparteien führen alle 10 Minuten eine Einzahlung, eine Zahlung und eine Auszahlung durch. Sie können diese im Explorer verfolgen. Sie liefen auch bei der lokalen Demo am 05.10.2026.                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Canton-Twins von ERC-20-Token                     | Seit dem 29.10.2026 live. TKA und WtROME existieren auf Canton als Twins über den Vault; Sperrungen und Einlösungen werden zusammen mit ihren Blöcken committet. Siehe [Einzahlungen, Auszahlungen und Zahlungen](https://docs.rome.builders/de/canton-zk-evm/deposits-withdrawals-payments.md#canton-twins-of-erc-20-tokens).                                                                                                                                                                                                                                                                                                                                                                                                               |
| Canton Coin ein- und auszahlen                    | Seit dem 29.10.2026 live. Canton Coin kommt als CC-Token auf Ostia und kann wieder zurückgeführt werden.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Bridge                                            | Die Bridge-Seite verbindet Ihre Browser-Wallet mit Ostia und – sobald sie für die jeweilige Wallet aktiviert wurde – mit Ihrer vorhandenen Canton-Wallet, um die vier möglichen Transfers zwischen Ostia und Canton durchzuführen. Solange eine Wallet nicht aktiviert ist, steht auf ihrer Schaltfläche „Demnächst verfügbar“, und über die Seite kann kein Transfer mit einem Canton-Schritt gestartet werden. Ein Datum steht nicht fest. Das Bridge-Konto (ein Canton-Konto, das aus einer Wallet-Signatur erstellt wird) war vom 08.11.2026 an in Betrieb und wurde am 17.11.2026 außer Betrieb genommen. Test-tROME erhalten Sie über das Faucet des Explorers. Siehe [Bridge](https://docs.rome.builders/de/canton-zk-evm/bridge.md). |
| Externe Aufrufe                                   | Seit dem 08.11.2026 live. Die Ansicht [Externe Aufrufe](https://docs.rome.builders/de/canton-zk-evm/explorer.md#external-calls) des Explorers zeigt die jeweils eine Canton-Transaktion pro Block sowie deren Status, Abwicklungszeit und Versuche. Die wichtigsten Kennzahlen stehen auf einer Stats-Karte; von der Startseite führt ein Link zu dieser Ansicht.                                                                                                                                                                                                                                                                                                                                                                            |
| Swaps auf Canton-Handelsplätzen                   | Am 27.10.2026 ausgeführt (ein von Rome durchgeführter Swap): Die Zahlung des Käufers und die Zuteilung an den Verkäufer wurden in einem Canton-Update committet, und der Explorer listet Swaps unter `/swaps`. Siehe [Mit Canton entwickeln](https://docs.rome.builders/de/canton-zk-evm/build-with-canton.md#a-canton-venue).                                                                                                                                                                                                                                                                                                                                                                                                               |
| Twins und Canton-Assets im Explorer               | Seit dem 30.10.2026 live. Die `/twins` -Seite und die Karte zu Canton-Assets unter Stats zeigen für jedes Asset den Bestand im Verhältnis zu den Beständen von Vault und Gateway. Siehe [Explorer](https://docs.rome.builders/de/canton-zk-evm/explorer.md#twins-and-canton-assets).                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Blöcke auf einer ruhigen Chain                    | Live. Wenn keine Arbeit ansteht, erstellt der Builder einmal pro Minute einen leeren Block.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Daml-Paket 0.5.0                                  | Seit dem 29.10.2026 live (der Chain-Eintrag wurde mit Block 28196 darauf umgestellt). Es ergänzt das Register der EVM-Verträge, die Twins, abgeleitete Einzahlungs-IDs und den Choice-Kontext des Legs.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Canton 3.7.2 auf Romes Validator                  | Seit dem 07.11.2026 live (Splice 0.10.1).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Private Übertragungen                             | Nicht angegeben. Siehe [Was bewiesen ist](https://docs.rome.builders/de/canton-zk-evm/what-is-proven.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

Die Testparteien von Rome führen die 10-Minuten-Schritte aus. Alle anderen führen ihre eigenen Schritte über eine Canton-Wallet aus, die auf der Seite [Bridge](https://docs.rome.builders/de/canton-zk-evm/bridge.md) verbunden ist, sobald diese Funktion für ihre Wallet aktiviert wurde. [Einzahlungen, Auszahlungen und Zahlungen](https://docs.rome.builders/de/canton-zk-evm/deposits-withdrawals-payments.md) erklärt, wie die Schritte und die Twins funktionieren und wie man sie beobachten kann.

## Bevorstehende Wartungsarbeiten

* **21.11.2026, 12:00 bis 16:00 UTC:** Ostia wechselt zu Canton TestNet. Während des Wechsels werden die Blöcke pausiert; tROME, Token und Verträge wechseln mit der Chain. Neue Adresse: ostia.testnet.romeprotocol.xyz. Canton Coin und andere von Canton unterstützte Token auf Ostia bleiben auf DevNet und werden nicht verschoben.

[Pausen und Wartungsarbeiten](https://docs.rome.builders/de/canton-zk-evm/devnet.md#pauses-and-maintenance) erläutert, was pausiert werden kann und wie wir über Aktualisierungen informieren.

## Bekannte Einschränkungen

Die Einschränkungen des Netzwerks sind auf [Ostia DevNet](https://docs.rome.builders/de/canton-zk-evm/devnet.md): nur HTTP-RPC, die unterstützten Methoden, Ratenbegrenzungen, ein leerer Block pro Minute bei geringer Netzwerkauslastung, Pausen und Wartungsarbeiten sowie die Möglichkeit eines Resets. Die Unterschiede zu Ethereum sind unter [Unterschiede zu Ethereum](https://docs.rome.builders/de/canton-zk-evm/evm-differences.md). Die Vertrauensgrenzen sind unter [Vertrauensmodell und Einschränkungen](https://docs.rome.builders/de/canton-zk-evm/trust-model.md) und [Was bewiesen ist](https://docs.rome.builders/de/canton-zk-evm/what-is-proven.md).

## Änderungsprotokoll

| Datum      | Was passiert ist                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 2026-10-05 | GPU-Demo in einem lokalen Netzwerk: Blöcke, die auf Canton bewiesen und bestätigt wurden, mit einer Einzahlung, Auszahlung und Zahlung über das Gateway. Siehe [Messwerte](https://docs.rome.builders/de/canton-zk-evm/measurements.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 2026-10-22 | Ostia ist auf Canton Network DevNet live. Block 1 wurde um 01:11:55 UTC bestätigt.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| 2026-10-24 | Explorer: Seiten für Contracts, Tokens, Canton, Stats und API, einschließlich Contract-Verifizierung. Gemischte Last über eine Stunde: 13.496 Transaktionen in 225 Blöcken, alle finalisiert.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| 2026-10-25 | Canton-Asset-Schritte sind auf DevNet live. Der Test-Token TKB ist registriert, seine Wrapped-Form wTKB ist auf Ostia verfügbar, und eine erste Einzahlung, Zahlung und Auszahlung wurden in den Blöcken 780, 783 und 784 (08:08 bis 08:10 UTC) bestätigt. Rome führte sie mit Testparteien aus.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| 2026-10-25 | Der Builder füllt einen Block anhand des von seinen Transaktionen verbrauchten Gases, nicht anhand des von ihnen angegebenen Gases. Für die Rohdaten der Transaktionen in einem Block gilt eine Größenbegrenzung (auf DevNet ab 11:42 UTC: 196.608 Bytes). Wenn keine Transaktionen anstehen, erstellt er einmal pro Minute einen leeren Block. Dadurch bleibt die Blockchain bei geringer Auslastung nicht mehr stundenlang ohne neuen Block. Bei gemischter Last stieg die Rate von etwa 7,5 auf etwa 10,9 tx/s.                                                                                                                                                                                                                                                                                                                                          |
| 2026-10-25 | Das Daml-Paket 0.2.0 mit der schnellen Blockprüfung wird ab Block 1453 (11:29 UTC) ausgeführt. Der Daml-Aufwand des Participants pro KB des `Advance` Arguments sank auf ein Fünftel bis ein Siebtel. Die Schritte wurden damit erneut in den Blöcken 1465, 1471 und 1473 (11:31 bis 11:34 UTC) ausgeführt.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 2026-10-25 | Messungen auf DevNet nach Version 0.2.0: einfache Übertragungen mit 64 tx/s im stabilen Betrieb während des zweiten von zwei Schüben mit je 9.000 Übertragungen (59 tx/s beim ersten Schub mit einer Größenbegrenzung von 131.072 Bytes), davon 1.428 in einem Block, bei dem die Gas-Obergrenze von 30.000.000 greift; die Canton-Bestätigung dauerte bei diesem Schub am 95. Perzentil 8,6 s. Die gemischte Last wurde seit Version 0.2.0 nicht erneut gemessen. Siehe [Messwerte](https://docs.rome.builders/de/canton-zk-evm/measurements.md).                                                                                                                                                                                                                                                                                                          |
| 2026-10-26 | Daml-Paket 0.3.0 ab 22:01 UTC.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 2026-10-27 | Daml-Paket 0.4.0 ab 15:44 UTC: Es ergänzt `VenueTrade` und `FundedClaim`. Um 15:55 UTC tauschte ein Canton-Venue den Canton-Token TKB gegen den ERC-20-Token TKA: Die Zahlung des Käufers ist in Block 16816 enthalten, in einem Canton-Update zusammen mit der Zuteilung an den Verkäufer, und der Anspruch des Käufers ist in Block 16823 enthalten.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 2026-10-27 | Das Gas-Limit pro Block auf DevNet wurde von 30.000.000 auf 60.000.000 erhöht und die Byte-Begrenzung für die Transaktionen eines Blocks auf 393.216. Ab Block 15573 (12:02 UTC) wurde die Blockchain auf ZisK 1.3.2-alpha mit einem neuen Programmschlüssel umgestellt.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 2026-10-28 | Der Osaka-Fork wurde auf DevNet aktiviert (12:00 UTC). Eine Transaktion darf höchstens 2^24 Gas verbrauchen. Der Builder wurde auf einen einzelnen GPU-Prover umgestellt.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 2026-10-29 | Canton-Assets in beide Richtungen sind live. Das Daml-Paket 0.5.0, der Vault und der Twin-Registry-Service wurden in Betrieb genommen. ERC-20-Twins (TKA, WtROME) wurden über den Vault gesperrt und eingelöst, und Canton Coin wurde als wCC auf Ostia übertragen und wieder zurück.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 2026-10-30 | Die Seite `/twins` im Explorer und die Karte zu Canton-Assets unter Stats wurden live geschaltet (10:29 UTC).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| 2026-11-04 | Die Blockchain lief vom 28.10.2026, 07:42 UTC, bis zum 04.11.2026, 18:37 UTC ohne Ausfall. Am 04.11.2026 kam es zu drei Präemptionen von Maschinen, die sich jeweils nach etwa 7 Minuten selbstständig erholten. Außerdem pausierte die Blockchain kurzzeitig während des geplanten 15-minütigen Validator-Upgrades auf Splice 0.10.0 mit Canton 3.7.1, das um 23:59 UTC abgeschlossen wurde.                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| 2026-11-05 | Der Code von Ostia, Commit `2857b00`, wurde um 01:09 UTC auf DevNet bereitgestellt.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| 2026-11-07 | Der DevNet-Validator von Rome wurde auf Splice 0.10.1 mit Canton 3.7.2 aktualisiert.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 2026-11-08 | Ostias Code, Commit `c350f87`, um 01:40 UTC auf DevNet bereitgestellt: die Bridge-Seite, der Kontodienst, die Annahme von Twins (Twin-Paket 0.2.0) und paginierte Canton-Lesevorgänge. Jeder mit einer Browser-Wallet kann ein Canton-Konto eröffnen und Token zwischen Ostia und Canton übertragen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 2026-11-08 | Ostias Code, Commit `24f8322`, um 07:42 UTC auf DevNet bereitgestellt: Eine Canton-Coin-Einzahlung, die nicht mehr abgewickelt werden kann, lässt sich über die Bridge-Seite zurückholen. Eine Sendung, auf die die Wallet nicht reagiert hat, wird zurückgehalten und mit Ostia abgeglichen, bevor sie erneut gesendet wird. Außerdem weist die Seite Beträge zurück, die der Builder nicht abwickeln kann.                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| 2026-11-08 | Ostias Code, Commit `43f252c`, um 18:53 UTC auf DevNet bereitgestellt: Der Explorer zeigt den Canton-Commit jedes Blocks unter `/canton`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 2026-11-08 | Ostias Code, Commit `37a243a`, um 22:06 UTC auf DevNet bereitgestellt: externe Aufrufe in der Kopfzeile des Explorers, auf „Statistiken“ und auf der Startseite. Die Bridge fordert zuerst Test-tROME an, zeigt das Kontopanel an und akzeptiert Beträge wie `.5`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| 2026-11-09 | Ostias Code, Commit `7e6d040`, um 01:46 UTC auf DevNet bereitgestellt: Token über die Bridge-Seite auf Canton senden, empfangene Token annehmen und eine nicht angenommene Sendung zurückholen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 2026-11-09 | Ostias Code, Commit `eee1404`, um 11:37 UTC auf DevNet bereitgestellt: Canton-Konten werden als `rome::1220...`bezeichnet, beim Neuladen bleibt die Wallet verbunden und das Canton-Konto in diesem Browser geöffnet, und der Faucet gewährt Buildern, die sich mit GitHub anmelden, einen Builder-Zuschuss von 100 tROME.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 2026-11-09 | Ostias Code, Commit `6fa3673`, um 16:15 UTC auf DevNet bereitgestellt, ohne sichtbare Änderungen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 2026-11-09 | Ostias Code, Commit `c835a68`, um 23:09 UTC auf DevNet bereitgestellt: eine Schaltfläche „Mit GitHub anmelden“ für den Builder-Zuschuss auf der Faucet-Seite und der Bridge.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| 2026-11-16 | Ostias Code, Commit `734b316` (Branch `devnet-switch-20261116`: Main bis einschließlich #214, ohne #202), läuft auf DevNet: ZisK 1.4.0-alpha mit einem neuen Programmschlüssel (Schlüssel C) ab Block 71864 (ab 13:31 UTC final). Mit Schlüssel B wurden die Blöcke 15573 bis 71863 verifiziert, und der Explorer zeigt drei Schlüsselbereiche. Seit 13:35 UTC prüfen Romes Sidecars Proofs ausschließlich mit Schlüssel C. Die Proofs dauern etwa 7,0 s statt etwa 7,5 s mit ZisK 1.3.2-alpha und sind weiterhin 1.344 Byte groß.                                                                                                                                                                                                                                                                                                                          |
| 2026-11-17 | Ostias Code, Commit `a385434`, um 08:44 UTC auf DevNet bereitgestellt. Das Bridge-Konto und sein Dienst wurden eingestellt: Auf der Bridge-Seite gibt es keine Anmeldeoption mehr, aus Wallet-Signaturen werden keine Canton-Schlüssel erzeugt, im Browser werden keine Schlüssel gespeichert und es gibt keinen Canton-Coin-Faucet. Die Seite verbindet stattdessen die bereits vorhandene Canton-Wallet, die Wallet für Wallet aktiviert wird; bis dahin lautet die Beschriftung der Schaltfläche „Demnächst verfügbar“. Die vom Bridge-Konto erstellten Konten bleiben auf Canton DevNet bestehen, bis DevNet zurückgesetzt wird, und kein Dienst akzeptiert ihren Schlüssel. Der Explorer führt nur Transaktionen als ausstehend auf, die in der letzten Stunde gesendet wurden. Siehe [Bridge](https://docs.rome.builders/de/canton-zk-evm/bridge.md). |
| 2026-11-17 | Ostias Code, Commit `f68103d`, um 09:10 UTC auf DevNet bereitgestellt, ohne sichtbare Änderungen: Der Explorer läuft jetzt auf Node 24.22.3 und seine Datenbank auf PostgreSQL 16.16.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 2026-11-18 | Der Synchronizer von DevNet wechselte um 14:00 UTC zu Protokollversion 37. Ostia lief damit weiter; die längste Pause zwischen finalen Blöcken betrug 72 s.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 2026-11-19 | Ostias Code, Commit `846de43`, um 14:48 UTC auf DevNet bereitgestellt: reth 2.11.0, ausgeführt als Nicht-Root-Benutzer ohne Berechtigungen und mit schreibgeschütztem Root-Dateisystem. Die Erzeugung neuer Blöcke pausierte für weniger als zwei Minuten.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

## Noch nicht

Diese Funktionen sind nicht implementiert, und hier wird kein Termin versprochen. Sie stammen aus dem Abschnitt „Nicht jetzt“ des [Designs](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/docs/DESIGN.md#not-now).

* Ziele für Durchsatz und Blockzeit.
* Mehr als ein Builder.
* Erzwungene Aufnahme.
* Datenschutz.
* Absicherung der Verwahrung. Die Gateway-Partei sollte mehr als nur den Teilnehmer des Betreibers benötigen.
* Canton MainNet.

## Problem melden

* Sicherheitsprobleme: Melde sie vertraulich über GitHub, wie in [SECURITY.md](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/SECURITY.md). Erstelle kein öffentliches Issue.
* Fehler und Fragen: Erstelle ein Issue im [Repository](https://github.com/rome-protocol/canton-zk-evm/issues).
* Frag im Rome [Discord](https://discord.gg/vZ9rnCdNSB).


---

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