dev.knotless.ref

Keyed `<repo key>.<ref hash>`, where the hash is the first 26 characters of the lowercase unpadded base32 SHA-256 of `name`. Written only in the same applyWrites as the dev.knotless.claim for its current generation.

Details · record, key any
Kindrecord
Record keyany
Authorityknotless.dev
Indexed

Showing version bafyreia2vq46kk6zvxsz3typlxjceavfj5y45p6nmqftthglb5r4y5u7we. Show the latest

Record

record · key any

Properties

createdAt

string · datetime

When the ref was made: the same as updatedAt until it first moves.

generation

requiredinteger

Goes up by one each time the ref moves. A new ref starts at the time in milliseconds since the epoch, past any generation an earlier ref of the same name reached; records written before 0.6 started at 1.

  • minimum: 1

name

requiredstring

The full ref name, such as refs/heads/main.

  • maxLength: 1024

pusher

string · did

The account that last moved the ref, when not the repository's owner: a collaborator or runner pushing through the gateway, which sets it from the caller's verified service token. Readers credit it only while the repository names it among its collaborators or runners.

repo

requiredstring · tid

The `key` of the dev.knotless.repo this ref belongs to.

target

string

The hex object ID the ref points at. Absent only from a record a client before 0.6 left of a deleted ref; a delete now deletes the record.

  • minLength: 40
  • maxLength: 64

updatedAt

requiredstring · datetime

When the ref last moved.

Similar lexicons

semantic match

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

  • The move of a ref off one generation: its key is the compare-and-swap, its body the reflog entry.

  • A did-git ref stored in an AT Protocol repository. Each record maps a repository name and ref name (e.g. refs/heads/main) to the hex SHA-256 object ID it points to.

  • A self-contained git packfile: every object reachable from `tips` and not from `bases`.

  • Git repository declaration. Record is owned by the repository owner and record-key is slug of the git repository.