RPC API

This documentation provides detailed information about the JSON-RPC methods supported by pod.

Overview

Pod implements a JSON-RPC API that allows interaction with the network. While many methods align with the Ethereum JSON-RPC specification (methods prefixed with "eth_"), pod includes additional metadata ("pod_metadata" attribute) and pod-specific functionality (methods prefixed with "pod_").

Base URL

The API endpoint is accessible at:

https://rpc.dev.pod.network

Request Format

All requests should follow the JSON-RPC 2.0 specification:

{
    "jsonrpc": "2.0",
    "method": "method_name",
    "params": [],
    "id": 1
}

Common Response Fields

All successful responses include:

• jsonrpc: Always "2.0"

• id: The request ID

• result: The method-specific response data

• pod_metadata: Additional POD-specific information (location varies by method)

Error Handling

Error responses follow the JSON-RPC 2.0 specification:

{
    "jsonrpc": "2.0",
    "error": {
        "code": -32000,
        "message": "Error message"
    },
    "id": 1
}

Error Codes

Common error codes include:

• -32700: Parse error

• -32600: Invalid Request

• -32601: Method not found

• -32602: Invalid params

• -32603: Internal error

• -32000: Server error (various)

Methods

eth_blockNumber

Returns the latest past perfection pod timestamp in microseconds.

eth_blockNumber

post

Body

jsonrpcstringRequiredDefault: 2.0Example: 2.0

methodstringRequiredDefault: eth_blockNumberExample: eth_blockNumber

paramsstring[]RequiredDefault: []Example: []

idintegerRequiredDefault: 1Example: 1

post

HTTPcURLJavaScriptPython

