Architecture

Components

contracts/   Aiken validators and minting policies
backend/     API, indexer, Keeper, wallet auth and Discord verification
frontend/    React/Vite marketplace and wallet application
discord/     Joi community agent, moderation and role polling
deploy/      Caddy, systemd and VPS operations

Marketplace flow

1. The frontend builds a transaction with Lucid Evolution.
2. The wallet signs and submits it.
3. The backend indexes escrows and updates the market cache.
4. The Keeper closes or settles eligible vaults and auctions.
5. The frontend reads the market snapshot through /api/market.

Trust boundaries

• Wallet keys remain in the wallet.
• The frontend never receives the Keeper private key.
• The backend uses provider APIs and the database, not a user wallet.
• Discord roles are assigned from verified backend records.
• Contract validation is authoritative; off-chain data only helps construct transactions.