Message Retrieval

eth_getBlockMessages

Get all messages from a specific block.

Parameters

{
  "blockNumber": "0x1234" // Block number (hex) or "latest"
}

Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "blockNumber": "0x1234",
    "blockHash": "0x...",
    "messages": [
      {
        "hash": "0x...",
        "sender": "0x...",
        "payload": "0x...",
        "timestamp": "0x...",
        "signature": "0x...",
        "bid": "0x0"
      }
    ]
  }
}

eth_getMessageByHash

Get a specific message by its hash.

Parameters

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

Response

{
  "hash": "0x...",
  "sender": "0x...",
  "payload": "0x...",
  "timestamp": "0x...",
  "signature": "0x...",
  "bid": "0x0",
  "blockNumber": "0x1234",
  "blockHash": "0x..."
}

eth_getMessagesBySender

Get messages from a specific address.

Parameters

{
  "address": "0x...",
  "fromBlock": "0x0",
  "toBlock": "latest",
  "limit": "0x64" // Optional: max results (default 100)
}

Response

{
  "messages": [...],
  "total": "0x..."
}

eth_getMessageQueueSize

Check current queue status.

Parameters

None.

Response

{
  "totalSize": "0x...", // Total pending messages
  "pmqSize": "0x...", // Priority queue count
  "smqSize": "0x...", // Standard queue count
  "topBid": "0x..." // Highest PMQ bid (wei)
}

eth_getMessageCount

Get total messages from an address.

Parameters

["0x..."] // Address

Response

"0x..." // Count (hex)