dh

type Curve interface {
	fmt.Stringer

	// GenerateKeyPair generates a new Diffie-Hellman key pair. It creates a key
	// pair from entropy. If the entropy is not supplied, it will use rand.Read
	// to generate a new private key.
	GenerateKeyPair(entropy []byte) (PrivateKey, error)

	// LoadPrivateKey uses the data provided to create a new private key.
	LoadPrivateKey(data []byte) (PrivateKey, error)

	// LoadPublicKey uses the data provided to create a new public key.
	LoadPublicKey(data []byte) (PublicKey, error)

	// Size returns the DHLEN value.
	Size() int
}

type NewCurve func() Curve

type PrivateKey interface {
	// Bytes turns the underlying bytes array into a slice.
	Bytes() []byte

	// DH performs a Diffie-Hellman calculation between the private key itself
	// and the public key supplied, returns an output sequence of bytes of
	// length DHLEN.
	//
	// Implementations must handle invalid public keys either by returning some
	// output which is purely a function of the public key and does not depend
	// on the private key, or by signaling an error to the caller. The DH
	// function may define more specific rules for handling invalid values.
	DH(pub []byte) ([]byte, error)

	// Update updates both the private key bytes and the public key bytes with
	// the data supplied. This means the calculation of the public key from the
	// private key shall be implemented inside this method.
	Update(data []byte)

	// PubKey returns the associated public key.
	PubKey() PublicKey
}

type PublicKey interface {
	// Bytes turns the underlying bytes array into a slice.
	Bytes() []byte

	// Hex returns the hexstring of the public key.
	Hex() string

	// LoadBytes loads the byte slice into a byte array specifically for a
	// public key defined in each curve.
	LoadBytes(data []byte) error
}