https://github.com/r-lib/sodium
R bindings to libsodium
https://github.com/r-lib/sodium
Last synced: 7 days ago
JSON representation
R bindings to libsodium
- Host: GitHub
- URL: https://github.com/r-lib/sodium
- Owner: r-lib
- License: other
- Created: 2015-10-04T19:53:28.000Z (over 9 years ago)
- Default Branch: main
- Last Pushed: 2024-12-14T22:49:24.000Z (4 months ago)
- Last Synced: 2025-03-31T13:18:40.471Z (14 days ago)
- Language: R
- Homepage: https://docs.ropensci.org/sodium
- Size: 981 KB
- Stars: 69
- Watchers: 6
- Forks: 11
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Changelog: NEWS
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - r-lib/sodium - R bindings to libsodium (R)
README
# sodium
> A Modern and Easy-to-Use Crypto Library
[](https://cran.r-project.org/package=sodium)
[](https://cran.r-project.org/package=sodium)
Bindings to libsodium: a modern, easy-to-use software library for
encryption, decryption, signatures, password hashing and more. Sodium uses
curve25519, a state-of-the-art Diffie-Hellman function by Daniel Bernstein,
which has become very popular after it was discovered that the NSA had
backdoored Dual EC DRBG.
## Documentation
About the R package:
- Vignette: [Introduction to Sodium for R](https://cran.r-project.org/web/packages/sodium/vignettes/intro.html)
- Vignette: [How does cryptography work](https://cran.r-project.org/web/packages/sodium/vignettes/crypto101.html)
Other resources:
- [The Sodium crypto library (libsodium)](https://doc.libsodium.org/)
## Hello World
```r
# Generate keypair:
key <- keygen()
pub <- pubkey(key)
# Encrypt message with pubkey
msg <- serialize(iris, NULL)
ciphertext <- simple_encrypt(msg, pub)
# Decrypt message with private key
out <- simple_decrypt(ciphertext, key)
```
## Installation
Binary packages for __OS-X__ or __Windows__ can be installed directly from CRAN:
```r
install.packages("sodium")
```
Installation from source on Linux or OSX requires [`libsodium`](https://doc.libsodium.org/). On __Debian or Ubuntu__ install [libsodium-dev](https://packages.debian.org/testing/libsodium-dev):
```
sudo apt-get install -y libsodium-dev
```
On __Fedora__ we need [libsodium-devel](https://src.fedoraproject.org/rpms/libsodium):
```
sudo yum install libsodium-devel
````
On __CentOS / RHEL__ we install [libsodium-devel](https://src.fedoraproject.org/rpms/libsodium) via EPEL:
```
sudo yum install epel-release
sudo yum install libsodium-devel
```
On __OS-X__ use [libsodium](https://github.com/Homebrew/homebrew-core/blob/master/Formula/libsodium.rb) from Homebrew:
```
brew install libsodium
```