Network & Consensus (pod_)

Network & Consensus (pod_) exposes Pod-specific endpoints that provide visibility into the network’s validator set and consensus process. These APIs surface data that is not available through standard Ethereum JSON-RPC methods, such as validator committees and aggregated voting information.

This interface is intended for infrastructure providers, validators, and light clients that need to inspect, monitor, or verify the state of the Pod network.

📝 This is a JSON-RPC 2.0 API. The request path is not important; the method to execute is defined by the method field in the request body. You can send all requests to /, and any path after / is optional and used only for documentation clarity.

Send Raw Transaction (With Attestation Feedback)

post

Submits a signed EIP-1559 transaction and waits for validator attestations, returning tx_hash, success count, and any rejection errors from validators.

Parameters:

  • signed_tx (string): Signed RLP-encoded transaction data

  • timeout_secs (integer, optional): Max seconds to wait for attestations. Default 10.

Body
jsonrpcstringRequiredDefault: 2.0
methodstringRequiredDefault: pod_sendRawTransaction
idintegerRequiredDefault: 1
paramsarrayRequired

Parameters:

  1. signed_tx (string): Signed RLP-encoded transaction data
  2. timeout_secs (integer, optional): Max seconds to wait for attestations
Example: ["0x02f8...",10]
Responses
chevron-right
200

Object with tx_hash, successes count, and errors array

application/json
post
/pod_sendRawTransaction
200

Object with tx_hash, successes count, and errors array

Get Validator Committee

post

Returns information about the current validator committee.

Body
jsonrpcstringRequiredDefault: 2.0
methodstringRequiredDefault: pod_getCommittee
idintegerRequiredDefault: 1
paramsarrayOptionalDefault: []
Responses
chevron-right
200

Committee information

application/json
post
/pod_getCommittee
200

Committee information

Get Vote Batches

post

Retrieves vote batches from validators within a specified range.

Body
jsonrpcstringRequiredDefault: 2.0
methodstringRequiredDefault: pod_getVoteBatches
idintegerRequiredDefault: 1
paramsinteger[]Required

Parameters:

  1. from_sequence (integer, nullable): Starting sequence number. None = start from 0
  2. to_sequence (integer, nullable): Ending sequence number. None = up to latest
Example: [0,1000]
Responses
chevron-right
200

Array of vote batch objects

application/json
post
/pod_getVoteBatches
200

Array of vote batch objects

Get Bridge Claim Proof

post

Returns a proof for claiming bridged assets on an external chain. Use this after a deposit transaction has been executed on Pod to obtain the committee attestations and proof data needed to call claim on the external bridge contract.

Body
jsonrpcstringRequiredDefault: 2.0
methodstringRequiredDefault: pod_getBridgeClaimProof
idintegerRequiredDefault: 1
paramsstring[]Required

Parameters:

  1. tx_hash (bytes32): Transaction hash of the deposit transaction
Example: ["0xf74e07ff80dc54c7e894396954326fe13f07d176746a6a29d0ea34922b856402"]
Responses
chevron-right
200

Bridge claim proof for the external chain claim call

application/json
post
/pod_getBridgeClaimProof

Last updated