Tillich-Zémor hashing golang implementation
Find a file
Stanislav Bogatyrev 9f80f99aed [#3] Update README and Contributing guide
Preparing to start accepting PRs from everybody.

Signed-off-by: Stanislav Bogatyrev <s.bogatyrev@yadro.com>
2023-02-13 15:16:25 +03:00
.github/workflows go.mod: bump to go1.16 2022-03-21 12:30:08 +03:00
cmd Move from nspcc-dev to TrueCloudLab 2022-12-12 21:40:06 +03:00
gf127 *: rename ByteArray to Bytes 2022-03-21 12:30:08 +03:00
tz Move from nspcc-dev to TrueCloudLab 2022-12-12 21:40:06 +03:00
.gitignore Ignore vendor and binary 2020-01-16 11:30:45 +03:00
auto.sh Initial 2018-12-29 16:04:17 +03:00
benchmark benchmark: fix shellcheck issues 2022-03-21 12:30:08 +03:00
CONTRIBUTING.md [#3] Update README and Contributing guide 2023-02-13 15:16:25 +03:00
Dockerfile Update alpine image, fixup for Makefile, fixup for benchmark 2020-01-16 11:30:46 +03:00
go.mod Move from nspcc-dev to TrueCloudLab 2022-12-12 21:40:06 +03:00
go.sum go.mod: update dependencies 2022-01-24 13:58:13 +03:00
LICENSE Initial 2018-12-29 16:04:17 +03:00
Makefile Makefile: add target for testing generic implementation 2022-03-21 12:30:08 +03:00
README.md [#3] Update README and Contributing guide 2023-02-13 15:16:25 +03:00

Demo

asciicast

In project root:

$ make
...
$ ./demo.sh

Homomorphic hashing in golang

Package tz contains pure-Go (with some Assembly) implementation of hashing function described by Tillich and Zémor.

There are existing implementations already, however they are written in C.

Package gf127 contains arithmetic in GF(2^127) with x^127+x^63+1 as reduction polynomial.

Description

TZ Hash can be used instead of Merkle-tree for data-validation, because homomorphic hashes are concatenable: hash sum of data can be calculated based on hashes of chunks.

The example of how it works can be seen in tests and demo.

Benchmarks

go vs AVX vs AVX2 version

BenchmarkSum/AVX_digest-8             308       3889484 ns/op          25.71 MB/s         5 allocs/op
BenchmarkSum/AVXInline_digest-8       457       2455437 ns/op          40.73 MB/s         5 allocs/op
BenchmarkSum/AVX2_digest-8            399       3031102 ns/op          32.99 MB/s         3 allocs/op
BenchmarkSum/AVX2Inline_digest-8      602       2077719 ns/op          48.13 MB/s         3 allocs/op
BenchmarkSum/PureGo_digest-8           68       17795480 ns/op          5.62 MB/s         5 allocs/op

Contributing

Feel free to contribute to this project after reading the contributing guidelines.

Before starting to work on a certain topic, create a new issue first, describing the feature/topic you are going to implement.

Makefile

  Usage:

    make <target>

  Targets:

    all       Just `make` will build all possible binaries
    clean     Print version
    dep       Pull go dependencies
    help      Show this help prompt
    test      Run Unit Test with go test
    version   Print version

References