Langganan WebSocket

Endpoint Rome EVM mendukung langganan Ethereum WebSocket (eth_subscribe / eth_unsubscribe) melalui wss://. Hubungkan ke host yang sama seperti RPC HTTPS, dengan wss:// skema:

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

Inilah yang ethers / viem WebSocketProvider digunakan di balik layar, jadi .on('block'), contract.on(event), dan viem's watchEvent / watchBlocks langsung berfungsi.

Jenis langganan

Jenis	Dipicu pada	Gunakan untuk
newHeads	setiap blok baru	pemantau blok, penyegaran saldo/nonce, bot per blok, pengindeks
log	event yang cocok (berdasarkan alamat / topik)	merespons event kontrak Anda, relayer/jembatan, bot trading
newPendingTransactions	—	diterima tetapi tidak pernah dipancarkan (Rome tidak memiliki mempool publik)

ethers (v6)

import { ethers } from "ethers";

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

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

// log — bereaksi terhadap event kontrak
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("new block", block.number),
});

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

JSON-RPC mentah

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

Untuk log, berikan objek filter sebagai parameter kedua:

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

Catatan

• Langganan mengirim pembaruan saat blok baru diproduksi (latensinya berada pada kisaran waktu satu blok).

• Untuk koneksi jangka panjang, tangani penyambungan ulang di klien Anda — standar untuk RPC WebSocket apa pun.