vrfEs

Documentation

Overview

* @author PalletOne core developers <dev@pallet.one> * @date 2018

* @author PalletOne core developers <dev@pallet.one> * @date 2018

Index

• Variables
• func GenerateKey() (IPrivateKey, IPublicKey)
• func H1(m []byte) (x, y *big.Int)
• func H2(m []byte) *big.Int
• func Unmarshal(curve elliptic.Curve, data []byte) (x, y *big.Int)
• type Es
  • func (e *Es) VrfProve(priKey interface{}, msg []byte) (proof, selData []byte, err error)
  • func (e *Es) VrfVerify(pubKey, msg, proof []byte) (bool, []byte, error)
• type IPrivateKey
• type IPublicKey
• type PrivateKey
  • func NewVRFSigner(key *ecdsa.PrivateKey) (*PrivateKey, error)
  • func (k PrivateKey) Evaluate(m []byte) (index [32]byte, proof []byte)
  • func (k PrivateKey) Public() crypto.PublicKey
• type PublicKey
  • func NewVRFVerifier(pubkey *ecdsa.PublicKey) (*PublicKey, error)
  • func (pk *PublicKey) ProofToHash(m, proof []byte) (index [32]byte, err error)

Variables

var (

	// ErrPointNotOnCurve occurs when a public key is not on the curve.
	ErrPointNotOnCurve = errors.New("point is not on the S256 curve")
	// ErrWrongKeyType occurs when a key is not an ECDSA key.
	ErrWrongKeyType = errors.New("not an ECDSA key")
	// ErrNoPEMFound occurs when attempting to parse a non PEM data structure.
	ErrNoPEMFound = errors.New("no PEM block found")
	// ErrInvalidVRF occurs when the VRF does not validate.
	ErrInvalidVRF = errors.New("invalid VRF proof")
)

Functions

func GenerateKey

func GenerateKey() (IPrivateKey, IPublicKey)

GenerateKey generates a fresh keypair for this VRF

func H1

func H1(m []byte) (x, y *big.Int)

H1 hashes m to a curve point

func H2

func H2(m []byte) *big.Int

H2 hashes to an integer [1,N-1]

func Unmarshal

func Unmarshal(curve elliptic.Curve, data []byte) (x, y *big.Int)

Unmarshal a compressed point in the form specified in section 4.3.6 of ANSI X9.62.

Types

type Es

type Es struct {
}

func (*Es) VrfProve

func (e *Es) VrfProve(priKey interface{}, msg []byte) (proof, selData []byte, err error)

func (*Es) VrfVerify

func (e *Es) VrfVerify(pubKey, msg, proof []byte) (bool, []byte, error)

type IPrivateKey

type IPrivateKey interface {
	// Evaluate returns the output of H(f_k(m)) and its proof.
	Evaluate(m []byte) (index [32]byte, proof []byte)
	// Public returns the corresponding public key.
	Public() crypto.PublicKey
}

PrivateKey supports evaluating the VRF function.

type IPublicKey

type IPublicKey interface {
	// ProofToHash verifies the NP-proof supplied by Proof and outputs Index.
	ProofToHash(m, proof []byte) (index [32]byte, err error)
}

PublicKey supports verifying output from the VRF function.

type PrivateKey

type PrivateKey struct {
	*ecdsa.PrivateKey
}

PrivateKey holds a private VRF key.

func NewVRFSigner

func NewVRFSigner(key *ecdsa.PrivateKey) (*PrivateKey, error)

NewVRFSigner creates a signer object from a private key.

func (PrivateKey) Evaluate

func (k PrivateKey) Evaluate(m []byte) (index [32]byte, proof []byte)

Evaluate returns the verifiable unpredictable function evaluated at m

func (PrivateKey) Public

func (k PrivateKey) Public() crypto.PublicKey

Public returns the corresponding public key as bytes.

type PublicKey

type PublicKey struct {
	*ecdsa.PublicKey
}

PublicKey holds a public VRF key.

func NewVRFVerifier

func NewVRFVerifier(pubkey *ecdsa.PublicKey) (*PublicKey, error)

NewVRFVerifier creates a verifier object from a public key.

func (*PublicKey) ProofToHash

func (pk *PublicKey) ProofToHash(m, proof []byte) (index [32]byte, err error)

ProofToHash asserts that proof is correct for m and outputs index.