mars
Read the spec
v1.0 · publishedMARS-QL · stableMARS-S · sharding draft16 REST endpointsWebSocket subscriptionsSigil anchoredFROST t-of-nv1.0 · publishedMARS-QL · stableMARS-S · sharding draft16 REST endpointsWebSocket subscriptionsSigil anchoredFROST t-of-nv1.0 · publishedMARS-QL · stableMARS-S · sharding draft16 REST endpointsWebSocket subscriptionsSigil anchoredFROST t-of-nv1.0 · publishedMARS-QL · stableMARS-S · sharding draft16 REST endpointsWebSocket subscriptionsSigil anchoredFROST t-of-n
M
A
R
S

The federated registry for every autonomous entity — agents, tools, skills, models, datasets, services. Cryptographically rooted in humans.

Read MARS v1.0Browse via Reggiereggie.ml
publishedFeb 2026
statusv1.0 · stable
licenseCC BY 4.0
targetIETF RFC
two-tier storage

Anchored on chain.
Stored off chain.

The Sigil chain stores only the smallest possible commitment — a content hash and a publisher bond. The full entry lives in the Weave DHT, where reads are fast and replicas are plenty.

  • Tier 1 — Sigil anchor (immutable)
  • Tier 2 — Weave DHT (eventually consistent)
  • Tier 3 — Optional CDN cache
SIGIL · IMMUTABLE ANCHORSWEAVE DHT · MUTABLE BYTESblk-1084219blk-1084220blk-1084221blk-1084222blk-1084223sha256:a2b9…sha256:c01f…sha256:0ff4…sha256:ee21…sha256:14b9…3-replica fan-out, primary + 2 shadow shards
entity lifecycle

Seven verbs, one ledger. Auditable forever.

01

Register

Publisher signs entry, posts bond, submits to home registry. Hash anchored on Sigil.

02

Resolve

Three-hop cascade — local shard → regional cluster → global anchor. P50 < 12 ms.

03

Discover

MARS-QL queries fan out across federated peers. Results ranked by attestation density.

04

Update

New version replaces previous. Old versions remain resolvable indefinitely.

05

Attest

Auditors sign attestations attached to entries. Build-reproducibility, license, malware, more.

06

Transfer

Ownership moves between DIDs with mutual signatures. Lineage chain extends.

07

Revoke

Bond gets slashed. Anchor flagged. Resolution returns 410 Gone with revocation reason.

api surface

16 endpoints. No more.

The MARS REST API is intentionally small. Every protocol behavior maps to a single endpoint — no hidden composition, no batched magic, no GraphQL maze.

Full reference → docs.mars.glass/api
  • GET/v1/health
  • POST/v1/entries
  • GET/v1/entries/:did
  • GET/v1/entries/:did/versions
  • PUT/v1/entries/:did
  • DELETE/v1/entries/:did
  • POST/v1/discover
  • POST/v1/discover/marsql
  • GET/v1/lineage/:did
  • POST/v1/transfer/:did
  • POST/v1/attestations
  • GET/v1/attestations/:did
  • POST/v1/report
  • GET/v1/registries
  • POST/v1/federate/sync
  • GET/v1/events (ws)
mars-ql

SQL.
Made for agents.

MARS-QL is a SQL-superset designed for graph traversal across registry entries. Lineage chains, attestation joins, recursive CTEs — everything you expect, with first-class DID semantics.

spec: §11 · grammar at /marsql/grammar

Find every embedding model published this year

mars-ql
SELECT entry_did, version, publisher_did
FROM entries
WHERE entry_type = 'model'
  AND tags CONTAINS 'embed'
  AND published_at >= '2026-01-01'
ORDER BY attestation_count DESC
LIMIT 50;

Find agents with three or more independent attestations

mars-ql
SELECT entry_did
FROM entries
WHERE entry_type = 'agent'
  AND attestation_count(distinct attester) >= 3;

Lineage descendants of a given HMR

mars-ql
WITH RECURSIVE descendants(did) AS (
  SELECT 'did:oas:l1fe:hmr:jared-rice'
  UNION
  SELECT child.did FROM lineage child, descendants
  WHERE child.parent = descendants.did
)
SELECT * FROM descendants;
cli + tui

Two ways. Both yours.

mars · CLI

brew install mars-cli
$ mars resolve did:oas:l1fe:agent:web-research
✓ resolved 4 hops · 8.2 ms
publisher: did:oas:l1fe:hmr:jared-rice
bond: 5 MINTS · healthy
attestations: 6 · independent
$ mars discover --kind agent --tag rag --limit 10
412 results across 184 federated registries
$ mars federate --add hive.openagent.id
✓ federation handshake complete · 312,004 entries
Single static binary. Works offline.All commands →

mars · TUI

mars tui
╭─ MARS · live ─────────────────────────╮
│ ▶ entries     1,044,220               │
│   federated     184 peers             │
│   uptime      99.997% · 90d           │
├───────────────────────────────────────┤
│ ▼ recent                              │
│   agt  l1fe/research/web-research     │
│   skl  l1fe/skill/arxiv-cite          │
│   mdl  openagent/embed/qwen3          │
│   tol  verbage/tool/email-fetch       │
│   ...                                 │
├───────────────────────────────────────┤
│ ▼ alerts                              │
│   ! bond expiring in 2d ·  l1fe/...   │
│   ! 3 attestations needed             │
╰─ q quit  / search  : command  ────────╯
Built on agent-tui-kit. Vim-style nav.Screencast →
implement mars

run
the
protocol.

The reference server is open source. The CLI ships statically. The protocol is forever yours.

git clone github.com/l1felabs/marsRead MARS v1.0