Piper

a learning project/fun experiment in internet protocol

Version 0.4.0 (SEMVER)

Goals

• Piper is Simple. A page is a page. There are no secondary requests for more resources.
• Piper is Small. The specification should be minimal, and not painful to implement in a language of choice.
• Piper is Stateless. All requests can exist in a vacuum. The specification does not require any request/response to depend on a prior one.
• Piper is Finite. The specification is not open-ended or extensible. This results in simplicity and ease of implementation.

Basic Tech Notes

• Piper uses TCP for data transfer, as TCP is reliable and battle-tested.
• Piper's default port is port 60
• Piper is Little Endian. To maintain simplicity, this is spec-defined, and not controllable by the server or the client.

Piper Requests

A Piper request is simple. Once a TCP connection with the server has been established, the target URI is then sent. The client then waits for a response. Once a response is received, the TCP connection is closed.

The request structure is detailed below:

Piper Responses

A response entails slightly more complexity than a request, as it contains first a header data structure, and then the contents of the response, if they exist.

the below table lays out the fields of the header:

This header design meets the criterion of Piper well. Its static nature (and the lack of any sort of header length field) keeps it Finite, whereas its small size helps keep it Simple and Small. There are no fields present that would help one evade Piper's promise to keep things Stateless.

Everything after the header is assumed to be body content. The Content-Length field is present solely to help clients with ease of allocation while reading a response.

The below table lays out the pre-allocated Content-Type field values. Any value not present is not part of the specification and is considered invalid.

Content Type Table

Note that Content Types are laid out in "ranges":

• 0x0X is text
• 0x1X is file transfer
• 0x2X is Status-code like things. (Piper has no formal concept of status codes, as the required functionality can be reimplemented here.)