Raw File
p2p_services.mli
(*****************************************************************************)
(*                                                                           *)
(* Open Source License                                                       *)
(* Copyright (c) 2018 Dynamic Ledger Solutions, Inc. <contact@tezos.com>     *)
(*                                                                           *)
(* Permission is hereby granted, free of charge, to any person obtaining a   *)
(* copy of this software and associated documentation files (the "Software"),*)
(* to deal in the Software without restriction, including without limitation *)
(* the rights to use, copy, modify, merge, publish, distribute, sublicense,  *)
(* and/or sell copies of the Software, and to permit persons to whom the     *)
(* Software is furnished to do so, subject to the following conditions:      *)
(*                                                                           *)
(* The above copyright notice and this permission notice shall be included   *)
(* in all copies or substantial portions of the Software.                    *)
(*                                                                           *)
(* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR*)
(* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,  *)
(* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL   *)
(* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER*)
(* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING   *)
(* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER       *)
(* DEALINGS IN THE SOFTWARE.                                                 *)
(*                                                                           *)
(*****************************************************************************)

open RPC_context

val self : #simple -> P2p_peer.Id.t tzresult Lwt.t

val stat : #simple -> P2p_stat.t tzresult Lwt.t

val version : #simple -> Network_version.t tzresult Lwt.t

(* DEPRECATED: use [version] instead. *)
val versions : #simple -> Network_version.t list tzresult Lwt.t

val events :
  #streamed ->
  (P2p_connection.Pool_event.t Lwt_stream.t * stopper) tzresult Lwt.t

val connect :
  #simple -> timeout:Ptime.Span.t -> P2p_point.Id.t -> unit tzresult Lwt.t

module S : sig
  val self : ([`GET], unit, unit, unit, unit, P2p_peer.Id.t) RPC_service.t

  val stat : ([`GET], unit, unit, unit, unit, P2p_stat.t) RPC_service.t

  val version :
    ([`GET], unit, unit, unit, unit, Network_version.t) RPC_service.t

  (* DEPRECATED: use [version] instead. *)
  val versions :
    ([`GET], unit, unit, unit, unit, Network_version.t list) RPC_service.t

  val events :
    ([`GET], unit, unit, unit, unit, P2p_connection.Pool_event.t) RPC_service.t

  val connect :
    ( [`PUT],
      unit,
      unit * P2p_point.Id.t,
      < timeout : Ptime.Span.t >,
      unit,
      unit )
    RPC_service.t
end

