On this page

latest contributor to this doc

Last Edit:

@smk762

List Banned Pubkeys

API-v1list_banned_pubkeys

The list_banned_pubkeys method returns a list of public keys of nodes that are banned from interacting with the node executing the method.

Banned nodes cannot complete orders and order matching requests with the node executing the method.

Some cases of swap failures give cause for banning a node. For example, a market taker may not follow the atomic-swap protocol by not sending the dex fee. The list_banned_pubkeys method is useful in these circumstances.

ParameterTypeRequiredDescription
(none)-This method does not take any parameters.

ParameterTypeDescription
resultmap of objects (key - pubkey in hexadecimal representation)The list of pubkeys banned by current node
result.*.typestringA standard BanTypeEnum enum. The type of the ban
result.*.caused_by_swapstring (optional)The uuid of the swap that triggered the ban; present only for the FailedSwap type
result.*.caused_by_eventobject (optional)The swap event that triggered the ban; present only for the FailedSwap type
result.*.reasonstring (optional)The reason for the Manual ban

list_banned_pubkeys

POST
list_banned_pubkeys
{
  "userpass": "RPC_UserP@SSW0RD",
  "method": "list_banned_pubkeys"
}