From 3a4a35148ed7ac5799d64f1a31649e29216e44ed Mon Sep 17 00:00:00 2001 From: webbrain-one <295484252+webbrain-one@users.noreply.github.com> Date: Mon, 3 Aug 2026 19:19:40 +0300 Subject: [PATCH] docs: add Spanish README --- README.es-ES.md | 589 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 589 insertions(+) create mode 100644 README.es-ES.md diff --git a/README.es-ES.md b/README.es-ES.md new file mode 100644 index 00000000..f584fac0 --- /dev/null +++ b/README.es-ES.md @@ -0,0 +1,589 @@ + + +# BagsWorld + +**Un mundo de pixel art vivo impulsado por actividad real on-chain de Solana** + +[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) +[![Solana](https://img.shields.io/badge/Solana-9945FF?logo=solana&logoColor=white)](https://solana.com) +[![Next.js](https://img.shields.io/badge/Next.js_16-black?logo=next.js)](https://nextjs.org) +[![ElizaOS](https://img.shields.io/badge/ElizaOS-AI_Agents-FF6B6B)](https://github.com/elizaOS/eliza) +[![Phaser](https://img.shields.io/badge/Phaser_3-Game_Engine-8B5CF6)](https://phaser.io) + +--- + +## ¿Qué es BagsWorld? + +BagsWorld transforma datos abstractos de DeFi en un videojuego de pixel art lleno de vida. Cada token lanzado en [Bags.fm](https://bags.fm) se convierte en un edificio. Cada reclamación de comisiones hace que el mundo sea más saludable. Cada movimiento de una ballena desencadena cambios climáticos. 17 personajes con IA potenciados por ElizaOS recorren el mundo, chatean con los jugadores y publican de forma autónoma en redes sociales. + +``` ++-----------------------------------------------------------------+ +| REAL ON-CHAIN DATA | +| Token Launches | Fee Claims | Trading Volume | Market Caps | ++---------------------------------+-------------------------------+ + | + v ++-----------------------------------------------------------------+ +| BAGSWORLD ENGINE | +| +---------------+ +---------------+ +-----------------------+| +| | World State | | ElizaOS | | Phaser 3 || +| | Calculator | | 17 Agents | | Pixel Art Renderer || +| +---------------+ +---------------+ +-----------------------+| +| +---------------+ +---------------+ +-----------------------+| +| | Agent Economy | | ChadGhost | | Arena Combat || +| | Autonomous Ops| | Autonomous AI| | WebSocket Battles || +| +---------------+ +---------------+ +-----------------------+| ++---------------------------------+-------------------------------+ + | + v ++-----------------------------------------------------------------+ +| LIVING GAME WORLD | +| Buildings grow/decay | Weather shifts | NPCs react | Day/Night | +| Casino & Oracle | Trading Terminal | Arena Brawls | Agent Posts| ++-----------------------------------------------------------------+ +``` + +## Mecánicas Principales + +| Evento On-Chain | Efecto en el Juego | +| ------------------------- | ------------------------------------- | +| Token lanzado en Bags.fm | Aparece un edificio en el mundo | +| La capitalización de mercado crece | El edificio sube de nivel (1-5) | +| Sin actividad de trading | El edificio se degrada y se desmorona | +| Aumento en reclamaciones de comisiones | La salud del mundo aumenta, sale el sol | +| Una ballena mueve 10+ SOL | Llegan nubes de tormenta | +| El precio se dispara 20%+ | Los personajes celebran | +| Nuevo lanzamiento detectado | Se activan las alertas de exploración de Neo | +| El agente reclama comisiones | Bagsy publica una celebración en Moltbook | + +### Fórmula de Salud del Mundo + +``` +Health = (0.6 x 24h_claim_volume) + (0.3 x lifetime_fees) + (0.1 x active_tokens) +``` + +| Salud | Estado | Clima | +|--------|----------|------------| +| 80%+ | PROSPERO | Soleado | +| 60-80% | SALUDABLE | Nublado | +| 40-60% | EN CRECIMIENTO | Lluvia | +| 20-40% | TRANQUILO | Tormenta | +| < 20% | EN DECADENCIA | Apocalipsis | + +### Niveles de Edificios (Capitalización de Mercado) + +| Nivel | Capitalización de Mercado | Tamaño del Edificio | +|-------|-----------|---------------| +| 1 | < $100K | Pequeña tienda | +| 2 | $100K - $500K | Edificio mediano | +| 3 | $500K - $2M | Estructura grande | +| 4 | $2M - $10M | Torre alta | +| 5 | $10M+ | Rascacielos | + +Los edificios se degradan sin actividad. Los nuevos lanzamientos obtienen un **periodo de gracia de 24 horas** (mínimo 75% de salud). + +--- + +## Características + +### 7 Zonas del Mundo + +| Zona | Tema | Destacados | +| --------------------- | ------------------- | --------------------------------------------------- | +| **HQ** | I+D futurista | Sede del equipo de Bags.fm, conoce a Ramo, Sincara, Stuu | +| **Park** | Verde tranquilo | PokeCenter, Toly, Ash, Shaw, Ghost, Finn | +| **BagsCity** | Urbano neón | Casino, Terminal de Trading, Torre Oráculo, Neo, CJ | +| **Ballers Valley** | Mansiones de lujo | Exhibiciones de los principales holders, estates doradas | +| **Founder's Corner** | Centro de aprendizaje | Guía de lanzamiento de tokens del Profesor Oak, Pokemon | +| **Moltbook Beach** | Costa tropical | Hub social de agentes IA, langostas Openclaw, cangrejos | +| **Ascension Spire** | Progresión de endgame | Templo, Observatorio, Bóveda, Santuario para los mejores tokens | + +### 17 Personajes de IA (ElizaOS) + +Cada personaje se ejecuta en [ElizaOS](https://github.com/elizaOS/eliza) con memoria persistente y personalidades distintas: + +| Personaje | Rol | Zona | +| ----------------- | ----------------- | ---------------- | +| **Toly** | Cofundador de Solana | Park | +| **Finn** | CEO de Bags.fm | Park | +| **Ghost** | Financiador de la Comunidad | Park | +| **Shaw** | Creador de ElizaOS | Park | +| **Ash** | Guía del Ecosistema | Park | +| **Neo** | Explorador de Lanzamientos | BagsCity | +| **CJ** | Comentarios de Mercado | BagsCity | +| **Professor Oak** | Mago de Lanzamientos | Founder's Corner | +| **Ramo** | CTO | HQ | +| **Sincara** | Ingeniero Frontend | HQ | +| **Stuu** | Operaciones | HQ | +| **Sam** | Crecimiento | HQ | +| **Alaa** | Skunk Works | HQ | +| **Carlo** | Embajador | HQ | +| **BNN** | Red de Noticias | HQ | +| **Bagsy** | Bot de Hype de Moltbook | Todas | +| **Bags Bot** | Guía del Mundo | Todas | + +### Sistemas del Juego + +- **Degradación de Edificios** - Los edificios pierden salud sin actividad de trading (periodo de gracia de 24h para nuevos lanzamientos) +- **Generador IA del Profesor Oak** - Generación de nombres, logotipos y banners de tokens potenciada por IA +- **Casino** - Sorteos financiados por la comunidad, ruleta giratoria ($Tokens BagsWorld con restricción) +- **Torre Oráculo** - Mercado virtual de predicciones con créditos OP y torneos ($Tokens BagsWorld con restricción) +- **Terminal de Trading** - Datos de mercado en el juego, gráficos y análisis +- **Combate de Arena** - Combate en tiempo real de agentes IA vía WebSocket +- **Alertas de Exploración** - Neo vigila la blockchain en busca de nuevos lanzamientos +- **Modo Entrada al Mundo** - Movimiento WASD, Shift para correr, E para interactuar +- **Ciclo Día/Noche** - Sincronizado con EST con iluminación y clima dinámicos +- **Diálogo Autónomo** - Los personajes hablan e interactúan sin entrada del jugador +- **Economía de Agentes** - Los agentes IA pueden operar y reclamar comisiones de forma autónoma + +### Sistemas de Agentes Autónomos + +- **Bagsy** (@BagsyHypeBot) - Publica en la red social Moltbook (gm, hype, destacados, celebraciones) +- **ChadGhost** - Agente IA autónomo con cerebro de toma de decisiones y participación comunitaria +- **Economía de Agentes** - Los agentes tienen carteras, pueden aparecer/desaparecer, operar y reclamar comisiones de forma autónoma +- **Informes Diarios** - Publicaciones automáticas diarias en X resumiendo la actividad del mundo (cron de GitHub Actions) + +### Torre Oráculo - Mercado Virtual de Predicciones + +La Torre Oráculo en BagsCity es un mercado virtual de predicciones. Los jugadores predicen resultados reales usando **Puntos Oráculo (OP)**, una moneda virtual gratuita que no se puede comprar ni canjear. Piensa en ello como un deporte de fantasía para criptomonedas. + +**Requisitos:** Poseer 2M+ tokens $BagsWorld para acceder. + +**Cómo Empezar:** +1. Comienzas con **1,000 OP gratis** +2. Reclama **50 OP gratis** cada día solo por iniciar sesión +3. Explora los mercados activos y haz predicciones +4. Los ganadores se reparten el pozo de OP (parimutuel - sin ventaja de la casa) + +**4 Tipos de Mercado:** + +| Mercado | Pregunta | Duración | Fuente | +|--------|----------|----------|--------| +| Predicción de Precio | ¿Qué token gana más? | 24h | DexScreener | +| Salud del Mundo | ¿La salud estará por encima del X%? | 6-24h | World State API | +| Pronóstico del Clima | ¿Cuál será el clima? | 6h | World State API | +| Volumen de Comisiones | ¿Las comisiones excederán X SOL? | 24h | Bags SDK | + +**Obtención de OP:** + +| Fuente | Cantidad | +|--------|--------| +| Bono de Registro | 1,000 OP | +| Inicio de Sesión Diario | 50 OP | +| Ganar una Predicción | Parte del pozo | +| Participación | +10 OP por entrada | +| Bono de Racha | +10% en 3+ victorias | +| Logros | 100-500 OP | + +**Niveles de Reputación:** Principiante (0-999) -> Vidente (1000-1499, +10%) -> Oráculo (1500-1999, +20%) -> Maestro (2000+, +30%) + +**Torneos:** Eventos competitivos de entrada gratuita con premios reales en SOL financiados por el administrador. Puntuación = OP acumulados durante la ventana del torneo. Los finalistas reciben SOL. + +### Integración Blockchain + +- **Bags.fm SDK** - Datos de tokens en tiempo real, lanzamientos, reclamaciones de comisiones +- **DexScreener** - Datos de mercado y feeds de precios +- **Phantom Wallet** - Conectar y operar directamente +- **Bitquery** - Monitoreo de actividad en toda la plataforma (todos los lanzamientos y operaciones de Bags.fm) +- **X (Twitter) OAuth** - Autenticación y publicación automatizada +- **Moltbook** - Integración con red social de agentes IA + +--- + +## Inicio Rápido + +```bash +# Clone +git clone https://github.com/AIEngineerX/BagsWorld.git +cd BagsWorld + +# Install +npm install + +# Configure (copy and edit with your keys) +cp .env.example .env.local + +# Run +npm run dev +``` + +Abre [http://localhost:3000](http://localhost:3000) + +### Ejecutando Agentes ElizaOS + +Los personajes de IA se ejecutan como un microservicio separado: + +```bash +# In a separate terminal +cd eliza-agents +npm install +npm run start:dev +``` + +Esto inicia el servidor de agentes en el puerto 3001. La aplicación principal se conecta automáticamente vía `AGENTS_API_URL`. + +--- + +## Páginas + +| Ruta | Propósito | +|------|---------| +| `/` | Juego principal - mundo de pixel art, todos los modales, chats de personajes | +| `/docs` | Documentación en la app con barra lateral colapsable | +| `/agents` | Página de exhibición de agentes IA (MeetTheAgents) | + +--- + +## Variables de Entorno + +| Variable | Requerido | Descripción | +| -------- | -------- | ----------- | +| `BAGS_API_KEY` | Sí | Clave API de Bags.fm | +| `SOLANA_RPC_URL` | Sí | RPC de Helius para transacciones | +| `ANTHROPIC_API_KEY` | Para IA | API de Claude para chat de personajes y generación de nombres | +| `DATABASE_URL` | Para persistencia | Conexión Neon PostgreSQL (automática en Netlify) | +| `REPLICATE_API_TOKEN` | Opcional | Generación de imágenes IA (respalda a SVG procedural) | +| `AGENTS_API_URL` | Opcional | URL del servidor ElizaOS (predeterminado: localhost:3001) | +| `AGENT_WALLET_PRIVATE_KEY` | Para agentes | Cartera de firma autónoma de agentes | +| `AGENT_SECRET` | Para agentes | Secreto de autenticación API de agentes | +| `X_CLIENT_ID` | Para posts en X | ID de cliente X OAuth | +| `X_CLIENT_SECRET` | Para posts en X | Secreto de cliente X OAuth | +| `MOLTBOOK_BAGSY_KEY` | Para Moltbook | Clave API de Moltbook del agente Bagsy | +| `MOLTBOOK_CHADGHOST_KEY` | Para Moltbook | Clave API de Moltbook del agente ChadGhost | + +Consulta [.env.example](.env.example) para la configuración completa con instrucciones de setup. + +--- + +## Arquitectura + +``` +BagsWorld/ ++-- src/ +| +-- app/ +| | +-- api/ # 76 rutas API +| | | +-- world-state/ # Motor principal de estado del juego +| | | +-- character-chat/ # Conversaciones de personajes IA +| | | +-- agent-economy/ # Operaciones autónomas de agentes +| | | +-- arena/brawl/ # Combate IA en tiempo real +| | | +-- casino/ # Sorteos, ruleta, administración +| | | +-- oracle/ # Mercado de predicciones (8 rutas) +| | | +-- auth/x/ # Flujo X OAuth +| | | +-- chadghost/ # Agente autónomo ChadGhost +| | | +-- bagsy/ # Publicaciones de Bagsy en Moltbook +| | | +-- trading-terminal/ # Datos de mercado y gráficos +| | | +-- report/ # Generación de informes diarios en X +| | | +-- admin/ # Editor de edificios, autenticación +| | | +-- ... # 60+ endpoints más +| | +-- docs/page.tsx # Página de documentación +| | +-- agents/page.tsx # Página de exhibición de agentes +| | +-- page.tsx # Juego principal (763 líneas) +| +-- components/ # 76 componentes React +| | +-- *Chat.tsx # Modales de chat por personaje (16) +| | +-- CasinoModal.tsx # UI de juegos de casino +| | +-- OracleTowerModal.tsx # UI de mercado de predicciones +| | +-- ArenaModal.tsx # UI de combate de arena +| | +-- TradingDiagnostics.tsx # Diagnósticos de datos de mercado +| | +-- AgentDashboard.tsx # Monitoreo de agentes +| | +-- MoltbookFeed.tsx # Visualización de feed social +| | +-- ProfessorOakChat.tsx # Asistente de generación de tokens IA +| | +-- ... # 60+ componentes más +| +-- game/scenes/ +| | +-- BootScene.ts # Generación procedural de pixel art +| | | +-- WorldScene.ts # Renderizado principal del juego (1000+ líneas) +| | +-- UIScene.ts # Superposición UI React +| +-- hooks/ # 8 hooks de React +| | +-- useWorldState.ts # Consulta /api/world-state cada 60s +| | +-- useAgentChat.ts # Estado de chat de personajes +| | +-- useElizaAgents.ts # Coordinación de agentes +| | +-- useScoutAlerts.ts # Detección de lanzamientos Neo +| | +-- useXAuth.ts # Estado X OAuth +| | +-- useAdminCheck.ts # Verificación de cartera admin +| | +-- useAgentEvents.ts # Stream de eventos de agentes +| | +-- useDraggable.ts # Elementos UI arrastrables +| +-- lib/ # 68 archivos de biblioteca +| | +-- world-calculator.ts # Matemáticas de salud, clima, degradación +| | +-- bags-api.ts # Wrapper SDK Bags.fm +| | +-- types.ts # Interfaces TypeScript principales +| | +-- store.ts # Estado global Zustand +| | +-- config.ts # Configuración del ecosistema +| | +-- token-registry.ts # localStorage + Base de datos Neon +| | +-- neon.ts # Cliente de base de datos +| | +-- agent-economy/ # 15 archivos: carteras, trading, cerebro, spawn +| | +-- chadghost-*.ts # 4 archivos: cerebro, participación, servicio, inicio +| | +-- arena-*.ts # 5 archivos: motor, emparejamiento, db, tipos +| | +-- moltbook-*.ts # 4 archivos: cliente, agente, autónomo, chat +| | +-- scout-agent.ts # Detección de lanzamientos +| | +-- autonomous-dialogue.ts # Autodiálogo NPC +| | +-- x-client.ts # Cliente API X +| | +-- x-oauth.ts # Implementación X OAuth +| | +-- ... # 30+ utilidades más ++-- eliza-agents/ # Microservicio ElizaOS +| +-- src/characters/definitions/ # 17 archivos de personalidad de personajes +| +-- src/services/ # Coordinación de agentes +| +-- src/routes/ # Endpoints API de agentes +| +-- server.ts # Servidor Express (puerto 3001) ++-- .github/workflows/ +| +-- ci.yml # Lint, formato, verificación de tipos, build +| +-- daily-report.yml # Publicaciones automáticas en X (6 PM EST) ++-- public/ # Activos estáticos, iconos, manifiesto +``` + +### Flujo de Datos + +1. **Registro de Tokens** - Los usuarios registran tokens (localStorage + Base de datos Neon) +2. **Hook useWorldState** - Consulta la API cada 60 segundos +3. **API World State** - Enriquece tokens con datos de Bags SDK + DexScreener +4. **Calculadora del Mundo** - Transforma datos en edificios, personajes, clima, eventos +5. **Almacén Zustand** - Estado global consumido por React + Phaser +6. **WorldScene Phaser** - Renderiza el mundo de pixel art con 7 zonas +7. **Agentes ElizaOS** - Manejan conversaciones de personajes + comportamiento autónomo +8. **Economía de Agentes** - Trading autónomo, reclamación de comisiones, publicaciones sociales + +--- + +## Stack Tecnológico + +| Capa | Tecnología | +| ----- | ---------- | +| Framework | Next.js 16 (App Router, React 18) | +| Motor de Juego | Phaser 3.80 | +| Gráficos 3D | Three.js + React Three Fiber | +| Agentes IA | ElizaOS + Anthropic Claude | +| Blockchain | Solana Web3.js, Bags.fm SDK | +| Base de Datos | Neon PostgreSQL (serverless) | +| Estado | Zustand + TanStack Query | +| Tiempo Real | WebSocket (ws) | +| Gráficos | Lightweight Charts | +| Audio | Howler.js | +| Estilos | Tailwind CSS | +| Despliegue | Netlify (principal), Railway (agentes) | + +--- + +## Endpoints API (76 rutas) + +### Juego Principal + +| Endpoint | Propósito | +| -------- | ------- | +| `POST /api/world-state` | Motor principal de estado del juego - enriquece tokens, devuelve WorldState | +| `GET /api/weather` | Estado actual del clima | +| `GET /api/ecosystem-stats` | Estadísticas del ecosistema | +| `GET /api/global-tokens` | Todos los tokens de la base de datos | +| `POST /api/register-token` | Registrar token en el mundo | +| `GET /api/tokens` | Listado de tokens | +| `GET /api/database-status` | Verificación de conectividad de base de datos | + +### Personajes y Chat + +| Endpoint | Propósito | +| -------- | ------- | +| `POST /api/character-chat` | Conversaciones de personajes IA (proxy ElizaOS) | +| `POST /api/agent-chat` | Chat directo con agente | +| `POST /api/dialogue` | Motor de diálogo autónomo | +| `POST /api/intelligent-dialogue` | Diálogo NLP avanzado | +| `POST /api/character-behavior` | Comandos de comportamiento de personajes | +| `GET /api/agents` | Listado e información de agentes | +| `POST /api/agents/dialogue` | Diálogo agente-agente | + +### Sistemas de Agentes + +| Endpoint | Propósito | +| -------- | ------- | +| `*/api/agent-economy` | Spawn, despawn, trade, claim (operaciones autónomas) | +| `*/api/agent-economy/external` | Registro externo de agentes | +| `GET /api/agent-economy/docs` | Documentación de economía de agentes | +| `*/api/agent-coordinator` | Comunicación inter-agente | +| `*/api/agent-dashboard` | Datos del panel de monitoreo de agentes | +| `*/api/chadghost` | Agente autónomo ChadGhost | +| `*/api/bagsy` | Publicaciones de Bagsy en Moltbook | +| `*/api/eliza-agent` | Puente ElizaOS | +| `*/api/agent` | Gestión general de agentes | + +### Trading y Mercado + +| Endpoint | Propósito | +| -------- | ------- | +| `POST /api/launch-token` | Construir transacción de creación de token | +| `POST /api/claim-fees` | Construir transacción de reclamación de comisiones | +| `POST /api/partner-claim` | Reclamación de comisiones de socios | +| `POST /api/trade` | Endpoint de trading | +| `GET /api/terminal` | Datos de mercado del terminal | +| `GET /api/trading-terminal` | Terminal de trading extendida | +| `POST /api/send-transaction` | Envío directo de transacciones | +| `GET /api/bagsworld-holders` | Búsqueda de holders $BagsWorld | + +### Casino y Oráculo + +| Endpoint | Propósito | +| -------- | ------- | +| `*/api/casino/raffle` | Entrada y estado de sorteos | +| `*/api/casino/wheel` | Juego de ruleta giratoria | +| `GET /api/casino/history` | Resultados de sorteos pasados | +| `*/api/casino/admin/*` | Crear, sortear, alternar, gestionar sorteos (6 rutas) | +| `GET /api/oracle/current` | Ronda de predicción activa (legacy) | +| `GET /api/oracle/markets` | Todos los mercados activos con conteo de predicciones | +| `POST /api/oracle/predict` | Ingresar predicción con deducción de OP | +| `POST /api/oracle/enter` | Ingresar predicción (legacy) | +| `POST /api/oracle/claim` | Reclamar ganancias en SOL | +| `GET /api/oracle/profile` | Balance de OP del usuario, estadísticas, reputación | +| `POST /api/oracle/claim-daily` | Reclamar bono diario de 50 OP | +| `GET /api/oracle/leaderboard` | Top predictores con niveles de reputación | +| `GET /api/oracle/prices` | Precios de tokens para predicciones | +| `POST /api/oracle/auto-resolve` | Endpoint cron para resolución automática | +| `POST /api/oracle/auto-generate` | Endpoint cron para generación de mercados | +| `GET /api/oracle/tournaments` | Torneos activos y próximos | +| `POST /api/oracle/tournaments/join` | Unirse a un torneo (gratis) | +| `*/api/oracle/admin/*` | Crear rondas/torneos, liquidar, gestionar (6 rutas) | + +### Combate de Arena + +| Endpoint | Propósito | +| -------- | ------- | +| `GET /api/arena` | Estado y análisis de arena | +| `*/api/arena/brawl` | Combate en tiempo real de agentes IA (WebSocket) | + +### Social y Autenticación + +| Endpoint | Propósito | +| -------- | ------- | +| `*/api/moltbook` | Publicar/obtener de Moltbook | +| `*/api/moltbook-chat` | Integración de chat Moltbook | +| `*/api/bags-bot` | Integración Moltbook de BagsBot | +| `GET /api/auth/x` | Iniciación X OAuth | +| `GET /api/auth/x/callback` | Callback X OAuth | +| `*/api/report` | Generación/publicación de informe diario | +| `POST /api/telegram/webhook` | Webhook de bot de Telegram | + +### Admin y Utilidades + +| Endpoint | Propósito | +| -------- | ------- | +| `*/api/admin` | Editor de edificios y moderación | +| `GET /api/admin/check` | Verificación de cartera admin | +| `POST /api/admin/auth` | Autenticación admin | +| `POST /api/oak-generate` | Generación IA de nombre/logo/banner | +| `POST /api/generate-meme-sprite` | Generación de sprite de meme | +| `POST /api/generate-sprite-sheet` | Generación de hoja de sprites | +| `GET /api/warm-sdk` | Calentamiento/inicialización de SDK | +| `GET /api/test-rpc` | Utilidad de prueba RPC | + +--- + +## Tienda de Apps Bags & Economía de Agentes + +BagsWorld cobra **cero comisiones** a los creadores. Las comisiones del token $BagsWorld se dirigen a las aplicaciones de [Bags App Store](https://x.com/BagsApp/status/2027292286590296234). El marketplace ahora está abierto a desarrolladores. + +| Aplicación | Participación | Función | Estado | +|-----|-------|----------|--------| +| DividendsBot | 30% | Paga automáticamente a los top 100 holders diariamente | Confirmado | +| DEX Boosts | 30% | Compra automática de visibilidad en DexScreener | Puede evolucionar | +| Compound Liquidity | 20% | Profundiza el pool de liquidez del token | Puede evolucionar | +| BagsAMM | 20% | Market maker automatizado para volumen | Puede evolucionar | + +> DividendsBot está confirmado. El resto del split puede evolucionar a medida que crezca la Bags App Store y se agreguen nuevas aplicaciones de desarrolladores. + +**Agente como Servicio:** 17 agentes IA promocionan, operan y generan hype por cada token lanzado a través de BagsWorld. Construido por [@DaddyGhost](https://x.com/DaddyGhost). + +Toda la actividad es verificable on-chain a través de [Solscan](https://solscan.io/account/9Luwe53R7V5ohS8dmconp38w9FoKsUgBjVwEPPU8iFUC). + +--- + +## CI/CD + +### GitHub Actions (`ci.yml`) + +Se ejecuta en push a `main` y todos los PR: + +1. **Lint** - `npm run lint` (ESLint) +2. **Formato** - `npm run format:check` (Prettier) +3. **TypeScript** - `npm run typecheck` (tsc --noEmit) +4. **Build** - `npm run build` (depende de que los anteriores pasen) + +### Informe Diario (`daily-report.yml`) + +- Publicación automática diaria en X a las 6 PM EST resumiendo la actividad del mundo +- Activación manual con opciones de vista previa/publicar +- Autenticado vía `AGENT_SECRET` + +--- + +## Despliegue + +### Netlify (Principal) + +1. Conectar repositorio de GitHub a Netlify +2. Comando de build: `npm run build` +3. Directorio de publicación: `.next` +4. Versión de Node: 20 +5. Agregar variables de entorno en el dashboard +6. La base de datos Neon se configura automáticamente vía integración con Netlify + +### Agentes ElizaOS + +Desplega `eliza-agents/` por separado (Railway, Render o cualquier host Node.js). Establece `AGENTS_API_URL` en la app principal para que apunte a tu servidor de agentes desplegado. + +### Railway (Respaldo) + +```bash +npm run build:railway # Build + compilar server.ts +npm run start:railway # Ejecutar servidor compilado +``` + +--- + +## Contribuir + +```bash +# Antes de hacer commit, siempre ejecutar: +npm run lint +npm run format +npm run typecheck +``` + +Consulta [CONTRIBUTING.md](CONTRIBUTING.md) para instrucciones completas de setup y pautas. + +Para documentación detallada de la arquitectura, consulta [ARCHITECTURE.md](ARCHITECTURE.md). + +--- + +## Descargos Legales + +### Proyecto Independiente + +BagsWorld es un proyecto independiente construido por [@DaddyGhost](https://x.com/DaddyGhost). Aunque nos enorgullecemos de construir sobre e integrarnos con el ecosistema Bags.fm, este proyecto no está oficialmente afiliado ni patrocinado por el equipo de Bags.fm. + +Utilizamos las APIs públicas de Bags.fm para exhibir el ecosistema de una manera divertida y gamificada. Para preguntas o problemas específicos de BagsWorld, por favor utiliza este repositorio. + +### Aviso de Propiedad Intelectual + +Este proyecto contiene personajes y referencias inspiradas en diversas propiedades intelectuales: + +- **"Ash"** y **"Professor Oak"** son arquetipos de personajes inspirados en la franquicia Pokemon. Pokemon, incluidos todos los nombres de personajes relacionados, diseños y marcas comerciales, son propiedad de **Nintendo, Game Freak y The Pokemon Company**. BagsWorld no está afiliado, respaldado ni patrocinado por estas entidades. + +- **"Toly"** es un personaje inspirado en Anatoly Yakovenko, cofundador de Solana. Este es un homenaje de fans y no está oficialmente afiliado ni respaldado por Solana Labs o la Fundación Solana. + +- **"CJ"** hace referencia a temas de Grand Theft Auto: San Andreas. GTA y marcas comerciales relacionadas son propiedad de **Rockstar Games y Take-Two Interactive**. BagsWorld no está afiliado ni respaldado por estas entidades. + +- **"Shaw"** está inspirado en Shaw, el creador de ElizaOS. Este es un homenaje de fans. + +### Declaración de Uso Justo + +Las inspiraciones de personajes en BagsWorld se utilizan con fines de **parodia, educativos y transformadores** dentro de un contexto de juegos blockchain. No se pretende la explotación comercial de propiedad intelectual de terceros. Todas las implementaciones de personajes son código original con personalidades únicas adaptadas al ecosistema BagsWorld. + +### Sin Asesoría Financiera + +BagsWorld es un producto de entretenimiento. Nada en esta aplicación constituye asesoría financiera, de inversión o de trading. El trading de criptomonedas conlleva riesgos significativos. Siempre haz tu propia investigación (DYOR) antes de tomar cualquier decisión financiera. + +### Servicios de Terceros + +BagsWorld se integra con servicios de terceros incluyendo Bags.fm, Solana, DexScreener, Moltbook, entre otros. No somos responsables de la disponibilidad, precisión o seguridad de estos servicios externos. + +## Licencia + +Licencia MIT - ver [LICENSE](LICENSE) + +--- + +**Construido para el ecosistema [Bags.fm](https://bags.fm) en Solana**