On this page

latest contributor to this doc

Last Edit:

@gcharang

list_banned_pubkeys

list_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.

StructureTypeDescription
(none)

StructureTypeDescription
resultmap of objects (key - pubkey in hexadecimal representation)the list of pubkeys banned by current node
result.*.typestringthe type of the ban; possible values: Manual or FailedSwap
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

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