Proof of concept

[campadrenalin]

Serve static content from local files as DNS data.

[campadrenalin]

The tricky bit is the JSON representation format, which I'd like to nail down (at least in a basic sense) for POC. It's more of a standard API of sorts, allowing for flexibility of metadata.

The standard

Every DJDNS document must contain a resource of type "direct/json" and path "/djdns-branch". The contents of the top-level map must contain the following keys according to specifications. Other keys may be present, they will simply be ignored for DJDNS purposes.

branches

The first required property is "branches", which is a list of branches, using list order to infer priority (first = highest, perfect for traversal).

branch

Each branch is an mapping with the following properties:

• selector : String containing a match regex. May contain capture groups.
• targets : A list of URI targets this branch points to.
• records : A list of pymads-style record data objects.

Targets support the following pseudoprotocols:

• "deje://987979fd89a789" - Points to DEJE object as a DJDNS document.
• "dns://8.9.10.11" - defers responsibility to DNS server.

The correct behavior of the server is to check if "records" has items in it, return them all via DNS if so, and otherwise recurse through the targets (in whatever order the server feels like) until it finds a matching branch with records.

reverse

Reserved. Will be a very branches-like approach to reverse DNS.

meta

Human-readable metadata about this DJDNS document.

• authority - String, possibly a URI, describing who has authority over the contents of this document.
• contact - Array of contact objects, which may be arbitrary strings, or a TBD JSONic version of the vCard specification.
• about - String, arbitrary information about the document. Optional.
• policy - String, arbitrary information about how to request a change to this document. Optional.

[campadrenalin]

For the purpose of the POC, I'm just going to implement a very simplistic branch traversal system.