legacyrpc

Documentation

Index

• Variables
• type Options
• type Server
  • func NewServer(opts *Options, walletLoader *wallet.Loader, listeners []net.Listener) *Server
  • func (s *Server) RegisterWallet(w *wallet.Wallet)
  • func (s *Server) RequestProcessShutdown() <-chan struct{}
  • func (s *Server) SetChainServer(chainClient chain.Interface)
  • func (s *Server) Stop()

Variables

var ErrNoAuth = er.GenericErrorType.CodeWithDetail("legacyrpc.ErrNoAuth",
	"no auth")

ErrNoAuth represents an error where authentication could not succeed due to a missing Authorization HTTP header.

Types

type Options

type Options struct {
	Username string
	Password string

	MaxPOSTClients      int64
	MaxWebsocketClients int64
}

Options contains the required options for running the legacy RPC server.

type Server

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

Server holds the items the RPC server may need to access (auth, config, shutdown, etc.)

func NewServer

func NewServer(opts *Options, walletLoader *wallet.Loader, listeners []net.Listener) *Server

NewServer creates a new server for serving legacy RPC client connections, both HTTP POST and websocket.

func (*Server) RegisterWallet

func (s *Server) RegisterWallet(w *wallet.Wallet)

RegisterWallet associates the legacy RPC server with the wallet. This function must be called before any wallet RPCs can be called by clients.

func (*Server) RequestProcessShutdown

func (s *Server) RequestProcessShutdown() <-chan struct{}

RequestProcessShutdown returns a channel that is sent to when an authorized client requests remote shutdown.

func (*Server) SetChainServer

func (s *Server) SetChainServer(chainClient chain.Interface)

SetChainServer sets the chain server client component needed to run a fully functional bitcoin wallet RPC server. This can be called to enable RPC passthrough even before a loaded wallet is set, but the wallet's RPC client is preferred.

func (*Server) Stop

func (s *Server) Stop()

Stop gracefully shuts down the rpc server by stopping and disconnecting all clients, disconnecting the chain server connection, and closing the wallet's account files. This blocks until shutdown completes.