ecdh

README

ECDH

This is a go implementation of elliptical curve diffie-hellman key exchange method. It supports the NIST curves (and any curves using the elliptic.Curve go interface) as well as djb's curve25519.

The library handles generating of keys, generating a shared secret, and the (un)marshalling of the elliptical curve keys into slices of bytes.

Warning and Disclaimer

I am not a cryptographer, this was written as part of a personal project to learn about cryptographic systems and protocols. No claims as to the security of this library are made, I would not advise using it for anything that requires any level of security. Pull requests or issues about security flaws are however still welcome.

Compatibility

Works with go 1.2 onwards.

TODO

• Improve documentation

Documentation

Index

• type ECDH
  • func NewCurve25519ECDH() ECDH
  • func NewEllipticECDH(curve elliptic.Curve) ECDH

Types

type ECDH

type ECDH interface {
	GenerateKey(io.Reader) (crypto.PrivateKey, crypto.PublicKey, error)
	Marshal(crypto.PublicKey) []byte
	Unmarshal([]byte) (crypto.PublicKey, bool)
	GenerateSharedSecret(crypto.PrivateKey, crypto.PublicKey) ([]byte, error)
}

The main interface for ECDH key exchange.

func NewCurve25519ECDH

func NewCurve25519ECDH() ECDH

NewCurve25519ECDH creates a new ECDH instance that uses djb's curve25519 elliptical curve.

func NewEllipticECDH

func NewEllipticECDH(curve elliptic.Curve) ECDH

NewEllipticECDH creates a new instance of ECDH with the given elliptic.Curve curve to use as the elliptical curve for elliptical curve diffie-hellman.