Mycorrhizal is yet another atproto SDK for Rust. It's the result of a whole bunch of gripes, both major and minor, that I personally have with the existing options. The goal is to have a good API design, good type modeling and integrating well with the Rust ecosystem. Essentially the goal is "correctness" and "being good" as it pertains to my personal flavour of autism ;3

NB #

This is mostly (at least for now) a personal project. It is also very much work in progress. Most stuff is in the beginning design and exploration phase and have been for a while. (Like I said, this is very much me going full autism on caring a lot about the design of something like this). It will likely end up being used in Tranquil as both me and Lewis have had our gripes with the current state of things. But it's likely not something that you will want to use. Not currently at least. Hopefully that changes in the future though!

Project structure #

Mycorrhizal is split up in various crates, each serving a relatively specific purpose:

mycorrhizal-model: Core modeling types for working with atproto. Models both the core atproto data model and the extended Lexicon data model/type system.
- Core data model.
- Lexicon extensions.
mycorrhizal-lexicon: Builds on mycorrhizal-model to provide functionality for dealing with Lexicon files.
- Reading Lexicon files.
- Resolving Lexicon files from NSID
mycorrhizal-xrpc: Models XRPC for type safe use with the tower ecosystem.
- Creating and verifying service auth tokens.
- Common, Tower friendly, types and traits for use both client and server side to call and handle XRPC requests.
- Type safe routing and handlers inspired by Axum.
mycorrhizal-lexgen: Builds on mycorrizhal-lexicon and mycorrizhal-xrpc to support generating Rust code from Lexicon files.
- CLI for classic-style code gen.
- Proc macro based code gen.
mycorrhizal-identity: Models atprotos DID based identities.
- Type modeling for DID documents and the fields within them that atproto cares about.
- DID resolution for did:plc and did:web
- Handle resolution and verification More to come as the goals and my personal needs get fleshed out.