ewan's projects — docs

projects

atpkt

May 30, 2026

# kotlin# atprotocol# sdk

atpkt

A professional-grade, modular ATProtocol SDK for Kotlin.

Overview

atpkt provides the foundational building blocks for interacting with the Authenticated Transfer Protocol (AT Protocol). Designed with a library-first architecture, it decouples core networking, authentication, and repository management logic from specific service implementations.

Architecture

atpkt follows the official ATProtocol "Agent" design:

  • Core Library: Networking, XRPC client, and Session management.
  • Namespaced API: Hierarchical access to protocol endpoints (e.g., agent.com.atproto.*, agent.app.bsky.*).
  • Lexicon Registry: Auto-generation of type-safe Kotlin models from official schema definitions (using KotlinPoet).
  • Repository Foundations: Content-addressed storage and Merkle Search Tree (MST) structures.
  • Streaming: Reactive, authenticated WebSocket subscription client.

Roadmap

  • Core extraction (Tid, AtProtoClient, SessionManager, RecordManager)
  • Namespaced API structure
  • AST-driven Lexicon generation (KotlinPoet)
  • MST & CID foundations
  • WebSocket Subscription (Firehose) support
  • DID/PLC Identity resolution
  • OAuth2 / DPoP compliance

← all docs