Skip to content

Commit 8bd5932

Browse files
committed
clean up account and identity docs
1 parent 77cab3e commit 8bd5932

1 file changed

Lines changed: 6 additions & 14 deletions

File tree

pages/architecture/account-and-identity.md

Lines changed: 6 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ Sign up at [certified.app](https://certified.app). You'll get:
1515

1616
- **Low-friction sign-in** — Sign in with just your email and a code. No passwords or protocol knowledge required.
1717
- **A DID** — Your permanent, portable identifier (e.g., `did:plc:z72i7hdynmk6r22z27h6tvur`). It never changes, even if you switch servers or handles.
18-
- **A PDS** — Your Personal Data Server, where your hypercerts, evaluations, and other records are stored. You own this data.
18+
- **A Repository** — Your own collection on the certified PDS, where your hypercerts, evaluations, and other records are stored. You own this data and you can migrate it between servers.
1919
- **An (embedded) wallet** — Add your existing EVM wallet or get a new one.
2020
- **Ecosystem access** — Your identity works across every Hypercerts application.
2121

@@ -45,7 +45,11 @@ Handles are not needed to log in to the Hypercerts ecosystem, but every user has
4545

4646
**Organizations should use custom domain handles.** A handle like `numpy.org` proves organizational identity — anyone can verify that the DID behind `numpy.org` is controlled by whoever controls the domain.
4747

48-
To set up a custom handle, add a DNS TXT record or host a file at `https://your-domain.com/.well-known/atproto-did`. See the [AT Protocol handle documentation](https://atproto.com/specs/handle) for details.
48+
To set up a custom handle, add a DNS TXT record or host a file at `https://your-domain.com/.well-known/atproto-did`. See the [AT Protocol handle documentation](https://atproto.com/specs/handle) for details and this [tutorial](https://blueskyweb.zendesk.com/hc/en-us/articles/19001802873101-How-to-Set-your-Domain-as-your-Handle) from bluesky for a step-by-step guide.
49+
50+
{% callout type="note" %}
51+
If you sign up using your email on certified.app you will initially be given a random handle like `1lasdk.certified.app`. You can change your handle by going to your profile settings and clicking on "Change handle" on [certified.app](https://certified.app).
52+
{% /callout %}
4953

5054
---
5155

@@ -87,18 +91,6 @@ Never commit app passwords to version control. Use environment variables or a se
8791

8892
---
8993

90-
## Account recovery
91-
92-
Your `did:plc` identity includes a recovery key. If you lose access to your account, you can use this key to prove ownership and regain control.
93-
94-
When you create an account, you'll be prompted to save your recovery key. Store it somewhere safe — a password manager, encrypted backup, or physical paper in a secure location.
95-
96-
{% callout type="warning" %}
97-
Without your recovery key, account recovery is difficult or impossible. Save it when prompted.
98-
{% /callout %}
99-
100-
---
101-
10294
## The app.certified namespace
10395

10496
Beyond identity, Certified contributes shared data schemas to the AT Protocol ecosystem. You'll see `app.certified.*` in some lexicon names — for example, [`app.certified.location`](/lexicons/certified-lexicons/location) defines how geographic locations are represented. These are general-purpose schemas available to any application on AT Protocol, not just Hypercerts.

0 commit comments

Comments
 (0)