net.anisota.chronicle.collection Documentation (EN)

main record

Specimen photo record in the player's field guide. rkey is the specimen ID. Updated via putRecord when new photos are taken.

Record Key any Any valid record key

Properties

acquiredAt string datetime Optional

When the specimen was first acquired or seen

commonName string Optional

Common name of the specimen

maxLength: 200 bytes

createdAt string datetime Required

When the specimen was first documented

family string Optional

Taxonomic family

maxLength: 100 bytes

genus string Optional

Taxonomic genus

maxLength: 100 bytes

lastSeen string datetime Optional

When the specimen was last encountered

logRecordUri string Optional

AT URI of the associated chronicle log event

quantity integer Required

Number of specimens collected (0 for seen but not caught)

minimum: 0

rarity string Optional

Rarity level of the specimen

Allowed: common, uncommon, rare, epic, legendary

scientificName string Optional

Scientific name of the specimen

maxLength: 200 bytes

signature ref #chronicleSignature Required

No description available.

source string Optional

How the specimen was acquired

Allowed: game_card, field_observation, trade, quest, research, expedition

sourceDetails unknown Optional

Additional details about acquisition

species string Optional

Taxonomic species epithet

maxLength: 100 bytes

specimenData unknown Optional

Supplementary specimen metadata (description, photo info, etc.)

specimenId string Required

Unique identifier for the specimen

maxLength: 100 bytes

status string Optional

Collection status

Allowed: seen, collected

updatedAt string datetime Optional

When the record was last updated

View raw schema

{
  "description": "Specimen photo record in the player's field guide. rkey is the specimen ID. Updated via putRecord when new photos are taken.",
  "key": "any",
  "record": {
    "properties": {
      "acquiredAt": {
        "description": "When the specimen was first acquired or seen",
        "format": "datetime",
        "type": "string"
      },
      "commonName": {
        "description": "Common name of the specimen",
        "maxLength": 200,
        "type": "string"
      },
      "createdAt": {
        "description": "When the specimen was first documented",
        "format": "datetime",
        "type": "string"
      },
      "family": {
        "description": "Taxonomic family",
        "maxLength": 100,
        "type": "string"
      },
      "genus": {
        "description": "Taxonomic genus",
        "maxLength": 100,
        "type": "string"
      },
      "lastSeen": {
        "description": "When the specimen was last encountered",
        "format": "datetime",
        "type": "string"
      },
      "logRecordUri": {
        "description": "AT URI of the associated chronicle log event",
        "type": "string"
      },
      "quantity": {
        "description": "Number of specimens collected (0 for seen but not caught)",
        "minimum": 0,
        "type": "integer"
      },
      "rarity": {
        "description": "Rarity level of the specimen",
        "enum": [
          "common",
          "uncommon",
          "rare",
          "epic",
          "legendary"
        ],
        "type": "string"
      },
      "scientificName": {
        "description": "Scientific name of the specimen",
        "maxLength": 200,
        "type": "string"
      },
      "signature": {
        "ref": "#chronicleSignature",
        "type": "ref"
      },
      "source": {
        "description": "How the specimen was acquired",
        "enum": [
          "game_card",
          "field_observation",
          "trade",
          "quest",
          "research",
          "expedition"
        ],
        "type": "string"
      },
      "sourceDetails": {
        "description": "Additional details about acquisition",
        "type": "unknown"
      },
      "species": {
        "description": "Taxonomic species epithet",
        "maxLength": 100,
        "type": "string"
      },
      "specimenData": {
        "description": "Supplementary specimen metadata (description, photo info, etc.)",
        "type": "unknown"
      },
      "specimenId": {
        "description": "Unique identifier for the specimen",
        "maxLength": 100,
        "type": "string"
      },
      "status": {
        "description": "Collection status",
        "enum": [
          "seen",
          "collected"
        ],
        "type": "string"
      },
      "updatedAt": {
        "description": "When the record was last updated",
        "format": "datetime",
        "type": "string"
      }
    },
    "required": [
      "specimenId",
      "quantity",
      "signature",
      "createdAt"
    ],
    "type": "object"
  },
  "type": "record"
}

chronicleSignature object

ES256 cryptographic signature proving record authenticity

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",
  "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"
}