bluesky-social/atproto
Atproto
atproto is a decentralized social networking protocol implementation and a schema-driven API framework. It provides the networking and data standards required to build interoperable social networks where users control their own identity and data through a personal data server specification.
The project distinguishes itself through a DID-based identity system for managing cryptographic keys and verifiable profiles, alongside a lexicon-based protocol definition that uses versioned schemas to ensure consistency across network services. It utilizes Merkle Search Trees for verifiable data storage, enabling efficient synchronization of signed record repositories.
The framework covers a broad set of capabilities, including decentralized identity resolution, remote procedure call orchestration, and social content management. It also includes systems for content moderation via labelers, social graph management for followers and following lists, and binary data serialization using CBOR.
Developer utilities are provided for schema-based code generation and protocol interoperability validation to ensure implementations comply with official specifications.
Features
- Decentralized Social Networks - Implements the networking and data rules required to build and operate a decentralized social network.
- Personal Data Servers - Provides a personal data server specification for hosting user-owned repositories of social content and identity.
- Social Connection Management - Manages followers and following lists to track social connections between users.
- Verifiable Storage - Uses Merkle Search Trees to provide cryptographic proofs of data integrity and efficient synchronization across mirrors.
- Schema Definition - Implements a specialized schema definition language to version and validate data structures across implementations.
- Decentralized Repository Managers - Provides the ability to create, retrieve, update, and delete records within decentralized data repositories.
- Signed - Stores CBOR-encoded records in a signed structure to ensure data integrity and authenticity.
- Social Content Retrievers - Implements decentralized social content management for creating and retrieving posts, threads, and feeds.
- Merkle Tree Synchronizations - Synchronizes and verifies versioned data repositories using Merkle Search Tree diffing.
- Federated API Standards - Provides a framework for creating interoperable network services using standardized schemas and remote procedure calls.
- Personal Data Server Interfaces - Provides client and server interfaces designed to interact with personal data servers via standardized communication.
- Remote Procedure Calls - Provides the ability to build and consume remote procedure calls using standardized communication formats.
- Schema-Driven Executions - Enables remote procedure calls to be executed following schema definitions for parameters and output formats.
- Remote Procedure Invocation Systems - Enables the invocation of queries and procedures defined in schemas to interact with network services.
- Signed Data Repositories - Ensures data integrity and authenticity by storing cryptographically signed key-value pairs within user-owned data repositories.
- Decentralized Identifier Resolution - Translates decentralized identifiers and handles into network addresses using a distributed identity system.
- Handle to DID Translations - The process of translating human-readable handles into decentralized identifiers to locate identity records.
- Decentralized Social Transfer Standards - Implements typed networking and data standards for information movement across decentralized social networks.
- Identity & Key Management - Implements a system for verifying ownership by signing data, serializing keys, and resolving decentralized identifiers.
- Decentralized Identifier Resolution - Implements decentralized identity resolution for mapping human-readable handles to cryptographic identifiers.
- Decentralized Identity Frameworks - Provides a DID-based identity system for managing cryptographic keys and verifiable user profiles.
- Lexicon-Based API Definitions - Defines network-wide data structures and remote procedure calls using a versioned schema system.
- Merkle-Tree Storage Engines - Organizes repository data in a verifiable Merkle Search Tree to enable efficient synchronization.
- Merkle-Tree Data Integrity - Uses verifiable tree structures to ensure account data consistency across network mirrors.
- Schema-Driven API Generators - Produces type-safe validation and builder utilities from JSON schema files to ensure consistency across network services.
- Content Moderation Tools - Implements labelers and filters to manage content visibility and user block lists across the network.
- API Mutation Atomic Batches - Allows performing multiple record operations atomically in a single request to ensure data consistency.
- Data Schema Management - Implements a system to fetch and update network-defined data schemas to maintain version consistency.
- TypeScript Type Generators - Produces type-safe validation and builder utilities from JSON schema files for TypeScript environments.
- Protocol Package Generators - Provides utilities to generate typed packages from definition files to synchronize specifications with implementation.
- Schema-Based Code Generators - Ships a command-line tool to produce code and documentation from schema files.
- Binary Data Encoding - Uses CBOR to serialize data structures into a compact binary format for efficient transport and storage.
- Protocol Server Communications - Facilitates the exchange of requests and responses with remote servers using standardized networking protocols.
- RPC Orchestrations - Combines multiple low-level schema-defined requests into high-level operations to simplify interactions.
- URI Construction and Parsing - Processes and validates identifier syntaxes such as URIs, handles, and network IDs.
- Identity Document Caching - Fetches and caches identity documents associated with decentralized identifiers to optimize repeat lookups.
- User Profile Management - Provides the ability to create, update, and search for user account identity information and handles.
- OAuth 2.0 Authorization Flows - Executes delegated authorization routines using the standard protocol for third-party access.
- DID Key Serialization - Converts public keys into strings that include the metadata required for decentralized identification.
- Moderation Labeler Configurations - Allows clients to configure trusted labeler lists to handle content moderation.
- Session Authentication - Maintains user session state using application passwords or authorization flows.
- Data Encoders and Decoders - Provides utilities for converting data structures between JSON, CBOR, and internal types for transport.
- Data Schema Validation - Provides systems for enforcing type safety and data consistency through schema-based validation of records and parameters.
- Identifier Validations - Enforces correct syntax for handles and decentralized identifiers based on protocol specifications.
- Protocol Method Conventions - Implements a system for invoking specific methods and recording operations using standardized naming conventions.
- RPC Action Orchestrators - Provides a mechanism to combine multiple low-level remote procedure calls into single high-level operations.
- API Interoperability Validation - Provides a test suite to verify that different implementations comply with the official protocol specifications.
- API Servers - Provides a server implementation that validates requests and responses using predefined schemas.
- Authenticity Verification - Provides a process to confirm that a user session is active and retrieve the unique identifier of the user.
- Schema Validation - Implements processes to verify data structures against official schema definitions using validation logic.
