system_localPeerId - Polkadot
Example code for the system_localPeerId JSON RPC method. Complete guide on how to use system_localPeerId JSON RPC in GetBlock Web3 documentation.
This method returns the base-58 encoded libp2p peer ID of the local node.
Parameters
This method does not accept any parameters.
Request
curl --location --request POST 'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/' \
--header 'Content-Type: application/json' \
--data-raw '{"jsonrpc": "2.0", "method": "system_localPeerId", "params": [], "id": "getblock.io"}'const response = await fetch('https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
jsonrpc: '2.0',
method: 'system_localPeerId',
params: [],
id: 'getblock.io'
})
});
const data = await response.json();
console.log(data.result);import requests
response = requests.post(
'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/',
headers={'Content-Type': 'application/json'},
json={
'jsonrpc': '2.0',
'method': 'system_localPeerId',
'params': [],
'id': 'getblock.io'
}
)
print(response.json()['result'])Response
{
"id": "getblock.io",
"jsonrpc": "2.0",
"result": "12D3KooWSueCPH3puP2PcvqPJdNaDNF3jMZjtJtDiSy35pWrbt5h"
}Response Parameters
id
string
Request identifier matching the request
jsonrpc
string
JSON-RPC protocol version ("2.0")
result
string
The node's libp2p peer ID
Use Cases
Node Identity: Read the node's peer ID
Networking: Configure reserved-peer relationships
Diagnostics: Identify a node in logs
Monitoring: Track nodes by peer ID
Error Handling
-32602
Invalid params
A parameter is missing or has the wrong type or format
-32601
Method not found
The method is not available on this endpoint
-32603
Internal error
The node failed to process the request
Library Integration
The idiomatic way to call Polkadot RPC is the Polkadot.js API (@polkadot/api), which connects over WebSocket and exposes the method as api.rpc.system.localPeerId.
Was this helpful?