Explicit mention of 34.10-related endianness

diff --git a/pygost/gost3410.py b/pygost/gost3410.py
index 7e92e3422c29b0b5ae569257143196a945836a04..d7c733df2f5302f44f6b2bd592e208915c73d00d 100644 (file)
--- a/pygost/gost3410.py
+++ b/pygost/gost3410.py
@@ -231,7 +231,7 @@ def sign(curve, prv, digest, rand=None, mode=2001):
     :type digest: bytes, 32 or 64 bytes
     :param rand: optional predefined random data used for k/r generation
     :type rand: bytes, 32 or 64 bytes
-    :returns: signature
+    :returns: signature, BE(S) || BE(R)
     :rtype: bytes, 64 or 128 bytes
     """
     size = MODE2SIZE[mode]
@@ -305,7 +305,7 @@ def verify(curve, pub, digest, signature, mode=2001):
 
 
 def prv_unmarshal(prv):
-    """Unmarshal private key
+    """Unmarshal little-endian private key
 
     :param bytes prv: serialized private key
     :rtype: long
@@ -318,6 +318,7 @@ def pub_marshal(pub, mode=2001):
 
     :type pub: (long, long)
     :rtype: bytes
+    :returns: LE(X) || LE(Y)
     """
     size = MODE2SIZE[mode]
     return (long2bytes(pub[1], size) + long2bytes(pub[0], size))[::-1]
@@ -326,6 +327,7 @@ def pub_marshal(pub, mode=2001):
 def pub_unmarshal(pub, mode=2001):
     """Unmarshal public key
 
+    :param pub: LE(X) || LE(Y)
     :type pub: bytes
     :rtype: (long, long)
     """

diff --git a/pygost/gost3410_vko.py b/pygost/gost3410_vko.py
index 046df9e1212cfaafe6712cbb7b80f2cd2e1f16d2..6ffc9537014f0b570399fed4d3042fa7708530d1 100644 (file)
--- a/pygost/gost3410_vko.py
+++ b/pygost/gost3410_vko.py
@@ -26,7 +26,7 @@ from pygost.utils import bytes2long
 def ukm_unmarshal(ukm):
     """Unmarshal UKM value
 
-    :type ukm: bytes
+    :type ukm: little-endian bytes
     :rtype: long
     """
     return bytes2long(ukm[::-1])
@@ -55,7 +55,7 @@ def kek_34102001(curve, prv, pub, ukm):
     """
     return GOST341194(
         kek(curve, prv, pub, ukm, mode=2001),
-        "id-GostR3411-94-CryptoProParamSet",
+        sbox="id-GostR3411-94-CryptoProParamSet",
     ).digest()