Description

This PR implements a new RPC/IPC call named debug.peerStats which can be used to get additional block related information from all the connected peers.

More specifically, it emits hash, number and td (total difficulty) of the head block of all the peers along with some metadata and identifiers. Note that the number field is derived locally and isn't maintained in the peer's struct. It may be a non-zero block number if we have the hash locally else 0.

Example: IPC

> debug.peerStats()
[{
    enode: "<enode>",
    hash: "0x8147d592629352a275b7dab82f8e0ff9d8a77bb63f3e1f833d7b7bd91366d464",
    id: "<id>",
    name: "bor/v1.2.8/linux-amd...",
    td: 1057759962,
    number: 0
}]

RPC: curl http://localhost:8545 -X POST --data '{"jsonrpc":"2.0","method":"debug_peerStats","params":[],"id":1}' -H "Content-Type: application/json" | jq

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "enode": "<enode>",
      "id": "<id>",
      "name": "bor/v1.2.8/linux-amd...",
      "hash": "0x64c8ae56ad588565ea98ed807c3dd8298b74e66c31d2e4748548a1f7421f4d6f",
      "td": 1057761180,
      "number": 0
    }
  ]
}

Changes

[ ] Bugfix (non-breaking change that solves an issue)
[ ] Hotfix (change that solves an urgent issue, and requires immediate attention)
[x] New feature (non-breaking change that adds functionality)
[ ] Breaking change (change that is not backwards-compatible and/or changes current functionality)
[ ] Changes only for a subset of nodes

Checklist

[x] I have added at least 2 reviewer or the whole pos-v1 team
[x] I have added sufficient documentation in code
[x] I will be resolving comments - if any - by pushing each fix in a separate commit and linking the commit hash in the comment reply
[x] Created a task in Jira and informed the team for implementation in Erigon client (if applicable)
[x] Includes RPC methods changes, and the Notion documentation has been updated

Cross repository changes

[ ] This PR requires changes to heimdall
- In case link the PR here:
[ ] This PR requires changes to matic-cli
- In case link the PR here:

Testing

[ ] I have added unit tests
[ ] I have added tests to CI
[ ] I have tested this code manually on local environment
[ ] I have tested this code manually on remote devnet using express-cli
[ ] I have tested this code manually on mumbai/amoy
[ ] I have created new e2e tests into express-cli

Manual tests

Please complete this section with the steps you performed if you ran manual tests for this functionality, otherwise delete it

maticnetwork / bor