In order to support the continuous improvement of
zcashd, features are
periodically deprecated and removed when they have been superseded or are no
longer useful. Deprecation follows a 3-stage process:
- Initially, a feature will be marked as DEPRECATED in the release notes and
user-facing documentation, but no other changes are made; the feature
continues to be available and function as normal. While features at this
stage remain enabled by default, they may be explicitly disabled by
-allowdeprecated=noneon the command line when starting the node, or by including
allowdeprecated=noneas a line in the
- In the next stage of deprecation, the feature will be disabled by default.
Disabled features may be reenabled via use of the
- In the third stage, the feature is fully removed and is no longer available.
Features that enter Stage 1 in a particular release will be disabled by default
after no fewer than 3 releases that update
zcashd's minor-version, and
features will only be fully removed after a total of at least 6 minor-version updates.
zcashd's release schedule intends to produce a release that updates the minor
version every 6 weeks, so deprecated features remain accessible by default for
approximately 18 weeks, and then can be expected to be removed no less than 36
weeks after their initial deprecation. Deprecation and removal timelines might
be extended beyond this on a case-by-case basis to satisfy user requirements.
The following features are deprecated, but remain enabled by default. These features
will be disabled if
-allowdeprecated=none is added to the CLI arguments when starting
the node, or if an
allowdeprecated=none line is added to
z_getbalance RPC method.
z_gettotalbalance RPC method.
blockcommitmentshash fields in the output of
getblocktemplate, which are replaced by the
deprecationheight field returned by the
getdeprecationinfo RPC method has been replaced by the
Each feature in the table below may be enabled by adding
to the CLI arguments when starting the node, or by adding an
z_sendmany has been replaced by the
getnewaddress RPC method.
getrawchangeaddress RPC method.
z_getnewaddress RPC method.
z_listaddresses RPC method.
type attribute is deprecated in the results of RPC methods that return address metadata. It is recommended that applications using this metadata be updated to use the
address_type attributes, which have replaced the
type attribute, as appropriate.
vjoinsplit attribute returned by the
gettransaction RPC method.