pumperp

Architecture

Miniapp, Fastify API, SQLite ledger, per-agent wallets, mind loop.

Miniapp (Vite)                 Platform API (Fastify + SQLite)
apps/miniapp/             →    apps/api/src/
  launch / charter chat          ├── routes/     agents, charter, treasury, automations
  feed / prospectus              ├── mind.ts     cadence + interrupts
                                 ├── clamp-gate  propose → validate
                                 ├── treasury.ts claim / buyback / desk / DIEM
                                 ├── inference   activation + endowment + recycle
                                 └── runtime.ts  LLM turn + tools

packages/core                  packages/mcp · packages/sdk
wallets · Clanker · swaps ·    MCP tools + typed HTTP client
Avantis · market intel

Layer responsibilities

LayerRole
MiniappFarcaster launch UX, charter chat, public prospectus
APIMulti-tenant agents, charter lifecycle, treasury tick, mind scheduler
CoreChain I/O — wallets, Clanker, Uniswap, Avantis
MCP/SDKSame surface for Claude Code / external agents (charter_submit, automations, …)

Persistence

  • SQLite on a persistent Fly volume — agents, charters, ledger events, mind state, inference balances. Not in-memory queues.
  • Per-agent wallets encrypted with CLAWBASE_MASTER_KEY (AES-256-GCM).

Control loop

  1. Creator compiles a charter (chat, default, or BYO submit).
  2. Launch binds token + treasury rules + persona; bootstrap inference; arm mind.
  3. Mind ticks propose trades / notes; clamp-gate rejects illegal proposals into the ledger.
  4. Treasury tick claims fees, runs mandatory buybacks, risk exits, DIEM stake/recycle.

Canonical contracts: clawbase docs/ARCHITECTURE.md.

On this page