<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> <meta http-equiv="X-UA-Compatible" content="IE=9"/> <meta name="generator" content="Doxygen 1.8.14"/> <meta name="viewport" content="width=device-width, initial-scale=1"/> <title>Crypto++: mqv.h Source File</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> <script type="text/javascript" src="jquery.js"></script> <script type="text/javascript" src="dynsections.js"></script> <link href="doxygen.css" rel="stylesheet" type="text/css" /> </head> <body> <div id="top"><!-- do not remove this div, it is closed by doxygen! --> <div id="titlearea"> <table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;"> <td id="projectalign" style="padding-left: 0.5em;"> <div id="projectname">Crypto++  <span id="projectnumber">7.0</span> </div> <div id="projectbrief">Free C++ class library of cryptographic schemes</div> </td> </tr> </tbody> </table> </div> <!-- end header part --> <!-- Generated by Doxygen 1.8.14 --> <script type="text/javascript" src="menudata.js"></script> <script type="text/javascript" src="menu.js"></script> <script type="text/javascript"> /* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */ $(function() { initMenu('',false,false,'search.php','Search'); }); /* @license-end */</script> <div id="main-nav"></div> </div><!-- top --> <div class="header"> <div class="headertitle"> <div class="title">mqv.h</div> </div> </div><!--header--> <div class="contents"> <a href="mqv_8h.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> <span class="comment">// mqv.h - originally written and placed in the public domain by Wei Dai</span></div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> <span class="comment"></span></div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> <span class="comment">/// \file mqv.h</span></div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> <span class="comment">/// \brief Classes for Menezes–Qu–Vanstone (MQV) key agreement</span></div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> <span class="comment">/// \since Crypto++ 3.0</span></div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span> <span class="comment"></span></div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> <span class="preprocessor">#ifndef CRYPTOPP_MQV_H</span></div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span> <span class="preprocessor">#define CRYPTOPP_MQV_H</span></div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> </div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span> <span class="preprocessor">#include "<a class="code" href="cryptlib_8h.html">cryptlib.h</a>"</span></div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span> <span class="preprocessor">#include "<a class="code" href="gfpcrypt_8h.html">gfpcrypt.h</a>"</span></div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span> <span class="preprocessor">#include "<a class="code" href="modarith_8h.html">modarith.h</a>"</span></div><div class="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="preprocessor">#include "<a class="code" href="integer_8h.html">integer.h</a>"</span></div><div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="preprocessor">#include "<a class="code" href="algebra_8h.html">algebra.h</a>"</span></div><div class="line"><a name="l00015"></a><span class="lineno"> 15</span> <span class="preprocessor">#include "<a class="code" href="misc_8h.html">misc.h</a>"</span></div><div class="line"><a name="l00016"></a><span class="lineno"> 16</span> </div><div class="line"><a name="l00017"></a><span class="lineno"> 17</span> NAMESPACE_BEGIN(<a class="code" href="namespace_crypto_p_p.html">CryptoPP</a>)</div><div class="line"><a name="l00018"></a><span class="lineno"> 18</span> </div><div class="line"><a name="l00019"></a><span class="lineno"> 19</span> <span class="comment">/// \brief MQV domain for performing authenticated key agreement</span></div><div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="comment"></span><span class="comment">/// \tparam GROUP_PARAMETERS doamin parameters</span></div><div class="line"><a name="l00021"></a><span class="lineno"> 21</span> <span class="comment"></span><span class="comment">/// \tparam COFACTOR_OPTION cofactor option</span></div><div class="line"><a name="l00022"></a><span class="lineno"> 22</span> <span class="comment"></span><span class="comment">/// \details GROUP_PARAMETERS parameters include the curve coefcients and the base point.</span></div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span> <span class="comment"></span><span class="comment">/// Binary curves use a polynomial to represent its characteristic, while prime curves</span></div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="comment"></span><span class="comment">/// use a prime number.</span></div><div class="line"><a name="l00025"></a><span class="lineno"> 25</span> <span class="comment"></span><span class="comment">/// \sa MQV, HMQV, FHMQV, and AuthenticatedKeyAgreementDomain</span></div><div class="line"><a name="l00026"></a><span class="lineno"> 26</span> <span class="comment"></span><span class="comment">/// \since Crypto++ 3.0</span></div><div class="line"><a name="l00027"></a><span class="lineno"> 27</span> <span class="comment"></span><span class="keyword">template</span> <<span class="keyword">class</span> GROUP_PARAMETERS, <span class="keyword">class</span> COFACTOR_OPTION = <span class="keyword">typename</span> GROUP_PARAMETERS::DefaultCofactorOption></div><div class="line"><a name="l00028"></a><span class="lineno"><a class="line" href="class_m_q_v___domain.html"> 28</a></span> <span class="keyword">class </span><a class="code" href="class_m_q_v___domain.html">MQV_Domain</a> : <span class="keyword">public</span> <a class="code" href="class_authenticated_key_agreement_domain.html">AuthenticatedKeyAgreementDomain</a></div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span> {</div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span> <span class="keyword">public</span>:</div><div class="line"><a name="l00031"></a><span class="lineno"> 31</span>  <span class="keyword">typedef</span> GROUP_PARAMETERS GroupParameters;</div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span>  <span class="keyword">typedef</span> <span class="keyword">typename</span> GroupParameters::Element Element;</div><div class="line"><a name="l00033"></a><span class="lineno"> 33</span>  <span class="keyword">typedef</span> <a class="code" href="class_m_q_v___domain.html">MQV_Domain<GROUP_PARAMETERS, COFACTOR_OPTION></a> <a class="code" href="class_m_q_v___domain.html">Domain</a>;</div><div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="comment"></span></div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="comment"> /// \brief Construct a MQV domain</span></div><div class="line"><a name="l00036"></a><span class="lineno"><a class="line" href="class_m_q_v___domain.html#ae2b0485e16dceb4349f434d774830431"> 36</a></span> <span class="comment"></span> <a class="code" href="class_m_q_v___domain.html#ae2b0485e16dceb4349f434d774830431">MQV_Domain</a>() {}</div><div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span class="comment"></span></div><div class="line"><a name="l00038"></a><span class="lineno"> 38</span> <span class="comment"> /// \brief Construct a MQV domain</span></div><div class="line"><a name="l00039"></a><span class="lineno"> 39</span> <span class="comment"> /// \param params group parameters and options</span></div><div class="line"><a name="l00040"></a><span class="lineno"><a class="line" href="class_m_q_v___domain.html#a89a6c2d98cc463ae0355c9c52d950b18"> 40</a></span> <span class="comment"></span> <a class="code" href="class_m_q_v___domain.html#a89a6c2d98cc463ae0355c9c52d950b18">MQV_Domain</a>(<span class="keyword">const</span> GroupParameters &params)</div><div class="line"><a name="l00041"></a><span class="lineno"> 41</span>  : m_groupParameters(params) {}</div><div class="line"><a name="l00042"></a><span class="lineno"> 42</span> <span class="comment"></span></div><div class="line"><a name="l00043"></a><span class="lineno"> 43</span> <span class="comment"> /// \brief Construct a MQV domain</span></div><div class="line"><a name="l00044"></a><span class="lineno"> 44</span> <span class="comment"> /// \param bt BufferedTransformation with group parameters and options</span></div><div class="line"><a name="l00045"></a><span class="lineno"><a class="line" href="class_m_q_v___domain.html#a2c64fc7b2e78e07654f4ec77176aa0dd"> 45</a></span> <span class="comment"></span> <a class="code" href="class_m_q_v___domain.html#a2c64fc7b2e78e07654f4ec77176aa0dd">MQV_Domain</a>(<a class="code" href="class_buffered_transformation.html">BufferedTransformation</a> &bt)</div><div class="line"><a name="l00046"></a><span class="lineno"> 46</span>  {m_groupParameters.BERDecode(bt);}</div><div class="line"><a name="l00047"></a><span class="lineno"> 47</span> <span class="comment"></span></div><div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="comment"> /// \brief Construct a MQV domain</span></div><div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="comment"> /// \tparam T1 template parameter used as a constructor parameter</span></div><div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="comment"> /// \tparam T2 template parameter used as a constructor parameter</span></div><div class="line"><a name="l00051"></a><span class="lineno"> 51</span> <span class="comment"> /// \param v1 first parameter</span></div><div class="line"><a name="l00052"></a><span class="lineno"> 52</span> <span class="comment"> /// \param v2 second parameter</span></div><div class="line"><a name="l00053"></a><span class="lineno"> 53</span> <span class="comment"> /// \details v1 and v2 are passed directly to the GROUP_PARAMETERS object.</span></div><div class="line"><a name="l00054"></a><span class="lineno"> 54</span> <span class="comment"></span> <span class="keyword">template</span> <<span class="keyword">class</span> T1, <span class="keyword">class</span> T2></div><div class="line"><a name="l00055"></a><span class="lineno"><a class="line" href="class_m_q_v___domain.html#a0f3553af8a957e127be76fee7fb8878c"> 55</a></span>  <a class="code" href="class_m_q_v___domain.html#a0f3553af8a957e127be76fee7fb8878c">MQV_Domain</a>(T1 v1, T2 v2)</div><div class="line"><a name="l00056"></a><span class="lineno"> 56</span>  {m_groupParameters.Initialize(v1, v2);}</div><div class="line"><a name="l00057"></a><span class="lineno"> 57</span> <span class="comment"></span></div><div class="line"><a name="l00058"></a><span class="lineno"> 58</span> <span class="comment"> /// \brief Construct a MQV domain</span></div><div class="line"><a name="l00059"></a><span class="lineno"> 59</span> <span class="comment"> /// \tparam T1 template parameter used as a constructor parameter</span></div><div class="line"><a name="l00060"></a><span class="lineno"> 60</span> <span class="comment"> /// \tparam T2 template parameter used as a constructor parameter</span></div><div class="line"><a name="l00061"></a><span class="lineno"> 61</span> <span class="comment"> /// \tparam T3 template parameter used as a constructor parameter</span></div><div class="line"><a name="l00062"></a><span class="lineno"> 62</span> <span class="comment"> /// \param v1 first parameter</span></div><div class="line"><a name="l00063"></a><span class="lineno"> 63</span> <span class="comment"> /// \param v2 second parameter</span></div><div class="line"><a name="l00064"></a><span class="lineno"> 64</span> <span class="comment"> /// \param v3 third parameter</span></div><div class="line"><a name="l00065"></a><span class="lineno"> 65</span> <span class="comment"> /// \details v1, v2 and v3 are passed directly to the GROUP_PARAMETERS object.</span></div><div class="line"><a name="l00066"></a><span class="lineno"> 66</span> <span class="comment"></span> <span class="keyword">template</span> <<span class="keyword">class</span> T1, <span class="keyword">class</span> T2, <span class="keyword">class</span> T3></div><div class="line"><a name="l00067"></a><span class="lineno"><a class="line" href="class_m_q_v___domain.html#aa0d4a0d10dc7acd0265af242758c2b53"> 67</a></span>  <a class="code" href="class_m_q_v___domain.html#aa0d4a0d10dc7acd0265af242758c2b53">MQV_Domain</a>(T1 v1, T2 v2, T3 v3)</div><div class="line"><a name="l00068"></a><span class="lineno"> 68</span>  {m_groupParameters.Initialize(v1, v2, v3);}</div><div class="line"><a name="l00069"></a><span class="lineno"> 69</span> <span class="comment"></span></div><div class="line"><a name="l00070"></a><span class="lineno"> 70</span> <span class="comment"> /// \brief Construct a MQV domain</span></div><div class="line"><a name="l00071"></a><span class="lineno"> 71</span> <span class="comment"> /// \tparam T1 template parameter used as a constructor parameter</span></div><div class="line"><a name="l00072"></a><span class="lineno"> 72</span> <span class="comment"> /// \tparam T2 template parameter used as a constructor parameter</span></div><div class="line"><a name="l00073"></a><span class="lineno"> 73</span> <span class="comment"> /// \tparam T3 template parameter used as a constructor parameter</span></div><div class="line"><a name="l00074"></a><span class="lineno"> 74</span> <span class="comment"> /// \tparam T4 template parameter used as a constructor parameter</span></div><div class="line"><a name="l00075"></a><span class="lineno"> 75</span> <span class="comment"> /// \param v1 first parameter</span></div><div class="line"><a name="l00076"></a><span class="lineno"> 76</span> <span class="comment"> /// \param v2 second parameter</span></div><div class="line"><a name="l00077"></a><span class="lineno"> 77</span> <span class="comment"> /// \param v3 third parameter</span></div><div class="line"><a name="l00078"></a><span class="lineno"> 78</span> <span class="comment"> /// \param v4 third parameter</span></div><div class="line"><a name="l00079"></a><span class="lineno"> 79</span> <span class="comment"> /// \details v1, v2, v3 and v4 are passed directly to the GROUP_PARAMETERS object.</span></div><div class="line"><a name="l00080"></a><span class="lineno"> 80</span> <span class="comment"></span> <span class="keyword">template</span> <<span class="keyword">class</span> T1, <span class="keyword">class</span> T2, <span class="keyword">class</span> T3, <span class="keyword">class</span> T4></div><div class="line"><a name="l00081"></a><span class="lineno"><a class="line" href="class_m_q_v___domain.html#a805ea6821887fd27eab3f2210950adcd"> 81</a></span>  <a class="code" href="class_m_q_v___domain.html#a805ea6821887fd27eab3f2210950adcd">MQV_Domain</a>(T1 v1, T2 v2, T3 v3, T4 v4)</div><div class="line"><a name="l00082"></a><span class="lineno"> 82</span>  {m_groupParameters.Initialize(v1, v2, v3, v4);}</div><div class="line"><a name="l00083"></a><span class="lineno"> 83</span> <span class="comment"></span></div><div class="line"><a name="l00084"></a><span class="lineno"> 84</span> <span class="comment"> /// \brief Retrieves the group parameters for this domain</span></div><div class="line"><a name="l00085"></a><span class="lineno"> 85</span> <span class="comment"> /// \return the group parameters for this domain as a const reference</span></div><div class="line"><a name="l00086"></a><span class="lineno"><a class="line" href="class_m_q_v___domain.html#acba0479b43a31a97b7e0b38661acd50a"> 86</a></span> <span class="comment"></span> <span class="keyword">const</span> GroupParameters & <a class="code" href="class_m_q_v___domain.html#acba0479b43a31a97b7e0b38661acd50a">GetGroupParameters</a>()<span class="keyword"> const </span>{<span class="keywordflow">return</span> m_groupParameters;}</div><div class="line"><a name="l00087"></a><span class="lineno"> 87</span> <span class="comment"></span></div><div class="line"><a name="l00088"></a><span class="lineno"> 88</span> <span class="comment"> /// \brief Retrieves the group parameters for this domain</span></div><div class="line"><a name="l00089"></a><span class="lineno"> 89</span> <span class="comment"> /// \return the group parameters for this domain as a non-const reference</span></div><div class="line"><a name="l00090"></a><span class="lineno"><a class="line" href="class_m_q_v___domain.html#aa2af02b1905ff725e7f8fb379ac64940"> 90</a></span> <span class="comment"></span> GroupParameters & <a class="code" href="class_m_q_v___domain.html#aa2af02b1905ff725e7f8fb379ac64940">AccessGroupParameters</a>() {<span class="keywordflow">return</span> m_groupParameters;}</div><div class="line"><a name="l00091"></a><span class="lineno"> 91</span> <span class="comment"></span></div><div class="line"><a name="l00092"></a><span class="lineno"> 92</span> <span class="comment"> /// \brief Retrieves the crypto parameters for this domain</span></div><div class="line"><a name="l00093"></a><span class="lineno"> 93</span> <span class="comment"> /// \return the crypto parameters for this domain as a non-const reference</span></div><div class="line"><a name="l00094"></a><span class="lineno"><a class="line" href="class_m_q_v___domain.html#af4dda134c82bac3cd13bb1b468159cde"> 94</a></span> <span class="comment"></span> <a class="code" href="class_crypto_parameters.html">CryptoParameters</a> & <a class="code" href="class_m_q_v___domain.html#af4dda134c82bac3cd13bb1b468159cde">AccessCryptoParameters</a>() {<span class="keywordflow">return</span> AccessAbstractGroupParameters();}</div><div class="line"><a name="l00095"></a><span class="lineno"> 95</span> <span class="comment"></span></div><div class="line"><a name="l00096"></a><span class="lineno"> 96</span> <span class="comment"> /// \brief Provides the size of the agreed value</span></div><div class="line"><a name="l00097"></a><span class="lineno"> 97</span> <span class="comment"> /// \return size of agreed value produced in this domain</span></div><div class="line"><a name="l00098"></a><span class="lineno"> 98</span> <span class="comment"> /// \details The length is calculated using <tt>GetEncodedElementSize(false)</tt>, which means the</span></div><div class="line"><a name="l00099"></a><span class="lineno"> 99</span> <span class="comment"> /// element is encoded in a non-reversible format. A non-reversible format means its a raw byte array,</span></div><div class="line"><a name="l00100"></a><span class="lineno"> 100</span> <span class="comment"> /// and it lacks presentation format like an ASN.1 BIT_STRING or OCTET_STRING.</span></div><div class="line"><a name="l00101"></a><span class="lineno"><a class="line" href="class_m_q_v___domain.html#a6558a699673c7de656379ef801e3bae1"> 101</a></span> <span class="comment"></span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="class_m_q_v___domain.html#a6558a699673c7de656379ef801e3bae1">AgreedValueLength</a>()<span class="keyword"> const </span>{<span class="keywordflow">return</span> GetAbstractGroupParameters().GetEncodedElementSize(<span class="keyword">false</span>);}</div><div class="line"><a name="l00102"></a><span class="lineno"> 102</span> <span class="comment"></span></div><div class="line"><a name="l00103"></a><span class="lineno"> 103</span> <span class="comment"> /// \brief Provides the size of the static private key</span></div><div class="line"><a name="l00104"></a><span class="lineno"> 104</span> <span class="comment"> /// \return size of static private keys in this domain</span></div><div class="line"><a name="l00105"></a><span class="lineno"> 105</span> <span class="comment"> /// \details The length is calculated using the byte count of the subgroup order.</span></div><div class="line"><a name="l00106"></a><span class="lineno"><a class="line" href="class_m_q_v___domain.html#a95a8aed92bc010a5b048902bcc30da37"> 106</a></span> <span class="comment"></span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="class_m_q_v___domain.html#a95a8aed92bc010a5b048902bcc30da37">StaticPrivateKeyLength</a>()<span class="keyword"> const </span>{<span class="keywordflow">return</span> GetAbstractGroupParameters().GetSubgroupOrder().ByteCount();}</div><div class="line"><a name="l00107"></a><span class="lineno"> 107</span> <span class="comment"></span></div><div class="line"><a name="l00108"></a><span class="lineno"> 108</span> <span class="comment"> /// \brief Provides the size of the static public key</span></div><div class="line"><a name="l00109"></a><span class="lineno"> 109</span> <span class="comment"> /// \return size of static public keys in this domain</span></div><div class="line"><a name="l00110"></a><span class="lineno"> 110</span> <span class="comment"> /// \details The length is calculated using <tt>GetEncodedElementSize(true)</tt>, which means the</span></div><div class="line"><a name="l00111"></a><span class="lineno"> 111</span> <span class="comment"> /// element is encoded in a reversible format. A reversible format means it has a presentation format,</span></div><div class="line"><a name="l00112"></a><span class="lineno"> 112</span> <span class="comment"> /// and its an ANS.1 encoded element or point.</span></div><div class="line"><a name="l00113"></a><span class="lineno"><a class="line" href="class_m_q_v___domain.html#ac2623ab1d98b3de87b35be50bc1e797f"> 113</a></span> <span class="comment"></span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="class_m_q_v___domain.html#ac2623ab1d98b3de87b35be50bc1e797f">StaticPublicKeyLength</a>()<span class="keyword"> const </span>{<span class="keywordflow">return</span> GetAbstractGroupParameters().GetEncodedElementSize(<span class="keyword">true</span>);}</div><div class="line"><a name="l00114"></a><span class="lineno"> 114</span> <span class="comment"></span></div><div class="line"><a name="l00115"></a><span class="lineno"> 115</span> <span class="comment"> /// \brief Generate static private key in this domain</span></div><div class="line"><a name="l00116"></a><span class="lineno"> 116</span> <span class="comment"> /// \param rng a RandomNumberGenerator derived class</span></div><div class="line"><a name="l00117"></a><span class="lineno"> 117</span> <span class="comment"> /// \param privateKey a byte buffer for the generated private key in this domain</span></div><div class="line"><a name="l00118"></a><span class="lineno"> 118</span> <span class="comment"> /// \details The private key is a random scalar used as an exponent in the range <tt>[1,MaxExponent()]</tt>.</span></div><div class="line"><a name="l00119"></a><span class="lineno"> 119</span> <span class="comment"> /// \pre <tt>COUNTOF(privateKey) == PrivateStaticKeyLength()</tt></span></div><div class="line"><a name="l00120"></a><span class="lineno"><a class="line" href="class_m_q_v___domain.html#a39b60e2dbf9ea3028d63f0dfc81d0cfb"> 120</a></span> <span class="comment"></span> <span class="keywordtype">void</span> <a class="code" href="class_m_q_v___domain.html#a39b60e2dbf9ea3028d63f0dfc81d0cfb">GenerateStaticPrivateKey</a>(<a class="code" href="class_random_number_generator.html">RandomNumberGenerator</a> &rng, byte *privateKey)<span class="keyword"> const</span></div><div class="line"><a name="l00121"></a><span class="lineno"> 121</span> <span class="keyword"> </span>{</div><div class="line"><a name="l00122"></a><span class="lineno"> 122</span>  <a class="code" href="class_integer.html">Integer</a> x(rng, <a class="code" href="class_integer.html#a8c070592581bf6c2f928c72bfa1c1638">Integer::One</a>(), GetAbstractGroupParameters().GetMaxExponent());</div><div class="line"><a name="l00123"></a><span class="lineno"> 123</span>  x.Encode(privateKey, <a class="code" href="class_m_q_v___domain.html#a95a8aed92bc010a5b048902bcc30da37">StaticPrivateKeyLength</a>());</div><div class="line"><a name="l00124"></a><span class="lineno"> 124</span>  }</div><div class="line"><a name="l00125"></a><span class="lineno"> 125</span> <span class="comment"></span></div><div class="line"><a name="l00126"></a><span class="lineno"> 126</span> <span class="comment"> /// \brief Generate a static public key from a private key in this domain</span></div><div class="line"><a name="l00127"></a><span class="lineno"> 127</span> <span class="comment"> /// \param rng a RandomNumberGenerator derived class</span></div><div class="line"><a name="l00128"></a><span class="lineno"> 128</span> <span class="comment"> /// \param privateKey a byte buffer with the previously generated private key</span></div><div class="line"><a name="l00129"></a><span class="lineno"> 129</span> <span class="comment"> /// \param publicKey a byte buffer for the generated public key in this domain</span></div><div class="line"><a name="l00130"></a><span class="lineno"> 130</span> <span class="comment"> /// \details The public key is an element or point on the curve, and its stored in a revrsible format.</span></div><div class="line"><a name="l00131"></a><span class="lineno"> 131</span> <span class="comment"> /// A reversible format means it has a presentation format, and its an ANS.1 encoded element or point.</span></div><div class="line"><a name="l00132"></a><span class="lineno"> 132</span> <span class="comment"> /// \pre <tt>COUNTOF(publicKey) == PublicStaticKeyLength()</tt></span></div><div class="line"><a name="l00133"></a><span class="lineno"><a class="line" href="class_m_q_v___domain.html#a5ce4df4bf76fe67038393e53e6dfe84d"> 133</a></span> <span class="comment"></span> <span class="keywordtype">void</span> <a class="code" href="class_m_q_v___domain.html#a5ce4df4bf76fe67038393e53e6dfe84d">GenerateStaticPublicKey</a>(<a class="code" href="class_random_number_generator.html">RandomNumberGenerator</a> &rng, <span class="keyword">const</span> byte *privateKey, byte *publicKey)<span class="keyword"> const</span></div><div class="line"><a name="l00134"></a><span class="lineno"> 134</span> <span class="keyword"> </span>{</div><div class="line"><a name="l00135"></a><span class="lineno"> 135</span>  CRYPTOPP_UNUSED(rng);</div><div class="line"><a name="l00136"></a><span class="lineno"> 136</span>  <span class="keyword">const</span> <a class="code" href="class_d_l___group_parameters.html">DL_GroupParameters<Element></a> &params = GetAbstractGroupParameters();</div><div class="line"><a name="l00137"></a><span class="lineno"> 137</span>  <a class="code" href="class_integer.html">Integer</a> x(privateKey, <a class="code" href="class_m_q_v___domain.html#a95a8aed92bc010a5b048902bcc30da37">StaticPrivateKeyLength</a>());</div><div class="line"><a name="l00138"></a><span class="lineno"> 138</span>  Element y = params.<a class="code" href="class_d_l___group_parameters.html#ae5bf9692b8879e0ed5ad7e16a696818d">ExponentiateBase</a>(x);</div><div class="line"><a name="l00139"></a><span class="lineno"> 139</span>  params.<a class="code" href="class_d_l___group_parameters.html#a71c6058bd5ddcd54bd36565b0ba0cae0">EncodeElement</a>(<span class="keyword">true</span>, y, publicKey);</div><div class="line"><a name="l00140"></a><span class="lineno"> 140</span>  }</div><div class="line"><a name="l00141"></a><span class="lineno"> 141</span> </div><div class="line"><a name="l00142"></a><span class="lineno"><a class="line" href="class_m_q_v___domain.html#a2e8c585ba17f8eb0ddf10cb2c6c4b0dc"> 142</a></span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="class_m_q_v___domain.html#a2e8c585ba17f8eb0ddf10cb2c6c4b0dc">EphemeralPrivateKeyLength</a>()<span class="keyword"> const </span>{<span class="keywordflow">return</span> <a class="code" href="class_m_q_v___domain.html#a95a8aed92bc010a5b048902bcc30da37">StaticPrivateKeyLength</a>() + <a class="code" href="class_m_q_v___domain.html#ac2623ab1d98b3de87b35be50bc1e797f">StaticPublicKeyLength</a>();}</div><div class="line"><a name="l00143"></a><span class="lineno"><a class="line" href="class_m_q_v___domain.html#a071369fe7462d070cbdf0521b8fb5edd"> 143</a></span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="class_m_q_v___domain.html#a071369fe7462d070cbdf0521b8fb5edd">EphemeralPublicKeyLength</a>()<span class="keyword"> const </span>{<span class="keywordflow">return</span> <a class="code" href="class_m_q_v___domain.html#ac2623ab1d98b3de87b35be50bc1e797f">StaticPublicKeyLength</a>();}</div><div class="line"><a name="l00144"></a><span class="lineno"> 144</span> </div><div class="line"><a name="l00145"></a><span class="lineno"><a class="line" href="class_m_q_v___domain.html#a6b07e1e10bf1d8b9f1a4644eef74ea43"> 145</a></span>  <span class="keywordtype">void</span> <a class="code" href="class_m_q_v___domain.html#a6b07e1e10bf1d8b9f1a4644eef74ea43">GenerateEphemeralPrivateKey</a>(<a class="code" href="class_random_number_generator.html">RandomNumberGenerator</a> &rng, byte *privateKey)<span class="keyword"> const</span></div><div class="line"><a name="l00146"></a><span class="lineno"> 146</span> <span class="keyword"> </span>{</div><div class="line"><a name="l00147"></a><span class="lineno"> 147</span>  <span class="keyword">const</span> <a class="code" href="class_d_l___group_parameters.html">DL_GroupParameters<Element></a> &params = GetAbstractGroupParameters();</div><div class="line"><a name="l00148"></a><span class="lineno"> 148</span>  <a class="code" href="class_integer.html">Integer</a> x(rng, <a class="code" href="class_integer.html#a8c070592581bf6c2f928c72bfa1c1638">Integer::One</a>(), params.<a class="code" href="class_d_l___group_parameters.html#a7275e04a4d21d985e698bb191e6cbdf1">GetMaxExponent</a>());</div><div class="line"><a name="l00149"></a><span class="lineno"> 149</span>  x.Encode(privateKey, <a class="code" href="class_m_q_v___domain.html#a95a8aed92bc010a5b048902bcc30da37">StaticPrivateKeyLength</a>());</div><div class="line"><a name="l00150"></a><span class="lineno"> 150</span>  Element y = params.<a class="code" href="class_d_l___group_parameters.html#ae5bf9692b8879e0ed5ad7e16a696818d">ExponentiateBase</a>(x);</div><div class="line"><a name="l00151"></a><span class="lineno"> 151</span>  params.<a class="code" href="class_d_l___group_parameters.html#a71c6058bd5ddcd54bd36565b0ba0cae0">EncodeElement</a>(<span class="keyword">true</span>, y, privateKey+<a class="code" href="class_m_q_v___domain.html#a95a8aed92bc010a5b048902bcc30da37">StaticPrivateKeyLength</a>());</div><div class="line"><a name="l00152"></a><span class="lineno"> 152</span>  }</div><div class="line"><a name="l00153"></a><span class="lineno"> 153</span> </div><div class="line"><a name="l00154"></a><span class="lineno"><a class="line" href="class_m_q_v___domain.html#a2dd74c07dd93b000b48e689b30809373"> 154</a></span>  <span class="keywordtype">void</span> <a class="code" href="class_m_q_v___domain.html#a2dd74c07dd93b000b48e689b30809373">GenerateEphemeralPublicKey</a>(<a class="code" href="class_random_number_generator.html">RandomNumberGenerator</a> &rng, <span class="keyword">const</span> byte *privateKey, byte *publicKey)<span class="keyword"> const</span></div><div class="line"><a name="l00155"></a><span class="lineno"> 155</span> <span class="keyword"> </span>{</div><div class="line"><a name="l00156"></a><span class="lineno"> 156</span>  CRYPTOPP_UNUSED(rng);</div><div class="line"><a name="l00157"></a><span class="lineno"> 157</span>  memcpy(publicKey, privateKey+<a class="code" href="class_m_q_v___domain.html#a95a8aed92bc010a5b048902bcc30da37">StaticPrivateKeyLength</a>(), <a class="code" href="class_m_q_v___domain.html#a071369fe7462d070cbdf0521b8fb5edd">EphemeralPublicKeyLength</a>());</div><div class="line"><a name="l00158"></a><span class="lineno"> 158</span>  }</div><div class="line"><a name="l00159"></a><span class="lineno"> 159</span> </div><div class="line"><a name="l00160"></a><span class="lineno"><a class="line" href="class_m_q_v___domain.html#a818955f5764130bb4e00f5c061d39be2"> 160</a></span>  <span class="keywordtype">bool</span> <a class="code" href="class_m_q_v___domain.html#a818955f5764130bb4e00f5c061d39be2">Agree</a>(byte *agreedValue,</div><div class="line"><a name="l00161"></a><span class="lineno"> 161</span>  <span class="keyword">const</span> byte *staticPrivateKey, <span class="keyword">const</span> byte *ephemeralPrivateKey,</div><div class="line"><a name="l00162"></a><span class="lineno"> 162</span>  <span class="keyword">const</span> byte *staticOtherPublicKey, <span class="keyword">const</span> byte *ephemeralOtherPublicKey,</div><div class="line"><a name="l00163"></a><span class="lineno"> 163</span>  <span class="keywordtype">bool</span> validateStaticOtherPublicKey=<span class="keyword">true</span>)<span class="keyword"> const</span></div><div class="line"><a name="l00164"></a><span class="lineno"> 164</span> <span class="keyword"> </span>{</div><div class="line"><a name="l00165"></a><span class="lineno"> 165</span>  <span class="keywordflow">try</span></div><div class="line"><a name="l00166"></a><span class="lineno"> 166</span>  {</div><div class="line"><a name="l00167"></a><span class="lineno"> 167</span>  <span class="keyword">const</span> <a class="code" href="class_d_l___group_parameters.html">DL_GroupParameters<Element></a> &params = GetAbstractGroupParameters();</div><div class="line"><a name="l00168"></a><span class="lineno"> 168</span>  Element WW = params.<a class="code" href="class_d_l___group_parameters.html#af3dc6d48394c356bb30dc72371aa02e7">DecodeElement</a>(staticOtherPublicKey, validateStaticOtherPublicKey);</div><div class="line"><a name="l00169"></a><span class="lineno"> 169</span>  Element VV = params.<a class="code" href="class_d_l___group_parameters.html#af3dc6d48394c356bb30dc72371aa02e7">DecodeElement</a>(ephemeralOtherPublicKey, <span class="keyword">true</span>);</div><div class="line"><a name="l00170"></a><span class="lineno"> 170</span> </div><div class="line"><a name="l00171"></a><span class="lineno"> 171</span>  <a class="code" href="class_integer.html">Integer</a> s(staticPrivateKey, <a class="code" href="class_m_q_v___domain.html#a95a8aed92bc010a5b048902bcc30da37">StaticPrivateKeyLength</a>());</div><div class="line"><a name="l00172"></a><span class="lineno"> 172</span>  <a class="code" href="class_integer.html">Integer</a> u(ephemeralPrivateKey, <a class="code" href="class_m_q_v___domain.html#a95a8aed92bc010a5b048902bcc30da37">StaticPrivateKeyLength</a>());</div><div class="line"><a name="l00173"></a><span class="lineno"> 173</span>  Element V = params.<a class="code" href="class_d_l___group_parameters.html#af3dc6d48394c356bb30dc72371aa02e7">DecodeElement</a>(ephemeralPrivateKey+<a class="code" href="class_m_q_v___domain.html#a95a8aed92bc010a5b048902bcc30da37">StaticPrivateKeyLength</a>(), <span class="keyword">false</span>);</div><div class="line"><a name="l00174"></a><span class="lineno"> 174</span> </div><div class="line"><a name="l00175"></a><span class="lineno"> 175</span>  <span class="keyword">const</span> <a class="code" href="class_integer.html">Integer</a> &r = params.<a class="code" href="class_d_l___group_parameters.html#aeff4e59562d2c9b0ffc6b677e8ce409a">GetSubgroupOrder</a>();</div><div class="line"><a name="l00176"></a><span class="lineno"> 176</span>  <a class="code" href="class_integer.html">Integer</a> h2 = <a class="code" href="class_integer.html#ade53248f5dbb520273a70856b975417c">Integer::Power2</a>((r.<a class="code" href="class_integer.html#a867356d88074424328d0ebb9bea63254">BitCount</a>()+1)/2);</div><div class="line"><a name="l00177"></a><span class="lineno"> 177</span>  <a class="code" href="class_integer.html">Integer</a> e = ((h2+params.<a class="code" href="class_d_l___group_parameters.html#afb36d983bb45fe3b8acb1767c0060700">ConvertElementToInteger</a>(V)%h2)*s+u) % r;</div><div class="line"><a name="l00178"></a><span class="lineno"> 178</span>  <a class="code" href="class_integer.html">Integer</a> tt = h2 + params.<a class="code" href="class_d_l___group_parameters.html#afb36d983bb45fe3b8acb1767c0060700">ConvertElementToInteger</a>(VV) % h2;</div><div class="line"><a name="l00179"></a><span class="lineno"> 179</span> </div><div class="line"><a name="l00180"></a><span class="lineno"> 180</span>  <span class="keywordflow">if</span> (COFACTOR_OPTION::ToEnum() == <a class="code" href="pubkey_8h.html#ae4b59f7b9d3c7e03bb739f0584905ff1a69418ae10529f1fab66df8063ea9d286">NO_COFACTOR_MULTIPLICTION</a>)</div><div class="line"><a name="l00181"></a><span class="lineno"> 181</span>  {</div><div class="line"><a name="l00182"></a><span class="lineno"> 182</span>  Element P = params.<a class="code" href="class_d_l___group_parameters.html#a11e487f345f8f9831f550647c0a609b0">ExponentiateElement</a>(WW, tt);</div><div class="line"><a name="l00183"></a><span class="lineno"> 183</span>  P = m_groupParameters.MultiplyElements(P, VV);</div><div class="line"><a name="l00184"></a><span class="lineno"> 184</span>  Element R[2];</div><div class="line"><a name="l00185"></a><span class="lineno"> 185</span>  <span class="keyword">const</span> <a class="code" href="class_integer.html">Integer</a> e2[2] = {r, e};</div><div class="line"><a name="l00186"></a><span class="lineno"> 186</span>  params.<a class="code" href="class_d_l___group_parameters.html#ac11607926a66ce8ba8ae273a5b0464e7">SimultaneousExponentiate</a>(R, P, e2, 2);</div><div class="line"><a name="l00187"></a><span class="lineno"> 187</span>  <span class="keywordflow">if</span> (!params.<a class="code" href="class_d_l___group_parameters.html#afb67ae388bba22447e45a74f87b2630b">IsIdentity</a>(R[0]) || params.<a class="code" href="class_d_l___group_parameters.html#afb67ae388bba22447e45a74f87b2630b">IsIdentity</a>(R[1]))</div><div class="line"><a name="l00188"></a><span class="lineno"> 188</span>  <span class="keywordflow">return</span> <span class="keyword">false</span>;</div><div class="line"><a name="l00189"></a><span class="lineno"> 189</span>  params.<a class="code" href="class_d_l___group_parameters.html#a71c6058bd5ddcd54bd36565b0ba0cae0">EncodeElement</a>(<span class="keyword">false</span>, R[1], agreedValue);</div><div class="line"><a name="l00190"></a><span class="lineno"> 190</span>  }</div><div class="line"><a name="l00191"></a><span class="lineno"> 191</span>  <span class="keywordflow">else</span></div><div class="line"><a name="l00192"></a><span class="lineno"> 192</span>  {</div><div class="line"><a name="l00193"></a><span class="lineno"> 193</span>  <span class="keyword">const</span> <a class="code" href="class_integer.html">Integer</a> &k = params.<a class="code" href="class_d_l___group_parameters.html#a1a7a2e50499872d2be408aa36621bf91">GetCofactor</a>();</div><div class="line"><a name="l00194"></a><span class="lineno"> 194</span>  <span class="keywordflow">if</span> (COFACTOR_OPTION::ToEnum() == <a class="code" href="pubkey_8h.html#ae4b59f7b9d3c7e03bb739f0584905ff1af008f1e77658d1f047d77a9524f68276">COMPATIBLE_COFACTOR_MULTIPLICTION</a>)</div><div class="line"><a name="l00195"></a><span class="lineno"> 195</span>  e = <a class="code" href="class_modular_arithmetic.html">ModularArithmetic</a>(r).<a class="code" href="class_modular_arithmetic.html#a584d214676856d1463e14c6407d1cd31">Divide</a>(e, k);</div><div class="line"><a name="l00196"></a><span class="lineno"> 196</span>  Element P = m_groupParameters.CascadeExponentiate(VV, k*e, WW, k*(e*tt%r));</div><div class="line"><a name="l00197"></a><span class="lineno"> 197</span>  <span class="keywordflow">if</span> (params.<a class="code" href="class_d_l___group_parameters.html#afb67ae388bba22447e45a74f87b2630b">IsIdentity</a>(P))</div><div class="line"><a name="l00198"></a><span class="lineno"> 198</span>  <span class="keywordflow">return</span> <span class="keyword">false</span>;</div><div class="line"><a name="l00199"></a><span class="lineno"> 199</span>  params.<a class="code" href="class_d_l___group_parameters.html#a71c6058bd5ddcd54bd36565b0ba0cae0">EncodeElement</a>(<span class="keyword">false</span>, P, agreedValue);</div><div class="line"><a name="l00200"></a><span class="lineno"> 200</span>  }</div><div class="line"><a name="l00201"></a><span class="lineno"> 201</span>  }</div><div class="line"><a name="l00202"></a><span class="lineno"> 202</span>  <span class="keywordflow">catch</span> (<a class="code" href="class_d_l___bad_element.html">DL_BadElement</a> &)</div><div class="line"><a name="l00203"></a><span class="lineno"> 203</span>  {</div><div class="line"><a name="l00204"></a><span class="lineno"> 204</span>  <span class="keywordflow">return</span> <span class="keyword">false</span>;</div><div class="line"><a name="l00205"></a><span class="lineno"> 205</span>  }</div><div class="line"><a name="l00206"></a><span class="lineno"> 206</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>;</div><div class="line"><a name="l00207"></a><span class="lineno"> 207</span>  }</div><div class="line"><a name="l00208"></a><span class="lineno"> 208</span> </div><div class="line"><a name="l00209"></a><span class="lineno"> 209</span> <span class="keyword">private</span>:</div><div class="line"><a name="l00210"></a><span class="lineno"> 210</span>  <a class="code" href="class_d_l___group_parameters.html">DL_GroupParameters<Element></a> & AccessAbstractGroupParameters() {<span class="keywordflow">return</span> m_groupParameters;}</div><div class="line"><a name="l00211"></a><span class="lineno"> 211</span>  <span class="keyword">const</span> <a class="code" href="class_d_l___group_parameters.html">DL_GroupParameters<Element></a> & GetAbstractGroupParameters()<span class="keyword"> const </span>{<span class="keywordflow">return</span> m_groupParameters;}</div><div class="line"><a name="l00212"></a><span class="lineno"> 212</span> </div><div class="line"><a name="l00213"></a><span class="lineno"> 213</span>  GroupParameters m_groupParameters;</div><div class="line"><a name="l00214"></a><span class="lineno"> 214</span> };</div><div class="line"><a name="l00215"></a><span class="lineno"> 215</span> <span class="comment"></span></div><div class="line"><a name="l00216"></a><span class="lineno"> 216</span> <span class="comment">/// Menezes-Qu-Vanstone in GF(p) with key validation, AKA <a href="http://www.weidai.com/scan-mirror/ka.html#MQV">MQV</a></span></div><div class="line"><a name="l00217"></a><span class="lineno"> 217</span> <span class="comment">/// \sa MQV, HMQV_Domain, FHMQV_Domain, AuthenticatedKeyAgreementDomain</span></div><div class="line"><a name="l00218"></a><span class="lineno"> 218</span> <span class="comment">/// \since Crypto++ 3.0</span></div><div class="line"><a name="l00219"></a><span class="lineno"><a class="line" href="mqv_8h.html#a55efec2ab777263bc0d165afa0c3fe3b"> 219</a></span> <span class="comment"></span><span class="keyword">typedef</span> <a class="code" href="class_m_q_v___domain.html">MQV_Domain<DL_GroupParameters_GFP_DefaultSafePrime></a> <a class="code" href="mqv_8h.html#a55efec2ab777263bc0d165afa0c3fe3b">MQV</a>;</div><div class="line"><a name="l00220"></a><span class="lineno"> 220</span> </div><div class="line"><a name="l00221"></a><span class="lineno"> 221</span> NAMESPACE_END</div><div class="line"><a name="l00222"></a><span class="lineno"> 222</span> </div><div class="line"><a name="l00223"></a><span class="lineno"> 223</span> <span class="preprocessor">#endif</span></div><div class="ttc" id="class_m_q_v___domain_html_a5ce4df4bf76fe67038393e53e6dfe84d"><div class="ttname"><a href="class_m_q_v___domain.html#a5ce4df4bf76fe67038393e53e6dfe84d">MQV_Domain::GenerateStaticPublicKey</a></div><div class="ttdeci">void GenerateStaticPublicKey(RandomNumberGenerator &rng, const byte *privateKey, byte *publicKey) const</div><div class="ttdoc">Generate a static public key from a private key in this domain. </div><div class="ttdef"><b>Definition:</b> <a href="mqv_8h_source.html#l00133">mqv.h:133</a></div></div> <div class="ttc" id="class_m_q_v___domain_html_a0f3553af8a957e127be76fee7fb8878c"><div class="ttname"><a href="class_m_q_v___domain.html#a0f3553af8a957e127be76fee7fb8878c">MQV_Domain::MQV_Domain</a></div><div class="ttdeci">MQV_Domain(T1 v1, T2 v2)</div><div class="ttdoc">Construct a MQV domain. </div><div class="ttdef"><b>Definition:</b> <a href="mqv_8h_source.html#l00055">mqv.h:55</a></div></div> <div class="ttc" id="class_d_l___group_parameters_html_a1a7a2e50499872d2be408aa36621bf91"><div class="ttname"><a href="class_d_l___group_parameters.html#a1a7a2e50499872d2be408aa36621bf91">DL_GroupParameters::GetCofactor</a></div><div class="ttdeci">virtual Integer GetCofactor() const</div><div class="ttdoc">Retrieves the cofactor. </div><div class="ttdef"><b>Definition:</b> <a href="pubkey_8h_source.html#l00884">pubkey.h:884</a></div></div> <div class="ttc" id="class_modular_arithmetic_html_a584d214676856d1463e14c6407d1cd31"><div class="ttname"><a href="class_modular_arithmetic.html#a584d214676856d1463e14c6407d1cd31">ModularArithmetic::Divide</a></div><div class="ttdeci">const Integer & Divide(const Integer &a, const Integer &b) const</div><div class="ttdoc">Divides elements in the ring. </div><div class="ttdef"><b>Definition:</b> <a href="modarith_8h_source.html#l00202">modarith.h:202</a></div></div> <div class="ttc" id="misc_8h_html"><div class="ttname"><a href="misc_8h.html">misc.h</a></div><div class="ttdoc">Utility functions for the Crypto++ library. </div></div> <div class="ttc" id="class_m_q_v___domain_html_a818955f5764130bb4e00f5c061d39be2"><div class="ttname"><a href="class_m_q_v___domain.html#a818955f5764130bb4e00f5c061d39be2">MQV_Domain::Agree</a></div><div class="ttdeci">bool Agree(byte *agreedValue, const byte *staticPrivateKey, const byte *ephemeralPrivateKey, const byte *staticOtherPublicKey, const byte *ephemeralOtherPublicKey, bool validateStaticOtherPublicKey=true) const</div><div class="ttdoc">Derive agreed value. </div><div class="ttdef"><b>Definition:</b> <a href="mqv_8h_source.html#l00160">mqv.h:160</a></div></div> <div class="ttc" id="class_d_l___group_parameters_html"><div class="ttname"><a href="class_d_l___group_parameters.html">DL_GroupParameters</a></div><div class="ttdoc">Interface for Discrete Log (DL) group parameters. </div><div class="ttdef"><b>Definition:</b> <a href="pubkey_8h_source.html#l00753">pubkey.h:753</a></div></div> <div class="ttc" id="class_m_q_v___domain_html_a805ea6821887fd27eab3f2210950adcd"><div class="ttname"><a href="class_m_q_v___domain.html#a805ea6821887fd27eab3f2210950adcd">MQV_Domain::MQV_Domain</a></div><div class="ttdeci">MQV_Domain(T1 v1, T2 v2, T3 v3, T4 v4)</div><div class="ttdoc">Construct a MQV domain. </div><div class="ttdef"><b>Definition:</b> <a href="mqv_8h_source.html#l00081">mqv.h:81</a></div></div> <div class="ttc" id="cryptlib_8h_html"><div class="ttname"><a href="cryptlib_8h.html">cryptlib.h</a></div><div class="ttdoc">Abstract base classes that provide a uniform interface to this library. </div></div> <div class="ttc" id="class_d_l___group_parameters_html_afb36d983bb45fe3b8acb1767c0060700"><div class="ttname"><a href="class_d_l___group_parameters.html#afb36d983bb45fe3b8acb1767c0060700">DL_GroupParameters::ConvertElementToInteger</a></div><div class="ttdeci">virtual Integer ConvertElementToInteger(const Element &element) const =0</div><div class="ttdoc">Converts an element to an Integer. </div></div> <div class="ttc" id="class_modular_arithmetic_html"><div class="ttname"><a href="class_modular_arithmetic.html">ModularArithmetic</a></div><div class="ttdoc">Ring of congruence classes modulo n. </div><div class="ttdef"><b>Definition:</b> <a href="modarith_8h_source.html#l00038">modarith.h:38</a></div></div> <div class="ttc" id="class_random_number_generator_html"><div class="ttname"><a href="class_random_number_generator.html">RandomNumberGenerator</a></div><div class="ttdoc">Interface for random number generators. </div><div class="ttdef"><b>Definition:</b> <a href="cryptlib_8h_source.html#l01330">cryptlib.h:1330</a></div></div> <div class="ttc" id="class_m_q_v___domain_html_a2c64fc7b2e78e07654f4ec77176aa0dd"><div class="ttname"><a href="class_m_q_v___domain.html#a2c64fc7b2e78e07654f4ec77176aa0dd">MQV_Domain::MQV_Domain</a></div><div class="ttdeci">MQV_Domain(BufferedTransformation &bt)</div><div class="ttdoc">Construct a MQV domain. </div><div class="ttdef"><b>Definition:</b> <a href="mqv_8h_source.html#l00045">mqv.h:45</a></div></div> <div class="ttc" id="algebra_8h_html"><div class="ttname"><a href="algebra_8h.html">algebra.h</a></div><div class="ttdoc">Classes for performing mathematics over different fields. </div></div> <div class="ttc" id="class_buffered_transformation_html"><div class="ttname"><a href="class_buffered_transformation.html">BufferedTransformation</a></div><div class="ttdoc">Interface for buffered transformations. </div><div class="ttdef"><b>Definition:</b> <a href="cryptlib_8h_source.html#l01545">cryptlib.h:1545</a></div></div> <div class="ttc" id="class_d_l___group_parameters_html_ae5bf9692b8879e0ed5ad7e16a696818d"><div class="ttname"><a href="class_d_l___group_parameters.html#ae5bf9692b8879e0ed5ad7e16a696818d">DL_GroupParameters::ExponentiateBase</a></div><div class="ttdeci">virtual Element ExponentiateBase(const Integer &exponent) const</div><div class="ttdoc">Exponentiates the base. </div><div class="ttdef"><b>Definition:</b> <a href="pubkey_8h_source.html#l00839">pubkey.h:839</a></div></div> <div class="ttc" id="class_integer_html_a8c070592581bf6c2f928c72bfa1c1638"><div class="ttname"><a href="class_integer.html#a8c070592581bf6c2f928c72bfa1c1638">Integer::One</a></div><div class="ttdeci">static const Integer & One()</div><div class="ttdoc">Integer representing 1. </div><div class="ttdef"><b>Definition:</b> <a href="integer_8cpp_source.html#l04824">integer.cpp:4824</a></div></div> <div class="ttc" id="mqv_8h_html_a55efec2ab777263bc0d165afa0c3fe3b"><div class="ttname"><a href="mqv_8h.html#a55efec2ab777263bc0d165afa0c3fe3b">MQV</a></div><div class="ttdeci">MQV_Domain< DL_GroupParameters_GFP_DefaultSafePrime > MQV</div><div class="ttdoc">Menezes-Qu-Vanstone in GF(p) with key validation, AKA MQV </div><div class="ttdef"><b>Definition:</b> <a href="mqv_8h_source.html#l00219">mqv.h:219</a></div></div> <div class="ttc" id="pubkey_8h_html_ae4b59f7b9d3c7e03bb739f0584905ff1af008f1e77658d1f047d77a9524f68276"><div class="ttname"><a href="pubkey_8h.html#ae4b59f7b9d3c7e03bb739f0584905ff1af008f1e77658d1f047d77a9524f68276">COMPATIBLE_COFACTOR_MULTIPLICTION</a></div><div class="ttdoc">Cofactor multiplication compatible with ordinary Diffie-Hellman. </div><div class="ttdef"><b>Definition:</b> <a href="pubkey_8h_source.html#l02066">pubkey.h:2066</a></div></div> <div class="ttc" id="class_m_q_v___domain_html"><div class="ttname"><a href="class_m_q_v___domain.html">MQV_Domain</a></div><div class="ttdoc">MQV domain for performing authenticated key agreement. </div><div class="ttdef"><b>Definition:</b> <a href="mqv_8h_source.html#l00028">mqv.h:28</a></div></div> <div class="ttc" id="pubkey_8h_html_ae4b59f7b9d3c7e03bb739f0584905ff1a69418ae10529f1fab66df8063ea9d286"><div class="ttname"><a href="pubkey_8h.html#ae4b59f7b9d3c7e03bb739f0584905ff1a69418ae10529f1fab66df8063ea9d286">NO_COFACTOR_MULTIPLICTION</a></div><div class="ttdoc">No cofactor multiplication applied. </div><div class="ttdef"><b>Definition:</b> <a href="pubkey_8h_source.html#l02062">pubkey.h:2062</a></div></div> <div class="ttc" id="class_d_l___group_parameters_html_ac11607926a66ce8ba8ae273a5b0464e7"><div class="ttname"><a href="class_d_l___group_parameters.html#ac11607926a66ce8ba8ae273a5b0464e7">DL_GroupParameters::SimultaneousExponentiate</a></div><div class="ttdeci">virtual void SimultaneousExponentiate(Element *results, const Element &base, const Integer *exponents, unsigned int exponentsCount) const =0</div><div class="ttdoc">Exponentiates a base to multiple exponents. </div></div> <div class="ttc" id="class_integer_html_ade53248f5dbb520273a70856b975417c"><div class="ttname"><a href="class_integer.html#ade53248f5dbb520273a70856b975417c">Integer::Power2</a></div><div class="ttdeci">static Integer Power2(size_t e)</div><div class="ttdoc">Exponentiates to a power of 2. </div><div class="ttdef"><b>Definition:</b> <a href="integer_8cpp_source.html#l03055">integer.cpp:3055</a></div></div> <div class="ttc" id="class_integer_html"><div class="ttname"><a href="class_integer.html">Integer</a></div><div class="ttdoc">Multiple precision integer with arithmetic operations. </div><div class="ttdef"><b>Definition:</b> <a href="integer_8h_source.html#l00049">integer.h:49</a></div></div> <div class="ttc" id="class_m_q_v___domain_html_a071369fe7462d070cbdf0521b8fb5edd"><div class="ttname"><a href="class_m_q_v___domain.html#a071369fe7462d070cbdf0521b8fb5edd">MQV_Domain::EphemeralPublicKeyLength</a></div><div class="ttdeci">unsigned int EphemeralPublicKeyLength() const</div><div class="ttdoc">Provides the size of ephemeral public key. </div><div class="ttdef"><b>Definition:</b> <a href="mqv_8h_source.html#l00143">mqv.h:143</a></div></div> <div class="ttc" id="class_m_q_v___domain_html_a95a8aed92bc010a5b048902bcc30da37"><div class="ttname"><a href="class_m_q_v___domain.html#a95a8aed92bc010a5b048902bcc30da37">MQV_Domain::StaticPrivateKeyLength</a></div><div class="ttdeci">unsigned int StaticPrivateKeyLength() const</div><div class="ttdoc">Provides the size of the static private key. </div><div class="ttdef"><b>Definition:</b> <a href="mqv_8h_source.html#l00106">mqv.h:106</a></div></div> <div class="ttc" id="gfpcrypt_8h_html"><div class="ttname"><a href="gfpcrypt_8h.html">gfpcrypt.h</a></div><div class="ttdoc">Classes and functions for schemes based on Discrete Logs (DL) over GF(p) </div></div> <div class="ttc" id="class_d_l___group_parameters_html_af3dc6d48394c356bb30dc72371aa02e7"><div class="ttname"><a href="class_d_l___group_parameters.html#af3dc6d48394c356bb30dc72371aa02e7">DL_GroupParameters::DecodeElement</a></div><div class="ttdeci">virtual Element DecodeElement(const byte *encoded, bool checkForGroupMembership) const =0</div><div class="ttdoc">Decodes the element. </div></div> <div class="ttc" id="class_m_q_v___domain_html_a6b07e1e10bf1d8b9f1a4644eef74ea43"><div class="ttname"><a href="class_m_q_v___domain.html#a6b07e1e10bf1d8b9f1a4644eef74ea43">MQV_Domain::GenerateEphemeralPrivateKey</a></div><div class="ttdeci">void GenerateEphemeralPrivateKey(RandomNumberGenerator &rng, byte *privateKey) const</div><div class="ttdoc">Generate ephemeral private key. </div><div class="ttdef"><b>Definition:</b> <a href="mqv_8h_source.html#l00145">mqv.h:145</a></div></div> <div class="ttc" id="class_d_l___bad_element_html"><div class="ttname"><a href="class_d_l___bad_element.html">DL_BadElement</a></div><div class="ttdoc">Exception thrown when an invalid group element is encountered. </div><div class="ttdef"><b>Definition:</b> <a href="pubkey_8h_source.html#l00743">pubkey.h:743</a></div></div> <div class="ttc" id="class_m_q_v___domain_html_a2dd74c07dd93b000b48e689b30809373"><div class="ttname"><a href="class_m_q_v___domain.html#a2dd74c07dd93b000b48e689b30809373">MQV_Domain::GenerateEphemeralPublicKey</a></div><div class="ttdeci">void GenerateEphemeralPublicKey(RandomNumberGenerator &rng, const byte *privateKey, byte *publicKey) const</div><div class="ttdoc">Generate ephemeral public key. </div><div class="ttdef"><b>Definition:</b> <a href="mqv_8h_source.html#l00154">mqv.h:154</a></div></div> <div class="ttc" id="class_integer_html_a867356d88074424328d0ebb9bea63254"><div class="ttname"><a href="class_integer.html#a867356d88074424328d0ebb9bea63254">Integer::BitCount</a></div><div class="ttdeci">unsigned int BitCount() const</div><div class="ttdoc">Determines the number of bits required to represent the Integer. </div><div class="ttdef"><b>Definition:</b> <a href="integer_8cpp_source.html#l03319">integer.cpp:3319</a></div></div> <div class="ttc" id="class_m_q_v___domain_html_a39b60e2dbf9ea3028d63f0dfc81d0cfb"><div class="ttname"><a href="class_m_q_v___domain.html#a39b60e2dbf9ea3028d63f0dfc81d0cfb">MQV_Domain::GenerateStaticPrivateKey</a></div><div class="ttdeci">void GenerateStaticPrivateKey(RandomNumberGenerator &rng, byte *privateKey) const</div><div class="ttdoc">Generate static private key in this domain. </div><div class="ttdef"><b>Definition:</b> <a href="mqv_8h_source.html#l00120">mqv.h:120</a></div></div> <div class="ttc" id="class_m_q_v___domain_html_ac2623ab1d98b3de87b35be50bc1e797f"><div class="ttname"><a href="class_m_q_v___domain.html#ac2623ab1d98b3de87b35be50bc1e797f">MQV_Domain::StaticPublicKeyLength</a></div><div class="ttdeci">unsigned int StaticPublicKeyLength() const</div><div class="ttdoc">Provides the size of the static public key. </div><div class="ttdef"><b>Definition:</b> <a href="mqv_8h_source.html#l00113">mqv.h:113</a></div></div> <div class="ttc" id="class_m_q_v___domain_html_a89a6c2d98cc463ae0355c9c52d950b18"><div class="ttname"><a href="class_m_q_v___domain.html#a89a6c2d98cc463ae0355c9c52d950b18">MQV_Domain::MQV_Domain</a></div><div class="ttdeci">MQV_Domain(const GroupParameters &params)</div><div class="ttdoc">Construct a MQV domain. </div><div class="ttdef"><b>Definition:</b> <a href="mqv_8h_source.html#l00040">mqv.h:40</a></div></div> <div class="ttc" id="class_d_l___group_parameters_html_a71c6058bd5ddcd54bd36565b0ba0cae0"><div class="ttname"><a href="class_d_l___group_parameters.html#a71c6058bd5ddcd54bd36565b0ba0cae0">DL_GroupParameters::EncodeElement</a></div><div class="ttdeci">virtual void EncodeElement(bool reversible, const Element &element, byte *encoded) const =0</div><div class="ttdoc">Encodes the element. </div></div> <div class="ttc" id="integer_8h_html"><div class="ttname"><a href="integer_8h.html">integer.h</a></div><div class="ttdoc">Multiple precision integer with arithmetic operations. </div></div> <div class="ttc" id="class_m_q_v___domain_html_aa0d4a0d10dc7acd0265af242758c2b53"><div class="ttname"><a href="class_m_q_v___domain.html#aa0d4a0d10dc7acd0265af242758c2b53">MQV_Domain::MQV_Domain</a></div><div class="ttdeci">MQV_Domain(T1 v1, T2 v2, T3 v3)</div><div class="ttdoc">Construct a MQV domain. </div><div class="ttdef"><b>Definition:</b> <a href="mqv_8h_source.html#l00067">mqv.h:67</a></div></div> <div class="ttc" id="class_m_q_v___domain_html_ae2b0485e16dceb4349f434d774830431"><div class="ttname"><a href="class_m_q_v___domain.html#ae2b0485e16dceb4349f434d774830431">MQV_Domain::MQV_Domain</a></div><div class="ttdeci">MQV_Domain()</div><div class="ttdoc">Construct a MQV domain. </div><div class="ttdef"><b>Definition:</b> <a href="mqv_8h_source.html#l00036">mqv.h:36</a></div></div> <div class="ttc" id="class_crypto_parameters_html"><div class="ttname"><a href="class_crypto_parameters.html">CryptoParameters</a></div><div class="ttdoc">Interface for crypto prameters. </div><div class="ttdef"><b>Definition:</b> <a href="cryptlib_8h_source.html#l02379">cryptlib.h:2379</a></div></div> <div class="ttc" id="class_d_l___group_parameters_html_a7275e04a4d21d985e698bb191e6cbdf1"><div class="ttname"><a href="class_d_l___group_parameters.html#a7275e04a4d21d985e698bb191e6cbdf1">DL_GroupParameters::GetMaxExponent</a></div><div class="ttdeci">virtual Integer GetMaxExponent() const =0</div><div class="ttdoc">Retrieves the maximum exponent for the group. </div></div> <div class="ttc" id="class_m_q_v___domain_html_af4dda134c82bac3cd13bb1b468159cde"><div class="ttname"><a href="class_m_q_v___domain.html#af4dda134c82bac3cd13bb1b468159cde">MQV_Domain::AccessCryptoParameters</a></div><div class="ttdeci">CryptoParameters & AccessCryptoParameters()</div><div class="ttdoc">Retrieves the crypto parameters for this domain. </div><div class="ttdef"><b>Definition:</b> <a href="mqv_8h_source.html#l00094">mqv.h:94</a></div></div> <div class="ttc" id="class_m_q_v___domain_html_a2e8c585ba17f8eb0ddf10cb2c6c4b0dc"><div class="ttname"><a href="class_m_q_v___domain.html#a2e8c585ba17f8eb0ddf10cb2c6c4b0dc">MQV_Domain::EphemeralPrivateKeyLength</a></div><div class="ttdeci">unsigned int EphemeralPrivateKeyLength() const</div><div class="ttdoc">Provides the size of ephemeral private key. </div><div class="ttdef"><b>Definition:</b> <a href="mqv_8h_source.html#l00142">mqv.h:142</a></div></div> <div class="ttc" id="modarith_8h_html"><div class="ttname"><a href="modarith_8h.html">modarith.h</a></div><div class="ttdoc">Class file for performing modular arithmetic. </div></div> <div class="ttc" id="namespace_crypto_p_p_html"><div class="ttname"><a href="namespace_crypto_p_p.html">CryptoPP</a></div><div class="ttdoc">Crypto++ library namespace. </div></div> <div class="ttc" id="class_m_q_v___domain_html_a6558a699673c7de656379ef801e3bae1"><div class="ttname"><a href="class_m_q_v___domain.html#a6558a699673c7de656379ef801e3bae1">MQV_Domain::AgreedValueLength</a></div><div class="ttdeci">unsigned int AgreedValueLength() const</div><div class="ttdoc">Provides the size of the agreed value. </div><div class="ttdef"><b>Definition:</b> <a href="mqv_8h_source.html#l00101">mqv.h:101</a></div></div> <div class="ttc" id="class_authenticated_key_agreement_domain_html"><div class="ttname"><a href="class_authenticated_key_agreement_domain.html">AuthenticatedKeyAgreementDomain</a></div><div class="ttdoc">Interface for domains of authenticated key agreement protocols. </div><div class="ttdef"><b>Definition:</b> <a href="cryptlib_8h_source.html#l02900">cryptlib.h:2900</a></div></div> <div class="ttc" id="class_m_q_v___domain_html_aa2af02b1905ff725e7f8fb379ac64940"><div class="ttname"><a href="class_m_q_v___domain.html#aa2af02b1905ff725e7f8fb379ac64940">MQV_Domain::AccessGroupParameters</a></div><div class="ttdeci">GroupParameters & AccessGroupParameters()</div><div class="ttdoc">Retrieves the group parameters for this domain. </div><div class="ttdef"><b>Definition:</b> <a href="mqv_8h_source.html#l00090">mqv.h:90</a></div></div> <div class="ttc" id="class_m_q_v___domain_html_acba0479b43a31a97b7e0b38661acd50a"><div class="ttname"><a href="class_m_q_v___domain.html#acba0479b43a31a97b7e0b38661acd50a">MQV_Domain::GetGroupParameters</a></div><div class="ttdeci">const GroupParameters & GetGroupParameters() const</div><div class="ttdoc">Retrieves the group parameters for this domain. </div><div class="ttdef"><b>Definition:</b> <a href="mqv_8h_source.html#l00086">mqv.h:86</a></div></div> <div class="ttc" id="class_d_l___group_parameters_html_a11e487f345f8f9831f550647c0a609b0"><div class="ttname"><a href="class_d_l___group_parameters.html#a11e487f345f8f9831f550647c0a609b0">DL_GroupParameters::ExponentiateElement</a></div><div class="ttdeci">virtual Element ExponentiateElement(const Element &base, const Integer &exponent) const</div><div class="ttdoc">Exponentiates an element. </div><div class="ttdef"><b>Definition:</b> <a href="pubkey_8h_source.html#l00849">pubkey.h:849</a></div></div> <div class="ttc" id="class_d_l___group_parameters_html_afb67ae388bba22447e45a74f87b2630b"><div class="ttname"><a href="class_d_l___group_parameters.html#afb67ae388bba22447e45a74f87b2630b">DL_GroupParameters::IsIdentity</a></div><div class="ttdeci">virtual bool IsIdentity(const Element &element) const =0</div><div class="ttdoc">Determines if an element is an identity. </div></div> <div class="ttc" id="class_d_l___group_parameters_html_aeff4e59562d2c9b0ffc6b677e8ce409a"><div class="ttname"><a href="class_d_l___group_parameters.html#aeff4e59562d2c9b0ffc6b677e8ce409a">DL_GroupParameters::GetSubgroupOrder</a></div><div class="ttdeci">virtual const Integer & GetSubgroupOrder() const =0</div><div class="ttdoc">Retrieves the subgroup order. </div></div> </div><!-- fragment --></div><!-- contents --> <!-- start footer part --> <hr class="footer"/><address class="footer"><small> Generated on Sun Sep 16 2018 07:57:58 for Crypto++ by  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/> </a> 1.8.14 </small></address> </body> </html>