package rfc7748

This library provides the two Diffie-Hellman-like functions defined in the eponymous RFC, x25519 and x448.

Summary

X25519 and X448 are instances of a special subset of elliptic curves, the so-called Edwards curves, for which point addition has a closed form. This eliminates a whole class of problems that arise in other elliptic curve implementations, where addition formulas depend on the arguments (e.g. whether a point is added to itself). In addition, these curves are also designed to be safe to implement and use: the addition formula is by construction resistant to timing attacks, neither public keys nor private keys need to be validated and the string-based interface is very portable.

Quick Start

You can use Rfc7748.x25519 and Rfc7748.x448 as described in the example program in the source tree.

API

Below is the public API for this library. It is divided into

• a module type Rfc7748.DH for scalar multiplication on Edwards curves (the elliptic curve analogon of discrete exponentiation, as used in the classical Diffie-Hellman key exchange)
• the curves Rfc7748.X25519 and Rfc7748.X448 and
• the functions Rfc7748.x25519 and Rfc7748.x448 described in RFC 7748.