# Mouth

## Docs

- [Backend Architecture](https://docs.mouth.app/architecture/backend.md): API, database, and service design for the Mouth platform.
- [Cron Jobs](https://docs.mouth.app/architecture/cron-jobs.md): Automated background tasks that keep on-chain and off-chain state in sync.
- [Identity & Wallets](https://docs.mouth.app/architecture/identity-and-wallets.md): How Mouth handles user identity via X login and embedded wallets via Privy.
- [Architecture Overview](https://docs.mouth.app/architecture/overview.md): High-level technical architecture of the Mouth protocol.
- [Resolution Engine](https://docs.mouth.app/architecture/resolution-engine.md): How the Mouth resolution engine determines bet outcomes.
- [Testing](https://docs.mouth.app/architecture/testing.md): Smart contract and backend API test suites for the Mouth protocol.
- [X Bot Service](https://docs.mouth.app/architecture/x-bot.md): Technical architecture of the Mouth X bot — tweet parsing, draft challenges, and social notifications.
- [Fee Model](https://docs.mouth.app/fee-model.md): How Mouth charges fees and generates revenue.
- [Accept a Bet](https://docs.mouth.app/flows/accept-bet.md): How to accept an existing bet and lock funds.
- [Create a Bet](https://docs.mouth.app/flows/create-bet.md): How to create a new PvP bet on Mouth.
- [Resolution & Claiming](https://docs.mouth.app/flows/resolution.md): How bets are resolved and how winners claim their funds.
- [X (Twitter) Integration](https://docs.mouth.app/flows/x-integration.md): How Mouth integrates with X for challenge creation, notifications, and social engagement.
- [How It Works](https://docs.mouth.app/how-it-works.md): The complete lifecycle of a Mouth bet, from creation to resolution.
- [Introduction](https://docs.mouth.app/introduction.md): Put your money where your mouth is.
- [MouthBet](https://docs.mouth.app/smart-contracts/bet-contract.md): The individual bet escrow contract deployed for each PvP and Open PvP bet.
- [MouthBetFactory](https://docs.mouth.app/smart-contracts/factory.md): The upgradeable factory contract that deploys and manages individual bet contracts.
- [Smart Contracts Overview](https://docs.mouth.app/smart-contracts/overview.md): Architecture and design of the Mouth smart contracts on Base.

## OpenAPI Specs

- [openapi](https://docs.mouth.app/api-reference/openapi.json)