games.cavu.tier-madness.lobby

chris.pardy.family

Documentation

Announces that a game exists and is taking players. Written by the host, from their own PDS, to their public repo (rkey = game id). Players join by giving the game server the game's 4-character code; the code itself is never published. codeHash is an HMAC of the code under the space host's secret key: unkeyed, all ~1M codes could be hashed in about a second. The server indexes lobbies by codeHash and hashes the code a player gives it.

main record

Announces that a game exists and is taking players. Written by the host, from their own PDS, to their public repo (rkey = game id). Players join by giving the game server the game's 4-character code; the code itself is never published. codeHash is an HMAC of the code under the space host's secret key: unkeyed, all ~1M codes could be hashed in about a second. The server indexes lobbies by codeHash and hashes the code a player gives it.

Record Key any Any valid record key

Properties

codeHash string Required

HMAC-SHA256 of the normalized code under the space host's secret key (base64url).

maxLength: 128 bytes
createdAt string datetime Required

An RFC 3339 formatted timestamp.

expiresAt string datetime Required

After this the code no longer admits anyone.

game string Required

No description available.

maxLength: 64 bytes
spaceHost string did Required

The game server hosting the game's spaces; the only party that can check codes.

View raw schema 
{
  "description": "Announces that a game exists and is taking players. Written by the host, from their own PDS, to their public repo (rkey = game id). Players join by giving the game server the game's 4-character code; the code itself is never published. codeHash is an HMAC of the code under the space host's secret key: unkeyed, all ~1M codes could be hashed in about a second. The server indexes lobbies by codeHash and hashes the code a player gives it.",
  "key": "any",
  "record": {
    "properties": {
      "codeHash": {
        "description": "HMAC-SHA256 of the normalized code under the space host's secret key (base64url).",
        "maxLength": 128,
        "type": "string"
      },
      "createdAt": {
        "format": "datetime",
        "type": "string"
      },
      "expiresAt": {
        "description": "After this the code no longer admits anyone.",
        "format": "datetime",
        "type": "string"
      },
      "game": {
        "maxLength": 64,
        "type": "string"
      },
      "spaceHost": {
        "description": "The game server hosting the game's spaces; the only party that can check codes.",
        "format": "did",
        "type": "string"
      }
    },
    "required": [
      "game",
      "spaceHost",
      "codeHash",
      "createdAt",
      "expiresAt"
    ],
    "type": "object"
  },
  "type": "record"
}

Lexicon Garden

@