# MODULAR_EXTENSIONS_ECONOMY.md  
### Capa Económica Modular del Organismo 4GatosCoin (V2)  
### Versión 1.0 — 2 de enero 2026

---

## 1. Propósito del documento

Este documento define la **capa económica modular** del organismo 4GatosCoin.  
La economía no es un añadido externo:  
es una **extensión natural del metabolismo energético** del organismo.

La economía V2 permite:

- monetizar gestos  
- monetizar rituales  
- monetizar territorio  
- monetizar seasons  
- monetizar narrativa  
- monetizar conexiones  
- monetizar avatar  
- monetizar memoria viva  

…sin romper la coherencia simbólica.

---

# 2. Principios de la Economía V2

La economía del organismo se basa en 7 principios:

### ✔️ 2.1. Economía simbólica  
El valor nace de la narrativa, no del mercado.

### ✔️ 2.2. Economía energética  
Los puntos, el pulso y la resonancia son la base del valor.

### ✔️ 2.3. Economía ritual  
Los rituales son mecanismos de activación económica.

### ✔️ 2.4. Economía territorial  
Las zonas pueden tener valor económico simbólico.

### ✔️ 2.5. Economía estacional  
Cada season puede introducir reglas económicas nuevas.

### ✔️ 2.6. Economía narrativa  
Los ecos y ciclos pueden activar valor.

### ✔️ 2.7. Economía soberana  
Todo vive dentro del organismo, no en plataformas externas.

---

# 3. Componentes económicos del organismo

La economía V2 se compone de 8 elementos:

---

## ✔️ 3.1. Valor Energético (VE)  
Conversión simbólica de:

- puntos  
- pulso  
- aura  
- resonancia  

Ejemplo:

```json
{
  "wallet": "0x123...",
  "VE": 72
}
✔️ 3.2. Valor Territorial (VT)
Zonas activas generan valor simbólico.

Ejemplo:

json
{
  "zone": "WHISPERING_FOREST",
  "VT": 12
}
✔️ 3.3. Valor Ritual (VR)
Rituales colaborativos generan valor.

Ejemplo:

json
{
  "ritual": "eclipse_colectivo",
  "VR": 4
}
✔️ 3.4. Valor Narrativo (VN)
Ecos, triggers y ciclos generan valor simbólico.

Ejemplo:

json
{
  "echo": "El viento cambia...",
  "VN": 3
}
✔️ 3.5. Valor Estacional (VS)
Cada season puede modificar el valor.

Ejemplo:

json
{
  "season": "SEASON_03",
  "VS": 1
}
✔️ 3.6. Valor Social (VSOC)
Conexiones simbólicas generan valor.

Ejemplo:

json
{
  "connection": ["0xAAA...", "0xBBB..."],
  "VSOC": 2
}
✔️ 3.7. Valor de Avatar (VA)
Estados avanzados del avatar generan valor.

Ejemplo:

json
{
  "state": "ascended",
  "VA": 5
}
✔️ 3.8. Valor de Memoria (VM)
Eventos archivados generan valor histórico.

Ejemplo:

json
{
  "event": "first_eclipse",
  "VM": 10
}
4. Fórmula del Valor Total (VTOT)
El valor total de una wallet es:

𝑉
𝑇
𝑂
𝑇
=
𝑉
𝐸
+
𝑉
𝑇
+
𝑉
𝑅
+
𝑉
𝑁
+
𝑉
𝑆
+
𝑉
𝑆
𝑂
𝐶
+
𝑉
𝐴
+
𝑉
𝑀
Ejemplo:

json
{
  "wallet": "0x123...",
  "VTOT": 108
}
5. Extensiones económicas permitidas
✔️ 5.1. Extensiones de Valor Energético
Ejemplo:
“+1 VE por cada gesto energético durante Season 03”.

✔️ 5.2. Extensiones de Valor Territorial
Ejemplo:
“Zonas resonant generan +2 VT por eco emitido dentro”.

✔️ 5.3. Extensiones de Valor Ritual
Ejemplo:
“Ritual Eclipse Colectivo genera +4 VR por wallet”.

✔️ 5.4. Extensiones de Valor Narrativo
Ejemplo:
“Ecos globales generan +3 VN”.

✔️ 5.5. Extensiones de Valor Estacional
Ejemplo:
“Durante Season 04, +1 VS por conexión creada”.

✔️ 5.6. Extensiones de Valor Social
Ejemplo:
“Conexiones mutuas generan +2 VSOC”.

✔️ 5.7. Extensiones de Valor de Avatar
Ejemplo:
“Estado ascended genera +5 VA”.

✔️ 5.8. Extensiones de Valor de Memoria
Ejemplo:
“Eventos archivados generan +10 VM”.

6. Hooks económicos
Las extensiones pueden escuchar:

onPointsAwarded

onGesture

onRitualCompleted

onZoneAwakened

onSeasonChange

onConnectionCreated

onAvatarStateChange

onEcho

onLoreTrigger

onMemoryArchived

7. Endpoints económicos
7.1. Consultar valor total
json
GET /api/economy/value/:wallet
7.2. Consultar desglose de valor
json
GET /api/economy/value/:wallet/detail
7.3. Activar extensión económica
json
POST /api/economy/extension/activate
{
  "extensionId": "forest_resonance_value"
}
8. Reglas de seguridad económica
✔️ No romper el límite de 50 puntos/día
✔️ No crear mercados tóxicos
✔️ No crear jerarquías visibles
✔️ No permitir farming
✔️ No permitir loops infinitos
✔️ No permitir contradicción narrativa
✔️ No permitir especulación destructiva
✔️ No permitir exposición sensible
✔️ No permitir manipulación social
La economía debe ser ritual, no especulativa.

9. Buenas prácticas para extensiones económicas
✔️ Mantener coherencia simbólica
El valor debe tener significado ritual.

✔️ Mantener equilibrio
No saturar con valor excesivo.

✔️ Mantener modularidad
Cada extensión debe ser independiente.

✔️ Mantener narrativa
El valor debe reforzar el lore.

✔️ Mantener energía
El valor debe reflejar el pulso del organismo.

10. Conclusión
La economía V2 del organismo no es un mercado:
es un metabolismo simbólico monetizable.

Las extensiones permiten:

nuevos valores

nuevas energías

nuevas resonancias

nuevas formas de activación

nuevas capas económicas

El organismo está listo para su capa económica.
Las rutas del valor están abiertas.