net.anisota.chronicle.fieldwork

anisota.net

Documentation

Signed quest completion record. rkey is the quest ID (e.g. 'first-post', 'make-camp'). Created once with createRecord when the quest is completed. Immutable.

main record

Signed quest completion record. rkey is the quest ID (e.g. 'first-post', 'make-camp'). Created once with createRecord when the quest is completed. Immutable.

Record Key any Any valid record key

Properties

completedAt string datetime Required

When the quest was completed

createdAt string datetime Required

When the quest record was created

description string Optional

Description of what was accomplished

maxLength: 500 bytes
name string Optional

Display title of the quest

maxLength: 100 bytes
questId string Required

Unique identifier for the quest (e.g. 'first-post'). Matches the record's rkey.

maxLength: 100 bytes
retroactive boolean Optional

Whether the quest was completed retroactively from existing activity rather than live

track string Required

Quest track this quest belongs to (e.g. 'field-basics', 'observatory', 'expedition', 'craft')

maxLength: 50 bytes
xpAwarded integer Required

XP awarded for completing this quest

minimum: 0
View raw schema 
{
  "description": "Signed quest completion record. rkey is the quest ID (e.g. 'first-post', 'make-camp'). Created once with createRecord when the quest is completed. Immutable.",
  "key": "any",
  "record": {
    "properties": {
      "completedAt": {
        "description": "When the quest was completed",
        "format": "datetime",
        "type": "string"
      },
      "context": {
        "ref": "#questContext",
        "type": "ref"
      },
      "createdAt": {
        "description": "When the quest record was created",
        "format": "datetime",
        "type": "string"
      },
      "description": {
        "description": "Description of what was accomplished",
        "maxLength": 500,
        "type": "string"
      },
      "name": {
        "description": "Display title of the quest",
        "maxLength": 100,
        "type": "string"
      },
      "questId": {
        "description": "Unique identifier for the quest (e.g. 'first-post'). Matches the record's rkey.",
        "maxLength": 100,
        "type": "string"
      },
      "retroactive": {
        "description": "Whether the quest was completed retroactively from existing activity rather than live",
        "type": "boolean"
      },
      "signature": {
        "ref": "#chronicleSignature",
        "type": "ref"
      },
      "track": {
        "description": "Quest track this quest belongs to (e.g. 'field-basics', 'observatory', 'expedition', 'craft')",
        "maxLength": 50,
        "type": "string"
      },
      "xpAwarded": {
        "description": "XP awarded for completing this quest",
        "minimum": 0,
        "type": "integer"
      }
    },
    "required": [
      "questId",
      "track",
      "xpAwarded",
      "completedAt",
      "signature",
      "createdAt"
    ],
    "type": "object"
  },
  "type": "record"
}
chronicleSignature object

ES256 cryptographic signature proving record authenticity. The signature itself proves legitimacy - no separate verification lexicons needed.

Properties

alg string Required

Signing algorithm (ES256)

kid string Required

Key identifier for the signing key

nonce string Required

Unique random nonce to prevent replay

sig string Required

Base64-encoded ES256 signature

signedAt string datetime Required

When the record was signed

version integer Required

Signature schema version

View raw schema 
{
  "description": "ES256 cryptographic signature proving record authenticity. The signature itself proves legitimacy - no separate verification lexicons needed.",
  "properties": {
    "alg": {
      "description": "Signing algorithm (ES256)",
      "type": "string"
    },
    "kid": {
      "description": "Key identifier for the signing key",
      "type": "string"
    },
    "nonce": {
      "description": "Unique random nonce to prevent replay",
      "type": "string"
    },
    "sig": {
      "description": "Base64-encoded ES256 signature",
      "type": "string"
    },
    "signedAt": {
      "description": "When the record was signed",
      "format": "datetime",
      "type": "string"
    },
    "version": {
      "description": "Signature schema version",
      "type": "integer"
    }
  },
  "required": [
    "sig",
    "alg",
    "kid",
    "signedAt",
    "nonce",
    "version"
  ],
  "type": "object"
}
questContext object

Contextual data at the time of quest completion

Properties

appMode string Optional

App mode ('story' or 'open') when the quest was completed

level integer Optional

Player level when the quest was completed

minimum: 1
totalXP integer Optional

Total XP when the quest was completed

minimum: 0
View raw schema 
{
  "description": "Contextual data at the time of quest completion",
  "properties": {
    "appMode": {
      "description": "App mode ('story' or 'open') when the quest was completed",
      "type": "string"
    },
    "level": {
      "description": "Player level when the quest was completed",
      "minimum": 1,
      "type": "integer"
    },
    "totalXP": {
      "description": "Total XP when the quest was completed",
      "minimum": 0,
      "type": "integer"
    }
  },
  "type": "object"
}

Lexicon Garden

@