sloth256-189

Crates.iosloth256-189
lib.rssloth256-189
version0.4.2
sourcesrc
created_at2021-08-31 14:33:14.892132
updated_at2022-06-21 13:25:08.109448
descriptionEncoder/decoder for the Subspace Network Blockchain based on the SLOTH permutation
homepage
repositoryhttps://github.com/subspace/sloth256-189
max_upload_size
id445121
size383,873
J Wagstaff (rg3l3dr)

documentation

https://docs.rs/sloth256-189

README

sloth256-189

Encoder/decoder for the Subspace Network Blockchain based on the SLOTH permutation

CI Crates.io Docs

This is an adaptation of SLOTH (slow-timed hash function) into a time-asymmetric permutation using a standard CBC block cipher.

This library consists of 2 major implementations:

  • CPU
  • OpenCL (requires opencl feature to be enabled)

WebAssembly (no_std) is also supported, but llvm-ar command needs to be available for build.rs to succeed in that case.

CPU

CPU Implementation contains 3 flavors:

  • optimized assembly-assisted implementation for x86-64 processors with ADX ISA extension (Linux, macOS and Windows)
  • any 64-bt platform with support for __int128 C type (modern GCC/Clang, but not MSVC)
  • fallback for other platforms

For more details, README.md under src/cpu can be referred.

OpenCL

OpenCL is a universal implementation that supports AMD (ROCm), Nvidia (CUDA) and Intel GPUs, including support for multiple GPU vendors on the same machine at the same time.

Details of the OpenCL implementation can be found in mod.rs under src/opencl.

How to test

Simply run cargo test at the root folder

  • use cargo test --features=opencl for enabling opencl tests (openCL drivers must be installed on your device)

How to benchmark

Simply run cargo bench at the root folder

  • use cargo bench --features=opencl for enabling opencl tests (openCL drivers must be installed on your device)

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in cc-rs by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Commit count: 147

cargo fmt