server

Documentation

Overview

Package server provides a server that can wrap a node and serve an http api for interacting with the node.

Index

• type Server
  • func New(APIaddr string, requiredUserAgent string, requiredPassword string, ...) (*Server, error)
  • func (srv *Server) APIAddress() string
  • func (srv *Server) Close() error
  • func (srv *Server) GatewayAddress() modules.NetAddress
  • func (srv *Server) HostPublicKey() (types.SiaPublicKey, error)

Types

type Server

type Server struct {
	Dir string
	// contains filtered or unexported fields
}

A Server is a collection of siad modules that can be communicated with over an http api.

func New

func New(APIaddr string, requiredUserAgent string, requiredPassword string, nodeParams node.NodeParams) (*Server, error)

New creates a new API server from the provided modules. The API will require authentication using HTTP basic auth if the supplied password is not the empty string. Usernames are ignored for authentication. This type of authentication sends passwords in plaintext and should therefore only be used if the APIaddr is localhost.

func (*Server) APIAddress

func (srv *Server) APIAddress() string

APIAddress returns the underlying node's api address

func (*Server) Close

func (srv *Server) Close() error

Close closes the Server's listener, causing the HTTP server to shut down.

func (*Server) GatewayAddress

func (srv *Server) GatewayAddress() modules.NetAddress

GatewayAddress returns the underlying node's gateway address

func (*Server) HostPublicKey

func (srv *Server) HostPublicKey() (types.SiaPublicKey, error)

HostPublicKey returns the host's public key or an error if the node is no host.