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

Lexicon Garden

@