Skip to content

registry: name the public registry network.auths.dev (one const, no silent default)#398

Merged
bordumb merged 1 commit into
mainfrom
net/public-registry-url
Jul 20, 2026
Merged

registry: name the public registry network.auths.dev (one const, no silent default)#398
bordumb merged 1 commit into
mainfrom
net/public-registry-url

Conversation

@bordumb

@bordumb bordumb commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Names our first-party public registry network.auths.dev and gives it a single home in code, replacing the old dead registry.auths.dev references.

What & why

  • One source of truth: pub const auths_sdk::PUBLIC_REGISTRY_URL = "https://network.auths.dev".
  • Named reference, not a silent default. Registry-touching commands still require an explicit --registry/AUTHS_REGISTRY_URL. Baking ours in as the fallback would make our infrastructure everyone's default and centralize the very network the deploy charts (helm/terraform/compose) exist to let anyone federate — and the core verbs (identity, signing, verification) need no registry at all. Ours is one option a party opts into; running your own is another.
  • Load-bearing, opt-in surfacing: the "no registry configured" error now names ours as the opt-in (… Our public registry is https://network.auths.dev — pass it, or point --registry at your own.), at the CLI boundary so it doesn't touch the frozen AUTHS-E5400 registry.

Rationale comments updated

registration.rs and verify_helpers.rs no longer explain the no-default stance via "it 404s" (incidental). The real reason — federation + offline-first — is now stated, and both reference PUBLIC_REGISTRY_URL.

Stale docs the removed default left behind

The clap --registry args have carried no default_value since the default was removed, but the generated CLI tables and the namespace arg help still advertised a registry.auths.dev default. Corrected to "no default" (), matching what xtask gen-docs produces. Prose guides (sharing-your-identity, github-claims, profiles) reframed from "the default registry … is not yet live" to "no default; use ours or your own."

Deliberately left alone

  • Dated planning docs (docs/plans/roadmap/product_roadmap_20260716.md, GTM docs, .recurve/.../next_plan.md) — rewriting them to say network.auths.dev would falsify what was analyzed at the time.
  • The gitignored mkdocs site/ build — regenerates from docs/.

Naming note

Constant is PUBLIC_REGISTRY_URL, not DEFAULT_REGISTRY_URL — since we decided it is not auto-applied, "DEFAULT" would mislead the next reader. Trivial to rename if preferred.

🤖 Generated with Claude Code

Introduce `auths_sdk::PUBLIC_REGISTRY_URL = "https://network.auths.dev"` as
the single home for our first-party public registry URL, and rename the old
dead `registry.auths.dev` references to it across SDK/CLI doc-comments,
examples, and the current guides.

It is a named reference, not a silent default. Registry-touching commands still
require an explicit --registry/AUTHS_REGISTRY_URL — baking ours in as the
fallback would centralize a network the deploy charts exist to let anyone
federate, and the core verbs need no registry at all. The rationale comments
(registration.rs, verify_helpers.rs) are updated to that reasoning rather than
the old "it 404s" one.

Also correct stale docs the removed default left behind: the generated CLI
tables and namespace arg help showed a `registry.auths.dev` default that no
longer exists — they now read "no default" (—), matching `xtask gen-docs`.
Dated planning docs and the gitignored mkdocs `site/` build are left as-is.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Auths-Scope: sign_commit
Auths-Id: did:keri:EB5cPHY0t-ejNC_rUzPS1dclTvd6kG-R9mQzjozCuGgd
Auths-Device: did:keri:EO1cBsYoV5izKvdIL6TstN5TOQl1hYN3WnhtAOh1lwAp
Auths-Anchor-Seq: 13
@bordumb
bordumb merged commit 8b04bde into main Jul 20, 2026
19 checks passed
@bordumb
bordumb deleted the net/public-registry-url branch July 20, 2026 21:43
@github-actions

Copy link
Copy Markdown

Auths Commit Verification

Commit Status Details
8348b3d1 ✅ Verified Signed by did:keri:EO1cBsYoV5izKvdIL6TstN5TOQl1hYN3WnhtAOh1lwAp

Result: ✅ 1/1 commits verified

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant