occulto/README.md
2019-07-07 21:46:09 +02:00

52 lines
1.1 KiB
Markdown

# occulto 🔒
High level wrapper around [forge](https://github.com/digitalbazaar/forge).
Supports Hashes, Symmetric AES & ChaCha20 ciphers and Asymmetric RSA.
**Typescript typings included**
## Quickstart 🚀
###### Install
```
npm i node-forge occulto
```
[**📒 DOCS HERE 📒**](https://cupcakearmy.github.io/occulto/index.html)
### Examples
## RSA
```typescript
const pair = await RSA.gen()
const encrypted = RSA.encrypt('some text', pair.pub)
const decrypted = RSA.decrypt(encrypted, pair.prv)
```
## Symmetric
```javascript
import { Symmetric } from 'occulto'
const encrypted = Symmetric.encrypt('some string' , 'myPass', Symmetric.Ciphers.AES_128_GCM)
const decrypted = Symmetric.decrypt(encrypted, 'myPadd')
```
## Hash
<a href="https://cupcakearmy.github.io/occulto/enums/_hash_.hashes.html" target="_blank">Available hashes</a>
[Available hashes](https://cupcakearmy.github.io/occulto/enums/_hash_.hashes.html)
```typescript
import { Hash } from 'occulto'
const hash = Hash.digest('something')
const h = Hash.digest('something', Hash.Hashes.MD5)
```