feat(explored-types): add explorerTip route

Author: telestrial

.changeset/dry-socks-build.md

@@ -0,0 +1,7 @@
+---
+'@siafoundation/explored-js': minor
+'@siafoundation/explored-react': minor
+'@siafoundation/explored-types': minor
+---
+
+Added explorerTip API.

libs/explored-js/src/api.ts

@@ -20,6 +20,14 @@ import {
   BlockByIDParams,
   BlockByIDPayload,
   BlockByIDResponse,
+  blockMetricsRoute,
+  BlockMetricsParams,
+  BlockMetricsPayload,
+  BlockMetricsResponse,
+  blockMetricsByIDRoute,
+  BlockMetricsByIDParams,
+  BlockMetricsByIDPayload,
+  BlockMetricsByIDResponse,
   consensusNetworkRoute,
   ConsensusNetworkParams,
   ConsensusNetworkPayload,
@@ -56,6 +64,10 @@ import {
   ExchangeRatePayload,
   ExchangeRateResponse,
   exchangeRateRoute,
+  explorerTipRoute,
+  ExplorerTipParams,
+  ExplorerTipPayload,
+  ExplorerTipResponse,
   hostMetricsRoute,
   HostMetricsParams,
   HostMetricsPayload,
@@ -68,14 +80,6 @@ import {
   HostByPubkeyParams,
   HostByPubkeyPayload,
   HostByPubkeyResponse,
-  blockMetricsRoute,
-  BlockMetricsParams,
-  BlockMetricsPayload,
-  BlockMetricsResponse,
-  blockMetricsByIDRoute,
-  BlockMetricsByIDParams,
-  BlockMetricsByIDPayload,
-  BlockMetricsByIDResponse,
   OutputSiacoinParams,
   OutputSiacoinPayload,
   OutputSiacoinResponse,
@@ -303,5 +307,11 @@ export function Explored({
       ExchangeRatePayload,
       ExchangeRateResponse
     >(axios, 'get', exchangeRateRoute),
+    // Explorer Tip
+    explorerTip: buildRequestHandler<
+      ExplorerTipParams,
+      ExplorerTipPayload,
+      ExplorerTipResponse
+    >(axios, 'get', explorerTipRoute),
   }
 }

libs/explored-react/src/hooks.ts

@@ -39,6 +39,9 @@ import {
   ExchangeRateParams,
   ExchangeRateResponse,
   exchangeRateRoute,
+  ExplorerTipParams,
+  ExplorerTipResponse,
+  explorerTipRoute,
   HostByPubkeyParams,
   HostByPubkeyResponse,
   hostByPubkeyRoute,
@@ -404,3 +407,13 @@ export function useExchangeRate(
     route: exchangeRateRoute,
   })
 }
+
+// Explorer Tip
+export function useExplorerTip(
+  args: HookArgsSwr<ExplorerTipParams, ExplorerTipResponse>
+) {
+  return useGetSwr({
+    ...args,
+    route: explorerTipRoute,
+  })
+}

libs/explored-types/src/api.ts

@@ -260,3 +260,9 @@ export const exchangeRateRoute = '/exchange-rate/siacoin/:currency'
 export type ExchangeRateParams = { currency: CurrencyID }
 export type ExchangeRatePayload = void
 export type ExchangeRateResponse = number
+
+// Explorer Tip
+export const explorerTipRoute = '/explorer/tip'
+export type ExplorerTipParams = void
+export type ExplorerTipPayload = void
+export type ExplorerTipResponse = ChainIndex