mirror of
https://github.com/btcsuite/btcd.git
synced 2024-11-19 09:50:08 +01:00
ba5407615d
The doc formatting changes introduced in the recent go version is increasing the diff for all of the new commits. Formatting it all in this commit will help the readability of future PRs by reducing the diff.
46 lines
2.1 KiB
Go
46 lines
2.1 KiB
Go
// Copyright (c) 2013-2021 The btcsuite developers
|
|
// Copyright (c) 2015-2021 The Decred developers
|
|
|
|
package btcec
|
|
|
|
import (
|
|
secp "github.com/decred/dcrd/dcrec/secp256k1/v4"
|
|
)
|
|
|
|
// ModNScalar implements optimized 256-bit constant-time fixed-precision
|
|
// arithmetic over the secp256k1 group order. This means all arithmetic is
|
|
// performed modulo:
|
|
//
|
|
// 0xfffffffffffffffffffffffffffffffebaaedce6af48a03bbfd25e8cd0364141
|
|
//
|
|
// It only implements the arithmetic needed for elliptic curve operations,
|
|
// however, the operations that are not implemented can typically be worked
|
|
// around if absolutely needed. For example, subtraction can be performed by
|
|
// adding the negation.
|
|
//
|
|
// Should it be absolutely necessary, conversion to the standard library
|
|
// math/big.Int can be accomplished by using the Bytes method, slicing the
|
|
// resulting fixed-size array, and feeding it to big.Int.SetBytes. However,
|
|
// that should typically be avoided when possible as conversion to big.Ints
|
|
// requires allocations, is not constant time, and is slower when working modulo
|
|
// the group order.
|
|
type ModNScalar = secp.ModNScalar
|
|
|
|
// NonceRFC6979 generates a nonce deterministically according to RFC 6979 using
|
|
// HMAC-SHA256 for the hashing function. It takes a 32-byte hash as an input
|
|
// and returns a 32-byte nonce to be used for deterministic signing. The extra
|
|
// and version arguments are optional, but allow additional data to be added to
|
|
// the input of the HMAC. When provided, the extra data must be 32-bytes and
|
|
// version must be 16 bytes or they will be ignored.
|
|
//
|
|
// Finally, the extraIterations parameter provides a method to produce a stream
|
|
// of deterministic nonces to ensure the signing code is able to produce a nonce
|
|
// that results in a valid signature in the extremely unlikely event the
|
|
// original nonce produced results in an invalid signature (e.g. R == 0).
|
|
// Signing code should start with 0 and increment it if necessary.
|
|
func NonceRFC6979(privKey []byte, hash []byte, extra []byte, version []byte,
|
|
extraIterations uint32) *ModNScalar {
|
|
|
|
return secp.NonceRFC6979(privKey, hash, extra, version, extraIterations)
|
|
}
|