Skip to content

System Diagrams โ€‹

High-level architecture and flow diagrams for Stratos.

System Architecture โ€‹

๐Ÿ—„๏ธ
User PDS
pds.bsky.social
โš™๏ธ
Stratos Service
API ยท OAuth ยท repo
๐Ÿ“ก
AppView
zone.stratos.feed.*
๐Ÿ”
DID Resolver
PLC ยท did:web
๐Ÿ“ฆ
Blob Storage
disk or S3
๐Ÿ›ข๏ธ
PostgreSQL
indexed records

Record Hydration Sequence โ€‹

๐Ÿ“ฑ
AppView
appview.example.com
full record โœ“
๐Ÿ—„๏ธ
PDS
pds.bsky.social
has stub record
โš™๏ธ
Stratos Service
stratos.example.com
holds full records
๐Ÿ“‹stub record
โ†’ stratos.example.com
๐Ÿ”DPoP token
user auth
๐Ÿ”verifying auth
โŠ“checking boundaries
๐Ÿ“ฆhydrated record
full content + metadata

Enrollment & Allowlist Mechanism โ€‹

๐Ÿง‘
User
OAuth request
โš™๏ธ
Stratos Service
enrollment
โœ…
Eligibility Check
DID ยท PDS ยท external
๐Ÿ—„๏ธ
User PDS
enrollment record

Indexer Sync Architecture โ€‹

๐Ÿ”ฅ
PDS Firehose
subscribeRepos
โš™๏ธ
Stratos Stream
subscribeRecords
๐Ÿ”„
Indexer
stratos-indexer
๐Ÿ›ข๏ธ
PostgreSQL
stratos_post ยท boundaries
๐Ÿ“ก
AppView
zone.stratos.feed.*