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]

Modules

[Index] [Quick Jump]

Raaz
- Raaz.Auth
  - Raaz.Auth.Blake2b
  - Raaz.Auth.Blake2s
- Raaz.AuthEncrypt
  - Raaz.AuthEncrypt.Unsafe
    - Raaz.AuthEncrypt.Unsafe.ChaCha20Poly1305
    - Raaz.AuthEncrypt.Unsafe.XChaCha20Poly1305
- Raaz.Core
  - Raaz.Core.Encode
  - Raaz.Core.Types
- Raaz.Digest
  - Raaz.Digest.Blake2b
  - Raaz.Digest.Blake2s
  - Raaz.Digest.Sha256
  - Raaz.Digest.Sha512
- Raaz.Random
  - Raaz.Random.Internal

Flags

Manual Flags

Name	Description	Default
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

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

Downloads

raaz-0.3.10.tar.gz [browse] (Cabal source package)
Package description (as included in the package)

Maintainer's Corner

Package maintainers

PiyushKurur

For package maintainers and hackage trustees

edit package information

Candidates

0.1.0, 0.2.0, 0.2.1, 0.2.2, 0.2.3, 0.3.0, 0.3.1, 0.3.2, 0.3.6, 0.3.7, 0.3.8, 0.3.9, 0.3.10

Versions [RSS]	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, 0.3.6, 0.3.7, 0.3.8, 0.3.9, 0.3.10 (info)
Change log	CHANGELOG.md
Dependencies	base (>=4.11 && <4.21), bytestring (>=0.10 && <0.13), criterion-measurement (>=0.1 && <0.3), deepseq (>=1.4 && <1.6), hspec (>=2.10.6 && <2.12), HUnit (>=1.2 && <1.7), optparse-applicative (>=0.13.0.0 && <0.19), pretty (>=1.1.3 && <1.2), QuickCheck (>=2.4 && <2.16), raaz, vector (>=0.12 && <0.14) [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 2024-06-14T07:12:25Z
Distributions	Debian:0.2.1, NixOS:0.3.10
Executables	raaz
Downloads	5705 total (68 in the last 30 days)
Rating	2.25 (votes: 2) [estimated by Bayesian average]
Your Rating	λ λ λ
Status	Docs uploaded by user Build status unknown [no reports yet]

Readme for raaz-0.3.10

[back to package description]

Raaz: A secure cryptographic library

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

Pervasive use of types for better safety.
Default choice of primitives and implementations are safe.
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.
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.

Legal

The library is licensed under

Apache License, Version 2.0 http://www.apache.org/licenses/LICENSE-2.0
BSD 3-Clause license https://opensource.org/licenses/BSD-3-Clause

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.