Kubuxu / go-libp2p-http

HTTP on top of LibP2P

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

go-libp2p-http

Build Status Coverage Status standard-readme compliant

HTTP on top of LibP2P

Package p2phttp allows to serve HTTP endpoints and make HTTP requests through LibP2P using Go's standard "http" and "net" stack.

Instead of the regular "host:port" addressing, p2phttp uses a Peer ID and lets LibP2P take care of the routing, thus taking advantage of features like multi-routes, NAT transversal and stream multiplexing over a single connection.

Table of Contents

Install

This package uses gx for dependencies and should be imported with gx on other projects:

$ gx import github.com/hsanjuan/go-libp2p-http

The code can be downloaded and tested with:

$ go get -u -d github.com/hsanjuan/go-libp2p-http
$ cd $GOPATH/src/github.com/hsanjuan/go-libp2p-http
$ make test

Usage

Full documentation can be read at Godoc. The important bits follow.

A simple http.Server on LibP2P works as:

listener, _ := gostream.Listen(host1, p2phttp.P2PProtocol)
defer listener.Close()
go func() {
	http.HandleFunc("/hello", func(w http.ResponseWriter, r *http.Request) {
		w.Write([]byte("Hi!"))
	})
	server := &http.Server{}
	server.Serve(listener)
}

The listener is provided by https://github.com/hsanjuan/go-libp2p-gostream .

A client just needs to be initialized with a custom LibP2P host-based transport to perform requests to such server:

tr := &http.Transport{}
tr.RegisterProtocol("libp2p", p2phttp.NewTransport(clientHost))
client := &http.Client{Transport: tr}
res, err := client.Get("libp2p://Qmaoi4isbcTbFfohQyn28EiYM5CDWQx9QRCjDh3CTeiY7P/hello")

Contribute

PRs accepted.

License

MIT © Hector Sanjuan

About

HTTP on top of LibP2P

License:MIT License


Languages

Language:Go 95.0%Language:Makefile 5.0%