tweetnacl-java

TweetNaCl in Java - a port of TweetNaCl-js.

License	MIT License
Categories	Java Languages
GroupId	org.purejava
ArtifactId	tweetnacl-java
Last Version	1.1.2
Release Date	Feb 26, 2021
Type	jar
Description	tweetnacl-java TweetNaCl in Java - a port of TweetNaCl-js.
Project URL	https://github.com/purejava/tweetnacl-java
Source Code Management	https://github.com/purejava/tweetnacl-java/tree/master

Download tweetnacl-java

Filename	Size
tweetnacl-java-1.1.2.pom
tweetnacl-java-1.1.2.jar	60 KB
tweetnacl-java-1.1.2-sources.jar	33 KB
tweetnacl-java-1.1.2-javadoc.jar	481 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.purejava/tweetnacl-java/ -->
<dependency>
    <groupId>org.purejava</groupId>
    <artifactId>tweetnacl-java</artifactId>
    <version>1.1.2</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.purejava/tweetnacl-java/
implementation 'org.purejava:tweetnacl-java:1.1.2'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.purejava/tweetnacl-java/
implementation ("org.purejava:tweetnacl-java:1.1.2")

Apache Buildr

'org.purejava:tweetnacl-java:jar:1.1.2'

Apache Ivy

<dependency org="org.purejava" name="tweetnacl-java" rev="1.1.2">
  <artifact name="tweetnacl-java" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.purejava', module='tweetnacl-java', version='1.1.2')
)

Scala SBT

libraryDependencies += "org.purejava" % "tweetnacl-java" % "1.1.2"

Leiningen

[org.purejava/tweetnacl-java "1.1.2"]

Dependencies

test (1)

Group / Artifact	Type	Version
junit : junit	jar	4.13.1

Project Modules

There are no modules declared in this project.

TweetNacl in Java: port of tweetnacl-js

API/Usage

Suggest always use TweetNaclFast implementation

Public key authenticated encryption

• get key pair: Box.KeyPair kp = Box.keyPair(), kp = Box.keyPair_fromSecretKey(sk)
• new Box object: Box box = new Box(theirPublicKey, mySecretKey, Nonce);
• encryption: cipher = box.box(message);
• decryption: message = box.open(cipher);
• Nonce MUST be unique for ever message passed between same peers

As an alternative, the nonce can be omitted from the Box() call, and passed in the box and open calls, like:

• byte [] nonce = new byte[nonceLength], randombytes(theNonce, nonceLength);
• Box.KeyPair kp = Box.keyPair(), kp = Box.keyPair_fromSecretKey(sk)
• Box box = new Box(theirPublicKey, mySecretKey);
• encryption: cipher = box.box(message, nonce);
• decryption: message = box.open(cipher, nonce);

Secret key authenticated encryption

• get shared key: crypto random, what you have
• new SecretBox object: SecretBox sbox = new SecretBox(sharedKey, Nonce);
• encryption: cipher = sbox.box(message);
• decryption: message = sbox.open(cipher);
• Nonce MUST be unique for ever message passed between same peers

As an alternative, the nonce can be omitted from the SecretBox() call, and passed in the box and open calls, like:

• byte [] nonce = new byte[nonceLength], randombytes(theNonce, nonceLength);
• SecretBox sbox = new SecretBox(sharedKey);
• cipher = sbox.box(message, nonce);
• decryption: message = sbox.open(cipher, nonce);

Signature

• get key pair: Signature.KeyPair kp = Signature.keyPair(), kp = Signature.keyPair_fromSecretKey(sk);
• new Signature object: Signature sig = new Signature(theirPublicKey, mySecretKey);
• sign: signedMessage = sig.sign(message);
• verify: message = sig.open(signedMessage);
• Nonce MUST be unique for ever message passed between same peers

Hash

• generate SHA-512: byte [] tag = Hash.sha512(message);

Refer to com.iwebpp.crypto.tests for details

About Random generation

• the library uses java.security.SecureRandom for key generation
• you can always use the library to generate key, or use a Crypto Random like java.security.SecureRandom

Testing

In top directory:

$ mvn test

Support us

• Welcome contributing on document, codes, tests and issues

License MIT

• Copyright(2014-present) by tom zhou, [email protected]

Versions

Version
1.1.2 Feb 26, 2021