Class BlockHashFilter

Predicate filter on the block.hash query parameter of the contract-results endpoints (/api/v1/contracts/results, /api/v1/contracts/{id}/results). Scopes the returned results to a single block by its hash.

Inheritance

object

BlockHashFilter

Implements

IMirrorFilter

IMirrorQueryParameter

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Namespace: Hiero.Mirror.Filters

Assembly: Hiero.dll

Syntax

public sealed class BlockHashFilter : IMirrorFilter, IMirrorQueryParameter

Remarks

The wire format accepts either a 32-byte EVM-form block hash (64 hex chars; the first 32 bytes of the 48-byte hash) or a 48-byte Hedera SHA-384 block hash (96 hex chars). Use Is(EvmHash) when you already have an EvmHash; use Is(ReadOnlyMemory<byte>) for raw bytes (EVM 32-byte or Hedera 48-byte). Construct via the static factories; the ctor is private.

Properties

Name

The query parameter name recognized by the remote mirror node.

Declaration

public string Name { get; }

Property Value

Type	Description
string

Value

The value of the query parameter sent to the mirror node — a 0x-prefixed lowercase hex string with 64 or 96 hex digits (66 or 98 characters including the prefix).

Declaration

public string Value { get; }

Property Value

Type	Description
string

Methods

Is(EvmHash)

Records whose block.hash equals the given 32-byte EVM block hash.

Declaration

public static BlockHashFilter Is(EvmHash evmHash)

Parameters

Type	Name	Description
EvmHash	evmHash	The 32-byte EVM-form block hash (the first 32 bytes of the 48-byte SHA-384 record-file hash).

Returns

Type	Description
BlockHashFilter

Is(ReadOnlyMemory<byte>)

Records whose block.hash equals the given raw hash bytes. Accepts 32-byte EVM hashes and 48-byte Hedera SHA-384 hashes; any other length throws.

Declaration

public static BlockHashFilter Is(ReadOnlyMemory<byte> hash)

Parameters

Type	Name	Description
ReadOnlyMemory<byte>	hash	The block hash bytes — must be 32 or 48 bytes.

Returns

Type	Description
BlockHashFilter

Exceptions

Type	Condition
ArgumentOutOfRangeException	Thrown when hash is neither 32 nor 48 bytes long.

Implements

IMirrorFilter

IMirrorQueryParameter