org.jivesoftware.smackx.omemo.util

Class KeyUtil.Bundle

java.lang.Object

org.jivesoftware.smackx.omemo.util.KeyUtil.Bundle

Enclosing class:

KeyUtil<T_IdKeyPair,T_IdKey,T_PreKey,T_SigPreKey,T_Sess,T_Addr,T_ECPub,T_Bundle,T_Ciph>

public class KeyUtil.Bundle
extends java.lang.Object

Bundle related methods.

Constructor Summary

Constructors

Constructor and Description
Bundle()

Method Summary

Modifier and Type	Method and Description
java.util.HashMap<java.lang.Integer,T_Bundle>	bundles(OmemoBundleVAxolotlElement bundle, OmemoDevice contact) Break up the OmemoBundleElement into a list of crypto-lib specific bundles (T_PreKey).
T_IdKey	identityKey(OmemoBundleVAxolotlElement bundle) Extract an IdentityKey from a OmemoBundleElement.
T_ECPub	preKeyPublic(OmemoBundleVAxolotlElement bundle, int keyId) Extract the preKey with id 'keyId' from the bundle.
int	signedPreKeyId(OmemoBundleVAxolotlElement bundle) Extract the id of the transported signedPreKey from the bundle.
T_ECPub	signedPreKeyPublic(OmemoBundleVAxolotlElement bundle) Extract a signedPreKey from an OmemoBundleElement.
byte[]	signedPreKeySignature(OmemoBundleVAxolotlElement bundle) Extract the signature of the signedPreKey in the bundle as a byte array.

Methods inherited from class java.lang.Object

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

Constructor Detail

Bundle

public Bundle()

Method Detail

identityKey

public T_IdKey identityKey(OmemoBundleVAxolotlElement bundle)
                    throws CorruptedOmemoKeyException

Extract an IdentityKey from a OmemoBundleElement.

Parameters:

bundle - OmemoBundleElement

Returns:

identityKey

Throws:

CorruptedOmemoKeyException - if the key is damaged/malformed

signedPreKeyPublic

public T_ECPub signedPreKeyPublic(OmemoBundleVAxolotlElement bundle)
                           throws CorruptedOmemoKeyException

Extract a signedPreKey from an OmemoBundleElement.

Parameters:

bundle - OmemoBundleElement

Returns:

singedPreKey

Throws:

CorruptedOmemoKeyException - if the key is damaged/malformed

signedPreKeyId

public int signedPreKeyId(OmemoBundleVAxolotlElement bundle)

Extract the id of the transported signedPreKey from the bundle.

Parameters:

bundle - OmemoBundleElement

Returns:

signedPreKeyId

signedPreKeySignature

public byte[] signedPreKeySignature(OmemoBundleVAxolotlElement bundle)

Extract the signature of the signedPreKey in the bundle as a byte array.

Parameters:

bundle - OmemoBundleElement

Returns:

signature

preKeyPublic

public T_ECPub preKeyPublic(OmemoBundleVAxolotlElement bundle,
                            int keyId)
                     throws CorruptedOmemoKeyException

Extract the preKey with id 'keyId' from the bundle.

Parameters:

bundle - OmemoBundleElement

keyId - id of the preKey

Returns:

the preKey

Throws:

CorruptedOmemoKeyException - when the key cannot be parsed from bytes

bundles

public java.util.HashMap<java.lang.Integer,T_Bundle> bundles(OmemoBundleVAxolotlElement bundle,
                                                             OmemoDevice contact)
                                                      throws CorruptedOmemoKeyException

Break up the OmemoBundleElement into a list of crypto-lib specific bundles (T_PreKey). In case of the signal library, we break the OmemoBundleElement in ~100 PreKeyBundles (one for every transported preKey).

Parameters:

bundle - OmemoBundleElement containing multiple PreKeys

contact - Contact that the bundle belongs to

Returns:

a HashMap with one T_Bundle per preKey and the preKeyId as key

Throws:

CorruptedOmemoKeyException - when one of the keys cannot be parsed