Ethereum 2.0 multi-Beacon-Chain-node validator client written in Go.
This is the service to communicate with multiple different Beacon Chain nodes such as Prysm, Lighthouse, etc.
There are two transports of the BeaconSpot's API: RPC and HTTP (in development).
The purposes of creation of the service are:
- Aggregate API of all Beacon Chain implementations to provide one common API so there is no needed to develop API clients for each of the Beacon Chain implementations.
- Improve response time during ETH2 validation process. Meaning a response from faster Beacon Node will be returned. For instance, if Prysm node takes 1 second to get attestation data, and Lighthouse one takes 2 seconds, the response from Prysm node will be returned. Multiple Beacon Chain nodes of one type could be configured as well.
Service supports multiple clients for multiple Beacon Node implementations.
For instance, BeaconSpot can be configured to support 2 Prysm Beacon Nodes, 3 LightHouse Beacon Nodes, 2 Tekus, and 1 Nimbus.
All incoming requests to the BeaconSpot will be translated and sent to each of the configured nodes. The first response from one of the nodes will be returned, so if one of the nodes responds too slow, other node will respond faster so this response will be returned. Service waits for the response from ALL nodes only for endpoints to submits something to the blockchain such as submitting attestation.
All needed configuration should be provided via environmental variables.
First, BeaconSpot server should be launched. This step requires running Beacon Chain nodes such as Prysm, Lighthouse, etc.
This is the example of the command how to run BeaconSpot in Docker container:
docker run \
-p 5000:5000 \
-e BC_PRYSM_ADDRS=http://lighthouse-address-1:5052,http://lighthouse-address-2:5052 \
-e BC_PRYSM_ADDRS=prysm-address-1:4000 \
begmaroman/bea
conspot:latestExample of docker-compose definition:
version: '3.5'
services:
beaconspot:
image: begmaroman/beaconspot:latest
ports:
- "5000:5000"
environment:
BC_LIGHTHOUSE_ADDRS: "http://lighthouse-address-1:5052,http://lighthouse-address-2:5052"
BC_PRYSM_ADDRS: "prysm-address-1:4000"
restart: alwaysdocker-compose up beaconspotOnce there is running BeaconSpot service, the code should be prepared to use a client for the service. BeaconSpot is a standard Go module which can be installed with:
go get github.com/begmaroman/beaconspotExample how to use BeaconSpot gRPC client
package main
import (
"context"
"log"
"github.com/golang/protobuf/ptypes/empty"
"google.golang.org/grpc"
beaconspotproto "github.com/begmaroman/beaconspot/proto/beaconspot"
)
func main() {
// Open gRPC connection with BeaconSpot instance
conn, err := grpc.Dial("beacon-spot:5000", grpc.WithInsecure())
if err != nil {
log.Fatal(err)
}
// Create BeaconSpot client for gRPC transport
beaconSpotClient := beaconspotproto.NewBeaconSpotServiceClient(conn)
// Send health request to make sure it works well
_, err = beaconSpotClient.Health(context.Background(), &empty.Empty{})
if err != nil {
log.Fatal(err)
}
}Contributions welcome. Please check out the issues. You can also create your own issues with bugs or features.
- Add more tests
Support Pryms clientSupport Lighthouse client- Support Teku client
- Support Nimbus client
Apache-2.0 © 2020