Advanced crypto library for the Go language
Go C Other
Latest commit e28860c Feb 13, 2017 @Daeinar Daeinar committed on GitHub Merge pull request #115 from dedis/dleq_godoc
Godoc fixes in dleq.go
Permalink
Failed to load latest commit information.
abstract Add Clone to Scalar Jul 5, 2016
anon converted secret to scalar Jun 16, 2016
base64 go fmt (to make travis pass the formatting test) Dec 14, 2015
cipher merging and replacing secret with scalar Jun 16, 2016
clique More extensive gofmt -w on files touched in this changeset. Jan 14, 2015
config merging and replacing secret with scalar Jun 16, 2016
cosi added getresponse Jun 17, 2016
ed25519 added NewInt*-methods Oct 3, 2016
eddsa converted secret to scalar Jun 16, 2016
edwards added NewInt*-methods Oct 3, 2016
group merging and replacing secret with scalar Jun 16, 2016
hash not equal Feb 9, 2017
ints Next major iteration on general message Cipher interface: Jan 29, 2015
math go fmt (to make travis pass the formatting test) Dec 14, 2015
nego merging and replacing secret with scalar Jun 16, 2016
nist updated comments Oct 4, 2016
openssl converted secret to scalar Jun 16, 2016
pbc converted secret to scalar Jun 16, 2016
poly converted secret to scalar Jun 16, 2016
proof godoc fixes Feb 13, 2017
random test pass Jun 9, 2016
share typo Feb 9, 2017
shuffle merging and replacing secret with scalar Jun 16, 2016
sign schnorr: signature slice of bytes compat. with eddsa Feb 2, 2017
sodium added NewInt*-methods Oct 3, 2016
subtle Generalize ConstantTimeNonzero to cleaner ConstantTimeAllEq Jan 17, 2015
suites constantstream removed replaced by 2 equal stream Jun 14, 2016
test as discussed: moved tests to test.go and removed the individual ones Jul 6, 2016
util constantstream removed replaced by 2 equal stream Jun 14, 2016
.gitignore removed intellij-file Oct 3, 2016
.travis.yml also checking formatting Jun 14, 2016
GO-WISHLIST Add tests for Grow Jan 17, 2015
README.md Updated travis badge Mar 16, 2016
dh_test.go Rename abstract.Secret to abstract.Scalar, Dec 5, 2015
doc.go converted secret to scalar Jun 16, 2016
ds_test.go merging and replacing secret with scalar Jun 16, 2016
enc_test.go Rename abstract.Secret to abstract.Scalar, Dec 5, 2015
gofmt.sh Simplifiy/fix travis: Dec 14, 2015
sig_test.go merging and replacing secret with scalar Jun 16, 2016

README.md

Build Status

DeDiS Advanced Crypto Library for Go

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.

Installing

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 ./...

Dependencies

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.

Issues

  • 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

Copyright (C) 2014 Yale DeDiS Group

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.