You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Delete the SDK page (pages/tools/sdk.md) and remove all mentions of
the Hypercerts SDK across 28 files. Code examples now use @atproto/api
directly instead of @hypercerts-org/sdk-core. Navigation and index
cards updated accordingly. Build passes cleanly.
Copy file name to clipboardExpand all lines: pages/architecture/account-and-identity.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -63,7 +63,7 @@ To set up an organizational account, create an account at [certified.app](https:
63
63
64
64
### OAuth (for applications)
65
65
66
-
Applications authenticate users via AT Protocol OAuth. The [Hypercerts SDK](/tools/sdk) handles the full OAuth flow — authorization, token management, and session restoration. Users authorize your app through their PDS and never share credentials with your application. See the [Quickstart](/getting-started/quickstart) for the SDK setup.
66
+
Applications authenticate users via AT Protocol OAuth. The AT Protocol client libraries handle the full OAuth flow — authorization, token management, and session restoration. Users authorize your app through their PDS and never share credentials with your application. See the [Quickstart](/getting-started/quickstart) for the authentication setup.
Copy file name to clipboardExpand all lines: pages/architecture/overview.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,7 +13,7 @@ The protocol operates across three layers that work together to enable portable
13
13
14
14
The **Data Layer** is the foundation. AT Protocol stores claims, attachments, and evaluations. Personal Data Servers (PDS) host user-controlled records — organizations can create dedicated PDS accounts for shared repositories. Relays aggregate data across servers. Indexers build queryable views that applications consume.
15
15
16
-
The **Application Layer** sits on top of the data layer. Funding platforms, dashboards, and evaluation tools live here. These applications read from and write to the data layer using the [Hypercerts SDK](/tools/sdk) and [Hyperindex](/tools/hyperindex).
16
+
The **Application Layer** sits on top of the data layer. Funding platforms, dashboards, and evaluation tools live here. These applications read from and write to the data layer using the [ATProto API](https://atproto.com/docs) and [Hyperindex](/tools/hyperindex).
17
17
18
18
The **Ownership Layer** is planned but not yet implemented. The intended design uses a freeze-then-fund model where hypercerts are frozen and anchored on-chain before funding — ensuring funders know exactly what they are paying for. See [Funding & Value Flow](/core-concepts/funding-and-value-flow) for details.
Copy file name to clipboardExpand all lines: pages/core-concepts/hypercerts-core-data-model.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,7 +24,7 @@ Every hypercert starts with an **activity claim** — the central record that an
24
24
25
25
In addition to these core dimensions, the activity claim can define the rights that come with this claim. The basic right is just "public display", e.g. bragging rights about financial or non-financial contributions to impact. If the hypercert is tokenized, the field can define how the hypercert is allowed to be transferred.
26
26
27
-
The activity claim is what you create when you call `repo.hypercerts.create()` in the SDK. It gets a permanent AT-URI like `at://did:plc:alice123/org.hypercerts.claim.activity/3k7`.
27
+
The activity claim is the core record you create when making a hypercert. It gets a permanent AT-URI like `at://did:plc:alice123/org.hypercerts.claim.activity/3k7`.
description:"Identified and patched a session fixation vulnerability in the OAuth callback handler.",
158
+
workScope: { allOf: ["Security", "Bug Fix"] },
159
+
startDate:"2026-01-15T00:00:00Z",
160
+
endDate:"2026-01-20T23:59:59Z",
161
+
$type:"org.hypercerts.claim.activity",
162
+
createdAt:newDate().toISOString(),
155
163
},
156
-
contributions: [
157
-
{
158
-
contributors: [contributorDid],
159
-
contributionDetails:"Bug fix author",
160
-
weight:"100",
161
-
},
162
-
],
163
164
});
164
165
```
165
166
@@ -239,15 +240,6 @@ Propose changes to lexicons through the standard process:
239
240
The GitHub repository for lexicon proposals will be available soon. Check the [Hypercerts GitHub](https://github.com/hypercerts-org) for updates.
240
241
{% /callout %}
241
242
242
-
### SDK Contributions
243
-
244
-
The Hypercerts SDK is open source. Contributions welcome:
245
-
246
-
- Bug fixes and performance improvements
247
-
- New helper functions for common operations
248
-
- Better TypeScript types and documentation
249
-
- Examples and tutorials
250
-
251
243
### Running a Relay
252
244
253
245
Help decentralize the network by running a relay node. Relays aggregate events from PDSs and make them available to indexers.
Copy file name to clipboardExpand all lines: pages/getting-started/common-use-cases.md
+54-92Lines changed: 54 additions & 92 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,48 +5,31 @@ description: See how hypercerts work for different types of contributions.
5
5
6
6
# Common Use Cases
7
7
8
-
Hypercerts work for any kind of impact work. This page shows four common scenarios with real SDK code.
8
+
Hypercerts work for any kind of impact work. This page shows four common scenarios with code examples.
9
9
10
10
## Open-source software maintenance
11
11
12
12
A team maintains a widely-used library. They create a hypercert covering a year of maintenance — bug fixes, documentation updates, and community support.
@@ -57,25 +40,19 @@ After creating the hypercert, the team attaches links to the repository, release
57
40
A conservation group restores degraded forest over several years. They document the work with location data and measurements.
58
41
59
42
```typescript
60
-
const result =awaitrepo.hypercerts.create({
61
-
title: "Forest restoration project, 2020–2025",
62
-
shortDescription: "Reforestation and biodiversity recovery in degraded tropical forest",
63
-
description: "Restored 200 hectares of degraded tropical forest through native species planting, invasive species removal, and community stewardship programs.",
description: "Right to publicly display this contribution",
43
+
const result =awaitagent.com.atproto.repo.createRecord({
44
+
repo: agent.session.did,
45
+
collection: "org.hypercerts.claim.activity",
46
+
record: {
47
+
title: "Forest restoration project, 2020–2025",
48
+
shortDescription: "Reforestation and biodiversity recovery in degraded tropical forest",
49
+
description: "Restored 200 hectares of degraded tropical forest through native species planting, invasive species removal, and community stewardship programs.",
shortDescription: "Novel approaches to improving therapeutic delivery",
92
-
description: "Developed and tested three novel nanoparticle-based drug delivery mechanisms, resulting in two published papers and one patent application.",
93
-
workScope: "Biomedical Research, Drug Delivery",
94
-
startDate: "2022-03-01T00:00:00Z",
95
-
endDate: "2024-11-30T23:59:59Z",
96
-
rights: {
97
-
name: "Public Display",
98
-
type: "display",
99
-
description: "Right to publicly display this contribution",
66
+
const result =awaitagent.com.atproto.repo.createRecord({
shortDescription: "Novel approaches to improving therapeutic delivery",
72
+
description: "Developed and tested three novel nanoparticle-based drug delivery mechanisms, resulting in two published papers and one patent application.",
@@ -125,17 +86,18 @@ Attachments link to the published paper (via DOI), lab notebooks, and experiment
125
86
A group runs regular workshops teaching practical skills to underrepresented communities. They want to document their educational impact.
126
87
127
88
```typescript
128
-
const result =awaitrepo.hypercerts.create({
129
-
title: "Community workshops, 2025",
130
-
shortDescription: "Free skill-building workshops for underrepresented groups",
131
-
description: "Organized and delivered 24 free workshops covering web development, data literacy, and career skills to 450 participants from underrepresented communities.",
132
-
workScope: "Education, Community Building",
133
-
startDate: "2025-01-01T00:00:00Z",
134
-
endDate: "2025-12-31T23:59:59Z",
135
-
rights: {
136
-
name: "Public Display",
137
-
type: "display",
138
-
description: "Right to publicly display this contribution",
89
+
const result =awaitagent.com.atproto.repo.createRecord({
90
+
repo: agent.session.did,
91
+
collection: "org.hypercerts.claim.activity",
92
+
record: {
93
+
title: "Community workshops, 2025",
94
+
shortDescription: "Free skill-building workshops for underrepresented groups",
95
+
description: "Organized and delivered 24 free workshops covering web development, data literacy, and career skills to 450 participants from underrepresented communities.",
0 commit comments