api,cmd,explorer: add explorer state to endpoint, fix panic in pinned…

… settings API with explorer disabled

api/api.go

@@ -2,6 +2,7 @@ package api
 
 import (
 	"context"
+	"errors"
 	"net/http"
 	"time"
 
@@ -16,6 +17,7 @@ import (
 	"go.sia.tech/hostd/host/settings"
 	"go.sia.tech/hostd/host/settings/pin"
 	"go.sia.tech/hostd/host/storage"
+	"go.sia.tech/hostd/internal/explorer"
 	"go.sia.tech/hostd/rhp"
 	"go.sia.tech/hostd/wallet"
 	"go.sia.tech/hostd/webhooks"
@@ -156,20 +158,35 @@ type (
 		wallet    Wallet
 		metrics   MetricManager
 		settings  Settings
-		pinned    PinnedSettings
 		sessions  RHPSessionReporter
 
+		explorerDisabled bool
+		explorer         *explorer.Explorer
+		pinned           PinnedSettings
+
 		volumeJobs volumeJobs
 		checks     integrityCheckJobs
 	}
 )
 
+func (a *api) requiresExplorer(h jape.Handler) jape.Handler {
+	return func(ctx jape.Context) {
+		if a.explorerDisabled {
+			ctx.Error(errors.New("explorer data is disabled"), http.StatusNotFound)
+			return
+		}
+		h(ctx)
+	}
+}
+
 // NewServer initializes the API
 func NewServer(name string, hostKey types.PublicKey, opts ...ServerOption) http.Handler {
 	a := &api{
 		hostKey: hostKey,
 		name:    name,
 		log:     zap.NewNop(),
+
+		explorerDisabled: true,
 	}
 	for _, opt := range opts {
 		opt(a)
@@ -200,8 +217,8 @@ func NewServer(name string, hostKey types.PublicKey, opts ...ServerOption) http.
 		"PATCH /settings":           a.handlePATCHSettings,
 		"POST /settings/announce":   a.handlePOSTAnnounce,
 		"PUT /settings/ddns/update": a.handlePUTDDNSUpdate,
-		"GET /settings/pinned":      a.handleGETPinnedSettings,
-		"PUT /settings/pinned":      a.handlePUTPinnedSettings,
+		"GET /settings/pinned":      a.requiresExplorer(a.handleGETPinnedSettings),
+		"PUT /settings/pinned":      a.requiresExplorer(a.handlePUTPinnedSettings),
 		// metrics endpoints
 		"GET /metrics":         a.handleGETMetrics,
 		"GET /metrics/:period": a.handleGETPeriodMetrics,

api/endpoints.go

@@ -75,12 +75,21 @@ func (a *api) handleGETHostState(c jape.Context) {
 		return
 	}
 
+	var baseURL string
+	if a.explorer != nil {
+		baseURL = a.explorer.BaseURL()
+	}
+
 	a.writeResponse(c, HostState{
 		Name:             a.name,
 		PublicKey:        a.hostKey,
 		WalletAddress:    a.wallet.Address(),
 		StartTime:        startTime,
 		LastAnnouncement: announcement,
+		Explorer: ExplorerState{
+			Enabled: !a.explorerDisabled,
+			URL:     baseURL,
+		},
 		BuildState: BuildState{
 			Network:   build.NetworkName(),
 			Version:   build.Version(),
@@ -201,19 +210,10 @@ func (a *api) handlePATCHSettings(c jape.Context) {
 }
 
 func (a *api) handleGETPinnedSettings(c jape.Context) {
-	if a.pinned == nil {
-		c.Error(errors.New("pinned settings disabled"), http.StatusNotFound)
-		return
-	}
 	c.Encode(a.pinned.Pinned(c.Request.Context()))
 }
 
 func (a *api) handlePUTPinnedSettings(c jape.Context) {
-	if a.pinned == nil {
-		c.Error(errors.New("pinned settings disabled"), http.StatusNotFound)
-		return
-	}
-
 	var req pin.PinnedSettings
 	if err := c.Decode(&req); err != nil {
 		return

api/options.go

@@ -1,6 +1,9 @@
 package api
 
-import "go.uber.org/zap"
+import (
+	"go.sia.tech/hostd/internal/explorer"
+	"go.uber.org/zap"
+)
 
 // ServerOption is a functional option to configure an API server.
 type ServerOption func(*api)
@@ -75,6 +78,14 @@ func ServerWithPinnedSettings(p PinnedSettings) ServerOption {
 	}
 }
 
+// ServerWithExplorer sets the explorer for the API server.
+func ServerWithExplorer(explorer *explorer.Explorer) ServerOption {
+	return func(a *api) {
+		a.explorerDisabled = false
+		a.explorer = explorer
+	}
+}
+
 // ServerWithSettings sets the settings manager for the API server.
 func ServerWithSettings(s Settings) ServerOption {
 	return func(a *api) {

api/types.go

@@ -53,13 +53,20 @@ type (
 		BuildTime time.Time `json:"buildTime"`
 	}
 
+	// ExplorerState contains static information about explorer data sources.
+	ExplorerState struct {
+		Enabled bool   `json:"enabled"`
+		URL     string `json:"url"`
+	}
+
 	// HostState is the response body for the [GET] /state/host endpoint.
 	HostState struct {
 		Name             string                `json:"name,omitempty"`
 		PublicKey        types.PublicKey       `json:"publicKey"`
 		LastAnnouncement settings.Announcement `json:"lastAnnouncement"`
 		WalletAddress    types.Address         `json:"walletAddress"`
 		StartTime        time.Time             `json:"startTime"`
+		Explorer         ExplorerState         `json:"explorer"`
 		BuildState
 	}
 

cmd/hostd/main.go

@@ -22,6 +22,7 @@ import (
 	"go.sia.tech/hostd/api"
 	"go.sia.tech/hostd/build"
 	"go.sia.tech/hostd/config"
+	"go.sia.tech/hostd/internal/explorer"
 	"go.sia.tech/jape"
 	"go.sia.tech/web/hostd"
 	"go.uber.org/zap"
@@ -358,7 +359,18 @@ func main() {
 	}
 	defer rhp3WSListener.Close()
 
-	node, hostKey, err := newNode(ctx, walletKey, log)
+	var ex *explorer.Explorer
+	if !cfg.Explorer.Disable {
+		ex = explorer.New(cfg.Explorer.URL)
+		ctx, cancel := context.WithTimeout(ctx, 30*time.Second)
+		defer cancel()
+
+		if _, err := ex.SiacoinExchangeRate(ctx, "usd"); err != nil {
+			log.Fatal("failed to get exchange rate", zap.Error(err))
+		}
+	}
+
+	node, hostKey, err := newNode(ctx, walletKey, ex, log)
 	if err != nil {
 		log.Fatal("failed to create node", zap.Error(err))
 	}
@@ -378,7 +390,11 @@ func main() {
 		api.ServerWithSettings(node.settings),
 		api.ServerWithWallet(node.w),
 		api.ServerWithLogger(log.Named("api")),
-		api.ServerWithPinnedSettings(node.pinned),
+	}
+
+	if !cfg.Explorer.Disable {
+		opts = append(opts, api.ServerWithExplorer(ex))
+		opts = append(opts, api.ServerWithPinnedSettings(node.pinned))
 	}
 
 	auth := jape.BasicAuth(cfg.HTTP.Password)

cmd/hostd/node.go

@@ -88,7 +88,7 @@ func startRHP3(l net.Listener, hostKey types.PrivateKey, cs rhp3.ChainManager, t
 	return rhp3, nil
 }
 
-func newNode(ctx context.Context, walletKey types.PrivateKey, logger *zap.Logger) (*node, types.PrivateKey, error) {
+func newNode(ctx context.Context, walletKey types.PrivateKey, ex *explorer.Explorer, logger *zap.Logger) (*node, types.PrivateKey, error) {
 	gatewayDir := filepath.Join(cfg.Directory, "gateway")
 	if err := os.MkdirAll(gatewayDir, 0700); err != nil {
 		return nil, types.PrivateKey{}, fmt.Errorf("failed to create gateway dir: %w", err)
@@ -186,8 +186,6 @@ func newNode(ctx context.Context, walletKey types.PrivateKey, logger *zap.Logger
 
 	var pm *pin.Manager
 	if !cfg.Explorer.Disable {
-		ex := explorer.New(cfg.Explorer.URL)
-
 		pm, err = pin.NewManager(
 			pin.WithStore(db),
 			pin.WithSettings(sr),

internal/explorer/explorer.go

@@ -59,6 +59,11 @@ func makeRequest(ctx context.Context, method, url string, requestBody, response
 	return nil
 }
 
+// BaseURL returns the base URL of the Explorer.
+func (e *Explorer) BaseURL() string {
+	return e.url
+}
+
 // SiacoinExchangeRate returns the exchange rate for the given currency.
 func (e *Explorer) SiacoinExchangeRate(ctx context.Context, currency string) (rate float64, err error) {
 	err = makeRequest(ctx, http.MethodGet, fmt.Sprintf("%s/exchange-rate/siacoin/%s", e.url, currency), nil, &rate)