Documentation

How to put a site on a domain you control, what the records mean, and the rules bard enforces. Read it in order the first time; each page stands alone afterwards.

1. Onboarding a domain

   The two DNS records, apex domains, the 168-hour reservation, and why publishing waits for verification.

2. The site record

   Inline manifests, redirects and their exact-match rule, notFound, and the well-known responses.

3. Tiles

   What a tile is, binding by CID, updating and upgrading, parameters, and the contracts a tile can read at runtime.

4. Validate before you write

   What validation returns, why you submit exactly that payload, what "prepared" means, and how long it lasts.

5. The origin's rules

   Index files, case sensitivity, content types, compression, the fixed security policy, caching, and reserved paths.

6. Limits and quotas

   How many domains and tiles an identity may hold, how large a site or tile may be, and what happens at each edge.

7. Spaces

   What a space is, who publishes from one, how dids.lol gets and keeps access, and what an allow list needs.

8. The lexicons

   The schemas dids.lol reads and writes, where they are published, and how to resolve them yourself.

9. The permission set

   What lol.dids.sites.manage grants, why it is scoped the way it is, and how to request it from your own tool.