BNB Smart Chain
BNB Smart Chain
Pronto para usar isso em produção?
O plano gratuito cobre projetos pessoais. O pay-as-you-go escala sem cartão de crédito.
BNB Smart Chain
O plano gratuito cobre projetos pessoais. O pay-as-you-go escala sem cartão de crédito.
BNB Smart Chain runs as chain ID 56 with BNB as its gas token, and eth_subscribe is the way to follow its ~3-second PoSA blocks as a live stream instead of by repeated requests. It opens a push-based subscription over a WebSocket connection. Subscribe to a topic, whether newHeads, logs, or newPendingTransactions, and the node pushes notifications your way the instant those events occur, which removes polling entirely. Being push-based, it has to run over a WebSocket: connect to the wss:// form of https://bsc.therpc.io/YOUR_API_KEY, and the call returns a hex subscription ID that tags every notification the node sends back.
newHeads block headers to power a real-time BNB Smart Chain dashboard that updates the instant each block seals, without any polling loop.logs for a contract address to receive its events, for example Venus market updates, the moment they are mined.newPendingTransactions to see transactions enter the BNB Smart Chain mempool before inclusion.| # | Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|---|
| 1 | subscriptionType | string | Sim | Subscription type: `newHeads` — new block headers; `logs` — matching event logs; `newPendingTransactions` — pending tx hashes; `syncing` — node sync status changes. |
| 2 | filter | object | Não | Required only for `logs` subscriptions. Same filter shape as eth_newFilter: `address` and/or `topics`. |
| Tipo | Descrição |
|---|---|
| string | Hex subscription ID. Subsequent notifications arrive as `eth_subscription` messages with `params.subscription` matching this ID. |
Try it live in the BNB Smart Chain playground.
| Código | Mensagem | Causa |
|---|---|---|
-32602 | invalid argument | Unknown subscription type or malformed filter for a logs subscription. |
-32000 | notifications not supported | Method called over an HTTP connection instead of WebSocket. |
notifications not supported error, so always connect via wss://.eth_getLogs once you are back online.logs notifications carrying removed: true; handle those explicitly so you roll back state for events that were un-mined.Parâmetros
"newHeads" | "logs" | "newPendingTransactions" | "syncing"
Required only for `logs` subscriptions. Same filter shape as eth_newFilter: `address` and/or `topics`.