Feature: Rodeos integration

README.md

@@ -24,6 +24,10 @@ To date, EOSIO SDK for Java has only been tested on Android. The goal, however,
 
 ## Updates
 
+7/7/20
+
+Version 0.1.3 Allows for deserialization of action return value structs.
+
 2/25/20
 
 Version 0.1.2 Uses JDK11 to build and targets 1.8 for source and target compatibility.
@@ -148,7 +152,7 @@ EOSIO SDK for Java _does not include_ an RPC provider implementation; one must b
 
 ### Serialization Provider Protocol
 
-The Serialization Provider is responsible for ABI-driven transaction and action serialization and deserialization between JSON and binary data representations. These implementations often contain platform-sensitive C++ code and larger dependencies. For those reasons, EOSIO SDK for Java _does not include_ a serialization provider implementation; one must be installed separately.
+The Serialization Provider is responsible for ABI-driven transaction, action, and struct serialization and deserialization between JSON and binary data representations. These implementations often contain platform-sensitive C++ code and larger dependencies. For those reasons, EOSIO SDK for Java _does not include_ a serialization provider implementation; one must be installed separately.
 
 * [ISerializationProvider](eosiojava/src/main/java/one/block/eosiojava/interfaces/ISerializationProvider.java)
 * [ABIEOS Serialization Provider Implementation](https://github.com/EOSIO/eosio-java-android-abieos-serialization-provider) - Currently supports Android 6 (Marshmallow)+

eosiojava/build.gradle

@@ -41,7 +41,7 @@ dependencies {
 
 def libraryGroupId = 'one.block'
 def libraryArtifactId = 'eosiojava'
-def libraryVersion = '0.1.2'
+def libraryVersion = '0.1.2-queryit'
 
 task sourcesJar(type: Jar, dependsOn: classes){
     classifier = 'sources'

eosiojava/src/main/java/one/block/eosiojava/error/ErrorConstants.java

@@ -10,6 +10,7 @@
 import one.block.eosiojava.models.rpcProvider.request.GetBlockRequest;
 import one.block.eosiojava.models.rpcProvider.request.GetRequiredKeysRequest;
 import one.block.eosiojava.models.rpcProvider.request.PushTransactionRequest;
+import one.block.eosiojava.models.rpcProvider.response.ActionTrace;
 import one.block.eosiojava.models.rpcProvider.response.GetInfoResponse;
 import one.block.eosiojava.models.signatureProvider.EosioTransactionSignatureRequest;
 import one.block.eosiojava.session.TransactionProcessor;
@@ -316,8 +317,17 @@ private ErrorConstants(){
     public static final String TRANSACTION_PROCESSOR_BROADCAST_SIGN_EMPTY = "Can't call broadcast because Signature is empty. Make sure of calling sign before calling broadcast.";
 
     /**
-     * Error message get thrown if {@link TransactionProcessor#getSignatures()} is empty during process of {@link TransactionProcessor#signAndBroadcast()} ()}
+     * Error message get thrown if {@link TransactionProcessor#getSignatures()} is empty during process of {@link TransactionProcessor#signAndBroadcast()}
      */
     public static final String TRANSACTION_PROCESSOR_SIGN_BROADCAST_SIGN_EMPTY = "Can't call sign and broadcast because Signature is empty. Make sure of calling sign before calling sign and broadcast.";
 
+    /**
+     * Error message get thrown if return value's deserialization process gets an error after calling {@link ISerializationProvider#deserialize(AbiEosSerializationObject)}
+     */
+    public static final String TRANSACTION_PROCESSOR_DESERIALIZE_RETURN_VALUE_ERROR = "Error happened on deserializing return value [%s]";
+
+    /**
+     * Error message thrown if return value's deserialization process is empty after calling {@link ISerializationProvider#deserialize(AbiEosSerializationObject)}
+     */
+    public static final String TRANSACTION_PROCESSOR_DESERIALIZE_RETURN_VALUE_EMPTY = "Deserialization of return value expected result, but was empty.";
 }

eosiojava/src/main/java/one/block/eosiojava/error/rpcProvider/SendTransactionRpcError.java

@@ -0,0 +1,26 @@
+package one.block.eosiojava.error.rpcProvider;
+
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Error class is used when there is an exception while attempting to use the RPC call,
+ * sendTransaction().
+ */
+public class SendTransactionRpcError extends RpcProviderError {
+
+    public SendTransactionRpcError() {
+    }
+
+    public SendTransactionRpcError(@NotNull String message) {
+        super(message);
+    }
+
+    public SendTransactionRpcError(@NotNull String message,
+            @NotNull Exception exception) {
+        super(message, exception);
+    }
+
+    public SendTransactionRpcError(@NotNull Exception exception) {
+        super(exception);
+    }
+}

eosiojava/src/main/java/one/block/eosiojava/error/serializationProvider/DeserializeReturnValueError.java

@@ -0,0 +1,26 @@
+package one.block.eosiojava.error.serializationProvider;
+
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Error class is used when there is an exception while attempting to call deserialize() of
+ * Serialization Provider
+ */
+public class DeserializeReturnValueError extends SerializationProviderError {
+
+    public DeserializeReturnValueError() {
+    }
+
+    public DeserializeReturnValueError(@NotNull String message) {
+        super(message);
+    }
+
+    public DeserializeReturnValueError(@NotNull String message,
+            @NotNull Exception exception) {
+        super(message, exception);
+    }
+
+    public DeserializeReturnValueError(@NotNull Exception exception) {
+        super(exception);
+    }
+}

eosiojava/src/main/java/one/block/eosiojava/error/session/TransactionFormatPushTransactionResponseError.java

@@ -0,0 +1,26 @@
+package one.block.eosiojava.error.session;
+
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Error class is used when there is an exception while attempting to call
+ * formatPushTransactionResponse() of TransactionProcessor
+ */
+public class TransactionFormatPushTransactionResponseError extends TransactionProcessorError {
+
+    public TransactionFormatPushTransactionResponseError() {
+    }
+
+    public TransactionFormatPushTransactionResponseError(@NotNull String message) {
+        super(message);
+    }
+
+    public TransactionFormatPushTransactionResponseError(@NotNull String message,
+            @NotNull Exception exception) {
+        super(message, exception);
+    }
+
+    public TransactionFormatPushTransactionResponseError(@NotNull Exception exception) {
+        super(exception);
+    }
+}

eosiojava/src/main/java/one/block/eosiojava/interfaces/IRPCProvider.java

@@ -5,15 +5,18 @@
 import one.block.eosiojava.error.rpcProvider.GetRawAbiRpcError;
 import one.block.eosiojava.error.rpcProvider.GetRequiredKeysRpcError;
 import one.block.eosiojava.error.rpcProvider.PushTransactionRpcError;
+import one.block.eosiojava.error.rpcProvider.SendTransactionRpcError;
 import one.block.eosiojava.models.rpcProvider.request.GetBlockRequest;
 import one.block.eosiojava.models.rpcProvider.request.GetRawAbiRequest;
 import one.block.eosiojava.models.rpcProvider.request.GetRequiredKeysRequest;
 import one.block.eosiojava.models.rpcProvider.request.PushTransactionRequest;
+import one.block.eosiojava.models.rpcProvider.request.SendTransactionRequest;
 import one.block.eosiojava.models.rpcProvider.response.GetBlockResponse;
 import one.block.eosiojava.models.rpcProvider.response.GetInfoResponse;
 import one.block.eosiojava.models.rpcProvider.response.GetRawAbiResponse;
 import one.block.eosiojava.models.rpcProvider.response.GetRequiredKeysResponse;
 import one.block.eosiojava.models.rpcProvider.response.PushTransactionResponse;
+import one.block.eosiojava.models.rpcProvider.response.SendTransactionResponse;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -74,4 +77,15 @@ public interface IRPCProvider {
      */
     @NotNull
     PushTransactionResponse pushTransaction(PushTransactionRequest pushTransactionRequest) throws PushTransactionRpcError;
+
+    /**
+     * This method expects a transaction in JSON format and will attempt to apply it to the blockchain.
+     *
+     * @param sendTransactionRequest the transaction to push with signatures.
+     * @return the send transaction response
+     * @throws SendTransactionRpcError thrown if there are any exceptions/backend error during the
+     * sendTransaction() process.
+     */
+    @NotNull
+    SendTransactionResponse sendTransaction(SendTransactionRequest sendTransactionRequest) throws SendTransactionRpcError;
 }

eosiojava/src/main/java/one/block/eosiojava/models/AbiEosSerializationObject.java

@@ -141,20 +141,39 @@ public void setJson(@NotNull String json) {
     }
 
     /**
-     * Initialize AbiEosSerializationObject
+     * Initialize AbiEosSerializationObject.
      *
      * @param contract - the contract name.
      * @param name - the action name.
      * @param type - the type name.
      * @param abi - the abi to use for conversion.
      */
     public AbiEosSerializationObject(@Nullable String contract,
-            @NotNull String name, @Nullable String type,
+            @Nullable String name, @Nullable String type,
             @NotNull String abi) {
         this.contract = contract;
         this.name = name;
         this.type = type;
         this.abi = abi;
     }
 
+    /**
+     * Initialize AbiEosSerializationObject for use with action/transaction data only.
+     *
+     * @param contract - the contract name.
+     * @param name - the action name.
+     * @param abi - the abi to use for conversion.
+     */
+    public AbiEosSerializationObject(@NotNull String contract, @NotNull String name, @NotNull String abi) {
+        this(contract, name, null, abi);
+    }
+
+    /**
+     * Initialize AbiEosSerializationObject for use with type data only.
+     * @param type - the type name.
+     * @param abi - the abi to use for conversion.
+     */
+    public AbiEosSerializationObject(@NotNull String type, @NotNull String abi) {
+        this(null, null, type, abi);
+    }
 }