naclpipe

NaCL Pipe Go Package

Purpose

A simple experimental Go package providing an io.Reader/io.Writer interface with an NaCL (pronounced 'Salt') crypto backend.

• np* is the previously called naclpipe tool using this Go package.

ChangeLog

• 2018-11-17

  • remove old unsafe backware compatibility code.
  • tagged 0.2.0

• 2018-06-24

  • added argon2id key derivation function.
  • upgraded the key derivation function and the parameters to a 2018 flavor.
  • added some godoc documentation

• 2018-04-01

  • separating command 'np' and package 'naclpipe', this way package can eventually be reused as "crypto" stream.
  • reusable io.Reader/Writer interface.
  • Starting 'semver' and documenting, first version will be 0.1.0

• 2018-03-24

  • fixing the empty scrypt salt reported by Tom Eklof
  • better handling of pipe input.
  • the structure has changed as the CSPRNG'ed salt is prefixed to the series of blocks

Package Example Usage

import "github.com/unix4fun/naclpipe"

// block size can be arbitrary, we read in block of datas
block := make([]byte, 8192)

// initilize my reader from stdin
cryptoReader, err := naclpipe.NewReader(os.Stdin, "mysuperduperpassword", naclpipe.DerivateArgon2id)
if err != nil {
    log.Fatalf("naclpipe error")
}

// read & decipher in block
_, err := cryptoReader.Read(b)

Package Usage Example / Tool

see np.

Package Doc

• godoc

Featuring (because there is always a star in your production..)

• NaCL ECC 25519 box/secretbox Go implementation AEAD using Salsa20 w/ Poly1305 MAC
• Argon2 for today key stretching.
• Scrypt for key stretching.
• SHA-3 for NONCE generation.
• Go because it works.