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.
Structure | Type | Description |
---|---|---|
(none) |
Structure | Type | Description |
---|---|---|
result | map of objects (key - pubkey in hexadecimal representation) | the list of pubkeys banned by current node |
result.*.type | string | the type of the ban; possible values: Manual or FailedSwap |
result.*.caused_by_swap | string (optional) | the uuid of the swap that triggered the ban; present only for the FailedSwap type |
result.*.caused_by_event | object (optional) | the swap event that triggered the ban; present only for the FailedSwap type |
result.*.reason | string (optional) | the reason for the Manual ban |
POST
list_banned_pubkeys{
"userpass": "testpsw",
"method": "list_banned_pubkeys"
}