ecdh

Documentation

Overview

ECDH implementation with curve25519. https://tools.ietf.org/html/rfc7748

Index

• type Pair
  • func New() (*Pair, error)
  • func Use(private []byte) (*Pair, error)
• type PrivateKey
  • func (pri PrivateKey) Bytes() []byte
  • func (pri PrivateKey) PlainSecret(pub PublicKey) ([]byte, error)
  • func (pri PrivateKey) Public() (PublicKey, error)
  • func (pri PrivateKey) Secret(pub PublicKey) (SharedSecret, error)
• type PublicKey
  • func (pub PublicKey) Bytes() []byte
• type SharedSecret
  • func (s SharedSecret) Bytes() []byte

Types

type Pair

type Pair struct {
	Private PrivateKey
	Public  PublicKey
}

Pair holds private and public key.

func New

func New() (*Pair, error)

New generates a pair of a random private and corresponding public key. Private key consists of randomly generated bytes. (rfc7748 pages 7/8) Both keys size is 32 bytes.

func Use

func Use(private []byte) (*Pair, error)

Use takes a []byte value of a valid PrivateKey and calculates a Pair.

type PrivateKey

type PrivateKey []byte

func (PrivateKey) Bytes

func (pri PrivateKey) Bytes() []byte

func (PrivateKey) PlainSecret

func (pri PrivateKey) PlainSecret(pub PublicKey) ([]byte, error)

PlainSecret provides a shared secret (32 bytes) of the given private and public keys.

func (PrivateKey) Public

func (pri PrivateKey) Public() (PublicKey, error)

Public provides the PublicKey of the given PrivateKey.

func (PrivateKey) Secret

func (pri PrivateKey) Secret(pub PublicKey) (SharedSecret, error)

Secret provides a SHA3 hashed shared secret of the given private and public keys. SharedSecret size is 64 bytes hashed by SHAKE256.

type PublicKey

type PublicKey []byte

func (PublicKey) Bytes

func (pub PublicKey) Bytes() []byte

type SharedSecret

type SharedSecret []byte

func (SharedSecret) Bytes

func (s SharedSecret) Bytes() []byte