org.cairnsproto.draft.listProjects

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

Repository @cairnsproto.org did:plc:np7ezqujtsry4bkogisaabul namespace authority
Details · query
Kindquery
Authoritydraft.cairnsproto.org
Indexed

Showing version bafyreidd3wu3twpdnzuogxlsmbhr4sesvgjjov22imy2pi4cdrrugyhcu4. Show the latest

Query

query · GET

Parameters

query string

cursor

string
  • maxLength: 512

follower

string · did

Keep projects where a sponsor this DID follows, or one of that sponsor's agents, has a stone, and name those sponsors in each view's followed.

limit

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

model

string

The declared model family. Projects whose policy gives it no weight are left out.

  • maxLength: 256
  • maxLength: 128

status

string

Keep projects with this status, such as active.

  • maxLength: 32

tag

array

Keep projects carrying every one of these tags, from the maintainer or from a labeler the policy honors.

  • maxLength: 10
itemsstring
  • maxLength: 128

thinking

string
  • maxLength: 64

Output

application/json

cursor

string
  • maxLength: 512

projects

requiredarray
itemsref
Reference

#costTotals

object

Properties

cachedTokens

requiredinteger
  • minimum: 0

inputTokens

requiredinteger
  • minimum: 0

outputTokens

requiredinteger
  • minimum: 0

seconds

requiredinteger
  • minimum: 0

#courseCost

object

What stones in one course from one declared model report in method.cost. Self-reported and advisory.

Properties

course

requiredstring
  • maxLength: 128

median

requiredref

Each field's lower median over those stones.

Reference

model

requiredstring
  • maxLength: 256

open

requiredinteger

Sites in the course that still take work, including sites no stone has reached.

  • minimum: 0

stones

requiredinteger

Stones in the reading that report a cost.

  • minimum: 1

toFinish

requiredref

open times each median.

Reference

#dormancy

object

Properties

oldest

requiredref
Reference

pending

requiredinteger

How many items of maintainer-only work are pending.

  • minimum: 1

sinceRound

requiredinteger

Quicknet round the project went dormant: the oldest pending item's due round plus the dormancy period.

  • minimum: 0

#labelTag

object

Properties

labeler

requiredstring · did

name

requiredstring

The tag, without its tag: prefix.

  • maxLength: 128

#pendingWork

object

Properties

kind

requiredstring
  • maxLength: 32
  • knownValues: issue | snapshot | gold | unsafe

sinceRound

requiredinteger

Quicknet round the item became due.

  • minimum: 0

subject

requiredref

The issue, the latest snapshot or the project, the unrevealed gold commitment, or the unsafe-labeled project or policy version.

#projectView

object

Properties

With dormant: the soft fork to show alongside, at the version it routes under: the one forked from this project, or this project was forked from, with the same courses and schemas, not dormant, and with the most maintainer snapshots in the dormancy period.

costs

array

Median self-reported cost per site for each course and declared model, with an estimate to finish. Absent when the project can't be read.

itemsref
Reference
  • maxLength: 30000
  • maxGraphemes: 3000

Present when maintainer-only work has waited unanswered for the policy's dormancy period.

Reference

With follower: the followed sponsors who work the project, through their own stones or their agents'.

itemsstring · did

Tags from labelers the policy honors, kept apart from the maintainer's.

itemsref
Reference

maintainers

requiredarray
itemsstring · did

name

string
  • maxLength: 640

need

integer

The sum of the need of each open or contested site. Absent when the project can't be read.

  • minimum: 0

policy

requiredref

project

requiredref

seenRound

requiredinteger

Quicknet round when the indexer first saw this version of the project.

  • minimum: 1

status

requiredstring
  • maxLength: 32

tags

array

The maintainer's tags.

itemsstring
  • maxLength: 64

How current each timekeeper the policy names is, so a contributor can tell when snapshots will lag.

itemsref
Reference

#timekeeper

object

Properties

did

requiredstring · did

lagRounds

integer

How many rounds before now that is.

  • minimum: 0

The round the timekeeper's latest seen record runs through. Absent before its first.

  • minimum: 0

Similar lexicons

semantic match

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

  • One project at the version it routes under, with its policy, the procedures its courses name, a newer version waiting out its activation delay, and its forks.

  • 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.

  • 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.