Topics: add several new topic pages #1467

harding · 2024-01-13T02:11:03Z

Includes some of the topics from #721 (all the ones I plan to do today; I'll open a new PR for additional topics at a later time).

Also includes a new topic category, "Invoicing", which is seeded with entries for BIP70, Offers, and LNURL.

murchandamus

LGTM except for the comment I left on CISA

murchandamus · 2024-01-16T16:10:35Z

_topics/en/cross-input-signature-aggregation.md

+produce a single 16-vbyte [MuSig]topic musig]-style [scriptless
+multisigature][topic multisignature] that corresponded to the aggregate
+public key, proving that she controlled the private key for both of the
+original public keys.


Maybe I’m wrong, but I thought that full aggregation must be interactive, and only half-aggregation can be non-interactive, because only the s values can be aggregated non-interactively, aggregating the r values requires interaction.

Yeah, the two concepts are a bit mixed up in this paragraph I think. In the case of halfagg any node can aggregate but the resulting signature would be 24-vbytes, see 2nd paragraph in the halfagg bip draft (motivation section): https://github.com/BlockstreamResearch/cross-input-aggregation/blob/master/half-aggregation.mediawiki. For fullagg only Alice can aggregate but the result would be a 16 vbyte signature. To make the (interactivity) downsides of fullagg clearer it would probably also be good to let the two outputs be controlled by different users.

I can suggest a bit more detailed version of the paragraph that distinguishes between halfagg and fullagg if that's ok for you @harding ? I am not sure if you were aiming for this to only be about halfagg for now though :)

@murchandamus @fjahr thanks for the reviews! I've almost totally rewritten that topic page to separate full and half agg and describe other tradeoffs I'm aware of.

murchandamus

ACK LGTM

vostrnad · 2024-01-18T21:17:23Z

_topics/en/bls-signatures.md

+  - title: Library announced for BLS signatures
+    url: /en/newsletters/2018/08/07/#library-announced-for-bls-signatures
+
+  - title: "Presentation: compact multisignatures for smaller blockchains"


The actual title of the presentation:

Suggested change

- title: "Presentation: compact multisignatures for smaller blockchains"

- title: "Presentation: Compact Multi-Signatures for Smaller Blockchains"

Gonna leave this as-is.

vostrnad · 2024-01-18T21:17:29Z

_topics/en/bls-signatures.md

+  - title: "Presentation: compact multisignatures for smaller blockchains"
+    url: /en/newsletters/2018/10/09/#compact-multi-signatures-for-smaller-blockchains
+
+  - title: "Using Bitcoin-compatible BLS signatures for Discree Log Contracts (DLCs)"


Suggested change

- title: "Using Bitcoin-compatible BLS signatures for Discree Log Contracts (DLCs)"

- title: "Using Bitcoin-compatible BLS signatures for Discreet Log Contracts (DLCs)"

vostrnad · 2024-01-18T21:17:31Z

_topics/en/bls-signatures.md

+  - title: "Using Bitcoin-compatible BLS signatures for Discree Log Contracts (DLCs)"
+    url: /en/newsletters/2022/08/17/#using-bitcoin-compatible-bls-signatures-for-dlcs
+
+  - title: "Question about schnorr signatures versus BLS signatures"


Suggested change

- title: "Question about schnorr signatures versus BLS signatures"

- title: "Question about Schnorr signatures versus BLS signatures"

Leaving as-is per our style guide.

vostrnad · 2024-01-18T21:17:38Z

_topics/en/bls-signatures.md

+## Required.  Use Markdown formatting.  Only one paragraph.  No links allowed.
+## Should be less than 500 characters
+excerpt: >
+  Boneh-Lynn-Shacham signatures (**BLS signatures**) are digital


Suggested change

Boneh-Lynn-Shacham signatures (**BLS signatures**) are digital

Boneh–Lynn–Shacham signatures (**BLS signatures**) are digital

Leaving as-is.

It's wrong though? Authors of a work are combined with an en dash, not hyphen (or at least, I've never seen it done otherwise).

Updated, but this is not a rule I care about.

vostrnad · 2024-01-18T21:17:41Z

_topics/en/bls-signatures.md

+excerpt: >
+  Boneh-Lynn-Shacham signatures (**BLS signatures**) are digital
+  signatures that provide a different set of tradeoffs compared to the
+  ECDSA and schnorr signatures currently used in Bitcoin.


Suggested change

ECDSA and schnorr signatures currently used in Bitcoin.

ECDSA and Schnorr signatures currently used in Bitcoin.

vostrnad · 2024-01-18T21:17:47Z

_topics/en/bls-signatures.md

+allow non-interactive signature aggregation.  For example, if Alice and
+Bob both independently sign the same transaction, a third party can
+combine their signatures into a single signature that proves both of
+them signed.  By comparison, using a Bitcoin's existing [schnorr


Suggested change

them signed. By comparison, using a Bitcoin's existing [schnorr

them signed. By comparison, using Bitcoin's existing [Schnorr

vostrnad · 2024-01-18T21:17:49Z

_topics/en/bls-signatures.md

+combine their signatures into a single signature that proves both of
+them signed.  By comparison, using a Bitcoin's existing [schnorr
+signatures][topic schnorr signatures], a single signature proving both
+of them signed can only be produce through an interactive protocol like


Suggested change

of them signed can only be produce through an interactive protocol like

of them signed can only be produced through an interactive protocol like

vostrnad · 2024-01-18T21:17:53Z

_topics/en/bls-signatures.md

