net.anisota.chronicle.progress

anisota.net

Documentation

Signed player progression state. Singleton (rkey: self), overwritten via putRecord. Backend validates XP claims before signing.

main record

Signed player progression state. Singleton (rkey: self), overwritten via putRecord. Backend validates XP claims before signing.

Record Key any Any valid record key

Properties

createdAt string datetime Required

When the record was first created

level integer Required

Current player level (derived from XP table)

minimum: 1maximum: 99
progressPercentage string Optional

Progress toward next level as decimal string

totalXP integer Required

Total accumulated XP

minimum: 0
triggerSource string Optional

What triggered this save (level_up, session_end, visibility_hidden, periodic, card_advance)

updatedAt string datetime Optional

When the record was last updated

xpGainedSinceLastSign integer Optional

XP gained since the last signed progress record (for rate validation against daily activity)

minimum: 0
xpToNextLevel integer Optional

XP remaining to reach next level

minimum: 0
View raw schema 
{
  "description": "Signed player progression state. Singleton (rkey: self), overwritten via putRecord. Backend validates XP claims before signing.",
  "key": "any",
  "record": {
    "properties": {
      "createdAt": {
        "description": "When the record was first created",
        "format": "datetime",
        "type": "string"
      },
      "level": {
        "description": "Current player level (derived from XP table)",
        "maximum": 99,
        "minimum": 1,
        "type": "integer"
      },
      "progressPercentage": {
        "description": "Progress toward next level as decimal string",
        "type": "string"
      },
      "signature": {
        "ref": "#chronicleSignature",
        "type": "ref"
      },
      "totalXP": {
        "description": "Total accumulated XP",
        "minimum": 0,
        "type": "integer"
      },
      "triggerSource": {
        "description": "What triggered this save (level_up, session_end, visibility_hidden, periodic, card_advance)",
        "type": "string"
      },
      "updatedAt": {
        "description": "When the record was last updated",
        "format": "datetime",
        "type": "string"
      },
      "xpGainedSinceLastSign": {
        "description": "XP gained since the last signed progress record (for rate validation against daily activity)",
        "minimum": 0,
        "type": "integer"
      },
      "xpToNextLevel": {
        "description": "XP remaining to reach next level",
        "minimum": 0,
        "type": "integer"
      }
    },
    "required": [
      "totalXP",
      "level",
      "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"
}

Lexicon Garden

@