This package provides a toolbox of advanced cryptographic primitives for Go, targeting applications like Dissent that need more than straightforward signing and encryption. Please see the GoDoc documentation for this package for details on the library's purpose and API functionality.

First make sure you have Go version 1.3 or newer installed.

The basic crypto library requires only Go and a few third-party Go-language dependencies that can be installed automatically as follows:

go get github.com/dedis/crypto
cd $GOPATH/src/github.com/dedis/crypto
go get ./... # install 3rd-party dependencies

You should then be able to test its basic function as follows:

cd $GOPATH/src/github.com/dedis/crypto
go test -v

You can recursively test all the packages in the library as follows, keeping in mind that some sub-packages will only build if certain dependencies are satisfied as described below:

go test -v ./...

The library's basic functionality depends only on the Go standard library. However, parts of the library will only build if certain other, optional system packages are installed with their header files and libraries (e.g., the "-dev" version of the package). In particular:

• crypto.openssl: This sub-package is a wrapper that builds on the OpenSSL crypto library to provide a fast, mature implementation of NIST-standardized elliptic curves and symmetric cryptosystems.

• crypto.pbc: This is a wrapper for the Stanford Pairing-Based Crypto (PBC) library, which will of course only work if the PBC library is installed.

• Traditionally, ECDH (Elliptic curve Diffie-Hellman) derives the shared secret from the x point only. In this framework, you can either manually retrieve the value or use the MarshalBinary method to take the combined (x, y) value as the shared secret. We recommend the latter process for new softare/protocols using this framework as it is cleaner and generalizes across differen types of groups (e.g., both integer and elliptic curves), although it will likely be incompatible with other implementations of ECDH. http://en.wikipedia.org/wiki/Elliptic_curve_Diffie%E2%80%93Hellman

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.