+signatures was added, miners could aggregate all signatures together
+before producing a block, allowing blocks to contain only a single
+signature, which would moderately improve onchain capacity and might
+speed block verification when cached verification was unavailable (e.g.


Suggested change

speed block verification when cached verification was unavailable (e.g.

speed up block verification when cached verification is unavailable (e.g.

vostrnad · 2024-01-18T21:18:11Z

_topics/en/bls-signatures.md

+before producing a block, allowing blocks to contain only a single
+signature, which would moderately improve onchain capacity and might
+speed block verification when cached verification was unavailable (e.g.
+during initial block download).


Note that with assumevalid the vast majority of signatures already aren't validated during IBD.

vostrnad · 2024-01-18T21:18:13Z

_topics/en/bls-signatures.md

+during initial block download).
+
+BLS signatures are not directly compatible with the elliptic curve used
+by Bitcoin and are not as well studied as [schnorr signatures][topic


Suggested change

by Bitcoin and are not as well studied as [schnorr signatures][topic

by Bitcoin and are not as well studied as [Schnorr signatures][topic

murchandamus · 2024-01-18T21:35:11Z

@vostrnad: We treat "schnorr" (and also "merkle") as common nouns according to our style guide which is why they are not capitalized. I forgot the detailed explanation why @harding prefers that, but figured that I could point out that it was by-design.

vostrnad · 2024-01-18T21:43:00Z

@murchandamus You're right, I should have checked the style guide. Though I did grep the repo for uppercase "Schnorr" and found numerous instances, and also went online to try and find a single reliable source with lowercase "schnorr" and failed, so I'd very much like to hear that detailed explanation.

fjahr · 2024-01-19T15:46:59Z

ACK c22e5ae

The CISA part looks good to me, I will keep it in mind to come back in the future and add more details. I am not as familiar with the other topics but I gave them all a light read and didn't notice any issues.

harding · 2024-01-23T02:03:18Z

@vostrnad re: using proper names in terms of art, I have two reasons:

Mixing cases in the middle of a sentence makes skimming harder, as we use words starting with an upprecase character to help quickly identify that a new sentence has begun. Making writing easy to skim seems really important to me when working with professional readers who might already know 90% of this stuff and just need to find the part that's relevant to what they're currently working on.
Any name in a term of art is eventually going to be lowercased if it gets used frequently enough---think "algorithm"---so we might as well go straight to lowercasing anything we expect to use frequently.

bitschmidty

ACK changes from fcb2a53 and 5890e85

murchandamus reviewed Jan 16, 2024

View reviewed changes

murchandamus approved these changes Jan 18, 2024

View reviewed changes

vostrnad reviewed Jan 18, 2024

View reviewed changes

harding force-pushed the 2024-01-new-topics branch from c22e5ae to fcb2a53 Compare January 23, 2024 02:16

Topics: add several new topic pages

5890e85

harding force-pushed the 2024-01-new-topics branch from fcb2a53 to 5890e85 Compare January 23, 2024 15:20

bitschmidty reviewed Jan 23, 2024

View reviewed changes

bitschmidty merged commit 331f5a5 into bitcoinops:master Jan 24, 2024
2 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Topics: add several new topic pages #1467

Topics: add several new topic pages #1467

harding commented Jan 13, 2024

murchandamus left a comment

murchandamus Jan 16, 2024

fjahr Jan 16, 2024

harding Jan 18, 2024

murchandamus left a comment

vostrnad Jan 18, 2024 •

edited

Loading

harding Jan 23, 2024

vostrnad Jan 18, 2024

vostrnad Jan 18, 2024

harding Jan 23, 2024

vostrnad Jan 18, 2024

harding Jan 23, 2024

vostrnad Jan 23, 2024

harding Jan 23, 2024

vostrnad Jan 18, 2024

vostrnad Jan 18, 2024

vostrnad Jan 18, 2024

vostrnad Jan 18, 2024

vostrnad Jan 18, 2024

vostrnad Jan 18, 2024

murchandamus commented Jan 18, 2024

vostrnad commented Jan 18, 2024

fjahr commented Jan 19, 2024

harding commented Jan 23, 2024

bitschmidty left a comment

	- title: "Presentation: compact multisignatures for smaller blockchains"
	- title: "Presentation: Compact Multi-Signatures for Smaller Blockchains"

	- title: "Using Bitcoin-compatible BLS signatures for Discree Log Contracts (DLCs)"
	- title: "Using Bitcoin-compatible BLS signatures for Discreet Log Contracts (DLCs)"

	- title: "Question about schnorr signatures versus BLS signatures"
	- title: "Question about Schnorr signatures versus BLS signatures"

	Boneh-Lynn-Shacham signatures (BLS signatures) are digital
	Boneh–Lynn–Shacham signatures (BLS signatures) are digital

	ECDSA and schnorr signatures currently used in Bitcoin.
	ECDSA and Schnorr signatures currently used in Bitcoin.

	them signed. By comparison, using a Bitcoin's existing [schnorr
	them signed. By comparison, using Bitcoin's existing [Schnorr

	of them signed can only be produce through an interactive protocol like
	of them signed can only be produced through an interactive protocol like

	speed block verification when cached verification was unavailable (e.g.
	speed up block verification when cached verification is unavailable (e.g.

	by Bitcoin and are not as well studied as [schnorr signatures][topic
	by Bitcoin and are not as well studied as [Schnorr signatures][topic

Topics: add several new topic pages #1467

Topics: add several new topic pages #1467

Conversation

harding commented Jan 13, 2024

murchandamus left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

murchandamus left a comment

Choose a reason for hiding this comment

vostrnad Jan 18, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

murchandamus commented Jan 18, 2024

vostrnad commented Jan 18, 2024

fjahr commented Jan 19, 2024

harding commented Jan 23, 2024

bitschmidty left a comment

Choose a reason for hiding this comment

vostrnad Jan 18, 2024 •

edited

Loading