Package net.i2p.data

Class SigningPublicKey

java.lang.Object
net.i2p.data.SimpleDataStructure
net.i2p.data.SigningPublicKey
All Implemented Interfaces:
DataStructure
public class SigningPublicKey extends SimpleDataStructure
Defines the SigningPublicKey as defined by the I2P data structure spec. A signing public key is by default 128 byte Integer. The public key represents only the exponent, not the primes, which are constant and defined in the crypto spec. This key varies from the PrivateKey in its usage (verifying signatures, not encrypting) As of release 0.9.8, keys of arbitrary length and type are supported. See SigType.
Author:
jrandom

  • Field Details

    • KEYSIZE_BYTES

      public static final int KEYSIZE_BYTES

  • Constructor Details

    • SigningPublicKey

      public SigningPublicKey()

    • SigningPublicKey

      public SigningPublicKey(SigType type)
      Parameters:
      type - if null, type is unknown
      Since:
      0.9.8

    • SigningPublicKey

      public SigningPublicKey(byte[] data)

    • SigningPublicKey

      public SigningPublicKey(SigType type, byte[] data)
      Parameters:
      type - if null, type is unknown
      Since:
      0.9.8

    • SigningPublicKey

      public SigningPublicKey(String base64Data) throws DataFormatException
      constructs from base64
      Parameters:
      base64Data - a string of base64 data (the output of .toBase64() called on a prior instance of SigningPublicKey
      Throws:
      DataFormatException

  • Method Details

    • create

      public static SigningPublicKey create(byte[] data, int off)
      Pull from cache or return new. Deprecated - used only by deprecated Destination.readBytes(data, off)
      Throws:
      ArrayIndexOutOfBoundsException - if not enough bytes, FIXME should throw DataFormatException
      Since:
      0.8.3

    • create

      public static SigningPublicKey create(InputStream in) throws IOException
      Pull from cache or return new
      Throws:
      IOException
      Since:
      0.8.3

    • length

      public int length()
      Description copied from class: SimpleDataStructure
      The legal length of the byte array in this data structure
      Specified by:
      length in class SimpleDataStructure
      Returns:
      if type unknown, the length of the data, or 128 if no data

    • getType

      public SigType getType()
      Returns:
      null if unknown
      Since:
      0.9.8

    • toTypedKey

      SigningPublicKey toTypedKey(KeyCertificate kcert)
      Up-convert this from an untyped (type 0) SPK to a typed SPK based on the Key Cert given. The type of the returned key will be null if the kcert sigtype is null.
      Throws:
      IllegalArgumentException - if this is already typed to a different type
      Since:
      0.9.12 changed from public to package private in 0.9.66, not for external use

    • getPadding

      public byte[] getPadding(KeyCertificate kcert)
      Get the portion of this (type 0) SPK that is really padding based on the Key Cert type given, if any
      Returns:
      leading padding length > 0 or null if no padding or type is unknown
      Throws:
      IllegalArgumentException - if this is already typed to a different type
      Since:
      0.9.12

    • writeTruncatedBytes

      void writeTruncatedBytes(OutputStream out) throws DataFormatException, IOException
      Write the data up to a max of 128 bytes. If longer, the rest will be written in the KeyCertificate.
      Throws:
      DataFormatException
      IOException
      Since:
      0.9.12 changed from public to package private in 0.9.66, not for external use

    • blind

      public SigningPublicKey blind(SigningPrivateKey alpha)
      Only for SigType EdDSA_SHA512_Ed25519
      Parameters:
      alpha - the secret data
      Throws:
      UnsupportedOperationException - unless supported
      Since:
      0.9.38

    • toString

      public String toString()
      Overrides:
      toString in class SimpleDataStructure
      Since:
      0.9.8

    • clearCache

      public static void clearCache()
      Since:
      0.9.17

    • hashCode

      public int hashCode()
      Description copied from class: SimpleDataStructure
      We assume the data has enough randomness in it, so use the first 4 bytes for speed. If this is not the case, override in the extending class.
      Overrides:
      hashCode in class SimpleDataStructure
      Since:
      0.9.17

    • equals

      public boolean equals(Object obj)
      Description copied from class: SimpleDataStructure
      Warning - this returns true for two different classes with the same size and same data, e.g. SessionKey and SessionTag, but you wouldn't put them in the same Set, would you?
      Overrides:
      equals in class SimpleDataStructure
      Since:
      0.9.17