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

crypto/ecdsa: improve documentation readability

Browse Source 
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: I76c3b0a2f7258b3ab4bf1c8e7681c5d159720a20
GitHub-Last-Rev: 30d5a1e2fb
GitHub-Pull-Request: golang/go#33723
Reviewed-on: https://go-review.googlesource.com/c/go/+/190840
Reviewed-by: Filippo Valsorda <filippo@golang.org>
This commit is contained in:
Mostyn Bramley-Moore 2019-08-27 22:26:38 +00:00 committed by Filippo Valsorda
parent 9dfa4cb026
commit 84198445d4
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