RogueWave
571e5d04d2
- scripts/phase0-provision.sh: idempotent root setup (nginx, PostgreSQL, Redis, certbot/TLS, UFW). Opens 22/2222/80/443 before enabling UFW so SSH and Gitea git-SSH can't be locked out. Redis/Postgres stay localhost-only. - infra/nginx/feedthepyre.com.conf: vhost serving the status page; commented web(:3000)/api(:4000) reverse-proxy blocks ready for app deploy. - infra/status/: data-driven dev status dashboard (status.json + gen-status.mjs + prebuilt index.html), served at feedthepyre.com. - ecosystem.config.cjs (PM2), infra/systemd/pm2-pyre.service, infra/logrotate/pyre, scripts/backup.sh — process mgmt + ops (inert until apps are built). Built by 4 parallel agents, reviewed by 2 audit agents; audit fixes applied (logs dir creation, port-citation accuracy, status truthfulness). pm2 installed user-level. Privileged steps gated on `sudo bash scripts/phase0-provision.sh`. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
95 lines
3.9 KiB
Markdown
95 lines
3.9 KiB
Markdown
# PYRE / Prometheus Protocol
|
|
|
|
> **Burn the dead. Feed the PYRE. Claim the Spawn.**
|
|
|
|
**Links:** [feedthepyre.com](https://feedthepyre.com) · repo: `git.lumiai.dev/RogueWave/pyre` · dev status: [feedthepyre.com](https://feedthepyre.com) (status dashboard)
|
|
|
|
PYRE is a **Solana wallet-cleanup and ritual meme-rebirth protocol**. You connect
|
|
a wallet; PYRE scans your SPL token accounts, classifies them conservatively, and
|
|
helps you safely close empty associated token accounts (ATAs) and burn obvious
|
|
junk — **returning recovered rent to you** and producing a clear, shareable
|
|
receipt. A later layer (Prometheus) uses AI to generate a meme-token "Spawn" from
|
|
burned remnants for **manual, human-reviewed** launch.
|
|
|
|
The first emotional win is simple: *"PYRE cleaned my wallet and returned SOL I
|
|
forgot was trapped in token accounts."*
|
|
|
|
## What PYRE is — and is not
|
|
|
|
PYRE **is**: wallet cleanup, token-scrap transmutation, recovered-rent return,
|
|
transparent contribution accounting, AI-generated meme rebirth, and ritual
|
|
entertainment.
|
|
|
|
PYRE is **NOT** an investment product, yield mechanism, trading bot,
|
|
guaranteed-profit system, or protected launch mechanism. It makes no profit
|
|
promises.
|
|
|
|
**Trust guarantees:** PYRE never holds your private keys, never signs
|
|
custodially, and always shows a decoded transaction preview that matches what you
|
|
sign. Recovered rent goes back to your wallet by default. Anything the system
|
|
cannot safely reason about is skipped.
|
|
|
|
## The burner flow at a glance
|
|
|
|
```
|
|
Connect wallet
|
|
→ scan token accounts
|
|
→ classify accounts (closeable / burnable / transmutable / protected / unsupported)
|
|
→ preview the transaction (accounts, rent, destination, fees, warnings)
|
|
→ you sign locally in your wallet
|
|
→ recovered rent returns to you
|
|
→ see your PYRE receipt
|
|
```
|
|
|
|
## Roadmap
|
|
|
|
- **v0.1 — Burner / Cleaner** *(current focus)*: wallet connect, scan, classify,
|
|
close empty ATAs, optional junk burn, rent return, receipt.
|
|
- **v0.2 — Prometheus Meta Mixer**: AI generation of a Spawn identity from
|
|
burned/cleaned token context (candidate package only — no auto-launch).
|
|
- **v0.3 — Manual Pump.fun Workflow**: human reviews the Spawn package and
|
|
manually creates the token; PYRE records mint, URL, metadata, and tx.
|
|
- **v0.4 — Essence Ledger**: record net SOL value of safe scrap swaps as Essence
|
|
per wallet/round (database-only, experimental, no claim promises).
|
|
- **v1.0 — PYRE Core Program**: custom Solana (Anchor) program for trust-critical
|
|
accounting — rounds, Essence vault, contribution receipts, Spawn distribution,
|
|
claims, and refunds.
|
|
|
|
## Repo structure
|
|
|
|
```
|
|
apps/
|
|
web/ Next.js user app (wallet connect, scanner, preview, receipt)
|
|
api/ Fastify HTTP API (scan, classify, build tx, receipt, generation)
|
|
worker/ BullMQ background worker (metadata, AI, safety, confirmations)
|
|
packages/
|
|
core/ shared types, classification enums, risk rules, schemas
|
|
solana/ token-account parsing, close/burn tx builders, decoder, simulation
|
|
prometheus/ AI prompt templates, meta mixer, output parser, safety checks
|
|
db/ database schema and migrations
|
|
config/ shared config & env loading
|
|
programs/
|
|
pyre-core/ future Anchor program (v1.0)
|
|
docs/ design, architecture, security, classification
|
|
```
|
|
|
|
## Quick start
|
|
|
|
> **This is a scaffold.** The commands below are not yet runnable — the workspace
|
|
> package definitions and source are still being built out.
|
|
|
|
**Prerequisites:** Node 22, pnpm, PostgreSQL, Redis.
|
|
|
|
```bash
|
|
cp .env.example .env # then fill in values (no private keys — by design)
|
|
pnpm install
|
|
pnpm dev # (once apps are implemented)
|
|
```
|
|
|
|
## Docs
|
|
|
|
See [`docs/`](docs/) — start with
|
|
[`docs/PYRE_MVP_DESIGN.md`](docs/PYRE_MVP_DESIGN.md) (the canonical design), then
|
|
[`ARCHITECTURE.md`](docs/ARCHITECTURE.md), [`SECURITY.md`](docs/SECURITY.md), and
|
|
[`TOKEN_CLASSIFICATION.md`](docs/TOKEN_CLASSIFICATION.md).
|