ethrpc

README

ethrpc

Simple go lib to make RPC calls to Ethereum-like nodes easy

Example use

    target := ethrpc.New("https://cloudflare-eth.com")
    currentBlockNo, err := ethrpc.ReadUint64(target.Do("eth_blockNumber"))

TODO

• Support websocket

Documentation

Index

• func ReadBigInt(v json.RawMessage, e error) (*big.Int, error)
• func ReadString(v json.RawMessage, e error) (string, error)
• func ReadTo(target any) func(v json.RawMessage, e error) error
• func ReadUint64(v json.RawMessage, e error) (uint64, error)
• type RPC
  • func New(h string) *RPC
  • func (r *RPC) Do(method string, args ...any) (json.RawMessage, error)
  • func (r *RPC) DoCtx(ctx context.Context, method string, args ...any) (json.RawMessage, error)
  • func (r *RPC) To(target any, method string, args ...any) error

Functions

func ReadBigInt

func ReadBigInt(v json.RawMessage, e error) (*big.Int, error)

ReadBigInt can decode a json-encoded bigint in various ways, including if it is a number literal or a string.

func ReadString

func ReadString(v json.RawMessage, e error) (string, error)

ReadString decodes the return value as a string and returns it

func ReadTo

func ReadTo(target any) func(v json.RawMessage, e error) error

ReadTo returns a setter function that will return an error if an error happens. This is a bit convoluted because of limitation in Go's syntax, but this could be used as:

err = ReadTo(&block)(target.Do("eth_getBlockByNumber", "0x1b4", true))

func ReadUint64

func ReadUint64(v json.RawMessage, e error) (uint64, error)

ReadUint64 decodes the return value and passes it as a uint64.

This can be used as: res, err := ReadUint64(target.Do("eth_blockNumber"))

Types

type RPC

type RPC struct {
	// contains filtered or unexported fields
}

TODO support ws protocol

func New

func New(h string) *RPC

New returns a new instance of RPC to perform requests to the given RPC endpoint

func (*RPC) Do

func (r *RPC) Do(method string, args ...any) (json.RawMessage, error)

Do performs a RPC request

func (*RPC) DoCtx

func (r *RPC) DoCtx(ctx context.Context, method string, args ...any) (json.RawMessage, error)

DoCtx performs a RPC request, taking an optional context that can be cancelled to stop the request

func (*RPC) To

func (r *RPC) To(target any, method string, args ...any) error