Sidequest MCP Server

Sidequest

Sidequest is an open job protocol on Monad with a hosted board and explorer. A creator publishes an escrow-backed hire, a worker activates against frozen terms, and the chain records review, disputes, bonds and settlement. The board prepares wallet actions; it never holds user keys or replaces chain state. V1 is the only supported protocol.

Stages

The stage profile in infra/<stage>.json selects the origin, chain, relay, Telegram bot and Cloudflare resources. The single testnet contract pair is deployment.main of kind sidequest-v1; addresses come from contracts/config/monad-testnet.json. Mainnet is a future, separately approved stage change.

Layout

apps/api/       hosted board API and MCP Worker
apps/indexer/   chain indexer Worker
apps/explore/   browser marketplace and explorer
apps/arbiter/   arbitration daemon
apps/docs/      Fumadocs/TanStack documentation site
packages/sdk/   typed client and v1 flow library
packages/board/ board domain and persistence contracts
packages/indexer/ indexing and notification domain logic
packages/react/ React hooks for the client
contracts/      Sidequest v1 Foundry contracts and scripts
tools/          graph, lint, migration and agent quality gates
docs/           protocol law, ADRs, runbooks and dated evidence

Runtime classes and import edges are declared in tools/graph.ts. Read the matching workspace AGENTS.md before editing a workspace.

Work and promotion

Work on dev; there is no main. A push to dev runs CI verification and the guarded dev deploy. Promote only an accepted SHA with Kris's approval: git push origin <green-dev-sha>:prod. Never run a prod release or push prod without that approval. The release guard rejects replacements, deletes and orphaned resources, and uses the shared remote Alchemy state store with a version check.

Daily commands

bun install
bun run check:files <owned paths>
bun run agents:check
bun run graph
bun run typecheck
bun run lint:gate
bunx turbo run test --filter <workspace>
bun run deploy:dev
bun run plan dev
bun run smoke dev

Use heavy for a command that may take over a minute. Exit 75 means the shared box is busy; retry after it clears. Never pipe heavy. Do not run fork, live, browser, Playwright or end-to-end tests in a cleanup lane.

Secrets

Local stage values are in mode-600 ~/.config/sidequest/dev.env and ~/.config/sidequest/prod.env; local flow and test keys belong in .env.local; CI uses the GitHub dev and prod environments. Never print, commit or place secrets in notes, logs, URLs, branch names or artifacts. Release commands disable Bun's automatic env-file loading.

Docs index

• Protocol law — invariants and v1 rules.
• Stages — origins, networks, resources and release history.
• Deploy — CI, Alchemy state, secrets, webhooks, rollback and incidents.
• ADRs — durable decisions, including toolchain and stage policy.
• Mainnet runbook — gated launch procedure; every transaction needs Kris's explicit go.
• Reality check — dated live evidence and its limits.
• Glossary — terms used by code and docs.