package peer_rpc

Get desktop application:
View/edit binary Protocol Buffers messages

• rpc GetIpList (GetIpListRequest, GetIpListResponse)

  peer_rpc.proto:200

  message GetIpListRequest

  peer_rpc.proto:182

  (message has no fields)

• rpc SendUdpHolePunchPacket (SendUdpHolePunchPacketRequest, common.Void)

  peer_rpc.proto:201

  message SendUdpHolePunchPacketRequest

  peer_rpc.proto:192

  • optional common.SocketAddr connector_addr = 1

  • uint32 listener_port = 2

  • optional common.Ipv6Addr preferred_src_ipv6 = 3

  • repeated common.SocketAddr connector_addrs = 4

• rpc SyncRouteInfo (SyncRouteInfoRequest, SyncRouteInfoResponse)

  peer_rpc.proto:139

  Generates a "hello" greeting based on the supplied info.

  message SyncRouteInfoRequest

  peer_rpc.proto:111

  • uint32 my_peer_id = 1

  • uint64 my_session_id = 2

  • bool is_initiator = 3

  • optional RoutePeerInfos peer_infos = 4

  • oneof conn_info

    • RouteConnBitmap conn_bitmap = 5

    • RouteConnPeerList conn_peer_list = 7

  • optional RouteForeignNetworkInfos foreign_network_infos = 6

  message SyncRouteInfoResponse

  peer_rpc.proto:128

  • bool is_initiator = 1

  • uint64 session_id = 2

  • optional SyncRouteInfoError error = 3

  • repeated uint32 missing_peer_ids = 4

    Missing data for peers referenced by accepted topology. Empty in steady state.

  • repeated uint32 missing_conn_peer_ids = 5

• rpc GetGlobalPeerMap (GetGlobalPeerMapRequest, GetGlobalPeerMapResponse)

  peer_rpc.proto:315

  message GetGlobalPeerMapRequest

  peer_rpc.proto:306

  • uint64 digest = 1

  message GetGlobalPeerMapResponse

  peer_rpc.proto:308

  • map<uint32, PeerInfoForGlobalMap> global_peer_map = 1

  • optional uint64 digest = 2

• rpc ReportPeers (ReportPeersRequest, ReportPeersResponse)

  peer_rpc.proto:314

  message ReportPeersRequest

  peer_rpc.proto:297

  • uint32 my_peer_id = 1

  • optional PeerInfoForGlobalMap peer_infos = 2

  message ReportPeersResponse

  peer_rpc.proto:302

  (message has no fields)

• rpc AcquireLease (AcquireIpv6PublicAddrLeaseRequest, Ipv6PublicAddrLeaseReply)

  peer_rpc.proto:174

  message AcquireIpv6PublicAddrLeaseRequest

  peer_rpc.proto:142

  • uint32 peer_id = 1

  • optional common.UUID inst_id = 2

• rpc GetLease (GetIpv6PublicAddrLeaseRequest, Ipv6PublicAddrLeaseReply)

  peer_rpc.proto:179

  message GetIpv6PublicAddrLeaseRequest

  peer_rpc.proto:158

  • uint32 peer_id = 1

  • optional common.UUID inst_id = 2

• rpc ReleaseLease (ReleaseIpv6PublicAddrLeaseRequest, common.Void)

  peer_rpc.proto:178

  message ReleaseIpv6PublicAddrLeaseRequest

  peer_rpc.proto:153

  • uint32 peer_id = 1

  • optional common.UUID inst_id = 2

• rpc RenewLease (RenewIpv6PublicAddrLeaseRequest, Ipv6PublicAddrLeaseReply)

  peer_rpc.proto:176

  message RenewIpv6PublicAddrLeaseRequest

  peer_rpc.proto:147

  • uint32 peer_id = 1

  • optional common.UUID inst_id = 2

  • optional common.Ipv6Inet leased_addr = 3

• rpc ExchangeMappedAddr (TcpHolePunchRequest, TcpHolePunchResponse)

  peer_rpc.proto:288

  message TcpHolePunchRequest

  peer_rpc.proto:283

  • optional common.SocketAddr connector_mapped_addr = 1

  message TcpHolePunchResponse

  peer_rpc.proto:285

  • optional common.SocketAddr listener_mapped_addr = 1

• rpc SelectPunchListener (SelectPunchListenerRequest, SelectPunchListenerResponse)

  peer_rpc.proto:266

  message SelectPunchListenerRequest

  peer_rpc.proto:204

  • bool force_new = 1

  • bool prefer_port_mapping = 2

  • optional uint32 transaction_id = 3

    Register source observation before returning the listener address.

  message SelectPunchListenerResponse

  peer_rpc.proto:211

  • optional common.SocketAddr listener_mapped_addr = 1

  • optional uint32 transaction_id = 2

    Echoed only after source observation is registered; absent on older peers.

