View raw

Client Integration

This section shows how to build an application on Hypercerts: signing users in, writing records, and reading them back.

Start with the API reference

The Hypercerts API is available for production reads. Use the XRPC reference and its endpoint explorer to query indexed records. The SDK and additional step-by-step integration guides are still in development; the pages below cover the integration patterns available today.

The integration path#

An application built on Hypercerts typically does the following:

  1. Signs the user in with their AT Protocol account and asks for the permissions it needs.
  2. Creates records with the Hypercerts SDK.
  3. Stores them in the user's Personal Data Server (PDS), the server that hosts the account's records.
  4. Reads and discovers records through the Hypercerts API.
  5. Uses labels and feeds where they help.
  6. Displays connected records, showing who published each one.

Step 2 can use the released Lexicon package and direct AT Protocol writes; the SDK remains under development. Step 4 can use the released Hypercerts API. See Services and tooling for running service endpoints.

Available today#

Building on Hypercerts

Review application patterns and interoperability principles.

Account & Identity Setup

Understand accounts, OAuth, handles, and organization-managed records.

Testing & Deployment

Validate records, test safely, and prepare an integration for production.

Use the Reference for Lexicons and service details.