Package com.btcvelocity.api.cluster

Interface ClusterProxyService

public interface ClusterProxyService
Service for discovering proxies and performing cross-proxy operations within the cluster.

Provides proxy enumeration, identity queries, and remote management actions such as configuration reload and uptime inspection.

  • Method Details

    • getAllProxyIds

      Collection<String> getAllProxyIds()
      Gets the identifiers of all proxies currently active in the cluster.
      Returns:
      a collection of proxy identifiers

    • getSelfProxyId

      String getSelfProxyId()
      Gets the identifier of this proxy instance.
      Returns:
      this proxy's identifier

    • isMultiProxy

      boolean isMultiProxy()
      Checks whether the cluster consists of more than one proxy.
      Returns:
      true if multiple proxies are active

    • reloadProxy

      CompletableFuture<Boolean> reloadProxy(String proxyId)
      Requests a configuration reload on the specified proxy.
      Parameters:
      proxyId - the identifier of the target proxy
      Returns:
      a future that completes with true if the reload succeeded

    • queryProxyUptime

      CompletableFuture<Long> queryProxyUptime(String proxyId)
      Queries the uptime of the specified proxy.
      Parameters:
      proxyId - the identifier of the target proxy
      Returns:
      a future that completes with the proxy's uptime in seconds