ch.epfl.dedis.skipchain

Class SkipchainRPC

java.lang.Object

ch.epfl.dedis.skipchain.SkipchainRPC

public class SkipchainRPC
extends Object

Implementing an interface to the skipchain service.

Field Summary

Fields

Modifier and Type	Field and Description
protected Roster	roster
protected SkipblockId	scID
static String	SERVICE_NANE

Constructor Summary

Constructors

Constructor and Description
SkipchainRPC(Roster roster, SkipblockId scID) If the skipchain is already initialised, this constructor will only initialise the class.

Method Summary

Modifier and Type	Method and Description
boolean	checkStatus() Contacts all nodes in the cothority and returns true only if _all_ nodes returned OK.
SkipblockId	getID() Getter for the skipchain ID.
Roster	getRoster() Getter for the roster.
SkipBlock	getSkipblock(SkipblockId id) Returns the skipblock from the skipchain, given its id.
List<SkipBlock>	getUpdateChain() Returns a list of blocks block and verify that the links are correct.
List<SkipBlock>	getUpdateChain(SkipblockId trustedLatest) Returns a list of blocks block and verify that the links are correct.

Methods inherited from class java.lang.Object

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

Field Detail

scID

protected SkipblockId scID

roster

protected Roster roster

SERVICE_NANE

public static final String SERVICE_NANE

See Also:

Constant Field Values

Constructor Detail

SkipchainRPC

public SkipchainRPC(Roster roster,
                    SkipblockId scID)
             throws CothorityCommunicationException

If the skipchain is already initialised, this constructor will only initialise the class. Once it is initialized, you can verify it with the verify()-method.

Parameters:

roster - list of all cothority servers with public keys

scID - the getId of the used skipchain

Throws:

CothorityCommunicationException - in case of communication difficulties

Method Detail

checkStatus

public boolean checkStatus()

Contacts all nodes in the cothority and returns true only if _all_ nodes returned OK.

Returns:

true only if all nodes are OK, else false.

getSkipblock

public SkipBlock getSkipblock(SkipblockId id)
                       throws CothorityCommunicationException

Returns the skipblock from the skipchain, given its id. Note that only the integrity of the block is verified but the caller must insure it belongs to the chain.

Parameters:

id - the id of the skipblock

Returns:

the proto-representation of the skipblock.

Throws:

CothorityCommunicationException - in case of communication difficulties

getUpdateChain

public List<SkipBlock> getUpdateChain()
                               throws CothorityCommunicationException,
                                      CothorityCryptoException

Returns a list of blocks block and verify that the links are correct. The verification is performed from the genesis block. Query the service and then return the chain of SkipBlocks going from trustedLatest to the most current SkipBlock of the chain. The returned list of blocks is linked using the highest level links available to shorten the returned chain.

Returns:

the chain of blocks

Throws:

CothorityCommunicationException - if something goes wrong with communication

CothorityCryptoException - if the verification goes wrong

getUpdateChain

public List<SkipBlock> getUpdateChain(SkipblockId trustedLatest)
                               throws CothorityCommunicationException,
                                      CothorityCryptoException

Returns a list of blocks block and verify that the links are correct. The verification is performed from trustedLatest. Query the service and then return the chain of SkipBlocks going from trustedLatest to the most current SkipBlock of the chain. The returned list of blocks is linked using the highest level links available to shorten the returned chain.

Parameters:

trustedLatest - is the latest block ID that the caller trusts, which serves as the source for verification.

Returns:

the the chain of blocks.

Throws:

CothorityCommunicationException - if something goes wrong with communication

CothorityCryptoException - if the verification goes wrong

getID

public SkipblockId getID()

Getter for the skipchain ID.

getRoster

public Roster getRoster()

Getter for the roster.