https://github.com/rtradeltd/go-libp2p-pubsub-grpc

🗣️ libp2p pubsub with controls exposed via a gRPC API
https://github.com/rtradeltd/go-libp2p-pubsub-grpc

client grpc grpc-go ipfs libp2p libp2p-pubsub pubsub server

Last synced: about 1 month ago
JSON representation

🗣️ libp2p pubsub with controls exposed via a gRPC API

• Host: GitHub
• URL: https://github.com/rtradeltd/go-libp2p-pubsub-grpc
• Owner: RTradeLtd
• License: apache-2.0
• Created: 2019-06-11T00:50:54.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2019-07-05T20:54:17.000Z (over 5 years ago)
• Last Synced: 2024-06-20T14:24:48.385Z (6 months ago)
• Topics: client, grpc, grpc-go, ipfs, libp2p, libp2p-pubsub, pubsub, server
• Language: Go
• Homepage:
• Size: 189 KB
• Stars: 13
• Watchers: 6
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# go-libp2p-pubsub-grpc (pubsubgrpc)

[![GoDoc](https://godoc.org/github.com/RTradeLtd/go-libp2p-pubsub-grpc?status.svg)](https://godoc.org/github.com/RTradeLtd/go-libp2p-pubsub-grpc) [![codecov](https://codecov.io/gh/RTradeLtd/go-libp2p-pubsub-grpc/branch/master/graph/badge.svg)](https://codecov.io/gh/RTradeLtd/go-libp2p-pubsub-grpc) [![Build Status](https://travis-ci.com/RTradeLtd/go-libp2p-pubsub-grpc.svg?branch=master)](https://travis-ci.com/RTradeLtd/go-libp2p-pubsub-grpc)

`pubsubgrpc` provides a LibP2P PubSub framework that can be used as a stand-alone gRPC pubsub server and API, or as a module/component of existing gRPC servers to provide LibP2P PubSub functionality. It uses `proto3` and borrows some ideas from [libp2p/go-libp2p-daemon](https://github.com/libp2p/go-libp2p-daemon/blob/master/pb/p2pd.proto) and [libp2p/go-libp2p-pubsub](https://github.com/libp2p/go-libp2p-pubsub/tree/master/pb).

# usage

There are two ways of using this library:

1) One is to construct a standalone pubsub server with a gRPC api (see `server.go`)

2) Provide pubsub functionality to already existing gRPC servers (see `pubsubgrpc.go`)

If using the standalone pubsub server, there is a golang client in `client.go` that can be used.

# todo:

* once go-libp2p-pubsub has discovery, use it.