[dev] transaction module

Author: nanmu42

response.go

@@ -107,3 +107,10 @@ type ContractSource struct {
 	Library              string `json:"Library"`
 	SwarmSource          string `json:"SwarmSource"`
 }
+
+// ExecutionStatus holds info from query for transaction execution status
+type ExecutionStatus struct {
+	// 0 = pass, 1 = error
+	IsError        int    `json:"isError,string"`
+	ErrDescription string `json:"errDescription"`
+}

transaction.go

@@ -0,0 +1,55 @@
+/*
+ * Copyright (c) 2018 LI Zhennan
+ *
+ * Use of this work is governed by a MIT License.
+ * You may find a license copy in project root.
+ */
+
+package etherscan
+
+import "errors"
+
+// ErrPreByzantiumTx transaction before 4,370,000 does not support receipt status check
+var ErrPreByzantiumTx = errors.New("pre-byzantium transaction does not support receipt status check")
+
+// ExecutionStatus checks contract execution status (if there was an error during contract execution)
+// note on IsError: 0 = pass, 1 = error
+func (c *Client) ExecutionStatus(txHash string) (status ExecutionStatus, err error) {
+	param := M{
+		"txhash": txHash,
+	}
+
+	err = c.call("transaction", "getstatus", param, &status)
+	return
+}
+
+// ReceiptStatus checks transaction receipt status
+// only applicable for post byzantium fork transactions, i.e. after block 4,370,000
+// An special err ErrPreByzantiumTx raises for the transaction before byzantium fork.
+// Note: receiptStatus: 0 = Fail, 1 = Pass.
+func (c *Client) ReceiptStatus(txHash string) (receiptStatus int, err error) {
+	param := M{
+		"txhash": txHash,
+	}
+
+	var rawStatus = struct {
+		Status string `json:"status"`
+	}{}
+
+	err = c.call("transaction", "gettxreceiptstatus", param, &rawStatus)
+	if err != nil {
+		return
+	}
+
+	switch rawStatus.Status {
+	case "0":
+		receiptStatus = 0
+	case "1":
+		receiptStatus = 1
+	default:
+		receiptStatus = -1
+		err = ErrPreByzantiumTx
+	}
+
+	return
+}

transaction_e2e_test.go

@@ -0,0 +1,57 @@
+/*
+ * Copyright (c) 2018 LI Zhennan
+ *
+ * Use of this work is governed by a MIT License.
+ * You may find a license copy in project root.
+ */
+
+package etherscan
+
+import (
+	"testing"
+)
+
+func TestClient_ExecutionStatus(t *testing.T) {
+	var err error
+
+	// bad execution
+	bad, err := api.ExecutionStatus("0x15f8e5ea1079d9a0bb04a4c58ae5fe7654b5b2b4463375ff7ffb490aa0032f3a")
+	noError(t, err, "api.ExecutionStatus")
+	if bad.IsError != 1 && bad.ErrDescription != "Bad jump destination" {
+		t.Errorf("api.ExecutionStatus not working, got\n%+v", bad)
+	}
+
+	// good execution
+	good, err := api.ExecutionStatus("0xe8253035f1a1e93be24f43a3592a2c6cdbe3360e6f738ff40d46305252b44f5c")
+	noError(t, err, "api.ExecutionStatus")
+	if good.IsError != 0 && good.ErrDescription != "" {
+		t.Errorf("api.ExecutionStatus not working, got\n%+v", good)
+	}
+}
+
+func TestClient_ReceiptStatus(t *testing.T) {
+	var err error
+
+	// bad execution
+	bad, err := api.ReceiptStatus("0xe7bbbeb43cf863e20ec865021d63005149c133d7822e8edc1e6cb746d6728d4e")
+	noError(t, err, "api.ReceiptStatus")
+	if bad != 0 {
+		t.Errorf("api.ExecutionStatus not working, got %v, want 0", bad)
+	}
+
+	// good execution
+	good, err := api.ReceiptStatus("0xe8253035f1a1e93be24f43a3592a2c6cdbe3360e6f738ff40d46305252b44f5c")
+	noError(t, err, "api.ReceiptStatus")
+	if good != 1 {
+		t.Errorf("api.ExecutionStatus not working, got %v, want 1", good)
+	}
+
+	// tx before byzantium fork
+	before, err := api.ReceiptStatus("0x836b403cc1516eb1337c151ff3660c3ebd528d850e6ac20a75652c705ea769f4")
+	if err != ErrPreByzantiumTx {
+		t.Errorf("api.ReceiptStatus does not throw error for tx before byzantium fork")
+	}
+	if before != -1 {
+		t.Errorf("api.ExecutionStatus not working, got %v, want -1", before)
+	}
+}