ecfsdsa

Documentation

Index

• Variables
• func PrivateKeyTo(key *PrivateKey) []byte
• func PublicKeyTo(key *PublicKey) []byte
• func Sign(rand io.Reader, priv *PrivateKey, h Hasher, data []byte) (sig []byte, err error)
• func SignBytes(rand io.Reader, priv *PrivateKey, h Hasher, data []byte) (sig []byte, err error)
• func SignToRS(rand io.Reader, priv *PrivateKey, hashFunc Hasher, msg []byte) (r, s *big.Int, err error)
• func Verify(pub *PublicKey, h Hasher, data, sig []byte) bool
• func VerifyBytes(pub *PublicKey, h Hasher, data, sig []byte) bool
• func VerifyWithRS(pub *PublicKey, hashFunc Hasher, data []byte, r, s *big.Int) bool
• type Hasher
• type PrivateKey
  • func GenerateKey(random io.Reader, c elliptic.Curve) (*PrivateKey, error)
  • func NewPrivateKey(curve elliptic.Curve, k []byte) (*PrivateKey, error)
  • func (priv *PrivateKey) Equal(x crypto.PrivateKey) bool
  • func (priv *PrivateKey) Public() crypto.PublicKey
  • func (priv *PrivateKey) Sign(rand io.Reader, digest []byte, opts crypto.SignerOpts) ([]byte, error)
• type PublicKey
  • func NewPublicKey(curve elliptic.Curve, k []byte) (*PublicKey, error)
  • func (pub *PublicKey) Equal(x crypto.PublicKey) bool
  • func (pub *PublicKey) Verify(msg, sign []byte, opts crypto.SignerOpts) (bool, error)
• type SignerOpts
  • func (opts *SignerOpts) GetHash() Hasher
  • func (opts *SignerOpts) HashFunc() crypto.Hash

Variables

var (
	ErrParametersNotSetUp = errors.New("go-cryptobin/ecfsdsa: parameters not set up before generating key")
	ErrInvalidASN1        = errors.New("go-cryptobin/ecfsdsa: invalid ASN.1")
	ErrInvalidSignerOpts  = errors.New("go-cryptobin/ecfsdsa: opts must be *SignerOpts")
)

Functions

func PrivateKeyTo

func PrivateKeyTo(key *PrivateKey) []byte

输出私钥明文 output PrivateKey data

func PublicKeyTo

func PublicKeyTo(key *PublicKey) []byte

输出公钥明文 output PublicKey data

func Sign

func Sign(rand io.Reader, priv *PrivateKey, h Hasher, data []byte) (sig []byte, err error)

Sign data returns the ASN.1 encoded signature.

func SignBytes

func SignBytes(rand io.Reader, priv *PrivateKey, h Hasher, data []byte) (sig []byte, err error)

Sign data returns the Bytes encoded signature.

func SignToRS

func SignToRS(rand io.Reader, priv *PrivateKey, hashFunc Hasher, msg []byte) (r, s *big.Int, err error)

*| IUF - ECFSDSA signature *| *| I 1. Get a random value k in ]0,q[ *| I 2. Compute W = (W_x,W_y) = kG *| I 3. Compute r = FE2OS(W_x)||FE2OS(W_y) *| I 4. If r is an all zero string, restart the process at step 1. *| IUF 5. Compute h = H(r||m) *| F 6. Compute e = OS2I(h) mod q *| F 7. Compute s = (k + ex) mod q *| F 8. If s is 0, restart the process at step 1 (see c. below) *| F 9. Return (r,s) * * Implementation notes: * * a) sig is built as the concatenation of r and s. r is encoded on * 2*ceil(bitlen(p)) bytes and s on ceil(bitlen(q)) bytes. * b) in EC-FSDSA, the public part of the key is not needed per se during * the signature but - as it is needed in other signature algs implemented * in the library - the whole key pair is passed instead of just the * private key.

func Verify

func Verify(pub *PublicKey, h Hasher, data, sig []byte) bool

Verify verifies the ASN.1 encoded signature, sig, M, of hash using the public key, pub. Its return value records whether the signature is valid.

func VerifyBytes

func VerifyBytes(pub *PublicKey, h Hasher, data, sig []byte) bool

Verify verifies the Bytes encoded signature

func VerifyWithRS

func VerifyWithRS(pub *PublicKey, hashFunc Hasher, data []byte, r, s *big.Int) bool

*| IUF - ECFSDSA verification *| *| I 1. Reject the signature if r is not a valid point on the curve. *| I 2. Reject the signature if s is not in ]0,q[ *| IUF 3. Compute h = H(r||m) *| F 4. Convert h to an integer and then compute e = -h mod q *| F 5. compute W' = sG + eY, where Y is the public key *| F 6. Compute r' = FE2OS(W'_x)||FE2OS(W'_y) *| F 7. Accept the signature if and only if r equals r' *

Types

type Hasher

type Hasher = func() hash.Hash

type PrivateKey

type PrivateKey struct {
	PublicKey

	D *big.Int
}

ec-gdsa PrivateKey

func GenerateKey

func GenerateKey(random io.Reader, c elliptic.Curve) (*PrivateKey, error)

Generate the PrivateKey

func NewPrivateKey

func NewPrivateKey(curve elliptic.Curve, k []byte) (*PrivateKey, error)

New a PrivateKey from privatekey data

func (*PrivateKey) Equal

func (priv *PrivateKey) Equal(x crypto.PrivateKey) bool

Equal reports whether pub and x have the same value.

func (*PrivateKey) Public

func (priv *PrivateKey) Public() crypto.PublicKey

Public returns the public key corresponding to priv.

func (*PrivateKey) Sign

func (priv *PrivateKey) Sign(rand io.Reader, digest []byte, opts crypto.SignerOpts) ([]byte, error)

crypto.Signer

type PublicKey

type PublicKey struct {
	elliptic.Curve

	X, Y *big.Int
}

ec-gdsa PublicKey

func NewPublicKey

func NewPublicKey(curve elliptic.Curve, k []byte) (*PublicKey, error)

根据公钥明文初始化公钥 New a PublicKey from publicKey data

func (*PublicKey) Equal

func (pub *PublicKey) Equal(x crypto.PublicKey) bool

Equal reports whether pub and x have the same value.

func (*PublicKey) Verify

func (pub *PublicKey) Verify(msg, sign []byte, opts crypto.SignerOpts) (bool, error)

Verify asn.1 marshal data

type SignerOpts

type SignerOpts struct {
	Hash Hasher
}

SignerOpts contains options for creating and verifying EC-GDSA signatures.

func (*SignerOpts) GetHash

func (opts *SignerOpts) GetHash() Hasher

GetHash returns func() hash.Hash

func (*SignerOpts) HashFunc

func (opts *SignerOpts) HashFunc() crypto.Hash

HashFunc returns opts.Hash