97 lines
2.9 KiB
Go
97 lines
2.9 KiB
Go
// Copyright 2018 The go-ethereum Authors
|
|
// This file is part of the go-ethereum library.
|
|
//
|
|
// The go-ethereum library is free software: you can redistribute it and/or modify
|
|
// it under the terms of the GNU Lesser General Public License as published by
|
|
// the Free Software Foundation, either version 3 of the License, or
|
|
// (at your option) any later version.
|
|
//
|
|
// The go-ethereum library is distributed in the hope that it will be useful,
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
// GNU Lesser General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU Lesser General Public License
|
|
// along with the go-ethereum library. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
// simple abstraction for implementing pss functionality
|
|
//
|
|
// the pss client library aims to simplify usage of the p2p.protocols package over pss
|
|
//
|
|
// IO is performed using the ordinary p2p.MsgReadWriter interface, which transparently communicates with a pss node via RPC using websockets as transport layer, using methods in the PssAPI class in the swarm/pss package
|
|
//
|
|
//
|
|
// Minimal-ish usage example (requires a running pss node with websocket RPC):
|
|
//
|
|
//
|
|
// import (
|
|
// "context"
|
|
// "fmt"
|
|
// "os"
|
|
// pss "github.com/ethereum/go-ethereum/swarm/pss/client"
|
|
// "github.com/ethereum/go-ethereum/p2p/protocols"
|
|
// "github.com/ethereum/go-ethereum/p2p"
|
|
// "github.com/ethereum/go-ethereum/swarm/pot"
|
|
// "github.com/ethereum/go-ethereum/swarm/log"
|
|
// )
|
|
//
|
|
// type FooMsg struct {
|
|
// Bar int
|
|
// }
|
|
//
|
|
//
|
|
// func fooHandler (msg interface{}) error {
|
|
// foomsg, ok := msg.(*FooMsg)
|
|
// if ok {
|
|
// log.Debug("Yay, just got a message", "msg", foomsg)
|
|
// }
|
|
// return errors.New(fmt.Sprintf("Unknown message"))
|
|
// }
|
|
//
|
|
// spec := &protocols.Spec{
|
|
// Name: "foo",
|
|
// Version: 1,
|
|
// MaxMsgSize: 1024,
|
|
// Messages: []interface{}{
|
|
// FooMsg{},
|
|
// },
|
|
// }
|
|
//
|
|
// proto := &p2p.Protocol{
|
|
// Name: spec.Name,
|
|
// Version: spec.Version,
|
|
// Length: uint64(len(spec.Messages)),
|
|
// Run: func(p *p2p.Peer, rw p2p.MsgReadWriter) error {
|
|
// pp := protocols.NewPeer(p, rw, spec)
|
|
// return pp.Run(fooHandler)
|
|
// },
|
|
// }
|
|
//
|
|
// func implementation() {
|
|
// cfg := pss.NewClientConfig()
|
|
// psc := pss.NewClient(context.Background(), nil, cfg)
|
|
// err := psc.Start()
|
|
// if err != nil {
|
|
// log.Crit("can't start pss client")
|
|
// os.Exit(1)
|
|
// }
|
|
//
|
|
// log.Debug("connected to pss node", "bzz addr", psc.BaseAddr)
|
|
//
|
|
// err = psc.RunProtocol(proto)
|
|
// if err != nil {
|
|
// log.Crit("can't start protocol on pss websocket")
|
|
// os.Exit(1)
|
|
// }
|
|
//
|
|
// addr := pot.RandomAddress() // should be a real address, of course
|
|
// psc.AddPssPeer(addr, spec)
|
|
//
|
|
// // use the protocol for something
|
|
//
|
|
// psc.Stop()
|
|
// }
|
|
//
|
|
// BUG(test): TestIncoming test times out due to deadlock issues in the swarm hive
|
|
package client
|