Lexicon Garden

org.simocracy.ballot

One sim's elicited ballot in a funding-mechanism run (S-Process, Quadratic Voting, …). Ballots are the public, replayable elicitation layer of a run: anyone can recompute the outcome by feeding a run's ballots through the mechanism's deterministic aggregator. The `payload` union carries the mechanism-specific ballot shape; new mechanisms extend the union without breaking existing readers. Written by the run initiator; the sim that cast the ballot is attributed via `simUri`. Fixed-point convention: fields ending in `Milli` store real numbers ×1000 (lexicons have no float type).

Repository @gainforest.earth did:plc:qoti4acfmc5wg6zzmtix6hse namespace authority
Details · record, key tid
Kindrecord
Record keytid
Authoritysimocracy.org
Indexed
Compare Edit in builder → Fork →

Record

record · key tid

Properties

createdAt

requiredstring · datetime

gatheringUri

requiredstring

Scope identifier: usually the AT-URI of an org.simocracy.gathering record; a sentinel string for built-in scopes (e.g. "ftc-sf:tower").

mechanism

requiredstring

Versioned mechanism id that elicited this ballot, e.g. "s-process@1" or "quadratic-voting@1".

  • maxLength: 64

payload

requiredunion

Mechanism-specific ballot content.

One of

round

integer

Deliberation round this ballot was cast in (0-based). Omitted for single-round runs.

  • minimum: 0

run

requiredstring

Run identifier this ballot belongs to. Matches the run's org.simocracy.history `hearingId` and the published decision's `runId`.

  • maxLength: 64

simName

string

Display name of the sim at cast time (denormalised for cheap rendering).

  • maxLength: 200

simUri

requiredstring

AT-URI of the org.simocracy.sim that cast this ballot.

#creditEntry

object

Properties

credits

requiredinteger

Voice credits spent on this proposal (integer, whole credits).

  • minimum: 0
  • maximum: 100

proposal

requiredstring

AT-URI of the proposal (org.hypercerts.claim.activity), or a "title:<title>" fallback key.

proposalTitle

string

Display title at cast time.

  • maxLength: 500

#creditsBallot

object

Quadratic Voting ballot: voice credits spent per proposal. Effective votes are the square root of credits; a sim spends at most 100 credits per run.

Properties

credits

requiredarray
  • maxLength: 100
itemsref
Reference

reasoning

string

The sim's in-character reasoning for this spread.

  • maxLength: 10000
  • maxGraphemes: 5000

#mvfBallot

object

S-Process ballot: one marginal-value function per proposal.

Properties

evaluations

requiredarray
  • maxLength: 100
itemsref
Reference

outsideOptionMilli

integer

Marginal value of keeping a dollar for future rounds, ×1000 (fixed-point: 500 = 0.5).

  • minimum: 0

#mvfEvaluation

object

Properties

mvf

requiredarray

Piecewise-linear marginal value function, points sorted ascending by dollars.

  • maxLength: 20
itemsref
Reference

proposal

requiredstring

AT-URI of the evaluated proposal (org.hypercerts.claim.activity), or a "title:<title>" fallback key when the URI could not be resolved.

proposalTitle

string

Display title at cast time.

  • maxLength: 500

reasoning

string

The sim's in-character reasoning for this curve.

  • maxLength: 10000
  • maxGraphemes: 5000

#mvfPoint

object

Properties

dollars

requiredinteger

Funding level in whole USD.

  • minimum: 0

marginalValueMilli

requiredinteger

Value-per-dollar of the next dollar at this funding level, ×1000 (fixed-point: 1500 = 1.5).

  • minimum: 0

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • org.simocracy.decision

    record

    A published allocation decision for a gathering. Written by the gathering admin to publish the results of an S-Process run (or any allocation mechanism) as the official outcome for a round. Visible to all viewers of the gathering.