aboutsummaryrefslogtreecommitdiffstats
path: root/rpc/shared/types.go
blob: 7c4b04e83d04ef55ca5a3ce429663c8542307ee4 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
package shared

import (
    "encoding/json"

    "github.com/ethereum/go-ethereum/logger"
    "github.com/ethereum/go-ethereum/logger/glog"
)

// Ethereum RPC API interface
type EthereumApi interface {
    // API identifier
    Name() string

    // API version
    ApiVersion() string

    // Execute the given request and returns the response or an error
    Execute(*Request) (interface{}, error)

    // List of supported RCP methods this API provides
    Methods() []string
}

// RPC request
type Request struct {
    Id      interface{}     `json:"id"`
    Jsonrpc string          `json:"jsonrpc"`
    Method  string          `json:"method"`
    Params  json.RawMessage `json:"params"`
}

// RPC response
type Response struct {
    Id      interface{} `json:"id"`
    Jsonrpc string      `json:"jsonrpc"`
}

// RPC success response
type SuccessResponse struct {
    Id      interface{} `json:"id"`
    Jsonrpc string      `json:"jsonrpc"`
    Result  interface{} `json:"result"`
}

// RPC error response
type ErrorResponse struct {
    Id      interface{}  `json:"id"`
    Jsonrpc string       `json:"jsonrpc"`
    Error   *ErrorObject `json:"error"`
}

// RPC error response details
type ErrorObject struct {
    Code    int    `json:"code"`
    Message string `json:"message"`
    // Data    interface{} `json:"data"`
}

// Create RPC error response, this allows for custom error codes
func NewRpcErrorResponse(id interface{}, jsonrpcver string, errCode int, err error) *interface{} {
    var response interface{}

    jsonerr := &ErrorObject{errCode, err.Error()}
    response = ErrorResponse{Jsonrpc: jsonrpcver, Id: id, Error: jsonerr}

    glog.V(logger.Detail).Infof("Generated error response: %s", response)
    return &response
}

// Create RPC response
func NewRpcResponse(id interface{}, jsonrpcver string, reply interface{}, err error) *interface{} {
    var response interface{}

    switch err.(type) {
    case nil:
        response = &SuccessResponse{Jsonrpc: jsonrpcver, Id: id, Result: reply}
    case *NotImplementedError:
        jsonerr := &ErrorObject{-32601, err.Error()}
        response = &ErrorResponse{Jsonrpc: jsonrpcver, Id: id, Error: jsonerr}
    case *DecodeParamError, *InsufficientParamsError, *ValidationError, *InvalidTypeError:
        jsonerr := &ErrorObject{-32602, err.Error()}
        response = &ErrorResponse{Jsonrpc: jsonrpcver, Id: id, Error: jsonerr}
    default:
        jsonerr := &ErrorObject{-32603, err.Error()}
        response = &ErrorResponse{Jsonrpc: jsonrpcver, Id: id, Error: jsonerr}
    }

    glog.V(logger.Detail).Infof("Generated response: %T %s", response, response)
    return &response
}