aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
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.