qbit/go
1
0
Fork 0
mirror of https://github.com/golang/go synced 2024-11-24 09:00:13 -07:00
Code Releases Activity

crypto/ecdsa: improve documentation readability

Browse Source 
formatting

Include references in the package-level comment block, expand
the obscure IRO acronym, and add a reference for "the standard
(cryptographic) assumptions".

Fixes #33589

Change-Id: I7c19c715a841d313e8e5e46e527f62507a87a822
This commit is contained in:
Mostyn Bramley-Moore 2019-08-19 22:58:33 +02:00
parent 52ae04fdfc
commit 30d5a1e2fb
1 changed files with 15 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
src/crypto/ecdsa/ecdsa.go
View File

@ -5,13 +5,23 @@
// Package ecdsa implements the Elliptic Curve Digital Signature Algorithm, as // Package ecdsa implements the Elliptic Curve Digital Signature Algorithm, as
// defined in FIPS 186-3. // defined in FIPS 186-3.
// //
// This implementation derives the nonce from an AES-CTR CSPRNG keyed by // This implementation derives the nonce from an AES-CTR CSPRNG keyed by:
// ChopMD(256, SHA2-512(priv.D || entropy || hash)). The CSPRNG key is IRO by //
// a result of Coron; the AES-CTR stream is IRO under standard assumptions. // SHA2-512(priv.D || entropy || hash)[:32]
//
// The CSPRNG key is indifferentiable from a random oracle as shown in
// [Coron], the AES-CTR stream is indifferentiable from a random oracle
// under standard cryptographic assumptions (see [Larsson] for examples).
//
// References:
// [Coron]
// https://cs.nyu.edu/~dodis/ps/merkle.pdf
// [Larsson]
// https://www.nada.kth.se/kurser/kth/2D1441/semteo03/lecturenotes/assump.pdf
package ecdsa package ecdsa
// References: // Further references:
// [NSA]: Suite B implementer's guide to FIPS 186-3, // [NSA]: Suite B implementer's guide to FIPS 186-3
// https://apps.nsa.gov/iaarchive/library/ia-guidance/ia-solutions-for-classified/algorithm-guidance/suite-b-implementers-guide-to-fips-186-3-ecdsa.cfm // https://apps.nsa.gov/iaarchive/library/ia-guidance/ia-solutions-for-classified/algorithm-guidance/suite-b-implementers-guide-to-fips-186-3-ecdsa.cfm
// [SECG]: SECG, SEC1 // [SECG]: SECG, SEC1
// http://www.secg.org/sec1-v2.pdf // http://www.secg.org/sec1-v2.pdf