Package org.bouncycastle.pqc.legacy.crypto.rainbow

Class Layer

java.lang.Object
org.bouncycastle.pqc.legacy.crypto.rainbow.Layer
public class Layer extends Object
This class represents a layer of the Rainbow Oil- and Vinegar Map. Each Layer consists of oi polynomials with their coefficients, generated at random.

To sign a document, we solve a LES (linear equation system) for each layer in order to find the oil variables of that layer and to be able to use the variables to compute the signature. This functionality is implemented in the RainbowSignature-class, by the aid of the private key.

Each layer is a part of the private key.

More information about the layer can be found in the paper of Jintai Ding, Dieter Schmidt: Rainbow, a New Multivariable Polynomial Signature Scheme. ACNS 2005: 164-175 (https://dx.doi.org/10.1007/11496137_12)

  • Constructor Summary

    Constructors
    Constructor
    Description
    Layer(byte vi, byte viNext, short[][][] coeffAlpha, short[][][] coeffBeta, short[][] coeffGamma, short[] coeffEta)
    Constructor
    Layer(int vi, int viNext, SecureRandom sr)
    This function generates the coefficients of all polynomials in this layer at random using random generator.

  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
    equals(Object other)
    This function compares this Layer with another object.
    short[][][]
    getCoeffAlpha()
    Getter for the alpha-coefficients of the polynomials in this layer.
    short[][][]
    getCoeffBeta()
    Getter for the beta-coefficients of the polynomials in this layer.
    short[]
    getCoeffEta()
    Getter for the eta-coefficients of the polynomials in this layer.
    short[][]
    getCoeffGamma()
    Getter for the gamma-coefficients of the polynomials in this layer.
    int
    getOi()
    Getter for the number of Oil variables of this layer.
    int
    getVi()
    Getter for the number of vinegar variables of this layer.
    int
    getViNext()
    Getter for the number of vinegar variables of the next layer.
    int
    hashCode()
     
    short[][]
    plugInVinegars(short[] x)
    This method plugs in the vinegar variables into the polynomials of this layer and computes the coefficients of the Oil-variables as well as the free coefficient in each polynomial.

    Methods inherited from class java.lang.Object

    clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

  • Constructor Details

    • Layer

      public Layer(byte vi, byte viNext, short[][][] coeffAlpha, short[][][] coeffBeta, short[][] coeffGamma, short[] coeffEta)
      Constructor
      Parameters:
      vi - number of vinegar variables of this layer
      viNext - number of vinegar variables of next layer. It's the same as (num of oils) + (num of vinegars) of this layer.
      coeffAlpha - alpha-coefficients in the polynomials of this layer
      coeffBeta - beta-coefficients in the polynomials of this layer
      coeffGamma - gamma-coefficients in the polynomials of this layer
      coeffEta - eta-coefficients in the polynomials of this layer

    • Layer

      public Layer(int vi, int viNext, SecureRandom sr)
      This function generates the coefficients of all polynomials in this layer at random using random generator.
      Parameters:
      sr - the random generator which is to be used

  • Method Details

    • plugInVinegars

      public short[][] plugInVinegars(short[] x)
      This method plugs in the vinegar variables into the polynomials of this layer and computes the coefficients of the Oil-variables as well as the free coefficient in each polynomial.

      It is needed for computing the Oil variables while signing.

      Parameters:
      x - vinegar variables of this layer that should be plugged into the polynomials.
      Returns:
      coeff the coefficients of Oil variables and the free coeff in the polynomials of this layer.

    • getVi

      public int getVi()
      Getter for the number of vinegar variables of this layer.
      Returns:
      the number of vinegar variables of this layer.

    • getViNext

      public int getViNext()
      Getter for the number of vinegar variables of the next layer.
      Returns:
      the number of vinegar variables of the next layer.

    • getOi

      public int getOi()
      Getter for the number of Oil variables of this layer.
      Returns:
      the number of oil variables of this layer.

    • getCoeffAlpha

      public short[][][] getCoeffAlpha()
      Getter for the alpha-coefficients of the polynomials in this layer.
      Returns:
      the coefficients of alpha-terms of this layer.

    • getCoeffBeta

      public short[][][] getCoeffBeta()
      Getter for the beta-coefficients of the polynomials in this layer.
      Returns:
      the coefficients of beta-terms of this layer.

    • getCoeffGamma

      public short[][] getCoeffGamma()
      Getter for the gamma-coefficients of the polynomials in this layer.
      Returns:
      the coefficients of gamma-terms of this layer

    • getCoeffEta

      public short[] getCoeffEta()
      Getter for the eta-coefficients of the polynomials in this layer.
      Returns:
      the coefficients eta of this layer

    • equals

      public boolean equals(Object other)
      This function compares this Layer with another object.
      Overrides:
      equals in class Object
      Parameters:
      other - the other object
      Returns:
      the result of the comparison

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object