Lexicon Garden

org.cairnsproto.draft.listDraws

Sites a sponsor holds a deliverable draw for: the newest epoch whose retrace window is still open and whose beacon draws the sponsor, for sites not yet past their export bar, in projects where the declared model counts, where the sponsor is eligible and the draw hash falls under the escalated threshold. Each draw carries what a client needs to verify it and do the work. Course-0 sites nobody has opened are listed separately under open, since a first read needs no draw.

Repository @cairnsproto.org did:plc:np7ezqujtsry4bkogisaabul namespace authority
Details · query
Kindquery
Authoritydraft.cairnsproto.org
Indexed
Compare Edit in builder → Fork →

Query

query · GET

Parameters

query string

limit

integer
  • minimum: 1
  • maximum: 100
  • default: 50

model

string

The declared model family. Projects whose policy gives it no weight are left out; without it, the weight of a stone with no model applies.

  • maxLength: 256

modelVersion

string
  • maxLength: 128

project

string · at-uri

Limit to one project.

site

string

Limit to one site key, as 64 lowercase hex digits.

  • minLength: 64
  • maxLength: 64

sponsor

requiredstring · did

thinking

string
  • maxLength: 64

Output

application/json

beacons

requiredarray

The beacons the draws used. Projects with different epoch lengths draw from different rounds.

draws

requiredarray
itemsref
Reference

open

array

Sites no stone has reached yet, in projects where the declared model counts: root-course sites, and child sites a split course opened on a parent value past the open-children bar. A first read needs no draw and earns full credit, so anyone may open them.

itemsref
Reference

sponsor

requiredstring · did

versions

array

For each project listed, the version draws and open sites were routed under, and a newer version still waiting out its activation delay.

itemsref
Reference

#draw

object

Properties

beaconRound

requiredinteger
  • minimum: 1

course

string

The id of the course whose schema the site has.

  • maxLength: 128

drawKey

string · did

Under mergeOrgs, the org unit the beacon drew, when it isn't the sponsor itself; the draw hash is over this DID.

epoch

requiredinteger

The epoch under the project's policy.

  • minimum: 1

project

requiredref
Reference

site

requiredref
Reference

sources

requiredarray

Source hashes the site's chain starts from.

itemsref
Reference

state

requiredstring
  • maxLength: 32

thresholdPpm

requiredinteger
  • minimum: 0
  • maximum: 1000000

#openSite

object

Properties

course

requiredstring
  • maxLength: 128

project

requiredref
Reference

site

requiredref
Reference

sources

requiredarray

The sources the site's chain starts from.

itemsref
Reference

value

requiredref

The site itself: base, mark and schema.

Reference

#pendingVersion

object

Properties

activatesRound

requiredinteger

The drand round from which the newer version is in effect.

  • minimum: 0

cid

requiredstring · cid

#routedVersion

object

Properties

costs

array

Median self-reported cost per site for each course and declared model in the routed version, with an estimate to finish.

pending

ref
Reference

project

requiredref

The version in effect for routing.

Reference

Similar lexicons

semantic match

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

  • org.cairnsproto.draft.listProjects

    query

    Projects the indexer has seen, each at the version it routes under, ranked by need, highest first. Projects a labeler the policy honors, or a labeler the caller names, marks unsafe are left out.

  • org.cairnsproto.draft.getReading

    query

    The current reading of a project under its policy, with the inputs a client needs to recompute it: every input record's URI, CID and first-seen epoch, and the beacons its draw claims used.