Skip to content

Commit 696c04f

Browse files
committed
bip-bod-descriptors: apply more edits suggested during review
Suggestions by @jonatack.
1 parent c6c727c commit 696c04f

File tree

1 file changed

+7
-7
lines changed

1 file changed

+7
-7
lines changed

bip-bod-descriptors.mediawiki

+7-7
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ software).</ref>
4242
<ref> '''Why not use the older Blockchain Commons BCR-2020-010 format?'''
4343
The format was [[https://github.com/BlockchainCommons/Research/blob/master/papers/bcr-2020-010-output-desc.md#deprecated-superseded-by-version-3-output-descriptors|recently deprecated]],
4444
due to its use of reserved CBOR tags.</ref>
45-
<ref>'''Why not use the new Blockchain Commons BCR-2023-010 format?'''.
45+
<ref>'''Why not use the new Blockchain Commons BCR-2023-010 format?'''
4646
The [[https://github.com/BlockchainCommons/Research/blob/master/papers/bcr-2023-010-output-descriptor.md|BCR-2023-010 format]]
4747
is roughly equivalent to this proposal, but was designed and released outside of
4848
the usual BIP proposal process.
@@ -60,8 +60,8 @@ support at the time of this writing.</ref>.
6060
==Specification==
6161

6262
The Binary Output Descriptor (BOD) format consists of a fixed header, a
63-
key-value map describing the output descriptor and its metadata followed by a
64-
map for each key referenced by the descriptor.
63+
key-value map describing the output descriptor, and a key-value map for
64+
each key.
6565

6666
<bod> := <magic> <global-map> <key-map>*
6767
<magic> := 0x62 0x6F 0x64 0xFF
@@ -86,13 +86,13 @@ The defined global types are as follows:
8686
| The earliest block height that may contain transactions for the descriptor, optionally followed by the UTF-8 encoded name of the descriptor.
8787
| <tt><bytes descriptor></tt>
8888
| The output descriptor in BIP 380 format without inline keys<ref>''Why not encode the descriptor in binary?'''
89-
The BIP 380 descriptor language is complicated and expanding, and we believe
90-
the effort of designing a parallel binary encoding does not outweigh the
91-
space savings.
89+
Designing and maintaining a compact binary representation of the complex and evolving BIP 380 descriptor
90+
language entail significant effort and introduce a time lag from the introduction of new BIP 380 features
91+
to the spcification of the binary counterpart. We don't believe the space savings outweigh the disadvantages.
9292
9393
The major source of bloat, base58-encoded keys, are binary encoded for compactness and
9494
can be re-used multiple times in a single descriptor.
95-
.</ref>
95+
</ref>.
9696
|-
9797
| Proprietary Use Type
9898
| <tt>BOD_GLOBAL_PROPRIETARY = 0xFC</tt>

0 commit comments

Comments
 (0)