WebSocket-Abonnements

Die Rome-EVM-Endpunkte unterstützen Ethereum-WebSocket-Abonnements (eth_subscribe / eth_unsubscribe) über wss://. Verbinde dich mit demselben Host wie der HTTPS-RPC, mit dem wss:// Schema:

wss://<chain>.testnet.romeprotocol.xyz/

Das ist, was ethers / viem WebSocketProvider unter der Haube verwendet, also .on('block'), contract.on(event), und viem's watchEvent / watchBlocks funktioniert out of the box.

Abonnementtypen

Typ	Wird ausgelöst bei	Verwenden für
newHeads	jeden neuen Block	Block-Ticker, Aktualisieren von Guthaben/Nonces, blockweise Bots, Indexer
Logs	passende Ereignisse (nach address / topics)	Reagieren auf die Ereignisse deines Vertrags, Relayer/Bridges, Trading-Bots
newPendingTransactions	—	akzeptiert, gibt aber nie etwas aus (Rome hat keinen öffentlichen Mempool)

ethers (v6)

import { ethers } from "ethers";

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

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

// Logs — reagiere auf ein Vertragsereignis
const contract = new ethers.Contract(address, abi, provider);
contract.on("Transfer", (from, to, value) => {
  console.log("Transfer", from, to, value.toString());
});

viem

import { createPublicClient, webSocket } from "viem";

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

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

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

Rohes JSON-RPC

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

Für Logs, übergib als zweiten Parameter ein Filterobjekt:

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

Hinweise

• Abonnements senden Updates, wenn neue Blöcke erzeugt werden (die Latenz liegt in der Größenordnung einer Blockzeit).

• Für langlebige Verbindungen solltest du Wiederverbindungen in deinem Client behandeln — Standard für jede WebSocket-RPC-Verbindung.