package org.bouncycastle.pqc.crypto.ntru;

import java.io.DataInputStream;
import java.io.DataOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.util.Arrays;

import org.bouncycastle.crypto.Digest;
import org.bouncycastle.crypto.digests.SHA256Digest;
import org.bouncycastle.crypto.digests.SHA512Digest;

A set of parameters for NtruEncrypt. Several predefined parameter sets are available and new ones can be created as well.
/** * A set of parameters for NtruEncrypt. Several predefined parameter sets are available and new ones can be created as well. */
public class NTRUEncryptionParameters implements Cloneable { public int N, q, df, df1, df2, df3; public int dr; public int dr1; public int dr2; public int dr3; public int dg; int llen; public int maxMsgLenBytes; public int db; public int bufferLenBits; int bufferLenTrits; public int dm0; public int pkLen; public int c; public int minCallsR; public int minCallsMask; public boolean hashSeed; public byte[] oid; public boolean sparse; public boolean fastFp; public int polyType; public Digest hashAlg;
Constructs a parameter set that uses ternary private keys (i.e. polyType=SIMPLE).
Params:
  • N – number of polynomial coefficients
  • q – modulus
  • df – number of ones in the private polynomial f
  • dm0 – minimum acceptable number of -1's, 0's, and 1's in the polynomial m' in the last encryption step
  • db – number of random bits to prepend to the message
  • c – a parameter for the Index Generation Function (IndexGenerator)
  • minCallsR – minimum number of hash calls for the IGF to make
  • minCallsMask – minimum number of calls to generate the masking polynomial
  • hashSeed – whether to hash the seed in the MGF first (true) or use the seed directly (false)
  • oid – three bytes that uniquely identify the parameter set
  • sparse – whether to treat ternary polynomials as sparsely populated (SparseTernaryPolynomial vs DenseTernaryPolynomial)
  • fastFp – whether f=1+p*F for a ternary F (true) or f is ternary (false)
  • hashAlg – a valid identifier for a java.security.MessageDigest instance such as SHA-256. The MessageDigest must support the getDigestLength() method.
/** * Constructs a parameter set that uses ternary private keys (i.e. <code>polyType=SIMPLE</code>). * * @param N number of polynomial coefficients * @param q modulus * @param df number of ones in the private polynomial <code>f</code> * @param dm0 minimum acceptable number of -1's, 0's, and 1's in the polynomial <code>m'</code> in the last encryption step * @param db number of random bits to prepend to the message * @param c a parameter for the Index Generation Function ({@link org.bouncycastle.pqc.crypto.ntru.IndexGenerator}) * @param minCallsR minimum number of hash calls for the IGF to make * @param minCallsMask minimum number of calls to generate the masking polynomial * @param hashSeed whether to hash the seed in the MGF first (true) or use the seed directly (false) * @param oid three bytes that uniquely identify the parameter set * @param sparse whether to treat ternary polynomials as sparsely populated ({@link org.bouncycastle.pqc.math.ntru.polynomial.SparseTernaryPolynomial} vs {@link org.bouncycastle.pqc.math.ntru.polynomial.DenseTernaryPolynomial}) * @param fastFp whether <code>f=1+p*F</code> for a ternary <code>F</code> (true) or <code>f</code> is ternary (false) * @param hashAlg a valid identifier for a <code>java.security.MessageDigest</code> instance such as <code>SHA-256</code>. The <code>MessageDigest</code> must support the <code>getDigestLength()</code> method. */
public NTRUEncryptionParameters(int N, int q, int df, int dm0, int db, int c, int minCallsR, int minCallsMask, boolean hashSeed, byte[] oid, boolean sparse, boolean fastFp, Digest hashAlg) { this.N = N; this.q = q; this.df = df; this.db = db; this.dm0 = dm0; this.c = c; this.minCallsR = minCallsR; this.minCallsMask = minCallsMask; this.hashSeed = hashSeed; this.oid = oid; this.sparse = sparse; this.fastFp = fastFp; this.polyType = NTRUParameters.TERNARY_POLYNOMIAL_TYPE_SIMPLE; this.hashAlg = hashAlg; init(); }
Constructs a parameter set that uses product-form private keys (i.e. polyType=PRODUCT).
Params:
  • N – number of polynomial coefficients
  • q – modulus
  • df1 – number of ones in the private polynomial f1
  • df2 – number of ones in the private polynomial f2
  • df3 – number of ones in the private polynomial f3
  • dm0 – minimum acceptable number of -1's, 0's, and 1's in the polynomial m' in the last encryption step
  • db – number of random bits to prepend to the message
  • c – a parameter for the Index Generation Function (IndexGenerator)
  • minCallsR – minimum number of hash calls for the IGF to make
  • minCallsMask – minimum number of calls to generate the masking polynomial
  • hashSeed – whether to hash the seed in the MGF first (true) or use the seed directly (false)
  • oid – three bytes that uniquely identify the parameter set
  • sparse – whether to treat ternary polynomials as sparsely populated (SparseTernaryPolynomial vs DenseTernaryPolynomial)
  • fastFp – whether f=1+p*F for a ternary F (true) or f is ternary (false)
  • hashAlg – a valid identifier for a java.security.MessageDigest instance such as SHA-256
/** * Constructs a parameter set that uses product-form private keys (i.e. <code>polyType=PRODUCT</code>). * * @param N number of polynomial coefficients * @param q modulus * @param df1 number of ones in the private polynomial <code>f1</code> * @param df2 number of ones in the private polynomial <code>f2</code> * @param df3 number of ones in the private polynomial <code>f3</code> * @param dm0 minimum acceptable number of -1's, 0's, and 1's in the polynomial <code>m'</code> in the last encryption step * @param db number of random bits to prepend to the message * @param c a parameter for the Index Generation Function ({@link org.bouncycastle.pqc.crypto.ntru.IndexGenerator}) * @param minCallsR minimum number of hash calls for the IGF to make * @param minCallsMask minimum number of calls to generate the masking polynomial * @param hashSeed whether to hash the seed in the MGF first (true) or use the seed directly (false) * @param oid three bytes that uniquely identify the parameter set * @param sparse whether to treat ternary polynomials as sparsely populated ({@link org.bouncycastle.pqc.math.ntru.polynomial.SparseTernaryPolynomial} vs {@link org.bouncycastle.pqc.math.ntru.polynomial.DenseTernaryPolynomial}) * @param fastFp whether <code>f=1+p*F</code> for a ternary <code>F</code> (true) or <code>f</code> is ternary (false) * @param hashAlg a valid identifier for a <code>java.security.MessageDigest</code> instance such as <code>SHA-256</code> */
public NTRUEncryptionParameters(int N, int q, int df1, int df2, int df3, int dm0, int db, int c, int minCallsR, int minCallsMask, boolean hashSeed, byte[] oid, boolean sparse, boolean fastFp, Digest hashAlg) { this.N = N; this.q = q; this.df1 = df1; this.df2 = df2; this.df3 = df3; this.db = db; this.dm0 = dm0; this.c = c; this.minCallsR = minCallsR; this.minCallsMask = minCallsMask; this.hashSeed = hashSeed; this.oid = oid; this.sparse = sparse; this.fastFp = fastFp; this.polyType = NTRUParameters.TERNARY_POLYNOMIAL_TYPE_PRODUCT; this.hashAlg = hashAlg; init(); } private void init() { dr = df; dr1 = df1; dr2 = df2; dr3 = df3; dg = N / 3; llen = 1; // ceil(log2(maxMsgLenBytes)) maxMsgLenBytes = N * 3 / 2 / 8 - llen - db / 8 - 1; bufferLenBits = (N * 3 / 2 + 7) / 8 * 8 + 1; bufferLenTrits = N - 1; pkLen = db; }
Reads a parameter set from an input stream.
Params:
  • is – an input stream
Throws:
/** * Reads a parameter set from an input stream. * * @param is an input stream * @throws IOException */
public NTRUEncryptionParameters(InputStream is) throws IOException { DataInputStream dis = new DataInputStream(is); N = dis.readInt(); q = dis.readInt(); df = dis.readInt(); df1 = dis.readInt(); df2 = dis.readInt(); df3 = dis.readInt(); db = dis.readInt(); dm0 = dis.readInt(); c = dis.readInt(); minCallsR = dis.readInt(); minCallsMask = dis.readInt(); hashSeed = dis.readBoolean(); oid = new byte[3]; dis.read(oid); sparse = dis.readBoolean(); fastFp = dis.readBoolean(); polyType = dis.read(); String alg = dis.readUTF(); if ("SHA-512".equals(alg)) { hashAlg = new SHA512Digest(); } else if ("SHA-256".equals(alg)) { hashAlg = new SHA256Digest(); } init(); } public NTRUEncryptionParameters clone() { if (polyType == NTRUParameters.TERNARY_POLYNOMIAL_TYPE_SIMPLE) { return new NTRUEncryptionParameters(N, q, df, dm0, db, c, minCallsR, minCallsMask, hashSeed, oid, sparse, fastFp, hashAlg); } else { return new NTRUEncryptionParameters(N, q, df1, df2, df3, dm0, db, c, minCallsR, minCallsMask, hashSeed, oid, sparse, fastFp, hashAlg); } }
Returns the maximum length a plaintext message can be with this parameter set.
Returns:the maximum length in bytes
/** * Returns the maximum length a plaintext message can be with this parameter set. * * @return the maximum length in bytes */
public int getMaxMessageLength() { return maxMsgLenBytes; }
Writes the parameter set to an output stream
Params:
  • os – an output stream
Throws:
/** * Writes the parameter set to an output stream * * @param os an output stream * @throws IOException */
public void writeTo(OutputStream os) throws IOException { DataOutputStream dos = new DataOutputStream(os); dos.writeInt(N); dos.writeInt(q); dos.writeInt(df); dos.writeInt(df1); dos.writeInt(df2); dos.writeInt(df3); dos.writeInt(db); dos.writeInt(dm0); dos.writeInt(c); dos.writeInt(minCallsR); dos.writeInt(minCallsMask); dos.writeBoolean(hashSeed); dos.write(oid); dos.writeBoolean(sparse); dos.writeBoolean(fastFp); dos.write(polyType); dos.writeUTF(hashAlg.getAlgorithmName()); } public int hashCode() { final int prime = 31; int result = 1; result = prime * result + N; result = prime * result + bufferLenBits; result = prime * result + bufferLenTrits; result = prime * result + c; result = prime * result + db; result = prime * result + df; result = prime * result + df1; result = prime * result + df2; result = prime * result + df3; result = prime * result + dg; result = prime * result + dm0; result = prime * result + dr; result = prime * result + dr1; result = prime * result + dr2; result = prime * result + dr3; result = prime * result + (fastFp ? 1231 : 1237); result = prime * result + ((hashAlg == null) ? 0 : hashAlg.getAlgorithmName().hashCode()); result = prime * result + (hashSeed ? 1231 : 1237); result = prime * result + llen; result = prime * result + maxMsgLenBytes; result = prime * result + minCallsMask; result = prime * result + minCallsR; result = prime * result + Arrays.hashCode(oid); result = prime * result + pkLen; result = prime * result + polyType; result = prime * result + q; result = prime * result + (sparse ? 1231 : 1237); return result; } public boolean equals(Object obj) { if (this == obj) { return true; } if (obj == null) { return false; } if (getClass() != obj.getClass()) { return false; } NTRUEncryptionParameters other = (NTRUEncryptionParameters)obj; if (N != other.N) { return false; } if (bufferLenBits != other.bufferLenBits) { return false; } if (bufferLenTrits != other.bufferLenTrits) { return false; } if (c != other.c) { return false; } if (db != other.db) { return false; } if (df != other.df) { return false; } if (df1 != other.df1) { return false; } if (df2 != other.df2) { return false; } if (df3 != other.df3) { return false; } if (dg != other.dg) { return false; } if (dm0 != other.dm0) { return false; } if (dr != other.dr) { return false; } if (dr1 != other.dr1) { return false; } if (dr2 != other.dr2) { return false; } if (dr3 != other.dr3) { return false; } if (fastFp != other.fastFp) { return false; } if (hashAlg == null) { if (other.hashAlg != null) { return false; } } else if (!hashAlg.getAlgorithmName().equals(other.hashAlg.getAlgorithmName())) { return false; } if (hashSeed != other.hashSeed) { return false; } if (llen != other.llen) { return false; } if (maxMsgLenBytes != other.maxMsgLenBytes) { return false; } if (minCallsMask != other.minCallsMask) { return false; } if (minCallsR != other.minCallsR) { return false; } if (!Arrays.equals(oid, other.oid)) { return false; } if (pkLen != other.pkLen) { return false; } if (polyType != other.polyType) { return false; } if (q != other.q) { return false; } if (sparse != other.sparse) { return false; } return true; } public String toString() { StringBuilder output = new StringBuilder("EncryptionParameters(N=" + N + " q=" + q); if (polyType == NTRUParameters.TERNARY_POLYNOMIAL_TYPE_SIMPLE) { output.append(" polyType=SIMPLE df=" + df); } else { output.append(" polyType=PRODUCT df1=" + df1 + " df2=" + df2 + " df3=" + df3); } output.append(" dm0=" + dm0 + " db=" + db + " c=" + c + " minCallsR=" + minCallsR + " minCallsMask=" + minCallsMask + " hashSeed=" + hashSeed + " hashAlg=" + hashAlg + " oid=" + Arrays.toString(oid) + " sparse=" + sparse + ")"); return output.toString(); } }