> 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/entwicklerleitfaden/websocket-subscriptions.md).

# WebSocket-Abonnements

Abonniere Rome-EVM-Ereignisse über WebSocket — eth\_subscribe mit newHeads und logs, sofort einsatzbereit mit ethers; mit viem verwende Polling.

Rome-EVM-Endpunkte unterstützen Ethereum-WebSocket-Abonnements (`eth_subscribe` / `eth_unsubscribe`) über `wss://`. Verbinden Sie sich mit demselben Host wie beim HTTPS-RPC, mit dem `wss://` Schema:

```
wss://<chain>.<network>.romeprotocol.xyz/
```

Das ist, was der `ethers` `WebSocketProvider` im Hintergrund verwendet, also `.on('block')` und `contract.on(event)` funktioniert sofort. `viem` benötigt eine Einstellung, beschrieben im [viem](#viem) Abschnitt.

## Abonnementtypen

| Typ                      | Wird ausgelöst bei                              | Verwenden für                                                                    |
| ------------------------ | ----------------------------------------------- | -------------------------------------------------------------------------------- |
| `newHeads`               | jeden neuen Block                               | Block-Ticker, das Aktualisieren von Guthaben/Nonces, pro-Block-Bots, Indexer     |
| `logs`                   | passende Ereignisse (nach `Adresse` / `Topics`) | Reaktionen auf die Ereignisse Ihres Contracts, Relayer/Bridges, Trading-Bots     |
| `newPendingTransactions` | —                                               | akzeptiert, aber sendet niemals etwas aus (Rome hat keinen öffentlichen Mempool) |

## ethers (v6)

```javascript
import { ethers } from "ethers";

const provider = new ethers.WebSocketProvider(
  "wss://hadrian.testnet.romeprotocol.xyz/"
);

// newHeads
provider.on("block", (blockNumber) => {
  console.log("new block", blockNumber);
});

// logs — auf ein Contract-Ereignis reagieren
const contract = new ethers.Contract(address, abi, provider);
contract.on("Transfer", (from, to, value) => {
  console.log("Transfer", from, to, value.toString());
});
```

## viem

`viem`'s `webSocket` transport registriert ein Abonnement nur, wenn die ID eine Zeichenkette ist. Rome gibt eine Zahl zurück, also `watchBlocks` über ein gewöhnliches `webSocket` erhält der transport nichts. Übergeben Sie `poll: true` und `viem` Abfragen stattdessen über die Verbindung (geprüft mit `watchBlocks`), oder verwenden Sie `ethers` für Push-Updates.

```javascript
import { createPublicClient, webSocket } from "viem";

const client = createPublicClient({
  transport: webSocket("wss://hadrian.testnet.romeprotocol.xyz/"),
});

const unwatch = client.watchBlocks({
  poll: true,
  onBlock: (block) => console.log("new block", block.number),
});

client.watchEvent({
  poll: true,
  address,
  onLogs: (logs) => console.log(logs),
});
```

## Rohes JSON-RPC

```json
→ {"jsonrpc":"2.0","id":1,"method":"eth_subscribe","params":["newHeads"]}
← {"jsonrpc":"2.0","id":1,"result":8704545703806774}            // Abonnement-ID
← {"jsonrpc":"2.0","method":"eth_subscription","params":{"subscription":8704545703806774,"result":{…block…}}}
```

Die Abonnement-ID ist eine JSON-Zahl, keine Hex-Zeichenkette, und die Benachrichtigungen tragen dieselbe Nummer. `ethers` handhabt dies für Sie. `viem`'s `webSocket` transport akzeptiert nur eine String-ID, also verwirft er die Benachrichtigungen (siehe [viem](#viem)). Wenn Sie einen rohen Client schreiben, vergleichen Sie die IDs als Zahlen und geben Sie die Zahl an `eth_unsubscribe`.

Für `logs`, übergeben Sie als zweiten Parameter ein Filterobjekt:

```json
{"jsonrpc":"2.0","id":1,"method":"eth_subscribe","params":["logs",{"address":"0x…","topics":["0x…"]}]}
```

## Hinweise

* Abonnements senden Updates, sobald neue Blöcke erzeugt werden (die Latenz liegt in der Größenordnung einer Blockzeit).
* Behandeln Sie bei lang laufenden Verbindungen Reconnects in Ihrem Client – Standard für jedes WebSocket-RPC.


---

# 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/entwicklerleitfaden/websocket-subscriptions.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.
