aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorSjors Provoost <sjors@sprovoost.nl>2023-04-04 18:33:08 +0200
committerSjors Provoost <sjors@sprovoost.nl>2023-04-04 18:33:08 +0200
commitbd13dc2f46ea10302a928fcf0f53b7aed77ad260 (patch)
treeb7c0773b762bd3374bbc0e675e6f8b54b1e779d8 /doc
parentfe1b3256888bd0e70d0c9655f565e139ec87b606 (diff)
Switch hardened derivation marker to h in descriptors
This makes it easier to handle descriptor strings manually. E.g. an RPC call that takes an array of descriptors can now use '["desc": ".../0h/..."]'. Both markers can still be parsed. The default for new descriptors is changed to h. In normalized form h is also used. For private keys the chosen marker is preserved in a round trip. The hdkeypath field in getaddressinfo is also impacted by this change.
Diffstat (limited to 'doc')
-rw-r--r--doc/release-notes-26076.md12
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/release-notes-26076.md b/doc/release-notes-26076.md
new file mode 100644
index 0000000000..a39affdae7
--- /dev/null
+++ b/doc/release-notes-26076.md
@@ -0,0 +1,12 @@
+RPC
+---
+
+- The `listdescriptors` RPC now shows `h` rather than apostrophe (`'`) to indicate
+ hardened derivation. This does not apply when using the `private` parameter, which
+ matches the marker used when descriptor was generated or imported. Newly created
+ wallets use `h`. This change makes it easier to handle descriptor strings manually.
+ E.g. an RPC call that takes an array of descriptors can now use '["desc": ".../0h/..."]'.
+ Either `h` or `'` can still be used when providing a descriptor to e.g. `getdescriptorinfo`
+ or `importdescriptors`. Note that this choice changes the descriptor checksum.
+ For legacy wallets the `hdkeypath` field in `getaddressinfo` is unchanged,
+ nor is the serialization format of wallet dumps. (#26076)