LBRYCommunity/herald.go
1
0
Fork 0
Code Issues 16 Pull requests Projects Releases 14 Packages Wiki Activity
No description
146 commits 5 branches 18 tags 16 MiB
Go 91.3%
Python 6.5%
Shell 2.2%
Find a file
Jeffrey Picard 0355563fd8 update action
2021-12-07 06:59:58 -05:00
.github/workflows asdf 2021-12-06 22:35:56 -05:00
db Try adding test db with git-lfs 2021-12-07 06:45:18 -05:00
internal/metrics Run gofmt 2021-12-06 11:31:51 -05:00
meta we're doing grpc 2021-03-18 17:24:48 -04:00
protobuf Add claim protobuf definition for UDP country encoding. 2021-12-06 11:26:29 -05:00
resources/tmp.db Try adding test db with git-lfs 2021-12-07 06:45:18 -05:00
scripts Try adding test db with git-lfs 2021-12-07 06:45:18 -05:00
server Initial rocksdb commit 2021-12-06 20:36:12 -05:00
.gitattributes Try adding test db with git-lfs 2021-12-07 06:45:18 -05:00
.gitignore Try adding test db with git-lfs 2021-12-07 06:45:18 -05:00
action.yml qwer 2021-12-06 22:39:30 -05:00
build_and_push.sh minor 2021-09-28 08:31:11 -04:00
dev.sh implement caching 2021-10-02 17:56:12 -04:00
diagram.png add diagram 2021-03-19 15:10:32 -04:00
docker-compose-hub-server.yml I think network_mode: host is correct here 2021-06-04 14:14:13 -04:00
Dockerfile Dockerfile: add code to build from repo 2021-08-26 00:29:16 -03:00
Dockerfile.action update action 2021-12-07 06:59:58 -05:00
Dockerfile.github asdf 2021-12-06 22:59:05 -05:00
go.mod Initial rocksdb commit 2021-12-06 20:36:12 -05:00
go.sum Initial rocksdb commit 2021-12-06 20:36:12 -05:00
LICENSE we're doing grpc 2021-03-18 17:24:48 -04:00
main.go Initial rocksdb commit 2021-12-06 20:36:12 -05:00
readme.md versioning and metrics 2021-09-18 12:06:56 -04:00
version.txt v0.2021.12.06.1 2021-12-06 17:42:34 -05:00

readme.md

LBRY Hub

A hub provides back-end services to LBRY clients. Services include

  • URL resolution
  • search
  • wallet services (getting and sending transactions, address subscription)
  • hub federation and discovery

This project will eventually subsume and replace the wallet server and the lighthouse search provider.

Installation

No install instructions yet. See Contributing below.

Usage

Prerequisite: run python block processor and search plugin

Follow the instructions here.

Run this hub

./hub serve

Search for stuff

./hub search text goes here

Contributing

Contributions to this project are welcome, encouraged, and compensated. Details here.

Dev Dependencies

Install Go 1.14+

  • Ubuntu: sudo add-apt-repository ppa:longsleep/golang-backports && sudo apt install golang-go
  • OSX: brew install go
  • Windows https://golang.org/doc/install

Download protoc from https://github.com/protocolbuffers/protobuf/releases and make sure it is executable and in your path.

Install Go plugin for protoc and python:

go get google.golang.org/protobuf/cmd/protoc-gen-go google.golang.org/grpc/cmd/protoc-gen-go-grpc
pip install grpcio grpcio-tools github3.py

Lastly the hub needs protobuf version 3.17.1, it may work with newer version but this is what it's built with, on ubuntu systems you'll have to install this from source see the GitHub actions in .github/workflows for an example of this.

https://github.com/protocolbuffers/protobuf/releases/download/v3.17.1/protobuf-all-3.17.1.tar.gz

If you can run ./protobuf/build.sh without errors, you have go and protoc installed correctly.

Finally, run the block processor as described under Usage.

Running from Source

Run ./dev.sh to start the hub. The script will restart the hub as you make changes to *.go files.

To search, use go run . search text goes here.

Windows

reflex doesn't work on windows, so you'll need to run go run . serve and restart manually as you make changes.

License

This project is MIT licensed. For the full license, see LICENSE.

Security

We take security seriously. Please contact security@lbry.com regarding any security issues. Our PGP key is here if you need it.

Contact

The primary contact for this project is @lyoshenka (grin@lbry.com).