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, or a labeler the caller names, marks unsafe are left out.
Details · query
| Kind | query |
|---|---|
| Authority | draft.cairnsproto.org |
| Commit rev | 3mzxyqlmgl32l |
| Indexed |
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.
label
stringKeep projects that a labeler named in labeler marks with this value, such as featured.
maxLength: 128
labeler
arrayLabelers the caller honors on top of each policy's, as a consumer overlay. Their unsafe hides a project and their other labels are listed under consumerLabels. The indexer serves only labelers its operator tracks and rejects others.
maxLength: 4
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
#consumerLabel
object#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.
#courseProgress
objectEach site of one course in exactly one of open, contested, ambiguous, belowExport, pastExport and held. diverges counts the sites whose leading value differs from the official repo's, whatever their bucket.
Properties
minimum: 0
minimum: 0
minimum: 0
maxLength: 128
minimum: 0
minimum: 0
minimum: 0
minimum: 0
#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#labelerState
objectProperties
error
stringWhy the last fetch failed, if it did.
maxLength: 1000
Whether a fetch from this labeler has ever succeeded.
refreshedAt
string · datetimeWhen the last successful fetch finished.
#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.
anyModel
booleanWhether the policy gives weight to models it doesn't list.
consumerLabels
arrayWith labeler: labels in force on the project or its policy from the labelers the caller named.
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.
license
stringThe license of the official repo's published data.
maxLength: 512
modelFamilies
arrayModel families the policy gives weight, sorted.
maxLength: 256
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
progress
arraySite counts per course, in the project's course order, from the reading need comes from. Left out when that reading fails.
publishRepo
stringThe Git URL of the official repo exports are published to.
maxLength: 2048
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.