# lexdns

> lexdns resolves ATProto Lexicon schemas from NSIDs or schema record URIs through DNS TXT discovery, DID resolution, and ATProto repo.getRecord.

Use lexdns when you need machine-readable ATProto Lexicon schema JSON for a published NSID. The API returns resolution metadata, source links, cache status, trace details, and the resolved `lexicon` object.

## API

- [Full LLM context](https://lex.desertthunder.dev/llms-full.txt): Expanded agent-oriented guide with endpoint details, examples, and response notes.
- [OpenAPI document](https://lex.desertthunder.dev/openapi): Generated API description for all documented JSON endpoints.
- [Resolve a Lexicon by NSID](https://lex.desertthunder.dev/api/resolve/com.atproto.repo.getRecord): Example response for `GET /api/resolve/{nsid}`.
- [Resolve only a Lexicon document](https://lex.desertthunder.dev/api/resolve/com.atproto.repo.getRecord/lexicon): Example response for `GET /api/resolve/{nsid}/lexicon`.
- [Resolve a Lexicon by URI](https://lex.desertthunder.dev/api/uri?uri=at%3A%2F%2Fdid%3Aplc%3Aexample%2Fcom.atproto.lexicon.schema%2Fcom.example.foo): Endpoint shape for resolving AT URIs or HTTPS repo.getRecord URLs passed as `uri`.

## Project

- [GitHub repository](https://github.com/desertthunder/lexdns): Source code, README, development setup, and implementation details.
- [Home page](https://lex.desertthunder.dev/): Interactive resolver UI for trying NSIDs in a browser.

## Optional

- [AT Protocol Lexicon documentation](https://atproto.com/specs/lexicon): Background on ATProto Lexicon schemas.
- [AT Protocol NSID documentation](https://atproto.com/specs/nsid): Background on namespaced identifiers used by Lexicons.