disconnectnode

disconnectnode ( "address" nodeid ) Immediately disconnects from the specified peer node. Strictly one out of 'address' and 'nodeid' can be provided to identify the node. To disconnect by nodeid, either set 'address' to the empty string, or call using the named 'nodeid' argument only. Arguments: 1. address (string, optional, default=fallback to nodeid) The IP address/port of the node 2. nodeid (numeric, optional, default=fallback to address) The node ID (see getpeerinfo for node IDs) Result: null (json null) Examples: > bitcoin-cli disconnectnode "192.168.0.6:8333" > bitcoin-cli disconnectnode "" 1 > curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "disconnectnode", "params": ["192.168.0.6:8333"]}' -H 'content-type: application/json' http://127.0.0.1:8332/ > curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "disconnectnode", "params": ["", 1]}' -H 'content-type: application/json' http://127.0.0.1:8332/

Signature

disconnectnode(address?: string, nodeid?: number) → any

Code samples

curl --user "$RPC_USER:$RPC_PASS" \
  --data-binary '{"jsonrpc":"1.0","id":"docs","method":"disconnectnode","params":["fallback to nodeid","fallback to address"]}' \
  -H 'content-type: text/plain;' \
  http://127.0.0.1:8332/

bitcoin-cli disconnectnode "192.168.0.6:8333"

bitcoin-cli disconnectnode "" 1

curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "disconnectnode", "params": ["192.168.0.6:8333"]}' -H 'content-type: application/json' http://127.0.0.1:8332/

curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "disconnectnode", "params": ["", 1]}' -H 'content-type: application/json' http://127.0.0.1:8332/

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "disconnectnode",
        "params": ["fallback to nodeid", "fallback to address"],
    },
    timeout=30,
)
print(r.json())

const res = await fetch("http://127.0.0.1:8332/", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "authorization": "Basic " + btoa(`${process.env.RPC_USER}:${process.env.RPC_PASS}`),
  },
  body: JSON.stringify({
    jsonrpc: "1.0",
    id: "docs",
    method: "disconnectnode",
    params: ["fallback to nodeid","fallback to address"],
  }),
});
console.log(await res.json());

Parameters

Name	Type	Req.	Description
address	`string`	—	The IP address/port of the node
nodeid	`number`	—	The node ID (see getpeerinfo for node IDs)

Result

Type: any

null (json null)

Source: services/core-node/bcore/src/rpc/net.cpp:430

C++ symbol: disconnectnode

Code samples

curl --user "$RPC_USER:$RPC_PASS" \
  --data-binary '{"jsonrpc":"1.0","id":"docs","method":"disconnectnode","params":["fallback to nodeid","fallback to address"]}' \
  -H 'content-type: text/plain;' \
  http://127.0.0.1:8332/

bitcoin-cli disconnectnode "192.168.0.6:8333"

bitcoin-cli disconnectnode "" 1

curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "disconnectnode", "params": ["192.168.0.6:8333"]}' -H 'content-type: application/json' http://127.0.0.1:8332/

curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "disconnectnode", "params": ["", 1]}' -H 'content-type: application/json' http://127.0.0.1:8332/

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "disconnectnode",
        "params": ["fallback to nodeid", "fallback to address"],
    },
    timeout=30,
)
print(r.json())

const res = await fetch("http://127.0.0.1:8332/", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "authorization": "Basic " + btoa(`${process.env.RPC_USER}:${process.env.RPC_PASS}`),
  },
  body: JSON.stringify({
    jsonrpc: "1.0",
    id: "docs",
    method: "disconnectnode",
    params: ["fallback to nodeid","fallback to address"],
  }),
});
console.log(await res.json());