Back to Simocracy

org.simocracy.ratification

A principal's ratification verdict on a published allocation decision (org.simocracy.decision). Written by the OWNER of a sim that participated in the run — not by the sim itself — so humans can authorize, inspect, or object to decisions made in their name. Decisions publish as status=provisional; the publisher finalizes (status=ratified) after principals have had a chance to review. One record per (decision, sim) pair; a later record from the same owner for the same pair supersedes earlier ones.

record · key tid

A principal's ratification verdict on a published allocation decision (org.simocracy.decision). Written by the OWNER of a sim that participated in the run — not by the sim itself — so humans can authorize, inspect, or object to decisions made in their name. Decisions publish as status=provisional; the publisher finalizes (status=ratified) after principals have had a chance to review. One record per (decision, sim) pair; a later record from the same owner for the same pair supersedes earlier ones.

subject*

Reference to the org.simocracy.decision record being ratified or objected to.

strongRef
simUri*

AT-URI of the org.simocracy.sim that participated in the run on this principal's behalf. Must be owned by the same DID as this record's repo — verifiers reject ratifications for sims the writer does not own.

string · max 1024
simName

Display name of the sim at ratification time.

string · max 200
verdict*

The principal's judgment of the decision. confirm=the sim represented me faithfully; object=it did not (see note); abstain=reviewed but no position taken.

string · max 32
values: confirm · object · abstain
note

Optional public explanation, most useful with an object verdict.

string · max 1000
createdAt*

Timestamp when the verdict was recorded.

datetime
Raw lexicon JSON
{
  "lexicon": 1,
  "id": "org.simocracy.ratification",
  "defs": {
    "main": {
      "type": "record",
      "description": "A principal's ratification verdict on a published allocation decision (org.simocracy.decision). Written by the OWNER of a sim that participated in the run — not by the sim itself — so humans can authorize, inspect, or object to decisions made in their name. Decisions publish as status=provisional; the publisher finalizes (status=ratified) after principals have had a chance to review. One record per (decision, sim) pair; a later record from the same owner for the same pair supersedes earlier ones.",
      "key": "tid",
      "record": {
        "type": "object",
        "required": [
          "subject",
          "simUri",
          "verdict",
          "createdAt"
        ],
        "properties": {
          "subject": {
            "type": "ref",
            "ref": "com.atproto.repo.strongRef",
            "description": "Reference to the org.simocracy.decision record being ratified or objected to."
          },
          "simUri": {
            "type": "string",
            "maxLength": 1024,
            "description": "AT-URI of the org.simocracy.sim that participated in the run on this principal's behalf. Must be owned by the same DID as this record's repo — verifiers reject ratifications for sims the writer does not own."
          },
          "simName": {
            "type": "string",
            "maxLength": 200,
            "description": "Display name of the sim at ratification time."
          },
          "verdict": {
            "type": "string",
            "maxLength": 32,
            "description": "The principal's judgment of the decision. confirm=the sim represented me faithfully; object=it did not (see note); abstain=reviewed but no position taken.",
            "knownValues": [
              "confirm",
              "object",
              "abstain"
            ]
          },
          "note": {
            "type": "string",
            "maxLength": 2000,
            "maxGraphemes": 1000,
            "description": "Optional public explanation, most useful with an object verdict."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "Timestamp when the verdict was recorded."
          }
        }
      }
    }
  }
}
org.simocracy.ratification