From: Sergey Matveev <stargrave@stargrave.org>
Date: Thu, 2 Jul 2020 08:22:26 +0000 (+0300)
Subject: Explicit mention of 34.10-related endianness
X-Git-Tag: 4.6~1
X-Git-Url: http://www.git.cypherpunks.ru/?p=pygost.git;a=commitdiff_plain;h=c36d50a5003f360ff22f93e286efd0f614523427

Explicit mention of 34.10-related endianness
---

diff --git a/pygost/gost3410.py b/pygost/gost3410.py
index 7e92e34..d7c733d 100644
--- 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 046df9e..6ffc953 100644
--- 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()