ch.epfl.dedis.calypso

Class CalypsoRPC

java.lang.Object

ch.epfl.dedis.byzcoin.ByzCoinRPC

ch.epfl.dedis.calypso.CalypsoRPC

public class CalypsoRPC
extends ByzCoinRPC

CalypsoRPC is the entry point for all the RPC calls to the Calypso service, which acts as the secret-management cothority.

Field Summary

Fields inherited from class ch.epfl.dedis.byzcoin.ByzCoinRPC

currentVersion

Constructor Summary

Constructors

Constructor and Description
CalypsoRPC(ByzCoinRPC byzcoin) Creates a new Long Term Secret on an existing ByzCoin ledger.
CalypsoRPC(Roster roster, Darc genesis, java.time.Duration blockInterval) Creates a new ByzCoin ledger and a new Long Term Secret.

Method Summary

Modifier and Type	Method and Description
LTS	createLTS() Create a long-term-secret (LTS) and retrieve its configuration.
static CalypsoRPC	fromCalypso(Roster roster, SkipblockId byzcoinId, LTSId ltsId) Connects to an existing byzcoin and an existing Long Term Secret.
LTS	getLTS()
LTSId	getLTSId()
Point	getLTSX()
Point	getSharedPublicKey(LTSId ltsId) returns the shared symmetricKey of the DKG that must be used to encrypt the symmetric encryption symmetricKey.
DecryptKeyReply	tryDecrypt(Proof writeProof, Proof readProof) Ask the secret-manageemnt cothority for the decryption shares.

Methods inherited from class ch.epfl.dedis.byzcoin.ByzCoinRPC

checkAuthorization, checkLiveness, fromByzCoin, getBlock, getConfig, getGenesisBlock, getGenesisDarc, getGenesisDarcInstance, getLatestBlock, getProof, getRoster, getSkipchain, getSubscription, makeGenesisDarc, sendTransaction, sendTransactionAndWait, setBlockInterval, setMaxBlockSize, setRoster, subscribeSkipBlock, subscribeSkipBlock, toBytes, unsubscribeBlock, update

Methods inherited from class java.lang.Object

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

Constructor Detail

CalypsoRPC

public CalypsoRPC(ByzCoinRPC byzcoin)
           throws CothorityException

Creates a new Long Term Secret on an existing ByzCoin ledger.

Parameters:

byzcoin - the existing byzcoin ledger.

Throws:

CothorityException - if something goes wrong

CalypsoRPC

public CalypsoRPC(Roster roster,
                  Darc genesis,
                  java.time.Duration blockInterval)
           throws CothorityException

Creates a new ByzCoin ledger and a new Long Term Secret.

Parameters:

roster - the nodes participating in the ledger

genesis - the first darc

blockInterval - how often a new block is created

Throws:

CothorityException - if something goes wrong

Method Detail

getSharedPublicKey

public Point getSharedPublicKey(LTSId ltsId)
                         throws CothorityCommunicationException

returns the shared symmetricKey of the DKG that must be used to encrypt the symmetric encryption symmetricKey. This will be the same as LTS.X stored when creating Calypso.

Parameters:

ltsId - the long term secret ID

Returns:

the aggregate public symmetricKey of the ocs-shard

Throws:

CothorityCommunicationException - in case of communication difficulties

createLTS

public LTS createLTS()
              throws CothorityCommunicationException

Create a long-term-secret (LTS) and retrieve its configuration.

Returns:

The LTS configuration that is needed to execute the write contract.

Throws:

CothorityCommunicationException - if something went wrong

tryDecrypt

public DecryptKeyReply tryDecrypt(Proof writeProof,
                                  Proof readProof)
                           throws CothorityCommunicationException

Ask the secret-manageemnt cothority for the decryption shares.

Parameters:

writeProof - The proof of the write request.

readProof - The proof of the read request.

Returns:

All the decryption shares that can be used to reconstruct the decryption key.

Throws:

CothorityCommunicationException - if something went wrong

getLTSId

public LTSId getLTSId()

Returns:

the id of the Long Term Secret

getLTSX

public Point getLTSX()

Returns:

the shared public key of the Long Term Secret

getLTS

public LTS getLTS()

Returns:

the Long Term Secret.

fromCalypso

public static CalypsoRPC fromCalypso(Roster roster,
                                     SkipblockId byzcoinId,
                                     LTSId ltsId)
                              throws CothorityException

Connects to an existing byzcoin and an existing Long Term Secret.

Parameters:

roster - the nodes handling the byzcoin ledger

byzcoinId - the id of the byzcoin ledger to connect to

ltsId - the id of the Long Term Secret to use

Returns:

CalypsoRPC if everything was found

Throws:

CothorityException - if something goes wrong