ATP #

A suite of TypeScript libraries for the AT Protocol, built on web standards.

Overview #

This monorepo provides modular, standards-based TypeScript implementations of core AT Protocol components, based on the @atproto NPM packages.

Each package is designed to work across JavaScript runtimes (Deno, Node.js, Bun, Cloudflare Workers) and can be used independently or together.

Packages #

@atp/xrpc-server #

Hono-based XRPC server implementation with lexicon validation, authentication, rate limiting, and WebSocket streaming support. Works across JavaScript runtimes with comprehensive error handling and type safety.

@atp/xrpc #

XRPC client library for calling AT Protocol services with lexicon schema validation.

@atp/sync #

Tools for syncing data from AT Protocol, including firehose (relay) subscriptions with authentication and filtering.

@atp/lex-cli #

Command-line tool for generating documentation, servers, and clients from AT Protocol lexicon files.

@atp/crypto #

Cryptographic primitives for AT Protocol supporting P-256 and K-256 (secp256k1) elliptic curves. Includes key generation, signing, verification, DID key serialization, and hashing utilities.

@atp/identity #

Decentralized identity resolution for DIDs and handles. Resolves handles to DIDs, DIDs to DID documents, and provides caching and verification methods.

@atp/lexicon #

Validation utilities for AT Protocol lexicons. Validates records, XRPC parameters, inputs, and outputs against lexicon schemas.

@atp/repo #

Repository utilities including the Merkle Search Tree (MST) implementation. Handles signed key/value stores with CBOR-encoded data records, CAR files, and repo synchronization.

@atp/syntax #

Validation and parsing for AT Protocol string formats including DIDs, handles, NSIDs, AT URIs, TIDs, record keys, and datetimes.

@atp/common #

Shared utilities for server-oriented applications, including IPLD handling, streams, async helpers, obfuscation, retry logic, and TID generation.

@atp/bytes #

Simple Uint8Array utilities including allocation, comparison, concatenation, string conversion (with multibase encoding support), and XOR operations. Based on the uint8arrays npm package.

Installation #

Each package can be installed independently from JSR:

# deno
deno add jsr:@atp/crypto jsr:@atp/xrpc-server

# pnpm 10.9+
pnpm add jsr:@atp/crypto jsr:@atp/identity jsr:@atp/xrpc

# yarn 4.9+
yarn add jsr:@atp/crypto jsr:@atp/identity jsr:@atp/xrpc

# npm, bun, and older versions of yarn or pnpm
npx jsr add @atp/xrpc-server # replace npx with any of yarn dlx, pnpm dlx, or bunx

Development #

Ensure you have the latest version of Deno installed.

deno test

License #

MIT