proto-blue 0.3.1

AT Protocol SDK for Rust — full-stack client for Bluesky and the AT Protocol
Documentation

proto-blue

Full-stack AT Protocol SDK for Rust.

This is the top-level facade crate that re-exports all proto-blue modules. Add a single dependency to get the entire SDK:

[dependencies]
proto-blue = "0.3"

Since v0.3.0, the api module's Agent / Session / LabelerOpts public surface uses validated syntax newtypes (Did, Handle, AtIdentifier, AtUri) and lex_data::Cid instead of String / &str. Wire format is unchanged — wrap at the call site with Did::new(s)?, Handle::new(s)?, etc.

Modules

Module Description
syntax Identifier types: DID, Handle, NSID, AT-URI, TID, RecordKey, Datetime
crypto P-256/K-256 key pairs, signing, did:key, SHA-256
lex_data Core Lexicon data model: LexValue, BlobRef, Cid
lex_cbor DAG-CBOR encoding/decoding
lex_json JSON ↔ Lexicon conversion
common DID document parsing, TID generation, retry helpers
lexicon Lexicon schema registry and validation
repo Merkle Search Tree, CAR files, block storage
xrpc XRPC HTTP client
ws Auto-reconnecting WebSocket client
identity DID and handle resolution with caching
api Agent, rich text, moderation, session management
oauth OAuth 2.0: DPoP, PKCE, PAR, token management

Usage

use proto_blue::api::Agent;
use proto_blue::syntax::{AtIdentifier, Did, Handle};
use proto_blue::oauth::OAuthClient;

# async fn demo() -> Result<(), Box<dyn std::error::Error>> {
let agent = Agent::new("https://bsky.social")?;
let id = AtIdentifier::new("alice.bsky.social")?;
agent.login(&id, "app-password").await?;
# Ok(()) }

License

Licensed under MIT OR Apache-2.0.

Part of the proto-blue AT Protocol SDK for Rust.