[#CreateMuSig2Nonce]
= CreateMuSig2Nonce
:mrdocs:

Generate a MuSig2 public nonce for a signing session and store the matching secret nonce.

== Synopsis

Declared in `<musig.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
std::vector<uint8_t>
CreateMuSig2Nonce(
    xref:MuSig2SecNonce.adoc[MuSig2SecNonce]& secnonce,
    xref:uint256.adoc[uint256] const& sighash,
    xref:CKey.adoc[CKey] const& our_seckey,
    xref:CPubKey.adoc[CPubKey] const& aggregate_pubkey,
    std::vector<CPubKey> const& pubkeys);
----

== Return Value

The serialized public nonce to share with the other participants.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *secnonce*
| Output holder that receives the secret nonce for this session.
| *sighash*
| The signature hash that will be signed in this session.
| *our_seckey*
| This participant's secret key.
| *aggregate_pubkey*
| The aggregate public key of all participants.
| *pubkeys*
| The participant public keys, in aggregation order.
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#