package jsonrpc import ( "bytes" "context" crand "crypto/rand" "encoding/json" "errors" mrand "math/rand" "net/http" "os/exec" "testing" "time" "github.com/fortytw2/leaktest" "github.com/stretchr/testify/assert" "github.com/stretchr/testify/require" tmbytes "github.com/tendermint/tendermint/libs/bytes" "github.com/tendermint/tendermint/libs/log" "github.com/tendermint/tendermint/rpc/jsonrpc/client" "github.com/tendermint/tendermint/rpc/jsonrpc/server" ) // Client and Server should work over tcp or unix sockets const ( tcpAddr = "tcp://127.0.0.1:47768" unixSocket = "/tmp/rpc_test.sock" unixAddr = "unix://" + unixSocket websocketEndpoint = "/websocket/endpoint" testVal = "acbd" ) type ResultEcho struct { Value string `json:"value"` } type ResultEchoInt struct { Value int `json:"value"` } type ResultEchoBytes struct { Value []byte `json:"value"` } type ResultEchoDataBytes struct { Value tmbytes.HexBytes `json:"value"` } // Define some routes var Routes = map[string]*server.RPCFunc{ "echo": server.NewRPCFunc(EchoResult, "arg"), "echo_ws": server.NewWSRPCFunc(EchoWSResult, "arg"), "echo_bytes": server.NewRPCFunc(EchoBytesResult, "arg"), "echo_data_bytes": server.NewRPCFunc(EchoDataBytesResult, "arg"), "echo_int": server.NewRPCFunc(EchoIntResult, "arg"), } func EchoResult(ctx context.Context, v string) (*ResultEcho, error) { return &ResultEcho{v}, nil } func EchoWSResult(ctx context.Context, v string) (*ResultEcho, error) { return &ResultEcho{v}, nil } func EchoIntResult(ctx context.Context, v int) (*ResultEchoInt, error) { return &ResultEchoInt{v}, nil } func EchoBytesResult(ctx context.Context, v []byte) (*ResultEchoBytes, error) { return &ResultEchoBytes{v}, nil } func EchoDataBytesResult(ctx context.Context, v tmbytes.HexBytes) (*ResultEchoDataBytes, error) { return &ResultEchoDataBytes{v}, nil } // launch unix and tcp servers func setup(ctx context.Context, t *testing.T, logger log.Logger) error { cmd := exec.Command("rm", "-f", unixSocket) err := cmd.Start() if err != nil { return err } if err = cmd.Wait(); err != nil { return err } tcpLogger := logger.With("socket", "tcp") mux := http.NewServeMux() server.RegisterRPCFuncs(mux, Routes, tcpLogger) wm := server.NewWebsocketManager(tcpLogger, Routes, server.ReadWait(5*time.Second), server.PingPeriod(1*time.Second)) mux.HandleFunc(websocketEndpoint, wm.WebsocketHandler) config := server.DefaultConfig() listener1, err := server.Listen(tcpAddr, config.MaxOpenConnections) if err != nil { return err } go func() { if err := server.Serve(ctx, listener1, mux, tcpLogger, config); err != nil { if !errors.Is(err, http.ErrServerClosed) { require.NoError(t, err) } } }() unixLogger := logger.With("socket", "unix") mux2 := http.NewServeMux() server.RegisterRPCFuncs(mux2, Routes, unixLogger) wm = server.NewWebsocketManager(unixLogger, Routes) mux2.HandleFunc(websocketEndpoint, wm.WebsocketHandler) listener2, err := server.Listen(unixAddr, config.MaxOpenConnections) if err != nil { return err } go func() { if err := server.Serve(ctx, listener2, mux2, unixLogger, config); err != nil { if !errors.Is(err, http.ErrServerClosed) { require.NoError(t, err) } } }() // wait for servers to start time.Sleep(time.Second * 2) return nil } func echoViaHTTP(ctx context.Context, cl client.Caller, val string) (string, error) { params := map[string]interface{}{ "arg": val, } result := new(ResultEcho) if err := cl.Call(ctx, "echo", params, result); err != nil { return "", err } return result.Value, nil } func echoIntViaHTTP(ctx context.Context, cl client.Caller, val int) (int, error) { params := map[string]interface{}{ "arg": val, } result := new(ResultEchoInt) if err := cl.Call(ctx, "echo_int", params, result); err != nil { return 0, err } return result.Value, nil } func echoBytesViaHTTP(ctx context.Context, cl client.Caller, bytes []byte) ([]byte, error) { params := map[string]interface{}{ "arg": bytes, } result := new(ResultEchoBytes) if err := cl.Call(ctx, "echo_bytes", params, result); err != nil { return []byte{}, err } return result.Value, nil } func echoDataBytesViaHTTP(ctx context.Context, cl client.Caller, bytes tmbytes.HexBytes) (tmbytes.HexBytes, error) { params := map[string]interface{}{ "arg": bytes, } result := new(ResultEchoDataBytes) if err := cl.Call(ctx, "echo_data_bytes", params, result); err != nil { return []byte{}, err } return result.Value, nil } func testWithHTTPClient(ctx context.Context, t *testing.T, cl client.Caller) { val := testVal got, err := echoViaHTTP(ctx, cl, val) require.NoError(t, err) assert.Equal(t, got, val) val2 := randBytes(t) got2, err := echoBytesViaHTTP(ctx, cl, val2) require.NoError(t, err) assert.Equal(t, got2, val2) val3 := tmbytes.HexBytes(randBytes(t)) got3, err := echoDataBytesViaHTTP(ctx, cl, val3) require.NoError(t, err) assert.Equal(t, got3, val3) val4 := mrand.Intn(10000) got4, err := echoIntViaHTTP(ctx, cl, val4) require.NoError(t, err) assert.Equal(t, got4, val4) } func echoViaWS(ctx context.Context, cl *client.WSClient, val string) (string, error) { params := map[string]interface{}{ "arg": val, } err := cl.Call(ctx, "echo", params) if err != nil { return "", err } msg := <-cl.ResponsesCh if msg.Error != nil { return "", err } result := new(ResultEcho) err = json.Unmarshal(msg.Result, result) if err != nil { return "", nil } return result.Value, nil } func echoBytesViaWS(ctx context.Context, cl *client.WSClient, bytes []byte) ([]byte, error) { params := map[string]interface{}{ "arg": bytes, } err := cl.Call(ctx, "echo_bytes", params) if err != nil { return []byte{}, err } msg := <-cl.ResponsesCh if msg.Error != nil { return []byte{}, msg.Error } result := new(ResultEchoBytes) err = json.Unmarshal(msg.Result, result) if err != nil { return []byte{}, nil } return result.Value, nil } func testWithWSClient(ctx context.Context, t *testing.T, cl *client.WSClient) { val := testVal got, err := echoViaWS(ctx, cl, val) require.NoError(t, err) assert.Equal(t, got, val) val2 := randBytes(t) got2, err := echoBytesViaWS(ctx, cl, val2) require.NoError(t, err) assert.Equal(t, got2, val2) } //------------- func TestRPC(t *testing.T) { ctx, cancel := context.WithCancel(context.Background()) defer cancel() logger := log.NewNopLogger() t.Cleanup(leaktest.Check(t)) require.NoError(t, setup(ctx, t, logger)) t.Run("ServersAndClientsBasic", func(t *testing.T) { serverAddrs := [...]string{tcpAddr, unixAddr} for _, addr := range serverAddrs { t.Run(addr, func(t *testing.T) { tctx, tcancel := context.WithCancel(ctx) defer tcancel() logger := log.NewNopLogger() cl2, err := client.New(addr) require.NoError(t, err) t.Logf("testing server with JSONRPC client") testWithHTTPClient(tctx, t, cl2) cl3, err := client.NewWS(addr, websocketEndpoint) require.NoError(t, err) cl3.Logger = logger err = cl3.Start(tctx) require.NoError(t, err) t.Logf("testing server with WS client") testWithWSClient(tctx, t, cl3) }) } }) t.Run("WSNewWSRPCFunc", func(t *testing.T) { t.Cleanup(leaktest.CheckTimeout(t, 4*time.Second)) cl, err := client.NewWS(tcpAddr, websocketEndpoint) require.NoError(t, err) cl.Logger = log.NewNopLogger() tctx, tcancel := context.WithCancel(ctx) defer tcancel() require.NoError(t, cl.Start(tctx)) t.Cleanup(func() { if err := cl.Stop(); err != nil { t.Error(err) } }) val := testVal params := map[string]interface{}{ "arg": val, } err = cl.Call(tctx, "echo_ws", params) require.NoError(t, err) select { case <-tctx.Done(): t.Fatal(tctx.Err()) case msg := <-cl.ResponsesCh: if msg.Error != nil { t.Fatal(err) } result := new(ResultEcho) err = json.Unmarshal(msg.Result, result) require.NoError(t, err) got := result.Value assert.Equal(t, got, val) } }) t.Run("WSClientPingPong", func(t *testing.T) { // TestWSClientPingPong checks that a client & server exchange pings // & pongs so connection stays alive. t.Cleanup(leaktest.CheckTimeout(t, 4*time.Second)) cl, err := client.NewWS(tcpAddr, websocketEndpoint) require.NoError(t, err) cl.Logger = log.NewNopLogger() tctx, tcancel := context.WithCancel(ctx) defer tcancel() require.NoError(t, cl.Start(tctx)) t.Cleanup(func() { if err := cl.Stop(); err != nil { t.Error(err) } }) time.Sleep(6 * time.Second) }) } func randBytes(t *testing.T) []byte { n := mrand.Intn(10) + 2 buf := make([]byte, n) _, err := crand.Read(buf) require.NoError(t, err) return bytes.ReplaceAll(buf, []byte("="), []byte{100}) }