Message Retrieval

eth_getBlockMessages

Get all messages from a specific block's Sidecars.

Parameters

["0x1234"]

Notes:

• Returns messages from all Lane Batches anchored in the block.

• Availability Warning: If the node has pruned the sidecar data (after window W), this call may return existing metadata (hashes) but missing payloads, or an error indicating data is pruned.

Response

Returns an array of message objects (empty array if none or pruned).

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "hash": "0x...",
      "sender": "0x...",
      "data": "0x...",
      "targetBlock": "0x...",
      "nonce": "0x...",
      "chainId": "0x1a5",
      "signature": "0x...",
      "bid": "0x0",
      "vdfCheckpoints": ["0x..."],
      "vdfCheckpointInterval": "0x...",
      "vdfIterations": "0x...",
      "vdfAlgVersion": "0x1"
    }
  ]
}

eth_getMessageByHash

Get a specific message by its hash.

Parameters

["0x..."] // Message hash

Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "hash": "0x...",
    "sender": "0x...",
    "data": "0x...",
    "targetBlock": "0x...",
    "nonce": "0x...",
    "chainId": "0x1a5",
    "signature": "0x...",
    "bid": "0x0",
    "blockNumber": "0x1234",
    "blockHash": "0x..."
  }
}

eth_getMessagesByAddress

Get messages from a specific address.

Parameters

["0x...", "0x0", "latest"]

Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "hash": "0x...",
      "sender": "0x...",
      "data": "0x...",
      "targetBlock": "0x...",
      "nonce": "0x...",
      "chainId": "0x1a5",
      "signature": "0x...",
      "bid": "0x0"
    }
  ]
}

eth_getMessageBufferStatus

Check current lane buffer status.

Parameters

None.

Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "laneCount": 8,
    "pmPending": 10,
    "smPending": 32,
    "topBid": "0x38d7ea4c68000"
  }
}