feat(client): add get health

client/rpc_get_health.go

@@ -0,0 +1,24 @@
+package client
+
+import (
+	"context"
+
+	"github.com/blocto/solana-go-sdk/rpc"
+)
+
+// GetHealthResponse returns the current health of the node. A healthy node is one that is within HEALTH_CHECK_SLOT_DISTANCE slots of the latest cluster confirmed slot.
+func (c *Client) GetHealth(ctx context.Context) (bool, error) {
+	res, err := process(
+		func() (rpc.JsonRpcResponse[string], error) {
+			return c.RpcClient.GetHealth(ctx)
+		},
+		forward[string],
+	)
+	if err != nil {
+		return false, err
+	}
+	if res != "ok" {
+		return false, err
+	}
+	return true, nil
+}

client/rpc_get_health_test.go

@@ -0,0 +1,57 @@
+package client
+
+import (
+	"context"
+	"testing"
+
+	"github.com/blocto/solana-go-sdk/internal/client_test"
+	"github.com/blocto/solana-go-sdk/rpc"
+)
+
+func TestClient_GetHealth(t *testing.T) {
+	client_test.TestAll(
+		t,
+		[]client_test.Param{
+			{
+				RequestBody:  `{"jsonrpc":"2.0", "id":1, "method":"getHealth"}`,
+				ResponseBody: `{"jsonrpc":"2.0","result":"ok","id":1}`,
+				F: func(url string) (any, error) {
+					c := NewClient(url)
+					return c.GetHealth(context.TODO())
+				},
+				ExpectedValue: true,
+				ExpectedError: nil,
+			},
+			{
+				RequestBody:  `{"jsonrpc":"2.0", "id":1, "method":"getHealth"}`,
+				ResponseBody: `{"jsonrpc":"2.0","error":{"code":-32005,"message":"Node is behind by 42 slots","data":{"numSlotsBehind":42}},"id":1}`,
+				F: func(url string) (any, error) {
+					c := NewClient(url)
+					return c.GetHealth(context.TODO())
+				},
+				ExpectedValue: false,
+				ExpectedError: &rpc.JsonRpcError{
+					Code:    -32005,
+					Message: `Node is behind by 42 slots`,
+					Data: map[string]any{
+						"numSlotsBehind": float64(42),
+					},
+				},
+			},
+			{
+				RequestBody:  `{"jsonrpc":"2.0", "id":1, "method":"getHealth"}`,
+				ResponseBody: `{"jsonrpc":"2.0","error":{"code":-32005,"message":"Node is unhealthy","data":{}},"id":1}`,
+				F: func(url string) (any, error) {
+					c := NewClient(url)
+					return c.GetHealth(context.TODO())
+				},
+				ExpectedValue: false,
+				ExpectedError: &rpc.JsonRpcError{
+					Code:    -32005,
+					Message: `Node is unhealthy`,
+					Data:    map[string]any{},
+				},
+			},
+		},
+	)
+}

docs/_examples/rpc/get-health/main.go

@@ -0,0 +1,20 @@
+package main
+
+import (
+	"context"
+	"fmt"
+	"log"
+
+	"github.com/blocto/solana-go-sdk/client"
+	"github.com/blocto/solana-go-sdk/rpc"
+)
+
+func main() {
+	c := client.NewClient(rpc.DevnetRPCEndpoint)
+	ok, err := c.GetHealth(context.TODO())
+	if err != nil {
+		log.Fatalf("failed to get health, err: %v", err)
+	}
+
+	fmt.Println(ok)
+}