opened 08:39AM - 26 Aug 20 UTC
closed 10:35AM - 06 Sep 20 UTC
t:enhancement
The project is under active development. Some RPC methods no longer make sense i…n the new version. We need a way to deprecate the RPC methods and finally remove them.
## CKB RPC Method Deprecation Process
A CKB RPC method is deprecated in three steps.
First the method is marked as deprecated in the CKB release notes and RPC document. However, the RPC method is still available. The RPC document will have the suggestion of the alternative solutions.
The CKB dev team will disable any deprecated RPC methods starting from the next minor version release. Users can enable the methods via the command line argument `--enable-deprecated-rpc` or the config file option `enable_deprecated_rpc`.
Once a deprecated method is disabled, the CKB dev team will remove it in a future minor version release.
For example, a method is marked as deprecated in 0.35.0, it can be disabled in 0.36.0 and removed in 0.37.0. The minor versions are released monthly, so there's at least two month buffer for a deprecated RPC method.