aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorCory Fields <cory-nospam-@coryfields.com>2024-01-05 16:27:58 +0000
committerCory Fields <cory-nospam-@coryfields.com>2024-01-30 23:19:02 +0000
commit25dc87e6f84c38c21e109e11f7bbd93f1e1f3183 (patch)
treede3a3fb5baf67c4d1515683cecba9c225543218d /doc
parentc80f57ba575af96890f185765a53a62ef58ef2c8 (diff)
libconsensus: deprecate
This library has existed for nearly 10 years with very little known uptake or impact. It has become a maintenance burden. In several cases it dictates our code/library structure (for example necessitating LIBBITCOIN_CRYPTO_BASE), as well as build-system procedures (building multiple copies of object files especially for the lib). Several discussions have arisen wrt migrating it to CMake and it has become difficult to justify adding more complexity for a library that is virtually unused anyway. See for example the discussions: https://github.com/hebasto/bitcoin/pull/41 https://github.com/bitcoin/bitcoin/pull/29123 Instead, we (fanquake, hebasto, TheCharlatan, and I) propose simply not migrating it to CMake and letting it end with v27. Any remaining use-cases could be handled in the future by libbitcoinkernel.
Diffstat (limited to 'doc')
-rw-r--r--doc/release-notes-29189.md15
-rw-r--r--doc/shared-libraries.md1
2 files changed, 16 insertions, 0 deletions
diff --git a/doc/release-notes-29189.md b/doc/release-notes-29189.md
new file mode 100644
index 0000000000..f75e450217
--- /dev/null
+++ b/doc/release-notes-29189.md
@@ -0,0 +1,15 @@
+libbitcoinconsensus
+========================
+
+This library is deprecated and will be removed for v28.
+
+It has existed for nearly 10 years with very little known uptake or impact. It
+has become a maintenance burden.
+
+The underlying functionality does not change between versions, so any users of
+the library can continue to use the final release indefinitely, with the
+understanding that Taproot is its final consensus update.
+
+In the future, libbitcoinkernel will provide a much more useful API that is
+aware of the UTXO set, and therefore be able to fully validate transactions and
+blocks.
diff --git a/doc/shared-libraries.md b/doc/shared-libraries.md
index 07aee46f0b..3a448c6556 100644
--- a/doc/shared-libraries.md
+++ b/doc/shared-libraries.md
@@ -2,6 +2,7 @@ Shared Libraries
================
## bitcoinconsensus
+***This library is deprecated and will be removed in v28***
The purpose of this library is to make the verification functionality that is critical to Bitcoin's consensus available to other applications, e.g. to language bindings.