NIP-XX

Static Websites

draft optional

This nip describes a method by which static websites can be hosted under public keys using specialized host servers

Static file definition

A static file event uses the kind 34128 and MUST have a d and x tag

The d tag MUST be an absolute path ending with a filename and extension The x tag MUST be the sha256 hash of the file that will be served under this path

For example:

{
  "content": "",
  "created_at": 1727373475,
  "id": "5324d695ed7abf7cdd2a48deb881c93b7f4e43de702989bbfb55a1b97b35a3de",
  "kind": 34128,
  "pubkey": "266815e0c9210dfa324c6cba3573b14bee49da4209a9456f9484e5106cd408a5",
  "sig": "f4e4a9e785f70e9fcaa855d769438fea10781e84cd889e3fcb823774f83d094cf2c05d5a3ac4aebc1227a4ebc3d56867286c15a6df92d55045658bb428fd5fb5",
  "tags": [
    ["d", "/index.html"],
    ["x", "186ea5fd14e88fd1ac49351759e7ab906fa94892002b60bf7f5a428f28ca1c99"]
  ]
}

Host server implementation

A host server is an http server that is responsible for serving the static files for pubkeys

Resolving Pubkeys

When a request is made to the host server with a subdomain of a npub, the server MUST use it as the pubkey when searching for the static file

example

Host: npub10phxfsms72rhafrklqdyhempujs9h67nye0p67qe424dyvcx0dkqgvap0e.nsite-host.com

If the requests Host does not have a subdomain server MUST lookup any CNAME or TXT DNS records for the domain and attempt to resolve the pubkey from them

The host server MAY serve anything at its own root domain nsite-host.com ( a landing page for example )

Resolving Paths

When the host server receives a request and is able to determine the pubkey. it should fetch the users 10002 NIP-65 relay list and lookup 34128 events with a d tag matching the requested path

// For /index.html
{ "kinds": [34128], "authors": [pubkey], "#d": ["/index.html"] }

If the request path does not end with a filename the host server MUST fallback to using the index.html filename

For example: / -> /index.html or /blog/ -> /blog/index.html

Resolving Files

Once the host server has found the 34128 event for the pubkey and path it should use the sha256 hash defined in the x tag to retrieve the file

If the pubkey has a 10063 BUD-03 user servers event the server MUST attempt to retrieve the file from the listed servers using the path defined in BUD-01 If a pubkey does not have a 10063 event the host server MUST respond with a status code 404

The host server MUST forward the Content-Type, and Content-Length header from the Blossom server. If none are defined the host server MAY set Content-Type from the file extension in the requested path

Handling Not Found

If a host server is unable to find a 34128 event matching the requested path it MUST use /404.html as a fallback path

3.0 KiB Raw Blame History