diff options
author | MarcoFalke <falke.marco@gmail.com> | 2019-04-11 15:53:06 -0400 |
---|---|---|
committer | fanquake <fanquake@gmail.com> | 2019-04-16 08:58:38 +0800 |
commit | a644780a2f7076d4705d4e0d3486c0df8424367d (patch) | |
tree | 28be4a0d50fba202df3b1c5692b064821478261a /doc | |
parent | 194226f6798e59cfd871db0335e078101b165043 (diff) | |
download | bitcoin-a644780a2f7076d4705d4e0d3486c0df8424367d.tar.xz |
doc: Clarify RPC versioning
Github-Pull: #15799
Rebased-From: fa747498f79c9f6bf29b08f5f3cc01b276126abb
Diffstat (limited to 'doc')
-rw-r--r-- | doc/JSON-RPC-interface.md | 12 |
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/JSON-RPC-interface.md b/doc/JSON-RPC-interface.md index 982afd5d56..a0cfe84a3e 100644 --- a/doc/JSON-RPC-interface.md +++ b/doc/JSON-RPC-interface.md @@ -5,6 +5,18 @@ The headless daemon `bitcoind` has the JSON-RPC API enabled by default, the GUI option. In the GUI it is possible to execute RPC methods in the Debug Console Dialog. +## Versioning + +The RPC interface might change from one major version of Bitcoin Core to the +next. This makes the RPC interface implicitly versioned on the major version. +The version tuple can be retrieved by e.g. the `getnetworkinfo` RPC in +`version`. + +Usually deprecated features can be re-enabled during the grace-period of one +major version via the `-deprecatedrpc=` command line option. The release notes +of a new major release come with detailed instructions on what RPC features +were deprecated and how to re-enable them temporarily. + ## Security The RPC interface allows other programs to control Bitcoin Core, |