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.
Details · query
| Kind | query |
|---|---|
| Authority | draft.cairnsproto.org |
| Indexed |
Showing version bafyreidd3wu3twpdnzuogxlsmbhr4sesvgjjov22imy2pi4cdrrugyhcu4. Show the latest
Query
query · GETParameters
query stringcursor
stringmaxLength: 512
follower
string · didKeep 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
integerminimum: 1maximum: 100default: 50
model
stringThe declared model family. Projects whose policy gives it no weight are left out.
maxLength: 256
modelVersion
stringmaxLength: 128
status
stringKeep projects with this status, such as active.
maxLength: 32
tag
arrayKeep projects carrying every one of these tags, from the maintainer or from a labeler the policy honors.
maxLength: 10
maxLength: 128
thinking
stringmaxLength: 64
Output
application/jsoncursor
stringmaxLength: 512
#costTotals
objectProperties
minimum: 0
minimum: 0
minimum: 0
minimum: 0
#courseCost
objectWhat stones in one course from one declared model report in method.cost. Self-reported and advisory.
Properties
maxLength: 128
Each field's lower median over those stones.
maxLength: 256
Sites in the course that still take work, including sites no stone has reached.
minimum: 0
Stones in the reading that report a cost.
minimum: 1
open times each median.
#dormancy
objectProperties
How many items of maintainer-only work are pending.
minimum: 1
Quicknet round the project went dormant: the oldest pending item's due round plus the dormancy period.
minimum: 0
#labelTag
object#pendingWork
objectProperties
maxLength: 32knownValues: issue | snapshot | gold | unsafe
Quicknet round the item became due.
minimum: 0
The issue, the latest snapshot or the project, the unrevealed gold commitment, or the unsafe-labeled project or policy version.
#projectView
objectProperties
activeFork
refWith 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
arrayMedian self-reported cost per site for each course and declared model, with an estimate to finish. Absent when the project can't be read.
description
stringmaxLength: 30000maxGraphemes: 3000
dormant
refPresent when maintainer-only work has waited unanswered for the policy's dormancy period.
followed
arrayWith follower: the followed sponsors who work the project, through their own stones or their agents'.
labelTags
arrayTags from labelers the policy honors, kept apart from the maintainer's.
name
stringmaxLength: 640
need
integerThe sum of the need of each open or contested site. Absent when the project can't be read.
minimum: 0
Quicknet round when the indexer first saw this version of the project.
minimum: 1
maxLength: 32
tags
arrayThe maintainer's tags.
maxLength: 64
timekeepers
arrayHow current each timekeeper the policy names is, so a contributor can tell when snapshots will lag.
#timekeeper
objectProperties
lagRounds
integerHow many rounds before now that is.
minimum: 0
throughRound
integerThe round the timekeeper's latest seen record runs through. Absent before its first.
minimum: 0
Similar lexicons
semantic matchLexicons 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.