com.github.katenachain

Class Transactor

java.lang.Object

com.github.katenachain.Transactor

public class Transactor
extends Object

Transactor provides helper methods to hide the complexity of Tx creation, signature and API dialog.

Constructor Summary

Constructors

Constructor and Description
Transactor(String apiUrl) Transactor constructor.
Transactor(String apiUrl, String chainID, String companyBcid, PrivateKey txSigner) Transactor constructor.

Method Summary

Modifier and Type	Method and Description
TxWrappers	retrieveCertificates(String companyBcid, String uuid, int page, int txPerPage) fetches the API to find the corresponding txs and returns tx wrappers or an error.
KeyV1[]	retrieveCompanyKeys(String companyBcid, int page, int txPerPage) fetches the API and returns the list of keyV1 for a company or an error.
TxWrappers	retrieveKeyCreateTxs(String companyBcid, String uuid, int page, int txPerPage) fetches the API to find the corresponding txs and returns tx wrappers or an error.
TxWrappers	retrieveKeyRevokeTxs(String companyBcid, String uuid, int page, int txPerPage) fetches the API to find the corresponding txs and returns tx wrappers or an error.
TxWrapper	retrieveLastCertificate(String companyBcid, String uuid) fetches the API to find the corresponding tx and return a tx wrapper.
TxWrappers	retrieveSecrets(String companyBcid, String uuid, int page, int txPerPage) fetches the API to find the corresponding txs and returns tx wrappers.
TxWrappers	retrieveTxs(String txCategory, String companyBcid, String uuid, int page, int txPerPage) fetches the API to find the corresponding txs and returns tx wrappers or an error.
TxStatus	sendCertificateEd25519V1(String uuid, PublicKey signer, byte[] signature) creates a CertificateEd25519 (V1), wraps in a tx and sends it to the API.
TxStatus	sendCertificateRawV1(String uuid, byte[] value) creates a CertificateRaw (V1), wraps in a tx and sends it to the API.
TxStatus	sendKeyCreateV1(String uuid, PublicKey publicKey, String role) creates a KeyCreate (V1) and sends it to the API.
TxStatus	sendKeyRevokeV1(String uuid, PublicKey publicKey) creates a KeyRevoke (V1) and sends it to the API.
TxStatus	sendSecretNaclBoxV1(String uuid, PublicKey sender, byte[] nonce, byte[] content) creates a SecretNaclBox (V1), wraps in a tx and sends it to the API.
TxStatus	sendTx(TxData txData) signs and sends a tx to the Api.

Methods inherited from class java.lang.Object

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

Constructor Detail

Transactor

public Transactor(String apiUrl,
                  String chainID,
                  String companyBcid,
                  PrivateKey txSigner)

Transactor constructor.

Transactor

public Transactor(String apiUrl)

Transactor constructor.

Method Detail

sendCertificateRawV1

public TxStatus sendCertificateRawV1(String uuid,
                                     byte[] value)
                              throws ApiException,
                                     IOException,
                                     NoSuchAlgorithmException,
                                     InvalidKeyException,
                                     SignatureException,
                                     ClientException

creates a CertificateRaw (V1), wraps in a tx and sends it to the API.

Throws:

ApiException

IOException

NoSuchAlgorithmException

InvalidKeyException

SignatureException

ClientException

sendCertificateEd25519V1

public TxStatus sendCertificateEd25519V1(String uuid,
                                         PublicKey signer,
                                         byte[] signature)
                                  throws ApiException,
                                         IOException,
                                         NoSuchAlgorithmException,
                                         InvalidKeyException,
                                         SignatureException,
                                         ClientException

creates a CertificateEd25519 (V1), wraps in a tx and sends it to the API.

Throws:

ApiException

IOException

NoSuchAlgorithmException

InvalidKeyException

SignatureException

ClientException

sendKeyCreateV1

public TxStatus sendKeyCreateV1(String uuid,
                                PublicKey publicKey,
                                String role)
                         throws ApiException,
                                IOException,
                                NoSuchAlgorithmException,
                                InvalidKeyException,
                                SignatureException,
                                ClientException

creates a KeyCreate (V1) and sends it to the API.

Throws:

ApiException

IOException

NoSuchAlgorithmException

InvalidKeyException

SignatureException

ClientException

sendKeyRevokeV1

public TxStatus sendKeyRevokeV1(String uuid,
                                PublicKey publicKey)
                         throws ApiException,
                                IOException,
                                NoSuchAlgorithmException,
                                InvalidKeyException,
                                SignatureException,
                                ClientException

creates a KeyRevoke (V1) and sends it to the API.

Throws:

ApiException

IOException

NoSuchAlgorithmException

InvalidKeyException

SignatureException

ClientException

sendSecretNaclBoxV1

public TxStatus sendSecretNaclBoxV1(String uuid,
                                    PublicKey sender,
                                    byte[] nonce,
                                    byte[] content)
                             throws NoSuchAlgorithmException,
                                    InvalidKeyException,
                                    SignatureException,
                                    IOException,
                                    ApiException,
                                    ClientException

creates a SecretNaclBox (V1), wraps in a tx and sends it to the API.

Throws:

NoSuchAlgorithmException

InvalidKeyException

SignatureException

IOException

ApiException

ClientException

sendTx

public TxStatus sendTx(TxData txData)
                throws NoSuchAlgorithmException,
                       InvalidKeyException,
                       SignatureException,
                       IOException,
                       ApiException,
                       ClientException

signs and sends a tx to the Api.

Throws:

NoSuchAlgorithmException

InvalidKeyException

SignatureException

IOException

ApiException

ClientException

retrieveLastCertificate

public TxWrapper retrieveLastCertificate(String companyBcid,
                                         String uuid)
                                  throws IOException,
                                         ApiException

fetches the API to find the corresponding tx and return a tx wrapper.

Throws:

IOException

ApiException

retrieveCertificates

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

fetches the API to find the corresponding txs and returns tx wrappers or an error.

Throws:

IOException

ApiException

retrieveKeyCreateTxs

public TxWrappers retrieveKeyCreateTxs(String companyBcid,
                                       String uuid,
                                       int page,
                                       int txPerPage)
                                throws IOException,
                                       ApiException

fetches the API to find the corresponding txs and returns tx wrappers or an error.

Throws:

IOException

ApiException

retrieveKeyRevokeTxs

public TxWrappers retrieveKeyRevokeTxs(String companyBcid,
                                       String uuid,
                                       int page,
                                       int txPerPage)
                                throws IOException,
                                       ApiException

fetches the API to find the corresponding txs and returns tx wrappers or an error.

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 an error.

Throws:

IOException

ApiException

retrieveSecrets

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

fetches the API to find the corresponding txs and returns tx wrappers.

Throws:

IOException

ApiException

retrieveTxs

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

fetches the API to find the corresponding txs and returns tx wrappers or an error.

Throws:

IOException

ApiException