transactions results

Author: dshulyak

proto/spacemesh/v1/tx.proto

@@ -26,4 +26,7 @@ service TransactionService {
     // Returns tx state for one or more txs every time the tx state changes for
     // one of these txs
     rpc TransactionsStateStream(TransactionsStateStreamRequest) returns (stream TransactionsStateStreamResponse);
+
+    // StreamResults streams historical data and watch live events with transaction results. 
+    rpc StreamResults(TransactionResultsRequest) returns (stream TransactionResult);
 }

proto/spacemesh/v1/tx_types.proto

@@ -53,3 +53,34 @@ message TransactionState {
     }
     TransactionState state = 2;
 }
+
+// TransactionResultsRequest request object for results stream.
+message TransactionResultsRequest {
+    // id is filter by transaction id.
+    bytes id = 1;
+    // address is a filter by account address, it could be principal or any affected address.
+    bytes address = 2;
+    // start streaming from this layer. if 0 - stream will start from genesis.
+    uint32 start = 3;
+    // end streaming at this layer. if 0 - stream till the latest available layer.
+    uint32 end = 4;
+    // watch live data.
+    bool watch = 5;
+}
+
+message TransactionResult {
+    enum Status {
+        SUCCESS = 0;
+        FAILURE = 1;
+        INVALID = 2;
+    }
+
+    Transaction tx = 1;
+    Status status = 2;
+    string message = 3;
+    uint64 gas_consumed = 4;
+    uint64 fee = 5;
+    bytes block = 6;
+    uint32 layer = 7;
+    repeated bytes touched_addresses = 8;
+}

proto/spacemesh/v1/types.proto

@@ -47,7 +47,7 @@ message Transaction {
     bytes id = 1;
     bytes principal = 2;
     bytes template = 3;
-    uint32 method = 4;
+    uint32 method = 4; // this is actually limited by uint8, but no type for that.
     Nonce nonce = 5;
     LayerLimits limits = 6;
     uint64 max_gas = 7;
@@ -111,4 +111,3 @@ message AppEvent { // an event emitted from an app instance
     TransactionId transaction_id = 1; // the transaction that called the code
     string message = 2; // the event's string emitted from code
 }
-