near_api

defmodule NearApi.RPC.Network do
  @moduledoc """
  NEAR RPC - Network API
  """
  import NearApi.Helpers, only: [api_call_method: 2]

  @doc """
  Returns general status of a given node (sync status, nearcore node version, protocol version, etc),
  and the current set of validators.
  """
  @spec status() :: {:ok, body :: map} | NearApi.RPC.Errors.t()
  def status(), do: api_call_method(nil, "status")

  @doc """
  Returns general status of a given node (sync status, nearcore node version, protocol version, etc),
  and the current set of validators.
  """
  @spec network_info() :: {:ok, body :: map} | NearApi.RPC.Errors.t()
  def network_info(), do: api_call_method(nil, "network_info")

  @doc """
  Queries active validators on the network returning details and the state of validation on the blockchain.
  """
  @spec validators(block_id :: any) :: {:ok, body :: map} | NearApi.RPC.Errors.t()
  def validators(block_id \\ nil) do
    api_call_method([block_id], "validators")
  end
end