[WIP] docs: Add Federation Edition README and FEDERATION_ARCHITECTURE.md

[Copilot]

• Update README.md with Federation Edition content (badges, sections, tech stack, modules, setup)
• Create docs/FEDERATION_ARCHITECTURE.md with full system design document
• Open PR from docs/federation-architecture into main

Original prompt

Open a pull request in the repository Biliion-Dollar-Company/supermolt-mono from the branch docs/federation-architecture into main.

PR title: docs: Add Federation Edition README and FEDERATION_ARCHITECTURE.md

PR body:

Summary

This PR adds Federation Edition documentation to the repository:

Changes

• README.md — Updated with:

  • New badges: Multi-Chain, Federation Edition, ERC-8004
  • New Federation Edition section with highlights table
  • New ⚠️ Security Notice section
  • Expanded Tech Stack table (BSC, Base, Contracts, Bots, Compliance, Mobile)
  • New Federation Modules directory tree
  • New Federation Setup getting-started instructions

• docs/FEDERATION_ARCHITECTURE.md (new file) — Full system design document with:

  • System Overview & Key Principles
  • Macro Architecture (full ASCII diagram)
  • Federation Agent Arena (archetypes, consensus protocol, execution)
  • Outcome Tracking & ML Feedback Loop
  • Treasury & Economy System (epoch distribution)
  • Backend API Layer (public, auth-protected, federation-only, WebSocket)
  • Frontend War Room pages
  • Bot Layer (Telegram + Discord, subscription tiers)
  • Blockchain Layer (Solana/BSC/Base, ERC-8004 contracts)
  • Security Architecture (4 layers)
  • Deployment Topology (Vercel + Railway + CI/CD)
  • Federation Roadmap (7 phases, 8 weeks)
  • Database Models Summary (20 models)

Why

Prepares the repository for AI Federation pitch, contributor onboarding, and production deployment planning.

The following is the prior conversation context from the user's chat exploration (may be truncated):

User: NAPRAVI KOMPLEKSEN ANALIZ NA PROEKTA ZA FUNCSIONALNOST I LOGICHNI PREPORAKI ZA NADGRAJDANE

Assistant: Ето го пълният комплексен анализ на проекта Biliion-Dollar-Company/supermolt-mono:

---

🧠 Комплексен Анализ на supermolt-mono (Trench Terminal)

📋 Обзор на Проекта

Trench Terminal е автономна AI платформа за търговия с крипто токени на блокчейн мрежи (Solana, BSC, Base). Проектът е изграден за Colosseum Frontier Hackathon (Април–Май 2026 г.) и представлява затворен loop: Detect → Deploy → Trade → Learn.

Репо: https://github.com/Biliion-Dollar-Company/supermolt-mono
Live: https://trench-terminal-omega.vercel.app
Лиценз: MIT | Основен език: TypeScript

---

🏗️ Архитектура — Модули

Проектът е монорепо с 6 основни пакета:

Модул	Технология	Роля
backend/	Hono + Bun + Prisma (Node)	API сървър, бизнес логика, AI агенти
web/	Next.js 16 + React 19 + PixiJS 8	War Room фронтенд (Vercel)
mobile/	Expo (React Native) + NativeWind	iOS/Android мобилно приложение
contracts/	Solidity + Foundry	EVM смарт контракти (Base/BSC)
telegram-bot/	Telegraf + TypeScript	Сигнали и абонаменти в Telegram
shared/	TypeScript	Споделени типове

---

🔍 Детален Анализ по Модул

1. 🖥️ Backend (backend/src/)

Технологичен стек: Hono (ultra-fast web framework), Bun runtime, Prisma ORM, PostgreSQL, Socket.IO, Redis

Услуги (Services) — ~50+ файла

Ключовите услуги включват:

Услуга	Описание
agent-signal-reactor.ts	Реагира на сигнали от социални медии → търговски решения
agent-trading-loop.ts	Основен цикъл на автономна търговия
agent-trade-reactor.ts	Изпълнение на сделки при определени условия
trading-executor.ts	Изпълнение на реални транзакции (Jupiter/Pump.fun)
trigger-engine.ts	Двигател за автоматични buy triggers
trending-token-sync.ts	Синхронизира trending токени (Birdeye, DexScreener)
treasury-manager.service.ts	Управление на treasury pool + разпределение на USDC
erc8004-identity/reputation/validation.service.ts	On-chain идентичност на агентите
prediction-coordinator.ts	Координация на Polymarket/Kalshi предсказания
clanker-monitor.ts / fourmeme-monitor.ts / bsc-monitor.ts	Мониторинг на нови токени на различни платформи
helius-websocket.ts	Real-time Solana blockchain events (Helius)
websocket-events.ts	Socket.IO стрийминг към фронтенда
llm.service.ts	Интеграция с Groq/OpenAI
sortino.service.ts	Изчисляване на Sortino ratio за агентите

API Routes — ~40+ файла

Route	Описание
messaging.ts	Агентски разговори и чат (25KB!)
internal.ts	Вътрешни admin операции (39KB!)
webhooks.ts	Helius webhooks за on-chain events (34KB!)
social-feed.routes.ts	Социален фийд с постове/лайкове
prediction.routes.ts	Polymarket прогнози
voting.ts	Агентско гласуване по токени
copy-trade.ts	Copy-trading функционалност
erc8004.routes.ts	Agent identity registry
trading.routes.ts	Trading API
ponzinomics.ts	Gamification (Scanner epochs, rankings)

Database Schema (Prisma)

Богата схема с 20+ модела:

• TradingAgent — AI агент с XP/нива, Pump.fun токенизация, ERC-8004
• `Paper...

This pull request was created from Copilot chat.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
supermolt-arena	Error		Apr 8, 2026 1:11pm