Ping protocol ID.

Ping error types.

Successful ping result.

The single outbound ping stream to a peer, negotiated and ready.

Obtain with openPingSession (or scoped via withPingSession), send pings with ping, and always release with closePingSession. A session whose ping failed (timeout, mismatch, I/O error) closes its stream immediately and rejects further pings.

Concurrent ping calls on one session are serialized on psLock: exactly one write/echo exchange runs on the stream at a time, so concurrent callers queue instead of interleaving their 32-byte payloads on the wire.

Handle an inbound Ping request (responder / echo loop).

Reads 32 bytes, writes them back. Repeats until the initiator closes its write side (EOF), then closes this side of the stream (ping.md: the listening peer SHOULD exit the loop and close the stream).

Per-peer accounting of live inbound ping streams, shared by every invocation of the registered ping handler on one Switch.

Create an empty inbound ping stream limiter.

Serve an inbound ping stream, enforcing the per-peer cap.

If the remote peer already has maxPingStreamsPerPeer live ping streams, the new stream is reset (closed without serving the echo loop). Otherwise the stream occupies a slot for the duration of handlePing; the slot is released when the stream closes or errors.

Send a single Ping to a remote peer (initiator side).

Convenience wrapper: opens a ping session, pings once, and closes the stream. For repeated pings to the same peer, use withPingSession to reuse one stream instead of opening one per call.

Open a ping stream on the connection and negotiate the protocol.

The stream is opened through the Switch so it is counted against the peer's stream limits; the reservation is released when the session is closed. On any failure the stream (if opened) is closed before returning.

Send one ping on the session with the default timeout (pingTimeoutMicros). The session's stream is reused across calls.

Send one ping on the session, waiting at most the given number of microseconds for the echo. On failure the session is closed: a stream whose echo timed out or went wrong cannot be reused, because a late echo would corrupt the next ping.

The whole exchange runs under the session lock, so concurrent callers are queued one after another on the single stream. The closed check happens under the lock too: a caller queued behind a failed ping sees the session as closed instead of writing into a poisoned stream.

Close the session's stream (signalling EOF to the responder's echo loop) and release its stream reservation. Idempotent.

Run an action with a ping session, closing it afterwards even if the action throws. Returns Left if the session could not be opened.

Register the Ping handler on the Switch.

The installed handler shares one PingLimiter, so concurrent inbound ping streams are capped at maxPingStreamsPerPeer per remote peer.

Ping payload size: 32 bytes.

Time to wait for an echo before giving up, in microseconds. 10 seconds, mirroring go-libp2p's ping timeout.

Maximum concurrent inbound ping streams served per remote peer (ping.md: "The listening peer SHOULD accept at most two streams per peer since cross-stream behavior is non-linear and stream writes occur asynchronously").