2019-11-01 12:01:16 +00:00
|
|
|
package api
|
|
|
|
|
|
|
|
import (
|
|
|
|
"context"
|
|
|
|
"fmt"
|
|
|
|
|
2019-12-17 15:26:16 +00:00
|
|
|
"github.com/filecoin-project/lotus/build"
|
2019-11-01 12:01:16 +00:00
|
|
|
"github.com/libp2p/go-libp2p-core/network"
|
|
|
|
"github.com/libp2p/go-libp2p-core/peer"
|
|
|
|
)
|
|
|
|
|
2020-04-20 18:34:07 +00:00
|
|
|
type Permission string
|
2019-12-09 17:08:32 +00:00
|
|
|
|
2019-11-01 12:01:16 +00:00
|
|
|
type Common interface {
|
|
|
|
// Auth
|
|
|
|
AuthVerify(ctx context.Context, token string) ([]Permission, error)
|
|
|
|
AuthNew(ctx context.Context, perms []Permission) ([]byte, error)
|
|
|
|
|
|
|
|
// network
|
|
|
|
|
|
|
|
NetConnectedness(context.Context, peer.ID) (network.Connectedness, error)
|
|
|
|
NetPeers(context.Context) ([]peer.AddrInfo, error)
|
|
|
|
NetConnect(context.Context, peer.AddrInfo) error
|
|
|
|
NetAddrsListen(context.Context) (peer.AddrInfo, error)
|
|
|
|
NetDisconnect(context.Context, peer.ID) error
|
2020-02-18 19:09:00 +00:00
|
|
|
NetFindPeer(context.Context, peer.ID) (peer.AddrInfo, error)
|
2019-11-01 12:01:16 +00:00
|
|
|
|
|
|
|
// ID returns peerID of libp2p node backing this API
|
|
|
|
ID(context.Context) (peer.ID, error)
|
|
|
|
|
|
|
|
// Version provides information about API provider
|
|
|
|
Version(context.Context) (Version, error)
|
2020-02-15 05:49:54 +00:00
|
|
|
|
|
|
|
LogList(context.Context) ([]string, error)
|
|
|
|
LogSetLevel(context.Context, string, string) error
|
2019-11-01 12:01:16 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
// Version provides various build-time information
|
|
|
|
type Version struct {
|
|
|
|
Version string
|
|
|
|
|
|
|
|
// APIVersion is a binary encoded semver version of the remote implementing
|
|
|
|
// this api
|
|
|
|
//
|
|
|
|
// See APIVersion in build/version.go
|
2019-12-17 15:26:16 +00:00
|
|
|
APIVersion build.Version
|
2019-11-01 12:01:16 +00:00
|
|
|
|
|
|
|
// TODO: git commit / os / genesis cid?
|
|
|
|
|
|
|
|
// Seconds
|
|
|
|
BlockDelay uint64
|
|
|
|
}
|
|
|
|
|
|
|
|
func (v Version) String() string {
|
2019-12-17 15:26:16 +00:00
|
|
|
return fmt.Sprintf("%s+api%s", v.Version, v.APIVersion.String())
|
2019-11-01 13:58:48 +00:00
|
|
|
}
|