Get mempool peers

The peer-to-peer communication that's required for Chainweb nodes to synchronize state is partitioned into separate independent network channels. The /cut/peer portion of the peer-to-peer network is responsible for communicating the consensus state across a set of distributed network nodes and all chains in the network. There is also one /mempool/peer peer-to-peer network channel for each chain. The /mempool/peer portion of the peer-to-peer network is responsible for queuing and managing pending transactions for each chain independently.

Request format

Use GET https://{baseURL}/chain/{chain}/mempool/peer to retrieve peer information from the mempool portion of the peer-to-peer network for a specific Chainweb node and chain identifier.

Path parameters

Parameter	Type	Description
chain (required)	integer >= 0	Specifies the chain identifier of the chain you want to send the request to. Valid values are 0 to 19. For example, to get block hashes for the first chain (0), the request is GET https://{baseURL}/chain/0/mempool/peer.

Query parameters

Parameter	Type	Description
limit	integer >= 0	Specifies the maximum number of records that should be returned. The actual number of records returned might be lower than the value you specify. For example: limit=3.
next	string	Specifies the cursor value to retrieve the next page of results. You can find the value to specify in the next property returned by the previous page in a successful response. For example: "inclusive:qgsxD1G5m8dGZ4W9nMKBotU2I10ilURkRIE3_UKHlLM".

Responses

Requests to GET https://{baseURL}/chain/{chain}/mempool/peer return the following response code:

• 200 OK indicates that the request succeeded and the response body returns the blockchain state for each chain at the specified block height.

Response header

The response header parameters are the same for all successful and unsuccessful Chainweb node requests.

Parameter	Type	Description
x-peer-addr	string	Specifies the host address and port number of the client as observed by the remote Chainweb node. The host address can be a domain name or an IP address in IPv4 or IPv6 format. For example: "10.36.1.3:42988".
x-server‑timestamp	integer >= 0	Specifies the clock time of the remote Chainweb node using the UNIX epoch timestamp. For example: 1618597601.
x‑chainweb‑node‑version	string	Specifies the version of the remote Chainweb node. For example: "2.23".

Successful response schema

If the request is successful, the response returns application/json content with the following:

Parameter	Type	Description
items (required)	Array of objects	Returns an array of peer information objects.
limit (required)	integer >= 0	Specifies the maximum number of items in the page. This number can be smaller but never larger than the number of requested items.
next (required)	string or null	Returns a value that can be used to query the next page. You can use this value for the next parameter in a follow-up request. The format for this parameter consists of two parts. The first part of the string can be inclusive, exclusive, or null. The second part is the value that calls the next page of results or null if there are no more results to query.

Examples

You can send a request to retrieve information about the memory pool portion of the peer-to-peer network with a call to the /mempool/peer endpoint similar to the following:

GET https://us1.testnet.chainweb.com/chainweb/0.0/testnet04/chain/4/mempool/peer?limit=3

The response body for this request returns the peer information for the nodes in the mempool portion of the peer-to-peer network for the specified node and chain. For example:

{
    "limit": 3,
    "items": [
        {
            "id": "aEdeq9bOZws1X5IpBF5aGM6vV6gh_EicHSMoPs5wb40",
            "address": {
                "hostname": "13.251.43.216",
                "port": 1789
            }
        },
        {
            "id": "SMq0oMEVVBNNl3GfMBJfbHVBIRIVa0v6qwoKZflQtAA",
            "address": {
                "hostname": "34.148.233.99",
                "port": 1789
            }
        },
        {
            "id": "AFqlaMJ8IfuwQiuyo_qxa83U_2DTkrJjhGftplwvWZc",
            "address": {
                "hostname": "34.75.215.49",
                "port": 1789
            }
        }
    ],
    "next": "inclusive:3"
}