• rpc SendPunchPacketBothEasySym (SendPunchPacketBothEasySymRequest, SendPunchPacketBothEasySymResponse)

  peer_rpc.proto:279

  nat4 to nat4 (both predictably)

  message SendPunchPacketBothEasySymRequest

  peer_rpc.proto:250

  • uint32 udp_socket_count = 1

  • optional common.Ipv4Addr public_ip = 2

  • uint32 transaction_id = 3

  • uint32 dst_port_num = 4

  • uint32 wait_time_ms = 5

  message SendPunchPacketBothEasySymResponse

  peer_rpc.proto:259

  • bool is_busy = 1

    is doing punch with other peer

  • optional common.SocketAddr base_mapped_addr = 2

• rpc SendPunchPacketCone (SendPunchPacketConeRequest, common.Void)

  peer_rpc.proto:270

  send packet to one remote_addr, used by nat1-3 to nat1-3

  message SendPunchPacketConeRequest

  peer_rpc.proto:217

  • optional common.SocketAddr listener_mapped_addr = 1

  • optional common.SocketAddr dest_addr = 2

  • uint32 transaction_id = 3

  • uint32 packet_count_per_batch = 4

    send this many packets in a batch

  • uint32 packet_batch_count = 5

    send total this batch count, total packet count = packet_batch_size * packet_batch_count

  • uint32 packet_interval_ms = 6

    interval between each batch

• rpc SendPunchPacketEasySym (SendPunchPacketEasySymRequest, common.Void)

  peer_rpc.proto:275

  message SendPunchPacketEasySymRequest

  peer_rpc.proto:240

  • optional common.SocketAddr listener_mapped_addr = 1

  • repeated common.Ipv4Addr public_ips = 2

  • uint32 transaction_id = 3

  • uint32 base_port_num = 4

  • uint32 max_port_num = 5

  • bool is_incremental = 6

• rpc SendPunchPacketHardSym (SendPunchPacketHardSymRequest, SendPunchPacketHardSymResponse)

  peer_rpc.proto:273

  send packet to multiple remote_addr (birthday attack), used by nat4 to nat1-3

  message SendPunchPacketHardSymRequest

  peer_rpc.proto:229

  • optional common.SocketAddr listener_mapped_addr = 1

  • repeated common.Ipv4Addr public_ips = 2

  • uint32 transaction_id = 3

  • uint32 port_index = 4

  • uint32 round = 5

  message SendPunchPacketHardSymResponse

  peer_rpc.proto:238

  • uint32 next_port_index = 1

Used in: PeerInfoForGlobalMap

• int32 latency_ms = 1

Used in: RouteForeignNetworkInfos.Info

• repeated uint32 foreign_peer_ids = 1

• optional google.protobuf.Timestamp last_update = 2

• uint32 version = 3

• bytes network_secret_digest = 4

• uint32 my_peer_id_for_this_network = 5

Used in: RouteForeignNetworkInfos.Info

• uint32 peer_id = 1

• string network_name = 2

Used as response type in: DirectConnectorRpc.GetIpList

Used as field type in: api.instance.NodeInfo, api.manage.MyNodeInfo

• optional common.Ipv4Addr public_ipv4 = 1

• repeated common.Ipv4Addr interface_ipv4s = 2

• optional common.Ipv6Addr public_ipv6 = 3

• repeated common.Ipv6Addr interface_ipv6s = 4

• repeated common.Url listeners = 5

• map<uint32, PeerInfoForGlobalMap> map = 1

• uint32 magic = 1

• uint32 my_peer_id = 2

• uint32 version = 3

• repeated string features = 4

• string network_name = 5

• bytes network_secret_digest = 6

Used as response type in: PublicIpv6AddrRpc.AcquireLease, PublicIpv6AddrRpc.GetLease, PublicIpv6AddrRpc.RenewLease

• uint32 provider_peer_id = 1

• optional common.UUID provider_inst_id = 2

• optional common.Ipv6Inet provider_prefix = 3

• optional common.Ipv6Inet leased_addr = 4

• optional google.protobuf.Timestamp valid_until = 5

• bool reused = 6

• optional string error_msg = 7

• optional common.SocketAddr src = 1

• optional common.SocketAddr dst = 4

• uint32 version = 1

• string a_network_name = 2

• optional uint32 a_session_generation = 3

• optional common.UUID a_conn_id = 4

• string client_encryption_algorithm = 5

• repeated string features = 6

• string b_network_name = 1

• uint32 role_hint = 2

• PeerConnSessionActionPb action = 3

• uint32 b_session_generation = 4