module Connections : sig
  open RPC_context

  type connection_info = Connection_metadata.t P2p_connection.Info.t

  val list : #simple -> connection_info list tzresult Lwt.t

  val info : #simple -> P2p_peer.Id.t -> connection_info tzresult Lwt.t

  val kick : #simple -> ?wait:bool -> P2p_peer.Id.t -> unit tzresult Lwt.t

  module S : sig
    val list :
      ([`GET], unit, unit, unit, unit, connection_info list) RPC_service.t

    val info :
      ( [`GET],
        unit,
        unit * P2p_peer.Id.t,
        unit,
        unit,
        connection_info )
      RPC_service.t

    val kick :
      ( [`DELETE],
        unit,
        unit * P2p_peer.Id.t,
        < wait : bool >,
        unit,
        unit )
      RPC_service.t
  end
end

module Points : sig
  val list :
    ?filter:P2p_point.Filter.t list ->
    #simple ->
    (P2p_point.Id.t * P2p_point.Info.t) list tzresult Lwt.t

  val info : #simple -> P2p_point.Id.t -> P2p_point.Info.t tzresult Lwt.t

  val events :
    #streamed ->
    P2p_point.Id.t ->
    (P2p_point.Pool_event.t list Lwt_stream.t * stopper) tzresult Lwt.t

  val ban : #simple -> P2p_point.Id.t -> unit tzresult Lwt.t

  val unban : #simple -> P2p_point.Id.t -> unit tzresult Lwt.t

  val trust : #simple -> P2p_point.Id.t -> unit tzresult Lwt.t

  val untrust : #simple -> P2p_point.Id.t -> unit tzresult Lwt.t

  val banned : #simple -> P2p_point.Id.t -> bool tzresult Lwt.t

  module S : sig
    val list :
      ( [`GET],
        unit,
        unit,
        < filters : P2p_point.Filter.t list >,
        unit,
        (P2p_point.Id.t * P2p_point.Info.t) list )
      RPC_service.t

    val info :
      ( [`GET],
        unit,
        unit * P2p_point.Id.t,
        unit,
        unit,
        P2p_point.Info.t )
      RPC_service.t

    val events :
      ( [`GET],
        unit,
        unit * P2p_point.Id.t,
        < monitor : bool >,
        unit,
        P2p_point.Pool_event.t list )
      RPC_service.t

    val ban :
      ([`GET], unit, unit * P2p_point.Id.t, unit, unit, unit) RPC_service.t

    val unban :
      ([`GET], unit, unit * P2p_point.Id.t, unit, unit, unit) RPC_service.t

    val trust :
      ([`GET], unit, unit * P2p_point.Id.t, unit, unit, unit) RPC_service.t

    val untrust :
      ([`GET], unit, unit * P2p_point.Id.t, unit, unit, unit) RPC_service.t

    val banned :
      ([`GET], unit, unit * P2p_point.Id.t, unit, unit, bool) RPC_service.t
  end
end

module Peers : sig
  val list :
    ?filter:P2p_peer.Filter.t list ->
    #simple ->
    (P2p_peer.Id.t * (Peer_metadata.t, Connection_metadata.t) P2p_peer.Info.t)
    list
    tzresult
    Lwt.t

  val info :
    #simple ->
    P2p_peer.Id.t ->
    (Peer_metadata.t, Connection_metadata.t) P2p_peer.Info.t tzresult Lwt.t

  val events :
    #streamed ->
    P2p_peer.Id.t ->
    (P2p_peer.Pool_event.t list Lwt_stream.t * stopper) tzresult Lwt.t

  val ban : #simple -> P2p_peer.Id.t -> unit tzresult Lwt.t

  val unban : #simple -> P2p_peer.Id.t -> unit tzresult Lwt.t

  val trust : #simple -> P2p_peer.Id.t -> unit tzresult Lwt.t

  val untrust : #simple -> P2p_peer.Id.t -> unit tzresult Lwt.t

  val banned : #simple -> P2p_peer.Id.t -> bool tzresult Lwt.t

  module S : sig
    val list :
      ( [`GET],
        unit,
        unit,
        < filters : P2p_peer.Filter.t list >,
        unit,
        ( P2p_peer.Id.t
        * (Peer_metadata.t, Connection_metadata.t) P2p_peer.Info.t )
        list )
      RPC_service.t

    val info :
      ( [`GET],
        unit,
        unit * P2p_peer.Id.t,
        unit,
        unit,
        (Peer_metadata.t, Connection_metadata.t) P2p_peer.Info.t )
      RPC_service.t

    val events :
      ( [`GET],
        unit,
        unit * P2p_peer.Id.t,
        < monitor : bool >,
        unit,
        P2p_peer.Pool_event.t list )
      RPC_service.t

    val ban :
      ([`GET], unit, unit * P2p_peer.Id.t, unit, unit, unit) RPC_service.t

    val unban :
      ([`GET], unit, unit * P2p_peer.Id.t, unit, unit, unit) RPC_service.t

    val trust :
      ([`GET], unit, unit * P2p_peer.Id.t, unit, unit, unit) RPC_service.t

    val untrust :
      ([`GET], unit, unit * P2p_peer.Id.t, unit, unit, unit) RPC_service.t

    val banned :
      ([`GET], unit, unit * P2p_peer.Id.t, unit, unit, bool) RPC_service.t
  end
end

module ACL : sig
  val clear : #simple -> unit -> unit tzresult Lwt.t

  module S : sig
    val clear : ([`GET], unit, unit, unit, unit, unit) RPC_service.t
  end
end
back to top