]> Cypherpunks.ru repositories - pygost.git/blob - news.texi
Remove excess mode kwargs from gost3410* functions
[pygost.git] / news.texi
1 @node News
2 @unnumbered News
3
4 @table @strong
5
6 @anchor{Release 5.0}
7 @item 5.0
8 Backward incompatible removing of misleading and excess @option{mode}
9 keyword argument from all @code{gost3410*} related functions. Point/key
10 sizes are determined by looking at curve's parameters size.
11
12 @anchor{Release 4.9}
13 @item 4.9
14     @itemize
15     @item @strong{Fixed} nasty bug with Edwards curves using in
16         34.10-VKO functions: curve's cofactor has not been used
17     @item CTR-ACPKM mode of operation
18     @item OMAC-ACPKM-Master moder of operation
19     @item KExp15/KImp15 key export/import functions
20     @item KDF_GOSTR3411_2012_256, KDF_TREE_GOSTR3411_2012_256
21     @item KEG export key generation function
22     @end itemize
23
24 @anchor{Release 4.8}
25 @item 4.8
26 MGM AEAD mode for 64 and 128 bit ciphers.
27
28 @anchor{Release 4.7}
29 @item 4.7
30 Removed @code{gost28147.addmod} for simplicity.
31
32 @anchor{Release 4.6}
33 @item 4.6
34 Fix invalid @code{gost28147.addmod}'s behaviour with much bigger values
35 than the modulo.
36
37 @anchor{Release 4.5}
38 @item 4.5
39 Fixed digest endianness and more RFC4491bis conformance in
40 @command{asn1schemas/cert-selfsigned-example.py} certificate's.
41
42 @anchor{Release 4.4}
43 @item 4.4
44     @itemize
45     @item @code{id-tc26-gost-3410-2012-512-paramSetTest} curve
46     @item Simple FAQ
47     @item More test vectors for 34.10-2012
48     @item More X.509, PKCS #10 and corresponding ASN.1 helper structures
49     @end itemize
50
51 @anchor{Release 4.3}
52 @item 4.3
53 Dummy release with fixed @code{pygost.__version__}.
54
55 @anchor{Release 4.2}
56 @item 4.2
57     @itemize
58     @item @code{pygost.gost3410.sign} accepts predefined random
59         data used for k/r generation
60     @item More test vectors for 34.10-2012
61     @end itemize
62
63 @anchor{Release 4.1}
64 @item 4.1
65     @itemize
66     @item PEP-396 compatible module's @code{__version__}
67     @item Curve parameters aliases:
68 @verbatim
69 id-GostR3410-2001-CryptoPro-XchA-ParamSet -> id-GostR3410-2001-CryptoPro-A-ParamSet
70 id-GostR3410-2001-CryptoPro-XchB-ParamSet -> id-GostR3410-2001-CryptoPro-C-ParamSet
71 id-tc26-gost-3410-2012-256-paramSetB      -> id-GostR3410-2001-CryptoPro-A-ParamSet
72 id-tc26-gost-3410-2012-256-paramSetC      -> id-GostR3410-2001-CryptoPro-B-ParamSet
73 id-tc26-gost-3410-2012-256-paramSetD      -> id-GostR3410-2001-CryptoPro-C-ParamSet
74 @end verbatim
75     @item Forbid any later GNU GPL version autousage (project's licence
76         now is GNU GPLv3 only)
77     @end itemize
78
79 @anchor{Release 4.0}
80 @item 4.0
81     @itemize
82     @item 34.10-2012 TC26 twisted Edwards curve related parameters
83     @item Coordinates conversion from twisted Edwards to Weierstrass
84         form and vice versa
85     @item More test vectors
86     @item Backward incompatible Sbox and curves parameters renaming,
87         to comply with OIDs identifying them:
88 @verbatim
89 Gost2814789_TestParamSet       -> id-Gost28147-89-TestParamSet
90 Gost28147_CryptoProParamSetA   -> id-Gost28147-89-CryptoPro-A-ParamSet
91 Gost28147_CryptoProParamSetB   -> id-Gost28147-89-CryptoPro-B-ParamSet
92 Gost28147_CryptoProParamSetC   -> id-Gost28147-89-CryptoPro-C-ParamSet
93 Gost28147_CryptoProParamSetD   -> id-Gost28147-89-CryptoPro-D-ParamSet
94 Gost28147_tc26_ParamZ          -> id-tc26-gost-28147-param-Z
95 GostR3411_94_TestParamSet      -> id-GostR3411-94-TestParamSet
96 GostR3411_94_CryptoProParamSet -> id-GostR3411-94-CryptoProParamSet
97
98 GostR3410_2001_TestParamSet            -> id-GostR3410-2001-TestParamSet
99 GostR3410_2001_CryptoPro_A_ParamSet    -> id-GostR3410-2001-CryptoPro-A-ParamSet
100 GostR3410_2001_CryptoPro_B_ParamSet    -> id-GostR3410-2001-CryptoPro-B-ParamSet
101 GostR3410_2001_CryptoPro_C_ParamSet    -> id-GostR3410-2001-CryptoPro-C-ParamSet
102 GostR3410_2001_CryptoPro_XchA_ParamSet -> id-GostR3410-2001-CryptoPro-XchA-ParamSet
103 GostR3410_2001_CryptoPro_XchB_ParamSet -> id-GostR3410-2001-CryptoPro-XchB-ParamSet
104 GostR3410_2012_TC26_256_ParamSetA      -> id-tc26-gost-3410-2012-256-paramSetA
105 GostR3410_2012_TC26_ParamSetA          -> id-tc26-gost-3410-12-512-paramSetA
106 GostR3410_2012_TC26_ParamSetB          -> id-tc26-gost-3410-12-512-paramSetB
107 GostR3410_2012_TC26_ParamSetC          -> id-tc26-gost-3410-2012-512-paramSetC
108 @end verbatim
109     @item Backward incompatible @code{GOST3410Curve} initialization: all
110         parameters are passed not as big-endian encoded binaries, but as
111         integers
112     @item Backward incompatible change: @code{gost3410.CURVE_PARAMS} is
113       disappeared. @code{gost3410.CURVES} dictionary holds already
114       initialized @code{GOST3410Curve}. Just use
115       @code{CURVES["id-tc26-gost-3410-12-512-paramSetA"]} instead of
116       @code{GOST3410Curve(*CURVE_PARAMS["id-tc26-gost-3410-12-512-paramSetA"])}
117     @end itemize
118
119 @anchor{Release 3.15}
120 @item 3.15
121     @itemize
122     @item Licence changed back to GNU GPLv3+. GNU LGPLv3+ licenced
123         versions are not available anymore
124     @item More ASN.1-based test vectors
125         (@url{http://www.pyderasn.cypherpunks.ru/, PyDERASN} dependency required)
126     @end itemize
127
128 @anchor{Release 3.14}
129 @item 3.14
130 Add missing typing stubs related to previous release.
131
132 @anchor{Release 3.13}
133 @item 3.13
134     @itemize
135     @item Ability to explicitly specify used 28147-89 Sbox in
136         @code{pygost.wrap.*} functions
137     @item Ability to use key meshing in 28147-89 CBC mode
138     @end itemize
139
140 @anchor{Release 3.12}
141 @item 3.12
142     @itemize
143     @item Added mode argument to @code{pygost.gost3410_vko.kek_34102012256},
144         because 256-bit private keys can be used with that algorithm too.
145     @item Fix incorrect degree sanitizing in
146         @code{pygost.gost3410.GOST3410Curve.exp} preventing using of
147         @code{UKM=1} in @code{pygost.gost3410_vko.kek_*} functions.
148     @end itemize
149
150 @anchor{Release 3.11}
151 @item 3.11
152 Fixed PEP247 typing stub with invalid hexdigest method.
153
154 @anchor{Release 3.10}
155 @item 3.10
156 Additional missing 34.11-* typing stubs.
157
158 @anchor{Release 3.9}
159 @item 3.9
160 Add missing 34.11-2012 PBKDF2 typing stub.
161
162 @anchor{Release 3.8}
163 @item 3.8
164     @itemize
165     @item 34.11-2012 based PBKDF2 function added
166     @item 34.13-2015 does not require double blocksized IVs
167     @end itemize
168
169 @anchor{Release 3.7}
170 @item 3.7
171 Fixed 34.13-2015 OFB bug with IVs longer than 2 blocks.
172
173 @anchor{Release 3.6}
174 @item 3.6
175 Fixed source files installation during @command{setup.py install} invocation.
176
177 @anchor{Release 3.5}
178 @item 3.5
179 Dummy release: added long description in package metadata.
180
181 @anchor{Release 3.4}
182 @item 3.4
183     @itemize
184     @item Small mypy stubs related fixes
185     @item Licence changed from GNU GPLv3+ to GNU LGPLv3+
186     @end itemize
187
188 @anchor{Release 3.3}
189 @item 3.3
190     @itemize
191     @item @code{GOST3412Kuz} renamed to @code{GOST3412Kuznechik}
192     @item @code{GOST3412Magma} implements GOST R 34.12-2015 Magma 64-bit
193         block cipher
194     @end itemize
195
196 @anchor{Release 3.2}
197 @item 3.2
198 34.13-2015 block cipher modes of operation implementations.
199
200 @anchor{Release 3.1}
201 @item 3.1
202 Fixed mypy stubs related to PEP247-successors.
203
204 @anchor{Release 3.0}
205 @item 3.0
206     @itemize
207     @item @code{gost3411_94} renamed to @code{gost341194}
208     @item @code{gost3411_2012} renamed and split to
209         @code{gost34112012256}, @code{gost34112012512}
210     @item @code{GOST34112012} split to
211         @code{GOST34112012256}, @code{GOST34112012512}
212     @item @code{gost3410.kek} moved to separate
213         @code{gost3410_vko.kek_34102001}
214     @item VKO GOST R 34.10-2012 appeared in @code{gost3410_vko},
215         with test vectors
216     @item 34.11-94 digest is reversed, to be compatible with HMAC and
217         PBKDF2 test vectors describe in TC26 documents
218     @item 34.11-94 PBKDF2 test vectors added
219     @item @code{gost3410.prv_unmarshal},
220         @code{gost3410.pub_marshal},
221         @code{gost3410.pub_unmarshal}
222         helpers added, removing the need of @code{x509} module at all
223     @item @code{gost3410.verify} requires @code{(pubX, pubY)} tuple,
224         instead of two separate @code{pubX}, @code{pubY} arguments
225     @item 34.11-94 based PBKDF2 function added
226     @end itemize
227
228 @anchor{Release 2.4}
229 @item 2.4
230 Fixed 34.13 mypy stub.
231
232 @anchor{Release 2.3}
233 @item 2.3
234 Typo and pylint fixes.
235
236 @item 2.2
237 GOST R 34.13-2015 padding methods.
238
239 @item 2.1
240 Documentation and supplementary files refactoring.
241
242 @item 2.0
243 PEP-0247 compatible hashers and MAC.
244
245 @item 1.0
246     @itemize
247     @item Ability to specify curve in pygost.x509 module
248     @item Ability to use 34.10-2012 in pygost.x509 functions
249     @item Renamed classes and modules:
250 @verbatim
251 pygost.gost3410.SIZE_34100 -> pygost.gost3410.SIZE_3410_2001
252 pygost.gost3410.SIZE_34112 -> pygost.gost3410.SIZE_3410_2012
253 pygost.gost3411_12.GOST341112 -> pygost.gost3411_2012.GOST34112012
254 @end verbatim
255     @end itemize
256
257 @item 0.16
258 34.10-2012 TC26 curve parameters.
259
260 @item 0.15
261 PEP-0484 static typing hints.
262
263 @item 0.14
264 34.10-2012 workability fix.
265
266 @item 0.13
267 Python3 compatibility.
268
269 @item 0.11
270 GOST R 34.12-2015 Кузнечик (Kuznechik) implementation.
271
272 @item 0.10
273 CryptoPro and GOST key wrapping, CryptoPro key meshing.
274
275 @end table