POST / HTTP/1.1
Host: rpc.dev.pod.network
Content-Type: application/json
Accept: */*
Content-Length: 63

{
  "jsonrpc": "2.0",
  "method": "eth_blockNumber",
  "params": [],
  "id": 1
}

Parameters: None

Returns:

• String - Timestamp in microseconds in hexadecimal format

Example Request:

curl -X POST https://rpc.dev.pod.network \
    -H "Content-Type: application/json" \
    -d '{
        "jsonrpc": "2.0",
        "method": "eth_blockNumber",
        "params": [],
        "id": 1
    }'

Example Response:

{
    "jsonrpc": "2.0",
    "result": "0x67505ef7",
    "id": 1
}

eth_chainId

Returns the chain ID of the current network.

eth_chainId

post

Body

jsonrpcstringRequiredDefault: 2.0Example: 2.0

methodstringRequiredDefault: eth_chainIdExample: eth_chainId

paramsstring[]RequiredDefault: []Example: []

idintegerRequiredDefault: 1Example: 1

post

cURL

curl -X POST https://rpc.dev.pod.network \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_chainId",
    "params": [],
    "id": 1
  }'

Parameters: None

Returns:

• String - Chain ID in hexadecimal format, always "0x50d".

Example Request:

curl -X POST https://rpc.dev.pod.network \
    -H "Content-Type: application/json" \
    -d '{
        "jsonrpc": "2.0",
        "method": "eth_chainId",
        "params": [],
        "id": 1
    }'

Example Response:

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x50d"
}

eth_estimateGas

Estimates gas needed for a transaction.

Parameters:

1. Object - Transaction call object

   • from: String - (Optional) 20-byte address of sender

   • to: String - 20-byte address of recipient

   • gas: String - (Optional) Gas provided for transaction execution

   • gasPrice: String - (Optional) Gas price in wei

   • value: String - (Optional) Value in wei

   • data: String - (Optional) Contract code or encoded function call data

Note: Only Legacy transactions are supported

Example Request:

curl -X POST https://rpc.dev.pod.network \
    -H "Content-Type: application/json" \
    -d '{
        "jsonrpc": "2.0",
        "method": "eth_estimateGas",
        "params": [{
            "from": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
            "to": "0xbe0eb53f46cd790cd13851d5eff43d12404d33e8"
        }],
        "id": 1
    }'

Example Response:

{
    "jsonrpc": "2.0",
    "result": "0x493e0",
    "id": 1
}

eth_gasPrice

Returns the current gas price.

Parameters: None

Returns:

• String - Current gas price in wei (hexadecimal format)

Example Request:

curl -X POST https://rpc.dev.pod.network \
    -H "Content-Type: application/json" \
    -d '{
        "jsonrpc": "2.0",
        "method": "eth_gasPrice",
        "params": [],
        "id": 1
    }'

Example Response:

{
    "jsonrpc": "2.0",
    "result": "0x1",
    "id": 1
}

eth_getBalance

Returns the balance of a given address.

Parameters:

1. String - 20-byte address to check balance for

2. String - Past perfect timestamp to query, specified in seconds(hexadecimal format). Can also be the tags: earliest, finalized or latest.

Note: Currently returns the current balance regardless of timestamp

Example Request:

curl -X POST https://rpc.dev.pod.network \
    -H "Content-Type: application/json" \
    -d '{
        "jsonrpc": "2.0",
        "method": "eth_getBalance",
        "params": [
            "0x13791790Bef192d14712D627f13A55c4ABEe52a4",
            "0x1"
        ],
        "id": 1
    }'

Example Response:

{
    "jsonrpc": "2.0",
    "result": "0x0",
    "id": 1
}

eth_getBlockByHash

Returns information about a block by its hash. Returns an empty block structure for compatibility.

Parameters:

1. String - Block hash

2. Boolean - If true, returns full transaction objects; if false, returns transaction hashes

Returns:

• Object - Block object with empty values:

  • number: String - "0"

  • mixHash: String - "0x0000000000000000000000000000000000000000000000000000000000000000"

  • hash: String - Requested block hash

  • parentHash: String - "0x0000000000000000000000000000000000000000000000000000000000000000"

  • nonce: String - "0x0000000000000000"

  • sha3Uncles: String - "0x0000000000000000000000000000000000000000000000000000000000000000"

  • logsBloom: String - "0x0" followed by 256 zeros

  • transactionsRoot: String - "0x0000000000000000000000000000000000000000000000000000000000000000"

  • stateRoot: String - "0x0000000000000000000000000000000000000000000000000000000000000000"

  • receiptsRoot: String - "0x0000000000000000000000000000000000000000000000000000000000000000"

  • miner: String - "0x0000000000000000000000000000000000000000"

  • difficulty: String - "0x0000000000000000"

  • extraData: String - "0x0000000000000000000000000000000000000000"

  • size: String - "0x0"

  • gasLimit: String - "0x0"

  • gasUsed: String - "0x0"

  • timestamp: String - "0x0"

  • transactions: Array - Empty array

  • uncles: Array - Empty array

Example Request:

curl -X POST https://rpc.dev.pod.network \
    -H "Content-Type: application/json" \
    -d '{
        "jsonrpc": "2.0",
        "method": "eth_getBlockByHash",
        "params": [
            "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
            false
        ],
        "id": 1
    }'

eth_getBlockByNumber

Returns information about a block by its number. Returns an empty block structure for compatibility.

Parameters:

1. String - Block number in hexadecimal format

2. Boolean - If true, returns full transaction objects; if false, returns transaction hashes

Returns:

• Object - Block object with empty values:

  • number: String - Requested block number

  • mixHash: String - "0x0000000000000000000000000000000000000000000000000000000000000000"

  • hash: String - "0x0000000000000000000000000000000000000000000000000000000000000000"

  • parentHash: String - "0x0000000000000000000000000000000000000000000000000000000000000000"

  • nonce: String - "0x0000000000000000"

  • sha3Uncles: String - "0x0000000000000000000000000000000000000000000000000000000000000000"

  • logsBloom: String - "0x0" followed by 256 zeros

  • transactionsRoot: String - "0x0000000000000000000000000000000000000000000000000000000000000000"

  • stateRoot: String - "0x0000000000000000000000000000000000000000000000000000000000000000"

  • receiptsRoot: String - "0x0000000000000000000000000000000000000000000000000000000000000000"

  • miner: String - "0x0000000000000000000000000000000000000000"

  • difficulty: String - "0x0000000000000000"

  • extraData: String - "0x0000000000000000000000000000000000000000"

  • size: String - "0x0"

  • gasLimit: String - "0x0"

  • gasUsed: String - "0x0"

  • timestamp: String - "0x0"

  • transactions: Array - Empty array

  • uncles: Array - Empty array

Example Request:

curl -X POST https://rpc.dev.pod.network \
    -H "Content-Type: application/json" \
    -d '{
        "jsonrpc": "2.0",
        "method": "eth_getBlockByNumber",
        "params": [
            "0x1",
            false
        ],
        "id": 1
    }'

eth_getLogs

Returns an array of event logs matching the given filter criteria.

Parameters:

1. Object - Filter options:

   • fromBlock: String - (optional) From block timestamp specified in seconds in hexadecimal format. Can also be the tags: earliest, finalized or latest.

   • toBlock: String - (optional) To block timestamp specified in seconds in hexadecimal format. Can also be the tags: earliest, finalized or latest.

   • address: String - (optional) Contract address

   • topics: Array - (optional) Array of topic filters (up to 4 topics):

     • Each topic can be either a string or null

     • Topics are ordered and must match in sequence

     • Null values match any topic

   • minimum_attestations: Number - (optional) Minimum number of attestations required for the log to be returned

Returns:

• Array - Array of log objects:

  • address: String - Address from which this log originated

  • block_number: String - Block number in hexadecimal format, supported for completeness, the block number returned is 1

  • block_hash: String - Block hash. Supported for completeness, the block hash returned is the 0 hash.

  • transaction_hash: String - Transaction hash

  • transaction_index: String - Transaction index

  • log_index: String - Log index

  • topics: Array - Array of indexed log parameters

  • data: String - Contains non-indexed log parameters

  • pod_metadata: Object - Additional pod-specific information including attestations

Example Request:

curl -X POST https://rpc.dev.pod.network \
    -H "Content-Type: application/json" \
    -d '{
        "jsonrpc": "2.0",
        "method": "eth_getLogs",
        "params": [{
            "address": "0x1234567890123456789012345678901234567890",
            "topics": [
                "0x71a5674c44b823bc0df08201dfeb2e8bdf698cd684fd2bbaa79adcf2c99fc186"
            ],
            "fromBlock": "0x1",
            "toBlock": "latest"
        }],
        "id": 1
    }'

eth_getTransactionByHash

Returns information about a transaction by its hash.

Parameters:

1. String - 32-byte transaction hash

Returns:

• Object - Transaction object, or null if no transaction was found:

  • hash: String - 32-byte transaction hash

  • nonce: String - Number of transactions sent by the sender prior to this one

  • blockHash: String - 32-byte block hash, or null if pending

  • blockNumber: String - Block number, or null if pending

  • transactionIndex: String - Integer index position in the block, or null if pending

  • from: String - 20-byte address of the sender

  • to: String - 20-byte address of the recipient, or null for contract creation

  • value: String - Value transferred in wei

  • gasPrice: String - Gas price in wei

  • gas: String - Gas provided for transaction execution

  • input: String - Contract code or encoded function call data

  • v: String - ECDSA recovery ID

  • r: String - ECDSA signature r

  • s: String - ECDSA signature s

  • pod_metadata: Object - Additional pod-specific information

Example Request:

curl -X POST https://rpc.dev.pod.network \
    -H "Content-Type: application/json" \
    -d '{
        "jsonrpc": "2.0",
        "method": "eth_getTransactionByHash",
        "params": [
            "0xf74e07ff80dc54c7e894396954326fe13f07d176746a6a29d0ea34922b856402"
        ],
        "id": 1
    }'

eth_getTransactionCount

Returns the number of transactions sent from an address.

Parameters:

1. String - 20-byte address

2. String - Past perfect timestamp in seconds (hexadecimal format). Can also be the tags: earliest, finalized or latest.

Note: Currently returns the current transaction count regardless of timestamp

Example Request:

curl -X POST https://rpc.dev.pod.network \
    -H "Content-Type: application/json" \
    -d '{
        "jsonrpc": "2.0",
        "method": "eth_getTransactionCount",
        "params": [
            "0x13791790Bef192d14712D627f13A55c4ABEe52a4",
            "latest"
        ],
        "id": 1
    }'

Example Response:

{
    "jsonrpc": "2.0",
    "result": "0x0",
    "id": 1
}

eth_getTransactionReceipt

Returns the receipt of a transaction by transaction hash.

Parameters:

1. String - 32-byte transaction hash

Returns:

• Object - A transaction receipt object with pod-specific metadata, or null if no receipt was found.

  • Standard Ethereum receipt fields

  • pod_metadata: Object - Contains pod-specific data including attestations

Example Request:

curl -X POST https://rpc.dev.pod.network \
    -H "Content-Type: application/json" \
    -d '{
        "jsonrpc": "2.0",
        "method": "eth_getTransactionReceipt",
        "params": [
            "0xf74e07ff80dc54c7e894396954326fe13f07d176746a6a29d0ea34922b856402"
        ],
        "id": 1
    }'

eth_networkId (alias: net_version)

Returns the current network ID.

Parameters: None

Returns:

• String - The network ID in decimal format

Example Request:

# Using eth_networkId
curl -X POST https://rpc.dev.pod.network \
    -H "Content-Type: application/json" \
    -d '{
        "jsonrpc": "2.0",
        "method": "eth_networkId",
        "params": [],
        "id": 1
    }'

# Using net_version alias
curl -X POST https://rpc.dev.pod.network \
    -H "Content-Type: application/json" \
    -d '{
        "jsonrpc": "2.0",
        "method": "net_version",
        "params": [],
        "id": 1
    }'

Example Response:

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "1293"
}

eth_sendRawTransaction

Submits a pre-signed transaction for broadcast to the POD network.

Parameters:

1. String - Signed transaction data in hex format

2. u64 - (optional) Timeout in milliseconds. Default is 0 milliseconds. The timeout allows the client to wait for the confirmation of the transaction instead of returning the hash immediately.

Returns:

• String - 32-byte transaction hash (or zero hash if transaction is not yet available)

Example Request:

curl -X POST https://rpc.dev.pod.network \
    -H "Content-Type: application/json" \
    -d '{
        "jsonrpc": "2.0",
        "method": "eth_sendRawTransaction",
        "params": [
            "0xf8658001830493e0945fbdb2315678afecb367f032d93f642f64180aa3830f424080820a3da00f49d94d0d83d905d6372b3548d7e922d58c69e611a296d2ca3c9f762b9b5051a073e5602f6889390a284f421cc5184d05ec82923e64e86ff37e437f0600930d26"
        ],
        "id": 1
    }'

Example Response:

{
    "jsonrpc": "2.0",
    "result": "0x9c3a42c40e708ad7c6c4643dcecc6cc3c38a3cfb14c19cd540612d63f3c0c218",
    "id": 1
}

eth_subscribe

Creates a subscription for specific events. This endpoint streams the new events, for historical data use the other endpoints (pod_listAccountReceipts, pod_listConfirmedReceipts, pod_pastPerfectTime, eth_getLogs). Each subscription type has different parameter requirements.

Parameters:

1. String - Subscription type (required):

   • "logs"

   • "pod_accountReceipts"

   • "pod_confirmedReceipts"

   • "pod_pastPerfectTime"

2. Object - Parameters object (varies by subscription type)

Example Request:

wscat -c ws://rpc.dev.pod.network \
    -H "Content-Type: application/json" \
    -d '{
        "jsonrpc": "2.0",
        "method": "eth_subscribe",
        "params": ["<subscription_type>", <parameters>],
        "id": 1
    }'

Subscription Types and Parameters:

1. logs

{
    "address": "0x1234567890123456789012345678901234567890",
    "topics": [
        "0x71a5674c44b823bc0df08201dfeb2e8bdf698cd684fd2bbaa79adcf2c99fc186"
    ],
    "fromBlock": "0x1",
    "toBlock": "latest",
    "minAttestations": 3
}

1. pod_accountReceipts

{
    "address": "0x13791790Bef192d14712D627f13A55c4ABEe52a4",
    "since": 1687245924000000 // Timestamp in microseconds
}

1. pod_confirmedReceipts

{
    "since": 1687245924000000 // Timestamp in microseconds
}

1. pod_pastPerfectTime

1687245924000000 // Timestamp in microseconds

Returns:

• String - Subscription ID

Example Initial Response:

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0xcd0c3e8af590364c09d0fa6a1210faf5"
}

Subscription Messages: Each subscription type returns different data in its subscription messages:

1. logs

{
    "jsonrpc": "2.0",
    "method": "eth_subscription",
    "params": {
        "subscription": "0xcd0c3e8af590364c09d0fa6a1210faf5",
        "result": {
            "address": "0x1234567890123456789012345678901234567890",
            "topics": ["0x71a5674c44b823bc0df08201dfeb2e8bdf698cd684fd2bbaa79adcf2c99fc186"],
            "data": "0x0000000000000000000000000000000000000000000000000000000000000001",
            "pod_metadata": {
                "proof": {
                    "generalized_index": "5",
                    "path": [
                        "0x17e9064016f07fc958206a993067e187e4f5d314191a42b92fb30a749c03836d",
                        "0xa9cdde087f3cc534a93b1f728c5108c3f89b4505e07805691e40b0f6d4ffda22"
                    ]
                },
                "receipt_root": "0xd0180358d6fa534054f22b12235af25558bbdd2d84e26396cae1fbacdc9122bf",
                "signatures": [
                    {
                        "r": "0xa319f330b99ffd9ae9bf1d26dffc4643e2853d073e1100ef6aeced9b5cf0a5b4",
                        "s": "0xef0980560aaa17c6c107096c494c304e30adf7f4985141ebe17e9c4e7c967bb",
                        "v": "0x0",
                        "yParity": "0x0"
                    }
                ]
            }
        }
    }
}

1. pod_accountReceipts and pod_confirmedReceipts

{
    "jsonrpc": "2.0",
    "method": "eth_subscription",
    "params": {
        "subscription": "0xcd0c3e8af590364c09d0fa6a1210faf5",
        "result": {
            "certified": {
                "actual_gas_used": 21000,
                "logs": [],
                "status": true,
                "tx": {
                    "signature": {
                        "r": "0x23feb2e5d0d64ee34aa10b4140a321452ba3306a51ce562b1fcf218d041ca8ab",
                        "s": "0x7d62195ff365ec9887729675e2dbccb7c4127fe2e90717de3f61eb9f4b541d5d",
                        "v": "0x1",
                        "yParity": "0x1"
                    },
                    "signed": {
                        "call_data": "",
                        "gas_limit": 300000,
                        "gas_price": 1,
                        "nonce": 0,
                        "to": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
                        "value": "0xde0b6b3a7640000"
                    },
                    "signer": "0xb8aa43999c2b3cbb10fbe2092432f98d8f35dcd7"
                }
            },
            "signatures": [
                {
                    "r": "0x52ca8bbfe8cda5060e8ebc001dbdbbf4fa2017ffc4debcfbf19df537cdb2595d",
                    "s": "0x1e8ceee2a6cc129194acccb0013be717836e2ca86d33146dbac67ebfc5495019",
                    "v": "0x1",
                    "yParity": "0x1"
                }
            ],
            "tx_hash": "0x4e5a4d444cf0614340425e18fd644d225c06514f933fa3814f4d407778c7859b"
        }
    }
}

1. pod_pastPerfectTime

{
    "jsonrpc": "2.0",
    "method": "eth_subscription",
    "params": {
        "subscription": "0xcd0c3e8af590364c09d0fa6a1210faf5",
        "result": "0x67505ef7"
    }
}

Error Handling:

• Invalid subscription type returns error code -32602

• Invalid parameters for a subscription type returns error code -32602

• Missing required parameters returns error code -32602

Example Error Response:

{
    "jsonrpc": "2.0",
    "error": {
        "code": -32602,
        "message": "invalid parameters, expected [\"pod_accountReceipts\", {\"address\": <address>, \"since\": <since>}]"
    },
    "id": 1
}

pod_getCommittee

Lists the validator public keys that are part of the committee.

Parameters: None

Returns:

• Object

  • quorum_size: Number of required attestations

  • replicas: Array of validator public keys

Example Request:

curl -X POST https://rpc.dev.pod.network \
    -H "Content-Type: application/json" \
    -d '{
        "jsonrpc": "2.0",
        "method": "pod_getCommittee",
        "params": {},
        "id": 1
    }'

Example Response:

{
    "jsonrpc": "2.0",
    "result": {
        "quorum_size": 3,
        "replicas": [
            "01f63ebcf3e22985abef399b43966f409bba8c02a61141de1a96398b5ed0a4f5002eb5e9083d0f8bc5bfcf75f43fbe34dfc037492025d18e42942f9ed6c4b00205e30c48e09b4c030cfa588ea4ec104bd9977173d8ef7c16021fb5edf727c38a2e2f2605c8a87f80b7900b64be0cbad48239d0cf4c09375753d4fb0b7036abcc",
            "2f8848f3696c99d7bdc1c1fcda5792577afb5bcd93cfd4c7b6a20f99c4c2bf950d55a3057171c1d87add3d690d62206b398121e5e1335bd598f7728225b8c9d0001dd768a50542e7bbdaadd69f4739054a6b1a600a5545dc0603766ec50ad85b28f99ce9c100112a0020d106b8723567b23b6e0ac1ec7559b686e1c18607ff83",
            "0b6dfa0424d710ac6158c0055be1cf0a4c21df3c3a9ca3d5e8d3e580674bc35400caf4585df58ad603e527bcfc026669c9dcaf03ec8c80f278886d34a6cae2b405f64057067f53ae226c48a555a1d10aeec46ac92b5c98f36974206f0ff84f2413ec4b4de5bc56e5ddd5c1f5d768f1ecf748cb44bea6de4c55306e2bfd8c2fee",
            "2abae2b0ca5c77d515c841cada5e825f169ff15dd392ac9aaebaf37ea23e04bd0158439d7925b770e46fd9b4e8158e6acb5784a91f261e35ea6605b8c4c9473923c961214b8a7b44e4dc58932d2b475943746439a100aea7eadda30022e78d312bdf55f96f6adbd12844c2df41b8e680994af83725a168c1d038575a032ec9e1"
        ]
    },
    "id": 2
}

pod_listAccountReceipts

Retrieves transaction receipts originating from or directed to a specific address.

Parameters:

1. String - 20-byte address

2. String - Timestamp specified in microseconds representing the start of the range to query

3. pagination: Object - (optional) Pagination object

   • cursor: String - (optional) Cursor to start the query from.

   • limit: Number - (optional) Maximum number of receipts to return.

   • newest_first: Boolean - (optional) Whether to start the query from the most recent receipts.

   • Note: If cursor is provided, newest_first must NOT be provided.

Returns:

• Object - Pagination Response Object

  • items: Array - List of transaction receipts with metadata

  • next_cursor: String - Cursor to start the next query from. null if there are no more items to fetch.

Example Request:

curl -X POST https://rpc.dev.pod.network \
    -H "Content-Type: application/json" \
    -d '{
        "jsonrpc": "2.0",
        "method": "pod_listAccountReceipts",
        "params": {
            "address": "0x13791790Bef192d14712D627f13A55c4ABEe52a4",
            "since": 0
        },
        "id": 1
    }'

Example Response:

{
	"jsonrpc": "2.0",
	"id": 1,
	"result": {
		"items": [
			{
				"blockHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
				"blockNumber": "0x1",
				"contractAddress": null,
				"cumulativeGasUsed": "0x5208",
				"effectiveGasPrice": "0x3b9aca00",
				"from": "0xb8aa43999c2b3cbb10fbe2092432f98d8f35dcd7",
				"gasUsed": "0x5208",
				"logs": [],
				"logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
				"pod_metadata": {
					"attestations": [
						{
							"public_key": "0x7d5761b7b49fc7bfdd499e3ae908a4acfe0807e6",
							"signature": {
								"r": "0x30262c9f183a9f7219d260affbf6c8f92bff24a094d63ff9ed3c7366076f7bd7",
								"s": "0x6a6ff240bbab35626d6f4ea2a27a2d9d739f9305a5f1bcabe0eaf1e14364390a",
								"v": "0x0",
								"yParity": "0x0"
							},
							"timestamp": 1740419698722233
						},
						{
							"public_key": "0xd64c0a2a1bae8390f4b79076ceae7b377b5761a3",
							"signature": {
								"r": "0x45a87fdf1455b5f93660c5e265767325afbd1e0cfa327970a63e188290625f9d",
								"s": "0x65343279465e0f1e43729b669589c2c80d12e95a72a5a52c63b70b3abf1ebef5",
								"v": "0x1",
								"yParity": "0x1"
							},
							"timestamp": 1740419698722014
						},
						{
							"public_key": "0x06ad294f74dc98be290e03797e745cf0d9c03da2",
							"signature": {
								"r": "0xf9d7f79e339b68f75eb6d172dc68539a1d0750c555979f998cb8a9211fdc1511",
								"s": "0x7239b2efc00415dd5866bf564366272af8fb4738c7697fec50628b9969521493",
								"v": "0x1",
								"yParity": "0x1"
							},
							"timestamp": 1740419698721922
						},
						{
							"public_key": "0x8646d958225301a00a6cb7b6609fa23bab87da7c",
							"signature": {
								"r": "0x8c8256bea8c0e919618abd973646d344e8ffe3c50c0757ce902d28659f1524b4",
								"s": "0x3b76b3818666a418572cc465d30638533d4bd987bfb5dd0550a311521f167719",
								"v": "0x1",
								"yParity": "0x1"
							},
							"timestamp": 1740419698722052
						}
					]
				},
				"status": "0x1",
				"to": "0x13791790bef192d14712d627f13a55c4abee52a4",
				"transactionHash": "0xfa71ee80b1bc58e00f4fe11ae1de362201de43ff65e849dcb5d8b92e0be71e87",
				"transactionIndex": "0x0",
				"type": "0x0"
			}
		],
		"next_cursor": "Y3I6MDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAxNzQwNDE5Njk3MjQ3NTczXzB4NzRjOWM0MTFkZDJjMDg0ZWE4NmZjOThjMDUwYWU0OTI4YTgzZjVlN2I3N2UyN2NkYTA5NWFiYmY0YTk1ZjJmY3xjcjowMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDBfMHgwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAw"
	}
}

pod_listConfirmedReceipts

Retrieves confirmed transaction receipts after a specified timestamp.

Parameters:

1. Object

   • since: String - Timestamp specified in microseconds representing the start of the range to query.

   • pagination: Object - (optional) Pagination object

     • cursor: String - (optional) Cursor to start the query from.

     • limit: Number - (optional) Maximum number of receipts to return.

     • newest_first: Boolean - (optional) Whether to start the query from the most recent receipts.

   • Note: If cursor is provided, newest_first must NOT be provided.

Returns:

• Object - Pagination Response Object

  • items: Array - List of transaction receipts with metadata

  • next_cursor: String - Cursor to start the next query from. null if there are no more items to fetch.

Example Request:

curl -X POST https://rpc.dev.pod.network \
    -H "Content-Type: application/json" \
    -d '{
        "jsonrpc": "2.0",
        "method": "pod_listConfirmedReceipts",
        "params": {
            "since": 0
        },
        "id": 1
    }'

Example Response:

{
	"jsonrpc": "2.0",
	"id": 1,
	"result": {
		"items": [
			{
				"blockHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
				"blockNumber": "0x1",
				"contractAddress": null,
				"cumulativeGasUsed": "0x5208",
				"effectiveGasPrice": "0x3b9aca00",
				"from": "0xb8aa43999c2b3cbb10fbe2092432f98d8f35dcd7",
				"gasUsed": "0x5208",
				"logs": [],
				"logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
				"pod_metadata": {
					"attestations": [
						{
							"public_key": "0x7d5761b7b49fc7bfdd499e3ae908a4acfe0807e6",
							"signature": {
								"r": "0x30262c9f183a9f7219d260affbf6c8f92bff24a094d63ff9ed3c7366076f7bd7",
								"s": "0x6a6ff240bbab35626d6f4ea2a27a2d9d739f9305a5f1bcabe0eaf1e14364390a",
								"v": "0x0",
								"yParity": "0x0"
							},
							"timestamp": 1740419698722233
						},
						{
							"public_key": "0xd64c0a2a1bae8390f4b79076ceae7b377b5761a3",
							"signature": {
								"r": "0x45a87fdf1455b5f93660c5e265767325afbd1e0cfa327970a63e188290625f9d",
								"s": "0x65343279465e0f1e43729b669589c2c80d12e95a72a5a52c63b70b3abf1ebef5",
								"v": "0x1",
								"yParity": "0x1"
							},
							"timestamp": 1740419698722014
						},
						{
							"public_key": "0x06ad294f74dc98be290e03797e745cf0d9c03da2",
							"signature": {
								"r": "0xf9d7f79e339b68f75eb6d172dc68539a1d0750c555979f998cb8a9211fdc1511",
								"s": "0x7239b2efc00415dd5866bf564366272af8fb4738c7697fec50628b9969521493",
								"v": "0x1",
								"yParity": "0x1"
							},
							"timestamp": 1740419698721922
						},
						{
							"public_key": "0x8646d958225301a00a6cb7b6609fa23bab87da7c",
							"signature": {
								"r": "0x8c8256bea8c0e919618abd973646d344e8ffe3c50c0757ce902d28659f1524b4",
								"s": "0x3b76b3818666a418572cc465d30638533d4bd987bfb5dd0550a311521f167719",
								"v": "0x1",
								"yParity": "0x1"
							},
							"timestamp": 1740419698722052
						}
					]
				},
				"status": "0x1",
				"to": "0x13791790bef192d14712d627f13a55c4abee52a4",
				"transactionHash": "0xfa71ee80b1bc58e00f4fe11ae1de362201de43ff65e849dcb5d8b92e0be71e87",
				"transactionIndex": "0x0",
				"type": "0x0"
			}
		],
		"next_cursor": "Y3I6MDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAxNzQwNDE5Njk3MjQ3NTczXzB4NzRjOWM0MTFkZDJjMDg0ZWE4NmZjOThjMDUwYWU0OTI4YTgzZjVlN2I3N2UyN2NkYTA5NWFiYmY0YTk1ZjJmY3xjcjowMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDBfMHgwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAw"
	}
}

pod_metrics

Returns the current metrics displayed in the pod explorer.

Parameters: None

Returns:

1. Object

   • gas_price: u128 - Current gas price in wei

   • validator_uptime: f64 - Validator uptime percentage

   • latency: f64 - Average latency in milliseconds

   • throughput: f64 - Average throughput in transactions per second

Example Request:

curl -X POST https://rpc.dev.pod.network \
    -H "Content-Type: application/json" \
    -d '{
        "jsonrpc": "2.0",
        "method": "pod_metrics",
        "params": {},
        "id": 1
    }'

Example Response:

{
    "jsonrpc": "2.0",
    "result": {
        "gas_price": 11482000000,
        "validator_uptime": 0.9999,
        "latency": 120,
        "throughput": 100
    },
    "id": 1
}