Something went wrong. Try again.
Pilot atproto-native commerce backend
Something went wrong. Try again.
Files
- Rust 96%
- TypeScript 3%
- Shell <1%
- Docker <1%
README.md
# commerce
Lexicons and backend implementation for piloting **ATmospheric commerce**—digital storefronts own their catalog and orders and can move them across the ATmosphere.
**commerce.lgtm.shop** includes:
- generic lexicon definitions
- self-hostable, pluggable backend for atproto storefronts in a single docker image
At this stage, the pilot namespace is **`shop.lgtm.commerce.*`** (on `lgtm.shop`). If this evolves into a proven workflow, we'd like to adopt a neutral standard namespace. See [SPEC.md](./SPEC.md) for the full technical specification.
## Lexicons
Records live in the shop's repo (merchant DID). Permissioned and buyer-owned records move to atproto permissioned spaces over time.
### Public — the shop window
| Lexicon | Description |
| ------------------------------- | ------------------------------------------------------------------------------------------------------ |
| `shop.lgtm.commerce.storefront` | Store identity, branding, currencies, shipping zones, policies (singleton: `self`) |
| `shop.lgtm.commerce.product` | Catalog entries — name, description, images, options; `status` (draft/active/discontinued/archived) |
| `shop.lgtm.commerce.variant` | Purchasable units — SKU, price, option values, `kind`, `availability` (available/sold_out/unavailable) |
### Public — proof (opt-in, keytrace-shaped)
| Lexicon | Description |
| ---------------------------------------- | ------------------------------------------ |
| `shop.lgtm.commerce.purchaseClaim` | Buyer-owned "I bought / I back this" badge |
| `shop.lgtm.commerce.purchaseAttestation` | Shop signature vouching for a claim |
| `shop.lgtm.commerce.attestationKey` | Rotating shop signing key |
### Permissioned — the private counterpart
| Lexicon | Description …