Skip to content

musig: add user documentation #45

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

Conversation

apoelstra
Copy link
Contributor

No description provided.

9. Any signer, or central coordinator, may combine the partial signatures to obtain
a complete signature using `secp256k1_musig_partial_sig_combine`. This function takes
a signing session and array of MuSig partial signatures, and outputs a single
Schnorr signature.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a small question: why is there no function for session closing / destruction?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh, yes, we should add one that zeroes out secret fields. I think we just overlooked this.

Use monospaced font for math expressions
API in ways that could lead to accidental signatures or loss of key material.

# Theory

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This paragraph uses "signers" and "participants" for the same thing. That's not necessarily bad it actually reminded me that there can be participants who are not signers (just listening -- and the code supports that). So maybe we should make that clearer.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ah I see that distinction is made below, so yes, I think it should be made here too

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I changed this paragraph.

@real-or-random
Copy link
Collaborator

LGTM

@apoelstra
Copy link
Contributor Author

Removed some docs from include file; added link to Blockstream blog post. @real-or-random @jonasnick thoughts?

@jonasnick
Copy link
Contributor

ACK

1 similar comment
@real-or-random
Copy link
Collaborator

ACK

@apoelstra apoelstra merged commit 1bbad3a into BlockstreamResearch:secp256k1-zkp Feb 21, 2019
@apoelstra apoelstra deleted the 2019-02-musig-docs branch February 21, 2019 17:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants