proto-blue 0.3.3

AT Protocol SDK for Rust — full-stack client for Bluesky and the AT Protocol
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

# 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:

```toml
[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

```rust
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](https://github.com/dollspace-gay/proto-blue) AT Protocol SDK for Rust.