Skip to main content
POST

Overview

Recomputes an Ethereum receipt logs bloom filter from the logs you supply and compares it against an expected bloom (for example, the value published in a block header or receipt). Useful when you only care about log-topic coverage without re-verifying the full receipt trie.

Parameters

number
Network identifier. Use when the verification workflow should be tied to a specific chain context. See the Chain enumeration.

Block Context

number
required
Canonical block height where the log was emitted. Use when the verification workflow should be tied to a specific block height context.
string
required
2048-bit bloom filter represented as a 512-character hex string (no 0x prefix). Typically sourced from a block header or receipt.

Log Inputs

object[]
required
Logs that should populate the bloom filter. Order is irrelevant.
string
required
Address that emitted the log (hex string, 20 bytes, no 0x prefix). Encoded into the bloom.
string[]
required
0-4 indexed topics (hex string, 32 bytes each, no 0x prefix). Each topic contributes to the bloom. Supply an empty array for topic-less logs.

Pagination Controls

number
default:"250"
Recommended default 250; maximum 1000 to stay under ~10 MB responses.
string
Pagination cursor from a prior call.

Response Fields

Meta

object
Echo of request metadata applied to the response.
number | null
EVM chain ID echoed from the request when provided; otherwise null.

Data

object[]
Verification results.
string
Bloom filter supplied in the request.
string
Bloom filter recomputed from logs.
boolean
true when expected_bloom and computed_bloom match bit-for-bit.

Envelope Fields

number
Number of verification entries returned (currently 1).

Use Cases

  • Sanity-check log ingestion pipelines without fetching receipts or recomputing trie roots.
  • Confirm that filtered event subscriptions captured all expected topics before downstream processing.
  • Lightweight guardrail for block producers or relayers to ensure bloom accuracy after custom transformations.
Last modified on July 19, 2026