com.scalar.dl.client.service

Class ClientService

java.lang.Object

com.scalar.dl.client.service.ClientService

All Implemented Interfaces:

java.lang.AutoCloseable

@Immutable
public class ClientService
extends java.lang.Object
implements java.lang.AutoCloseable

A thread-safe client that interacts with Ledger and Auditor components to register certificates, register contracts, execute contracts, and validate data.

Usage Examples

Here is a simple example to demonstrate how to use ClientService. ClientService should always be created with ClientServiceFactory, which reuses internal instances as much as possible for better performance and less resource usage.

 ClientServiceFactory factory = new ClientServiceFactory(); // the factory should be reused

 ClientService service = factory.create(new ClientConfig(new File(properties));
 try {
   JsonNode jsonArgument = ...; // create an application-specific argument
   ContractExecutionResult result = service.executeContract(contractId, jsonArgument);
   result.getContractResult().ifPresent(System.out::println);
 } catch (ClientException e) {
   System.err.println(e.getStatusCode());
   System.err.println(e.getMessage());
 }

 factory.close();
 

Constructor Summary

Constructors

Constructor and Description
ClientService(ClientConfig config, ClientServiceHandler handler, RequestSigner signer) Constructs a ClientService with the specified ClientConfig, ClientServiceHandler and RequestSigner.

Method Summary

Modifier and Type	Method and Description
void	close() Deprecated. This method will be removed in release 5.0.0.
com.scalar.dl.ledger.model.ContractExecutionResult	executeContract(byte[] serializedBinary) Executes the specified contract with the specified serialized byte array of a ContractExecutionRequest.
com.scalar.dl.ledger.model.ContractExecutionResult	executeContract(java.lang.String contractId, com.fasterxml.jackson.databind.JsonNode contractArgument) Executes the specified contract with the specified argument.
com.scalar.dl.ledger.model.ContractExecutionResult	executeContract(java.lang.String contractId, com.fasterxml.jackson.databind.JsonNode contractArgument, java.lang.String functionId, com.fasterxml.jackson.databind.JsonNode functionArgument) Executes the specified contract (and functions) with the specified arguments.
com.scalar.dl.ledger.model.ContractExecutionResult	executeContract(java.lang.String contractId, javax.json.JsonObject contractArgument) Executes the specified contract (and functions) with the specified argument.
com.scalar.dl.ledger.model.ContractExecutionResult	executeContract(java.lang.String contractId, javax.json.JsonObject contractArgument, java.util.Optional<javax.json.JsonObject> functionArgument) Deprecated. This method will be removed in release 5.0.0.
com.scalar.dl.ledger.model.ContractExecutionResult	executeContract(java.lang.String contractId, javax.json.JsonObject contractArgument, java.lang.String functionId, javax.json.JsonObject functionArgument) Executes the specified contract (and function) with the specified arguments.
com.scalar.dl.ledger.model.ContractExecutionResult	executeContract(java.lang.String contractId, java.lang.String contractArgument) Executes the specified contract with the specified argument.
com.scalar.dl.ledger.model.ContractExecutionResult	executeContract(java.lang.String nonce, java.lang.String contractId, com.fasterxml.jackson.databind.JsonNode contractArgument) Deprecated. This method will be removed in release 5.0.0.
com.scalar.dl.ledger.model.ContractExecutionResult	executeContract(java.lang.String nonce, java.lang.String contractId, com.fasterxml.jackson.databind.JsonNode contractArgument, java.lang.String functionId, com.fasterxml.jackson.databind.JsonNode functionArgument) Deprecated. This method will be removed in release 5.0.0.
com.scalar.dl.ledger.model.ContractExecutionResult	executeContract(java.lang.String nonce, java.lang.String contractId, javax.json.JsonObject contractArgument) Deprecated. This method will be removed in release 5.0.0.
com.scalar.dl.ledger.model.ContractExecutionResult	executeContract(java.lang.String nonce, java.lang.String contractId, javax.json.JsonObject contractArgument, java.util.Optional<javax.json.JsonObject> functionArgument) Deprecated. This method will be removed in release 5.0.0.
com.scalar.dl.ledger.model.ContractExecutionResult	executeContract(java.lang.String nonce, java.lang.String contractId, javax.json.JsonObject contractArgument, java.lang.String functionId, javax.json.JsonObject functionArgument) Deprecated. This method will be removed in release 5.0.0.
com.scalar.dl.ledger.model.ContractExecutionResult	executeContract(java.lang.String nonce, java.lang.String contractId, java.lang.String contractArgument) Deprecated. This method will be removed in release 5.0.0.
com.scalar.dl.ledger.model.ContractExecutionResult	executeContract(java.lang.String contractId, java.lang.String contractArgument, java.lang.String functionId, java.lang.String functionArgument) Executes the specified contract (and function) with the specified arguments.
com.scalar.dl.ledger.model.ContractExecutionResult	executeContract(java.lang.String nonce, java.lang.String contractId, java.lang.String contractArgument, java.lang.String functionId, java.lang.String functionArgument) Deprecated. This method will be removed in release 5.0.0.
javax.json.JsonObject	listContracts(byte[] serializedBinary) Retrieves a list of contracts with the specified serialized byte array of a ContractsListingRequest.
javax.json.JsonObject	listContracts(java.lang.String id) Retrieves a list of contracts for the certificate holder specified in ClientConfig.
void	registerCertificate() Registers the certificate specified in the given ClientConfig for digital signature authentication.
void	registerCertificate(byte[] serializedBinary) Registers the certificate specified with the serialized byte array of a CertificateRegistrationRequest for digital signature authentication.
void	registerContract(byte[] serializedBinary) Registers the contract with the specified serialized byte array of a ContractRegistrationRequest.
void	registerContract(java.lang.String id, java.lang.String name, byte[] contractBytes) Registers the specified contract for the certificate holder specified in ClientConfig.
void	registerContract(java.lang.String id, java.lang.String name, byte[] contractBytes, com.fasterxml.jackson.databind.JsonNode properties) Registers the specified contract for the certificate holder specified in ClientConfig.
void	registerContract(java.lang.String id, java.lang.String name, byte[] contractBytes, javax.json.JsonObject properties) Registers the specified contract for the certificate holder specified in ClientConfig.
void	registerContract(java.lang.String id, java.lang.String name, byte[] contractBytes, java.util.Optional<javax.json.JsonObject> properties) Deprecated. This method will be removed in release 5.0.0.
void	registerContract(java.lang.String id, java.lang.String name, byte[] contractBytes, java.lang.String properties) Registers the specified contract for the certificate holder specified in ClientConfig.
void	registerContract(java.lang.String id, java.lang.String name, java.lang.String contractPath) Registers the specified contract for the certificate holder specified in ClientConfig.
void	registerContract(java.lang.String id, java.lang.String name, java.lang.String contractPath, com.fasterxml.jackson.databind.JsonNode properties) Registers the specified contract for the certificate holder specified in ClientConfig.
void	registerContract(java.lang.String id, java.lang.String name, java.lang.String contractPath, javax.json.JsonObject properties) Registers the specified contract for the certificate holder specified in ClientConfig.
void	registerContract(java.lang.String id, java.lang.String name, java.lang.String contractPath, java.util.Optional<javax.json.JsonObject> properties) Deprecated. This method will be removed in release 5.0.0.
void	registerContract(java.lang.String id, java.lang.String name, java.lang.String contractPath, java.lang.String properties) Registers the specified contract for the certificate holder specified in ClientConfig.
void	registerFunction(byte[] serializedBinary) Registers the function with the specified serialized byte array of a FunctionRegistrationRequest.
void	registerFunction(java.lang.String id, java.lang.String name, byte[] functionBytes) Registers the specified function.
void	registerFunction(java.lang.String id, java.lang.String name, java.lang.String functionPath) Registers the specified function.
void	registerSecret() Registers the secret key specified in the given ClientConfig for HMAC authentication.
void	registerSecret(byte[] serializedBinary) Registers the secret key specified with the serialized byte array of a SecretRegistrationRequest for HMAC authentication.
com.scalar.dl.ledger.model.LedgerValidationResult	validateLedger(byte[] serializedBinary) Validates the specified asset in the ledger with the specified serialized byte array of a LedgerValidationRequest.
com.scalar.dl.ledger.model.LedgerValidationResult	validateLedger(java.lang.String assetId) Validates the specified asset in the ledger.
com.scalar.dl.ledger.model.LedgerValidationResult	validateLedger(java.lang.String assetId, int startAge, int endAge) Validates the specified asset between the specified ages in the ledger.

Methods inherited from class java.lang.Object

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

Constructor Detail

ClientService

public ClientService(ClientConfig config,
                     ClientServiceHandler handler,
                     @Nullable
                     RequestSigner signer)

Constructs a ClientService with the specified ClientConfig, ClientServiceHandler and RequestSigner.

Parameters:

config - a configuration for the client

handler - a client service handler to interact the server(s)

signer - a request signer for requests

Method Detail

registerCertificate

public void registerCertificate()

Registers the certificate specified in the given ClientConfig for digital signature authentication.

Throws:

ClientException - if a request fails for some reason

registerCertificate

public void registerCertificate(byte[] serializedBinary)

Registers the certificate specified with the serialized byte array of a CertificateRegistrationRequest for digital signature authentication.

Parameters:

serializedBinary - a serialized byte array of CertificateRegistrationRequest.

Throws:

ClientException - if a request fails for some reason

registerSecret

public void registerSecret()

Registers the secret key specified in the given ClientConfig for HMAC authentication.

Throws:

ClientException - if a request fails for some reason

registerSecret

public void registerSecret(byte[] serializedBinary)

Registers the secret key specified with the serialized byte array of a SecretRegistrationRequest for HMAC authentication.

Parameters:

serializedBinary - a serialized byte array of SecretRegistrationRequest.

Throws:

ClientException - if a request fails for some reason

registerFunction

public void registerFunction(java.lang.String id,
                             java.lang.String name,
                             byte[] functionBytes)

Registers the specified function. To execute the function, you need to use the corresponding executeContract methods that match the type of the function.

Parameters:

id - an ID of the function

name - the binary name of the function class

functionBytes - the byte code of the function class

Throws:

ClientException - if a request fails for some reason

registerFunction

public void registerFunction(java.lang.String id,
                             java.lang.String name,
                             java.lang.String functionPath)

Registers the specified function. To execute the function, you need to use the corresponding executeContract methods that match the type of the function.

Parameters:

id - an ID of the function

name - the binary name of the function class

functionPath - the relative path of the function class

Throws:

ClientException - if a request fails for some reason

registerFunction

public void registerFunction(byte[] serializedBinary)

Registers the function with the specified serialized byte array of a FunctionRegistrationRequest.

Parameters:

serializedBinary - a serialized byte array of FunctionRegistrationRequest.

Throws:

ClientException - if a request fails for some reason

registerContract

@Deprecated
public void registerContract(java.lang.String id,
                                         java.lang.String name,
                                         byte[] contractBytes,
                                         java.util.Optional<javax.json.JsonObject> properties)

Deprecated. This method will be removed in release 5.0.0.

Registers the specified contract for the certificate holder specified in ClientConfig. To execute the contract, you need to use the corresponding executeContract methods that match the type of the contract.

Parameters:

id - an ID of the contract

name - the binary name of the contract class

contractBytes - the byte code of the contract class

properties - a contract properties

Throws:

ClientException - if a request fails for some reason

registerContract

@Deprecated
public void registerContract(java.lang.String id,
                                         java.lang.String name,
                                         java.lang.String contractPath,
                                         java.util.Optional<javax.json.JsonObject> properties)

Deprecated. This method will be removed in release 5.0.0.

Registers the specified contract for the certificate holder specified in ClientConfig. To execute the contract, you need to use the corresponding executeContract methods that match the type of the contract.

Parameters:

id - an ID for the contract

name - the binary name of the contract class

contractPath - the relative path of the contract class

properties - a contract properties

Throws:

ClientException - if a request fails for some reason

registerContract

public void registerContract(java.lang.String id,
                             java.lang.String name,
                             byte[] contractBytes)

Registers the specified contract for the certificate holder specified in ClientConfig. To execute the contract, you need to use the corresponding executeContract methods that match the type of the contract.

Parameters:

id - an ID for the contract

name - the binary name of the contract class

contractBytes - the byte array of the contract class

Throws:

ClientException - if a request fails for some reason

registerContract

public void registerContract(java.lang.String id,
                             java.lang.String name,
                             java.lang.String contractPath)

Registers the specified contract for the certificate holder specified in ClientConfig. To execute the contract, you need to use the corresponding executeContract methods that match the type of the contract.

Parameters:

id - an ID for the contract

name - the binary name of the contract class

contractPath - the relative path of the contract class

Throws:

ClientException - if a request fails for some reason

registerContract

public void registerContract(java.lang.String id,
                             java.lang.String name,
                             byte[] contractBytes,
                             @Nullable
                             javax.json.JsonObject properties)

Registers the specified contract for the certificate holder specified in ClientConfig. To execute the contract, you need to use the corresponding executeContract methods that match the type of the contract.

Parameters:

id - an ID for the contract

name - the binary name of the contract class

contractBytes - the byte array of the contract class

properties - a contract properties

Throws:

ClientException - if a request fails for some reason

registerContract

public void registerContract(java.lang.String id,
                             java.lang.String name,
                             java.lang.String contractPath,
                             @Nullable
                             javax.json.JsonObject properties)

Registers the specified contract for the certificate holder specified in ClientConfig. To execute the contract, you need to use the corresponding executeContract methods that match the type of the contract.

Parameters:

id - an ID for the contract

name - the binary name of the contract class

contractPath - the relative path of the contract class

properties - a contract properties

Throws:

ClientException - if a request fails for some reason

registerContract

public void registerContract(java.lang.String id,
                             java.lang.String name,
                             byte[] contractBytes,
                             @Nullable
                             com.fasterxml.jackson.databind.JsonNode properties)

Registers the specified contract for the certificate holder specified in ClientConfig. To execute the contract, you need to use the corresponding executeContract methods that match the type of the contract.

Parameters:

id - an ID for the contract

name - the binary name of the contract class

contractBytes - the byte array of the contract class

properties - a contract properties

Throws:

ClientException - if a request fails for some reason

registerContract

public void registerContract(java.lang.String id,
                             java.lang.String name,
                             java.lang.String contractPath,
                             @Nullable
                             com.fasterxml.jackson.databind.JsonNode properties)

Registers the specified contract for the certificate holder specified in ClientConfig. To execute the contract, you need to use the corresponding executeContract methods that match the type of the contract.

Parameters:

id - an ID for the contract

name - the binary name of the contract class

contractPath - the relative path of the contract class

properties - a contract properties

Throws:

ClientException - if a request fails for some reason

registerContract

public void registerContract(java.lang.String id,
                             java.lang.String name,
                             java.lang.String contractPath,
                             @Nullable
                             java.lang.String properties)

Registers the specified contract for the certificate holder specified in ClientConfig. To execute the contract, you need to use the corresponding executeContract methods that match the type of the contract.

Parameters:

id - an ID for the contract

name - the binary name of the contract class

contractPath - the relative path of the contract class

properties - a contract properties

Throws:

ClientException - if a request fails for some reason

registerContract

public void registerContract(java.lang.String id,
                             java.lang.String name,
                             byte[] contractBytes,
                             @Nullable
                             java.lang.String properties)

Registers the specified contract for the certificate holder specified in ClientConfig. To execute the contract, you need to use the corresponding executeContract methods that match the type of the contract.

Parameters:

id - an ID for the contract

name - the binary name of the contract class

contractBytes - the byte array of the contract class

properties - a contract properties

Throws:

ClientException - if a request fails for some reason

registerContract

public void registerContract(byte[] serializedBinary)

Registers the contract with the specified serialized byte array of a ContractRegistrationRequest.

Parameters:

serializedBinary - a serialized byte array of ContractRegistrationRequest.

Throws:

ClientException - if a request fails for some reason

listContracts

public javax.json.JsonObject listContracts(java.lang.String id)

Retrieves a list of contracts for the certificate holder specified in ClientConfig. If specified with a contract ID, it will return the matching contract only.

Parameters:

id - a contract ID

Returns:

JsonObject

Throws:

ClientException - if a request fails for some reason

listContracts

public javax.json.JsonObject listContracts(byte[] serializedBinary)

Retrieves a list of contracts with the specified serialized byte array of a ContractsListingRequest.

Parameters:

serializedBinary - a serialized byte array of ContractsListingRequest.

Returns:

JsonObject

Throws:

ClientException - if a request fails for some reason

executeContract

public com.scalar.dl.ledger.model.ContractExecutionResult executeContract(java.lang.String contractId,
                                                                          javax.json.JsonObject contractArgument)

Executes the specified contract (and functions) with the specified argument. The contract and functions have to be based on JSONP, such as JsonpBasedContract and JsonpBasedFunction.

Parameters:

contractId - an ID of the contract

contractArgument - an argument of the contract

Returns:

ContractExecutionResult

Throws:

ClientException - if a request fails for some reason

executeContract

@Deprecated
public com.scalar.dl.ledger.model.ContractExecutionResult executeContract(java.lang.String nonce,
                                                                                      java.lang.String contractId,
                                                                                      javax.json.JsonObject contractArgument)

Deprecated. This method will be removed in release 5.0.0.

Executes the specified contract (and functions) with the specified argument. The contract and functions have to be based on JSONP, such as JsonpBasedContract and JsonpBasedFunction.

This method is only for internal use and will be removed in release 5.0.0. Users should not depend on it. Instead, execute contracts without specifying a nonce by using other methods.

Parameters:

nonce - a unique ID of the execution request

contractId - an ID of the contract

contractArgument - an argument of the contract

Returns:

ContractExecutionResult

Throws:

ClientException - if a request fails for some reason

executeContract

@Deprecated
public com.scalar.dl.ledger.model.ContractExecutionResult executeContract(java.lang.String contractId,
                                                                                      javax.json.JsonObject contractArgument,
                                                                                      java.util.Optional<javax.json.JsonObject> functionArgument)

Deprecated. This method will be removed in release 5.0.0.

Executes the specified contract (and functions) with the specified arguments. The contract and functions have to be based on JSONP, such as JsonpBasedContract and JsonpBasedFunction.

The contract argument can have a "_functions_" key to specify an array of function IDs to execute with the specified contract, but this feature is deprecated and will be removed in release 5.0.0.

Parameters:

contractId - an ID of the contract

contractArgument - an argument of the contract

functionArgument - an argument of the function

Returns:

ContractExecutionResult

Throws:

ClientException - if a request fails for some reason

executeContract

@Deprecated
public com.scalar.dl.ledger.model.ContractExecutionResult executeContract(java.lang.String nonce,
                                                                                      java.lang.String contractId,
                                                                                      javax.json.JsonObject contractArgument,
                                                                                      java.util.Optional<javax.json.JsonObject> functionArgument)

Deprecated. This method will be removed in release 5.0.0.

Executes the specified contract (and functions) with the specified arguments. The contract and functions have to be based on JSONP, such as JsonpBasedContract and JsonpBasedFunction.

The contract argument can have a "_functions_" key to specify an array of function IDs to execute with the specified contract, but this feature is deprecated and will be removed in release 5.0.0.

This method is only for internal use and will be removed in release 5.0.0. Users should not depend on it. Instead, execute contracts without specifying a nonce by using other methods.

Parameters:

nonce - a unique ID of the execution request

contractId - an ID of the contract

contractArgument - an argument of the contract

functionArgument - an argument of the function

Returns:

ContractExecutionResult

Throws:

ClientException - if a request fails for some reason

executeContract

public com.scalar.dl.ledger.model.ContractExecutionResult executeContract(java.lang.String contractId,
                                                                          javax.json.JsonObject contractArgument,
                                                                          @Nullable
                                                                          java.lang.String functionId,
                                                                          @Nullable
                                                                          javax.json.JsonObject functionArgument)

Executes the specified contract (and function) with the specified arguments. The contract and functions have to be based on JSONP, such as JsonpBasedContract and JsonpBasedFunction.

Parameters:

contractId - an ID of the contract

contractArgument - an argument of the contract

functionId - an ID of the function

functionArgument - an argument of the function

Returns:

ContractExecutionResult

Throws:

ClientException - if a request fails for some reason

executeContract

@Deprecated
public com.scalar.dl.ledger.model.ContractExecutionResult executeContract(java.lang.String nonce,
                                                                                      java.lang.String contractId,
                                                                                      javax.json.JsonObject contractArgument,
                                                                                      @Nullable
                                                                                      java.lang.String functionId,
                                                                                      @Nullable
                                                                                      javax.json.JsonObject functionArgument)

Deprecated. This method will be removed in release 5.0.0.

Executes the specified contract (and functions) with the specified arguments. The contract and functions have to be based on JSONP, such as JsonpBasedContract and JsonpBasedFunction.

This method is only for internal use and will be removed in release 5.0.0. Users should not depend on it. Instead, execute contracts without specifying a nonce by using other methods.

Parameters:

nonce - a unique ID of the execution request

contractId - an ID of the contract

contractArgument - an argument of the contract

functionId - an ID of the function

functionArgument - an argument of the function

Returns:

ContractExecutionResult

Throws:

ClientException - if a request fails for some reason

executeContract

public com.scalar.dl.ledger.model.ContractExecutionResult executeContract(java.lang.String contractId,
                                                                          com.fasterxml.jackson.databind.JsonNode contractArgument)

Executes the specified contract with the specified argument. The contract and functions have to be based on Jackson, such as JacksonBasedContract and JacksonBasedFunction.

Parameters:

contractId - an ID of the contract

contractArgument - an argument of the contract

Returns:

ContractExecutionResult

Throws:

ClientException - if a request fails for some reason

executeContract

@Deprecated
public com.scalar.dl.ledger.model.ContractExecutionResult executeContract(java.lang.String nonce,
                                                                                      java.lang.String contractId,
                                                                                      com.fasterxml.jackson.databind.JsonNode contractArgument)

Deprecated. This method will be removed in release 5.0.0.

Executes the specified contract with the specified argument. The contract has to be based on Jackson (i.e., JacksonBasedContract).

This method is only for internal use and will be removed in release 5.0.0. Users should not depend on it. Instead, execute contracts without specifying a nonce by using other methods.

Parameters:

nonce - a unique ID of the execution request

contractId - an ID of the contract

contractArgument - an argument of the contract

Returns:

ContractExecutionResult

Throws:

ClientException - if a request fails for some reason

executeContract

public com.scalar.dl.ledger.model.ContractExecutionResult executeContract(java.lang.String contractId,
                                                                          com.fasterxml.jackson.databind.JsonNode contractArgument,
                                                                          @Nullable
                                                                          java.lang.String functionId,
                                                                          @Nullable
                                                                          com.fasterxml.jackson.databind.JsonNode functionArgument)

Executes the specified contract (and functions) with the specified arguments. The contract and functions have to be based on Jackson, such as JacksonBasedContract and JacksonBasedFunction.

Parameters:

contractId - an ID of the contract

contractArgument - an argument of the contract

functionId - an ID of the function

functionArgument - an argument of the function

Returns:

ContractExecutionResult

Throws:

ClientException - if a request fails for some reason

executeContract

@Deprecated
public com.scalar.dl.ledger.model.ContractExecutionResult executeContract(java.lang.String nonce,
                                                                                      java.lang.String contractId,
                                                                                      com.fasterxml.jackson.databind.JsonNode contractArgument,
                                                                                      @Nullable
                                                                                      java.lang.String functionId,
                                                                                      @Nullable
                                                                                      com.fasterxml.jackson.databind.JsonNode functionArgument)

Deprecated. This method will be removed in release 5.0.0.

Executes the specified contract (and functions) with the specified arguments. The contract and functions have to be based on Jackson, such as JacksonBasedContract and JacksonBasedFunction.

This method is only for internal use and will be removed in release 5.0.0. Users should not depend on it. Instead, execute contracts without specifying a nonce by using other methods.

Parameters:

nonce - a unique ID of the execution request

contractId - an ID of the contract

contractArgument - an argument of the contract

functionId - an ID of the function

functionArgument - an argument of the function

Returns:

ContractExecutionResult

Throws:

ClientException - if a request fails for some reason

executeContract

public com.scalar.dl.ledger.model.ContractExecutionResult executeContract(java.lang.String contractId,
                                                                          java.lang.String contractArgument)

Executes the specified contract with the specified argument. The contract has to be based on String (i.e., StringBasedContract).

Parameters:

contractId - an ID of the contract

contractArgument - an argument of the contract

Returns:

ContractExecutionResult

Throws:

ClientException - if a request fails for some reason

executeContract

@Deprecated
public com.scalar.dl.ledger.model.ContractExecutionResult executeContract(java.lang.String nonce,
                                                                                      java.lang.String contractId,
                                                                                      java.lang.String contractArgument)

Deprecated. This method will be removed in release 5.0.0.

Executes the specified contract with the specified argument. The contract has to be based on String (i.e., StringBasedContract).

This method is only for internal use and will be removed in release 5.0.0. Users should not depend on it. Instead, execute contracts without specifying a nonce by using other methods.

Parameters:

nonce - a unique ID of the execution request

contractId - an ID of the contract

contractArgument - an argument of the contract

Returns:

ContractExecutionResult

Throws:

ClientException - if a request fails for some reason

executeContract

public com.scalar.dl.ledger.model.ContractExecutionResult executeContract(java.lang.String contractId,
                                                                          java.lang.String contractArgument,
                                                                          @Nullable
                                                                          java.lang.String functionId,
                                                                          @Nullable
                                                                          java.lang.String functionArgument)

Executes the specified contract (and function) with the specified arguments. The contract and functions have to be based on String, such as StringBasedContract and StringBasedFunction.

Parameters:

contractId - an ID of the contract

contractArgument - an argument of the contract

functionId - an ID of the function

functionArgument - an argument of the function

Returns:

ContractExecutionResult

Throws:

ClientException - if a request fails for some reason

executeContract

@Deprecated
public com.scalar.dl.ledger.model.ContractExecutionResult executeContract(java.lang.String nonce,
                                                                                      java.lang.String contractId,
                                                                                      java.lang.String contractArgument,
                                                                                      @Nullable
                                                                                      java.lang.String functionId,
                                                                                      @Nullable
                                                                                      java.lang.String functionArgument)

Deprecated. This method will be removed in release 5.0.0.

Executes the specified contract (and function) with the specified arguments. The contract and functions have to be based on String, such as StringBasedContract and StringBasedFunction.

This method is only for internal use and will be removed in release 5.0.0. Users should not depend on it. Instead, execute contracts without specifying a nonce by using other methods.

Parameters:

nonce - a unique ID of the execution request

contractId - an ID of the contract

contractArgument - an argument of the contract

functionId - an ID of the function

functionArgument - an argument of the function

Returns:

ContractExecutionResult

Throws:

ClientException - if a request fails for some reason

executeContract

public com.scalar.dl.ledger.model.ContractExecutionResult executeContract(byte[] serializedBinary)

Executes the specified contract with the specified serialized byte array of a ContractExecutionRequest.

Parameters:

serializedBinary - a serialized byte array of ContractExecutionRequest.

Returns:

ContractExecutionResult

Throws:

ClientException - if a request fails for some reason

validateLedger

public com.scalar.dl.ledger.model.LedgerValidationResult validateLedger(java.lang.String assetId)

Validates the specified asset in the ledger.

Parameters:

assetId - an asset ID

Returns:

LedgerValidationResult

Throws:

ClientException - if a request fails for some reason

validateLedger

public com.scalar.dl.ledger.model.LedgerValidationResult validateLedger(java.lang.String assetId,
                                                                        int startAge,
                                                                        int endAge)

Validates the specified asset between the specified ages in the ledger.

Parameters:

assetId - an asset ID

startAge - an age to be validated from (inclusive)

endAge - an age to be validated to (inclusive)

Returns:

LedgerValidationResult

Throws:

ClientException - if a request fails for some reason

validateLedger

public com.scalar.dl.ledger.model.LedgerValidationResult validateLedger(byte[] serializedBinary)

Validates the specified asset in the ledger with the specified serialized byte array of a LedgerValidationRequest.

Parameters:

serializedBinary - a serialized byte array of LedgerValidationRequest.

Returns:

LedgerValidationResult

Throws:

ClientException - if a request fails for some reason

close

@Deprecated
public void close()

Deprecated. This method will be removed in release 5.0.0.

It does nothing now. It's left here for backward compatibility.

Specified by:

close in interface java.lang.AutoCloseable