blake3

Blake3 for Crystal (fork)
1.2.0 released

BLAKE3

Crystal CI GitHub release GitHub commits since latest release (by date) for a branch

Blake3 using the official BLAKE3 c implementation.

Features

  • [x] Fast. ~2x faster than Sodium::Digest::Blake2b.
  • [x] Uses Crystal's Digest API.
  • [x] Keyed digests.
  • [ ] Key derivation.
  • [x] Configurable final size.
  • [ ] Streaming final output.
  • [x] Tested against official test vectors.
  • [x] Builds a blake3 c static library.

Speed

examples/blake3_hash.cr is approximately the same speed as b3sum with 1 thread or mmap disabled.

Installation

  1. Add the dependency to your shard.yml:

    dependencies:
      blake3:
        github: GeopJr/blake3.cr
    
  2. Run shards install

Usage

require "blake3"
digest = Digest::Blake3.new
digest.update data
p digest.final.hexstring
output_size = 1024
digest = Digest::Blake3.new(output_size)
digest.update data
p digest.final.hexstring => ...a.very.long.string...
digest = Digest::Blake3.new(key: "super secret exactly 32 byte key")
digest.update data
p digest.final.hexstring

For further API documentation see Crystal's Digest API

Contributing

  1. Fork it (https://github.com/GeopJr/blake3.cr/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Contributors

blake3:
  github: GeopJr/blake3.cr
  version: ~> 1.2.0
License MIT
Crystal >= 0.36.0

Dependencies 0

Development Dependencies 0

Dependents 1

Last synced .
search fire star recently