raaz: Fast and type safe cryptography.

[ codec, library, program, raaz ] [ Propose Tags ]

Raaz is a cryptographic library which provides the state of the art cryptographic primitives via a high-level, type safe interface. The default interface provided to the user is through the top level module Raaz. Rather than bothering the user with low-level details like the selection of primitives or entropy sources, this top level module only talks about the desired cryptographic operation (whether it is message digest or message encryption etc). A standalone application that needs cryptography should stick to using this top level interface.

Sometimes the selection of primitives is not in our hands --- we may need to interface with other programs written in other languages or using other libraries. For such situation, raaz exposes a primitive specific interface. As an example raaz exposes the Raaz.Digest.Sha256 module that gives the same interface as that of Raaz.Digest but uses sha256 as the underlying cryptographic hash.


[Skip to Readme]
Versions [RSS] [faq] 0.0.1, 0.0.2, 0.1.0, 0.1.1, 0.2.0, 0.2.1, 0.2.2, 0.2.3, 0.3.0, 0.3.1, 0.3.2, 0.3.3, 0.3.4, 0.3.5 (info)
Change log CHANGELOG.md
Dependencies base (>=4.11 && <4.16), bytestring (>=0.10 && <0.12), criterion-measurement (>=0.1), deepseq (==1.4.*), hspec, HUnit (>=1.2), optparse-applicative (>=0.13.0.0), pretty, QuickCheck (>=2.4), raaz, transformers, vector (==0.12.*) [details]
License (Apache-2.0 OR BSD-3-Clause)[multiple license files]
Copyright (c) 2012 Piyush P Kurur
Author Piyush P Kurur
Maintainer ppk@cse.iitk.ac.in
Category Codec, Raaz
Home page https://github.com/raaz-crypto/raaz
Bug tracker https://github.com/raaz-crypto/raaz/issues
Source repo head: git clone https://github.com/raaz-crypto/raaz
Uploaded by PiyushKurur at 2021-10-10T18:19:35Z
Distributions Debian:0.2.0, NixOS:0.3.0
Executables raaz
Downloads 4403 total (484 in the last 30 days)
Rating 2.25 (votes: 2) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Hackage Matrix CI
Docs available [build log]
Last success reported on 2021-10-10 [all 1 reports]

Modules

[Index] [Quick Jump]

Manual Flags

NameDescriptionDefault
linux-getrandom

Use the getrandom for system entropy instead of devurandom. Enabled by default but disable this when building for kernel < 3.17.

Enabled
native

Compile for native architecture. Often this enables a lot of platform specific optimisation which lead to better performance. Do not enable this when packaging though. Also tested only with gcc

Disabled
wipe-memset

Use plain memset for wiping memory. The problem with its use is that agressive compilers often optimise it out. Raaz uses platform specific functions designed specifically to avoid this and hence enabling this flag is STRONGLY DISCOURAGED. Use it only if your platform does not support such a call.

Disabled
Automatic Flags
NameDescriptionDefault

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

Maintainer's Corner

For package maintainers and hackage trustees

Candidates


Readme for raaz-0.3.5

[back to package description]

Raaz: A secure cryptographic library

Apache-2.0 OR BSD-3-Clause Hackage Hackage Dependencies

Raaz is a cryptographic library in Haskell that provide a high level and safe access to a lot of cryptographic operations. The library can be used for standalone cryptographic applications as well as for implementing other network protocols. Some of the features that are unique to raaz are the following

  1. Pervasive use of types for better safety.
  2. Default choice of primitives and implementations are safe.
  3. Mechanism to have multiple implementations for any given cryptographic primitives. An advanced user who has an in-depth knowledge of the platform should be able to plugin the desired implementation.
  4. Strong emphasis on API design with through documentation.

Building

The recommended way to install raaz is through cabal-install version 3.0 or above. We also need a version of GHC that supports backpack (for details on which version of GHC is supported, refer to our CI-builds).

cabal build
cabal test
cabal install

Online documentation

About the name

The word Raaz (राज़) stands for secret in Hindi.

Copyright 2012 Piyush P Kurur

The library is licensed under

You may not use this software except in compliance with one of the above Licenses (at your option).

SPDX-License-Identifier: (Apache-2.0 OR BSD-3-Clause)

Unless required by applicable law or agreed to in writing, software distributed under these Licenses is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. For the exact terms and conditions see the accompanying LICENSE file.