0543a28941
* make jsonrpc api namespaces extensible Closes: #1052, #1037 * Apply suggestions from code review Co-authored-by: Federico Kunze Küllmer <31522760+fedekunze@users.noreply.github.com>
156 lines
4.6 KiB
Go
156 lines
4.6 KiB
Go
// Package rpc contains RPC handler methods and utilities to start
|
|
// Ethermint's Web3-compatibly JSON-RPC server.
|
|
package rpc
|
|
|
|
import (
|
|
"fmt"
|
|
|
|
"github.com/cosmos/cosmos-sdk/client"
|
|
"github.com/cosmos/cosmos-sdk/server"
|
|
|
|
"github.com/ethereum/go-ethereum/rpc"
|
|
|
|
"github.com/tharsis/ethermint/rpc/ethereum/backend"
|
|
"github.com/tharsis/ethermint/rpc/ethereum/namespaces/debug"
|
|
"github.com/tharsis/ethermint/rpc/ethereum/namespaces/eth"
|
|
"github.com/tharsis/ethermint/rpc/ethereum/namespaces/eth/filters"
|
|
"github.com/tharsis/ethermint/rpc/ethereum/namespaces/miner"
|
|
"github.com/tharsis/ethermint/rpc/ethereum/namespaces/net"
|
|
"github.com/tharsis/ethermint/rpc/ethereum/namespaces/personal"
|
|
"github.com/tharsis/ethermint/rpc/ethereum/namespaces/txpool"
|
|
"github.com/tharsis/ethermint/rpc/ethereum/namespaces/web3"
|
|
"github.com/tharsis/ethermint/rpc/ethereum/types"
|
|
|
|
rpcclient "github.com/tendermint/tendermint/rpc/jsonrpc/client"
|
|
)
|
|
|
|
// RPC namespaces and API version
|
|
const (
|
|
Web3Namespace = "web3"
|
|
EthNamespace = "eth"
|
|
PersonalNamespace = "personal"
|
|
NetNamespace = "net"
|
|
TxPoolNamespace = "txpool"
|
|
DebugNamespace = "debug"
|
|
MinerNamespace = "miner"
|
|
|
|
apiVersion = "1.0"
|
|
)
|
|
|
|
// APICreator creates the json-rpc api implementations.
|
|
type APICreator = func(*server.Context, client.Context, *rpcclient.WSClient) []rpc.API
|
|
|
|
// apiCreators defines the json-rpc api namespaces.
|
|
var apiCreators map[string]APICreator
|
|
|
|
func init() {
|
|
apiCreators = map[string]APICreator{
|
|
EthNamespace: func(ctx *server.Context, clientCtx client.Context, tmWSClient *rpcclient.WSClient) []rpc.API {
|
|
nonceLock := new(types.AddrLocker)
|
|
evmBackend := backend.NewEVMBackend(ctx, ctx.Logger, clientCtx)
|
|
return []rpc.API{
|
|
{
|
|
Namespace: EthNamespace,
|
|
Version: apiVersion,
|
|
Service: eth.NewPublicAPI(ctx.Logger, clientCtx, evmBackend, nonceLock),
|
|
Public: true,
|
|
},
|
|
{
|
|
Namespace: EthNamespace,
|
|
Version: apiVersion,
|
|
Service: filters.NewPublicAPI(ctx.Logger, clientCtx, tmWSClient, evmBackend),
|
|
Public: true,
|
|
},
|
|
}
|
|
},
|
|
Web3Namespace: func(*server.Context, client.Context, *rpcclient.WSClient) []rpc.API {
|
|
return []rpc.API{
|
|
{
|
|
Namespace: Web3Namespace,
|
|
Version: apiVersion,
|
|
Service: web3.NewPublicAPI(),
|
|
Public: true,
|
|
},
|
|
}
|
|
},
|
|
NetNamespace: func(_ *server.Context, clientCtx client.Context, _ *rpcclient.WSClient) []rpc.API {
|
|
return []rpc.API{
|
|
{
|
|
Namespace: NetNamespace,
|
|
Version: apiVersion,
|
|
Service: net.NewPublicAPI(clientCtx),
|
|
Public: true,
|
|
},
|
|
}
|
|
},
|
|
PersonalNamespace: func(ctx *server.Context, clientCtx client.Context, _ *rpcclient.WSClient) []rpc.API {
|
|
evmBackend := backend.NewEVMBackend(ctx, ctx.Logger, clientCtx)
|
|
return []rpc.API{
|
|
{
|
|
Namespace: PersonalNamespace,
|
|
Version: apiVersion,
|
|
Service: personal.NewAPI(ctx.Logger, clientCtx, evmBackend),
|
|
Public: false,
|
|
},
|
|
}
|
|
},
|
|
TxPoolNamespace: func(ctx *server.Context, _ client.Context, _ *rpcclient.WSClient) []rpc.API {
|
|
return []rpc.API{
|
|
{
|
|
Namespace: TxPoolNamespace,
|
|
Version: apiVersion,
|
|
Service: txpool.NewPublicAPI(ctx.Logger),
|
|
Public: true,
|
|
},
|
|
}
|
|
},
|
|
DebugNamespace: func(ctx *server.Context, clientCtx client.Context, _ *rpcclient.WSClient) []rpc.API {
|
|
evmBackend := backend.NewEVMBackend(ctx, ctx.Logger, clientCtx)
|
|
return []rpc.API{
|
|
{
|
|
Namespace: DebugNamespace,
|
|
Version: apiVersion,
|
|
Service: debug.NewAPI(ctx, evmBackend, clientCtx),
|
|
Public: true,
|
|
},
|
|
}
|
|
},
|
|
MinerNamespace: func(ctx *server.Context, clientCtx client.Context, _ *rpcclient.WSClient) []rpc.API {
|
|
evmBackend := backend.NewEVMBackend(ctx, ctx.Logger, clientCtx)
|
|
return []rpc.API{
|
|
{
|
|
Namespace: MinerNamespace,
|
|
Version: apiVersion,
|
|
Service: miner.NewPrivateAPI(ctx, clientCtx, evmBackend),
|
|
Public: false,
|
|
},
|
|
}
|
|
},
|
|
}
|
|
}
|
|
|
|
// GetRPCAPIs returns the list of all APIs
|
|
func GetRPCAPIs(ctx *server.Context, clientCtx client.Context, tmWSClient *rpcclient.WSClient, selectedAPIs []string) []rpc.API {
|
|
var apis []rpc.API
|
|
|
|
for _, ns := range selectedAPIs {
|
|
if creator, ok := apiCreators[ns]; ok {
|
|
apis = append(apis, creator(ctx, clientCtx, tmWSClient)...)
|
|
} else {
|
|
ctx.Logger.Error("invalid namespace value", "namespace", ns)
|
|
}
|
|
}
|
|
|
|
return apis
|
|
}
|
|
|
|
// RegisterAPINamespace registers a new API namespace with the API creator.
|
|
// This function fails if the namespace is already registered.
|
|
func RegisterAPINamespace(ns string, creator APICreator) error {
|
|
if _, ok := apiCreators[ns]; ok {
|
|
return fmt.Errorf("duplicated api namespace %s", ns)
|
|
}
|
|
apiCreators[ns] = creator
|
|
return nil
|
|
}
|