# MODULAR_EXTENSIONS_CONNECTIONS.md  
### Extensiones del Sistema de Conexiones del Organismo 4GatosCoin  
### Versión 1.0 — 2 de enero 2026

---

## 1. Propósito del documento

Este documento define cómo crear extensiones que interactúan con el **Sistema de Conexiones** del organismo 4GatosCoin.  
Las conexiones no son “amistades” ni “follows”:  
son **vínculos simbólicos**, rituales, energéticos y narrativos entre wallets.

Las conexiones:

- fortalecen el pulso  
- activan rituales colaborativos  
- influyen en el territorio  
- afectan al avatar  
- generan resonancia social  
- alimentan el feed vivo  
- forman parte de la narrativa  

Las extensiones permiten crear nuevas formas de conexión, nuevos rituales de vínculo y nuevas dinámicas simbólicas.

---

## 2. ¿Qué es una conexión?

Una conexión es un **vínculo simbólico** entre dos wallets.

Ejemplo:

```json
{
  "walletA": "0xAAA...",
  "walletB": "0xBBB...",
  "timestamp": 123456789
}
Las conexiones:

no tienen métricas visibles

no tienen contadores

no tienen jerarquías

no tienen “popularidad”

no son públicas por defecto

Son puentes rituales, no relaciones sociales tradicionales.

3. Tipos de conexiones
✔️ 3.1. Conexión simple
Una wallet conecta con otra.

✔️ 3.2. Conexión mutua
Ambas wallets se conectan entre sí.

✔️ 3.3. Conexión ritual
Activada por un ritual colaborativo.

Ejemplo:
“Puente de Resonancia”.

✔️ 3.4. Conexión narrativa
Activada por un eco o trigger narrativo.

Ejemplo:
“El bosque une dos voces”.

✔️ 3.5. Conexión territorial
Activada dentro de una zona específica.

Ejemplo:
“Conexión del Bosque Susurrante”.

✔️ 3.6. Conexión estacional
Solo disponible durante ciertas seasons.

Ejemplo:
“Vínculo de la Llama del Norte”.

✔️ 3.7. Conexión on‑chain (futura)
Validada mediante transacción en Base.

4. Hooks disponibles para extensiones de conexiones
Las extensiones pueden escuchar:

Eventos sociales
onConnectionCreated

onMutualConnection

Eventos energéticos
onGesture(type="pulse_to")

onGesture(type="echo_to")

Eventos rituales
onRitualCompleted

onRitualTriggered

Eventos territoriales
onZoneAwakened

Eventos globales
onSeasonChange

Eventos narrativos
onEcho

onLoreTrigger

5. Endpoints del sistema de conexiones
5.1. Crear conexión simbólica
json
POST /api/actions/social/connect
{
  "walletA": "0xAAA...",
  "walletB": "0xBBB..."
}
5.2. Crear conexión mutua
json
POST /api/actions/social/connect/mutual
{
  "walletA": "0xAAA...",
  "walletB": "0xBBB..."
}
5.3. Consultar conexiones
json
GET /api/social/connections/:wallet
5.4. Emitir gesto social dirigido
json
POST /api/actions/gesture
{
  "wallet": "0xAAA...",
  "type": "pulse_to",
  "target": "0xBBB..."
}
6. Arquitectura de una conexión
Una conexión puede incluir:

✔️ 6.1. Wallets involucradas
A y B.

✔️ 6.2. Tipo de conexión
simple, mutua, ritual, narrativa, territorial, estacional.

✔️ 6.3. Origen
gesto, ritual, season, territorio, narrativa.

✔️ 6.4. Intensidad simbólica (opcional)
No visible al usuario.

✔️ 6.5. Historia
Registro de interacciones.

7. Ejemplos de extensiones de conexiones
7.1. Extensión “Puente de Resonancia”
Trigger: dos wallets emiten echo_to en 30s

Acción: crear conexión

Eco: “Dos voces se encuentran.”

7.2. Extensión “Mirada Compartida”
Trigger: mirror(wallet) respondido en 10s

Acción: conexión mutua

Eco: “La mirada se sostiene.”

7.3. Extensión “Conexión del Bosque”
Trigger: zona WHISPERING_FOREST → awakening

Acción: conectar wallets activas en la zona

7.4. Extensión “Vínculo de la Llama del Norte”
Trigger: Season 03

Acción: conexiones energéticas entre avatares ignited

7.5. Extensión “Eco Encadenado”
Trigger: 3 ecos entre dos wallets

Acción: conexión narrativa

7.6. Extensión “Conexión On‑Chain” (futura)
Trigger: transacción verificada

Acción: conexión validada

8. Reglas de seguridad del sistema de conexiones
✔️ No se permiten métricas visibles
Nada de contadores, rankings o popularidad.

✔️ No se permite exposición sensible
Las conexiones no son públicas por defecto.

✔️ No se permite manipulación emocional
Las conexiones deben ser rituales, no coercitivas.

✔️ No se permite spam social
Rate limiting aplicado a gestos sociales.

✔️ No se permite contradicción narrativa
Las conexiones deben tener sentido simbólico.

✔️ No se permite romper el pulso
Las conexiones no otorgan puntos sin validación.

9. Buenas prácticas para diseñar conexiones
✔️ Mantener lo simbólico
Una conexión debe sentirse ritual.

✔️ Mantener lo ligero
No debe sentirse invasiva.

✔️ Mantener lo colectivo
Las conexiones fortalecen el organismo.

✔️ Mantener modularidad
Cada conexión debe poder existir sin romper otras.

10. Conclusión
Las conexiones son los hilos invisibles del organismo.
Las extensiones permiten:

nuevos vínculos

nuevas resonancias

nuevos rituales colaborativos

nuevas interacciones simbólicas

nuevas mutaciones narrativas

El organismo está listo para nuevos puentes.
Las rutas de conexión están abiertas.