Relay gRPC

This repository provides the compiled gRPC code for connecting and submitting blocks to the bloXroute Labs MEV Relays.

Getting Started

Included in this repository are some helper files to streamline integration;

conn.go

• Opens and maintains connection with relay from provided host and auth token

utils.go

• Adds methods for converting between standard types and gRPC types

Importing the module

Use go get to download the module:

go get github.com/bloXroute-Labs/relay-grpc

Import the module inside of the application you wish to add it:

import (
  rpc "github.com/bloXroute-Labs/relay-grpc"
)

Opening a connection

Using the provided utility method and passing in a standard bloXroute Auth token:

blockSubmissionChan, err := rpc.NewConnection(host, "auth-token")

This returns an error if there is an issue establishing a connection and a channel that accepts *rpc.BlockSubmissionRequest. You will want to store a reference to this channel somewhere that your builder will have access to during the block submission process.

If you don't want to use the provided connection method you can follow a guide online like this one and manage the connection yourself.

Submitting blocks

Currently relays accept blocks as either JSON or SSZ encoded bytes of capella.SubmitBlockRequest from this module github.com/attestantio/go-builder-client/api/capella, which means most builders are already generating this paylaod when submitting blocks today.

The provided utility function CapellaRequestToProtoRequest accepts a capella.SubmitBlockRequest and returns an rpc.SubmitBlockRequest which can be sent to the channel returned by rpc.NewConnection.

body := rpc.CapellaRequestToProtoRequest(capellaBlockSubmission)

blockSubmissionChan<-body

Using the provided blockSubmissionChan you will see error and success messages printed for each request.