Adding dev docs

This commit is contained in:
Chris Troutner
2026-06-02 16:54:13 -07:00
parent 90e0722304
commit c1a841c60e
7 changed files with 823 additions and 0 deletions
+24
View File
@@ -0,0 +1,24 @@
# Memo Indexer Developer Documentation
This directory documents the architecture, operation, and design rationale for the Permissionless Software Foundation Memo indexing stack:
| Repository | Role |
|------------|------|
| [psf-memo-db](../../psf-memo-db) | LevelDB persistence exposed as a REST API |
| [psf-memo-indexer](../) | Block and mempool indexer (this repo) |
Protocol reference: [memo-protocol.md](../../memo-protocol.md). Reference implementation: [memo/index](../../index) (Go).
## Reading order
1. **[Overview](./overview.md)** — Why these services exist and what they produce
2. **[Architecture](./architecture.md)** — Components, processes, Clean Architecture layout, data flow
3. **[Theory of operation](./theory-of-operation.md)** — IBD, ZMQ, parsing, indexing pipeline step-by-step
4. **[psf-memo-db](./psf-memo-db.md)** — Database service design and REST contract
5. **[Design decisions and tradeoffs](./design-decisions-and-tradeoffs.md)** — Comparisons to SLP and the Go indexer, scope limits, future work
## Related material
- Production deployment: [production/docker](../production/docker/)
- SLP analogue: [psf-slp-indexer-g2](https://github.com/Permissionless-Software-Foundation/psf-slp-indexer-g2) and [psf-slp-db](https://github.com/Permissionless-Software-Foundation/psf-slp-db)
- Clean Architecture primer: [Chris Troutner — Clean Architecture](https://christroutner.github.io/trouts-blog/blog/clean-architecture)