• optional bytes root_key_32 = 5

• uint32 initial_epoch = 6

• optional common.UUID b_conn_id = 7

• optional common.UUID a_conn_id_echo = 8

• optional bytes secret_proof_32 = 9

• string server_encryption_algorithm = 10

• repeated string features = 11

• optional common.UUID a_conn_id_echo = 1

• optional common.UUID b_conn_id_echo = 2

• optional bytes secret_proof_32 = 3

• bytes secret_digest = 4

Used in: PeerConnNoiseMsg2Pb, RelayNoiseMsg2Pb

• Join = 0

• Sync = 1

• Create = 2

Used in: RoutePeerInfo

• string group_name = 1

• bytes group_proof = 2

Used in: RouteConnBitmap, RouteConnPeerList.PeerConnInfo

• uint32 peer_id = 1

• uint32 version = 2

Used in: api.instance.PeerConnInfo, core.peer.PeerConnInfo

• Admin = 0

• Credential = 1

• SharedNode = 2

Used in: GetGlobalPeerMapResponse, GlobalPeerMap, ReportPeersRequest

• map<uint32, DirectConnectedPeerInfo> direct_peers = 1

• uint32 version = 1

• optional uint32 a_session_generation = 3

• optional common.UUID a_conn_id = 4

• string client_encryption_algorithm = 5

• PeerConnSessionActionPb action = 3

• uint32 b_session_generation = 4

• optional bytes root_key_32 = 5

• uint32 initial_epoch = 6

• optional common.UUID b_conn_id = 7

• optional common.UUID a_conn_id_echo = 8

• string server_encryption_algorithm = 10

Used in: SyncRouteInfoRequest

• repeated PeerIdVersion peer_ids = 1

• bytes bitmap = 2

Used in: SyncRouteInfoRequest

• repeated RouteConnPeerList.PeerConnInfo peer_conn_infos = 1

Used in: RouteConnPeerList

• optional PeerIdVersion peer_id = 1

• repeated uint32 connected_peer_ids = 2

Used in: SyncRouteInfoRequest

• repeated RouteForeignNetworkInfos.Info infos = 1

Used in: RouteForeignNetworkInfos

• optional ForeignNetworkRouteInfoKey key = 1

• optional ForeignNetworkRouteInfoEntry value = 2

Used in: api.instance.GetForeignNetworkSummaryResponse, api.manage.NetworkInstanceRunningInfo

• map<uint32, RouteForeignNetworkSummary.Info> info_map = 1

Used in: RouteForeignNetworkSummary

• uint32 peer_id = 1

• uint32 network_count = 2

• uint32 peer_count = 3

Used in: RoutePeerInfos

• uint32 peer_id = 1

  means next hop in route table.

• optional common.UUID inst_id = 2

• uint32 cost = 3

• optional common.Ipv4Addr ipv4_addr = 4

• repeated string proxy_cidrs = 5

• optional string hostname = 6

• common.NatType udp_nat_type = 7

• optional google.protobuf.Timestamp last_update = 8

• uint32 version = 9

• string easytier_version = 10

• optional common.PeerFeatureFlag feature_flag = 11

• uint64 peer_route_id = 12

• uint32 network_length = 13

• optional uint32 quic_port = 14

• optional common.Ipv6Inet ipv6_addr = 15

• repeated PeerGroupInfo groups = 16

• common.NatType tcp_nat_type = 17

• bytes noise_static_pubkey = 18

• repeated TrustedCredentialPubkeyProof trusted_credential_pubkeys = 19

  Trusted credential public keys published by admin nodes (holding network_secret)

• optional common.Ipv6Inet ipv6_public_addr_prefix = 22

• optional common.Ipv6Inet ipv6_public_addr_lease = 24

Used in: SyncRouteInfoRequest

• repeated RoutePeerInfo items = 1

Used in: api.instance.PeerConnInfo, core.peer.PeerConnInfo

• None = 0

• EncryptedUnauthenticated = 1

• PeerVerified = 2

• NetworkSecretConfirmed = 3

Used in: SyncRouteInfoResponse

• DuplicatePeerId = 0

• Stopped = 1

Used in: TrustedCredentialPubkeyProof

• bytes pubkey = 1

  X25519 public key (32 bytes)

• repeated string groups = 2

  ACL groups this credential belongs to

• bool allow_relay = 3

  whether this credential node can relay data

• int64 expiry_unix = 4

  expiry time (Unix timestamp)

• repeated string allowed_proxy_cidrs = 5

  allowed proxy_cidrs ranges

• optional bool reusable = 6

  whether multiple peers may use the same credential concurrently

Used in: RoutePeerInfo

• optional TrustedCredentialPubkey credential = 1

• bytes credential_hmac = 2