ch.epfl.dedis.lib

Class SkipBlock

java.lang.Object

ch.epfl.dedis.lib.SkipBlock

public class SkipBlock
extends Object

SkipBlock is a wrapper around the protobuf SkipBlock class. It is mainly used to serialize the genesis block for storage.

Constructor Summary

Constructors

Constructor and Description
SkipBlock(byte[] sb)
SkipBlock(SkipchainProto.SkipBlock skipBlock)

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj)
List<SkipblockId>	getBackLinks() Getter for the list of backlinks in the skipblock.
int	getBaseHeight()
byte[]	getData()
List<ForwardLink>	getForwardLinks()
byte[]	getHash()
int	getHeight()
SkipblockId	getId()
int	getIndex()
int	getMaximumHeight()
byte[]	getPayload()
SkipchainProto.SkipBlock	getProto()
Roster	getRoster() Gets the roster from the skipblock.
SkipblockId	getSkipchainId()
List<byte[]>	getVerifiers() Getter for the list of verifiers in the skipblock.
byte[]	toByteArray()
boolean	verifyForwardSignatures() This function checks whether all signatures in the forward-links are correctly signed by the aggregate public key of the roster

Methods inherited from class java.lang.Object

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

Constructor Detail

SkipBlock

public SkipBlock(SkipchainProto.SkipBlock skipBlock)

Parameters:

skipBlock - the protobuf definition of the skipblock.

SkipBlock

public SkipBlock(byte[] sb)
          throws CothorityException

Parameters:

sb - the binary representation of the protobuf of the skipblock.

Throws:

CothorityException - if something goes wrong

Method Detail

getHash

public byte[] getHash()

Returns:

the hash of the block, which includes the backward-links and the data.

getId

public SkipblockId getId()

Returns:

the id of the block, which is its hash.

getSkipchainId

public SkipblockId getSkipchainId()
                           throws CothorityCryptoException

Returns:

the id of the skipchain this block is part of. This is equal to the hash for the genesis block.

Throws:

CothorityCryptoException - if there's a problem with the cryptography

getData

public byte[] getData()

Returns:

the data of the block, which is protected by the block hash.

getPayload

public byte[] getPayload()

Returns:

the payload of the block, which is not directly protected by the block hash.

getIndex

public int getIndex()

Returns:

the index of the skipblock - the genesis block has index 0.

getHeight

public int getHeight()

Returns:

the height of the block.

getMaximumHeight

public int getMaximumHeight()

Returns:

the maximum height of the block.

getBaseHeight

public int getBaseHeight()

Returns:

the base height of the block.

getForwardLinks

public List<ForwardLink> getForwardLinks()

Returns:

the list of all forwardlinks contained in this block. There might be no forward link at all, if this is the tip of the chain.

verifyForwardSignatures

public boolean verifyForwardSignatures()

This function checks whether all signatures in the forward-links are correctly signed by the aggregate public key of the roster

Returns:

true if the signature is ok.

getBackLinks

public List<SkipblockId> getBackLinks()

Getter for the list of backlinks in the skipblock.

getVerifiers

public List<byte[]> getVerifiers()

Getter for the list of verifiers in the skipblock.

getRoster

public Roster getRoster()
                 throws CothorityCryptoException

Gets the roster from the skipblock.

Returns:

the roster responsible for that skipblock

Throws:

CothorityCryptoException - if the roster cannot be parsed

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toByteArray

public byte[] toByteArray()

Returns:

the serialized skipblock.

getProto

public SkipchainProto.SkipBlock getProto()

Returns:

the protobuf representation of the block.