clearPeerBlacklist

Finalized

Introduction

The clearPeerBlacklist method is a powerful administrative endpoint that completely purges the node's peer blacklist. A single call to this method will remove all previously blacklisted hosts and wallet addresses, immediately allowing them to connect to the node again.

This is the counterpart to the blacklistPeer method and is intended for node operators who need to reset their node's connection-blocking policies.


Request

This method does not accept any parameters. Requests can be made using either HTTP POST or HTTP GET.

Example POST Request

POST /clearPeerBlacklist
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "method": "clearPeerBlacklist",
  "params": {},
  "id": 1
}

Example GET Request

GET /clearPeerBlacklist

Response

If the request is successful, the response result is a simple confirmation string.

Result Fields (on Success)

NameTypeDescription
resultstringThe static string "OK" on success.

Example Success Response

{
  "jsonrpc": "2.0",
  "result": "OK",
  "id": 1,
  "error": null
}

Behavioral Notes

  • Global Action: This command is global and irreversible. It removes all entries from the blacklist. There is no API method for removing individual entries; this method clears the entire list.
  • Immediate Effect: The change takes effect immediately. Any peers that were previously on the blacklist will be able to establish connections with the node as soon as the command completes.