com.github.katenachain.api

Class Handler

java.lang.Object

com.github.katenachain.api.Handler

public class Handler
extends Object

Handler provides helper methods to send and retrieve tx without directly interacting with the HTTP Client.

Constructor Summary

Constructors

Constructor and Description
Handler(String apiUrl, Serializer serializer) Handler constructor.

Method Summary

Modifier and Type	Method and Description
byte[]	getTxDataState(String chainID, Date nonceTime, TxData txData) returns the sorted and marshaled json representation of a TxData ready to be signed.
TxWrappers	retrieveCertificates(String id, int page, int txPerPage) fetches the API and returns a tx wrappers or throws an error.
KeyV1[]	retrieveCompanyKeys(String companyBcid, int page, int txPerPage) fetches the API and returns the list of keyV1 for a company or throws an error.
TxWrapper	retrieveLastCertificate(String id) fetches the API and returns a tx wrapper or throws an error.
TxWrappers	retrieveSecrets(String id, int page, int txPerPage) fetches the API and returns a tx wrappers or throws an error.
TxWrappers	retrieveTxs(String txCategory, String id, int page, int txPerPage) fetches the API and returns a tx wrappers or throws an error.
TxStatus	sendTx(Tx tx) accepts a tx and sends it to the Api to return a tx status or throws an error.
Tx	signTx(PrivateKey privateKey, String chainID, Date nonceTime, TxData txData) signs a tx data and returns a new tx ready to be sent.

Methods inherited from class java.lang.Object

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

Constructor Detail

Handler

public Handler(String apiUrl,
               Serializer serializer)

Handler constructor.

Parameters:

apiUrl -

serializer -

Method Detail

sendTx

public TxStatus sendTx(Tx tx)
                throws IOException,
                       ApiException

accepts a tx and sends it to the Api to return a tx status or throws an error.

Parameters:

tx -

Returns:

Throws:

IOException

ApiException

retrieveLastCertificate

public TxWrapper retrieveLastCertificate(String id)
                                  throws IOException,
                                         ApiException

fetches the API and returns a tx wrapper or throws an error.

Parameters:

id -

Returns:

Throws:

IOException

ApiException

retrieveCertificates

public TxWrappers retrieveCertificates(String id,
                                       int page,
                                       int txPerPage)
                                throws IOException,
                                       ApiException

fetches the API and returns a tx wrappers or throws an error.

Parameters:

id -

page -

txPerPage -

Returns:

Throws:

IOException

ApiException

retrieveSecrets

public TxWrappers retrieveSecrets(String id,
                                  int page,
                                  int txPerPage)
                           throws IOException,
                                  ApiException

fetches the API and returns a tx wrappers or throws an error.

Parameters:

txPerPage -

page -

id -

Returns:

Throws:

IOException

ApiException

retrieveTxs

public TxWrappers retrieveTxs(String txCategory,
                              String id,
                              int page,
                              int txPerPage)
                       throws IOException,
                              ApiException

fetches the API and returns a tx wrappers or throws an error.

Parameters:

id -

page -

txPerPage -

txCategory -

Returns:

Throws:

IOException

ApiException

retrieveCompanyKeys

public KeyV1[] retrieveCompanyKeys(String companyBcid,
                                   int page,
                                   int txPerPage)
                            throws IOException,
                                   ApiException

fetches the API and returns the list of keyV1 for a company or throws an error.

Parameters:

txPerPage -

page -

companyBcid -

Returns:

Throws:

IOException

ApiException

signTx

public Tx signTx(PrivateKey privateKey,
                 String chainID,
                 Date nonceTime,
                 TxData txData)
          throws NoSuchAlgorithmException,
                 InvalidKeyException,
                 SignatureException

signs a tx data and returns a new tx ready to be sent.

Parameters:

chainID -

nonceTime -

privateKey -

txData -

Returns:

Throws:

NoSuchAlgorithmException

InvalidKeyException

SignatureException

getTxDataState

public byte[] getTxDataState(String chainID,
                             Date nonceTime,
                             TxData txData)

returns the sorted and marshaled json representation of a TxData ready to be signed.

Parameters:

txData -

nonceTime -

chainID -

Returns: