Desarrollar en el ecosistema TroncoCorp: guía para integradores

TroncoCorp no es solo un conjunto de productos. Es una plataforma sobre la que cualquiera puede construir. Esta guía explica cómo hacerlo.

Filosofía de integración

Antes de los detalles técnicos, tres principios:

1. Todo es open source — El código del ecosistema está disponible para auditoría, fork y contribución. No hay cajas negras.
2. Las APIs son públicas — No necesitas un contrato comercial para integrarte. Solo necesitas una clave de API.
3. Tú controlas tus datos — Integrarte con TroncoCorp no significa entregarnos tus datos. Las APIs están diseñadas para que los datos del integrador nunca crucen nuestras fronteras si no es necesario.

API Gateway

El punto de entrada único para todas las integraciones es el API Gateway en api.troncocorp.io:

GET    /v1/status                  Estado del ecosistema
GET    /v1/nodes                   Lista de nodos Zénit disponibles
POST   /v1/auth/register           Registro de aplicación
POST   /v1/auth/token              Obtención de token JWT
GET    /v1/parliament/proposals    Propuestas activas del Parlamento
POST   /v1/tripx/bookings          Crear reserva TripX
GET    /v1/zenit/graph             Topología de red Zénit

Todas las respuestas usan JSON con envelope estándar:

{
  "status": "ok",
  "data": { ... },
  "meta": {
    "timestamp": "2026-06-18T10:00:00Z",
    "version": "1.0"
  }
}

Autenticación federada

No obligamos a los usuarios a crear cuentas nuevas. Nuestro sistema de autenticación federada soporta:

• OAuth 2.0 + OpenID Connect
• Claves API para machine-to-machine
• Web3 (si el integrador lo prefiere)

Cada aplicación integradora recibe un client_id y puede configurar sus propios scopes de acceso.

Webhooks

Para integraciones en tiempo real, el sistema de webhooks permite suscribirse a eventos del ecosistema:

• booking.created — Nueva reserva TripX
• proposal.voted — Votación registrada en el Parlamento
• node.status — Cambio de estado de un nodo Zénit
• payment.confirmed — Pago completado

Los webhooks se entregan con firma HMAC para verificación. Si tu endpoint no responde en 5 segundos, reintentamos hasta 3 veces con backoff exponencial.

SDKs disponibles

Mantenemos SDKs oficiales para los lenguajes más usados del ecosistema:

• Python — pip install troncocorp-sdk
• TypeScript/JavaScript — npm install @troncocorp/sdk
• Go — go get github.com/troncocorp/sdk-go

Los SDKs gestionan autenticación, reintentos, rate limiting y serialización automáticamente.

Rate limiting y precios

El tier gratuito permite 1000 requests/día. Por encima de eso, se usa el token TRN como unidad de consumo:

• 1000 requests extra = 1 TRN
• 1 webhook activo = 5 TRN/mes
• Acceso a datos históricos = 10 TRN/consulta

Los tokens TRN se adquieren contribuyendo al ecosistema o a través del programa de socios.

Integración con nodos Zénit

Para integradores que necesitan capacidad de cómputo soberana, la red Zénit permite alquilar capacidad de nodo:

POST /v1/zenit/allocate
{
  "cpu": 4,
  "ram_gb": 8,
  "storage_gb": 100,
  "duration_days": 30
}

Los nodos se asignan en segundos y corren en infraestructura 100% soberana con energía renovable.

Ejemplo rápido

from troncocorp_sdk import TroncoCorpClient

client = TroncoCorpClient(api_key="tc_key_xxxx")

# Listar propuestas activas del Parlamento
props = client.parliament.list_proposals()
for p in props:
    print(f"{p.id}: {p.title} ({p.votes} votos)")

# Crear un webhook para reservas TripX
client.webhooks.create(
    url="https://miapp.com/webhook",
    events=["booking.created"]
)

Cómo empezar

1. Regístrate en api.troncocorp.io/register
2. Obtén tu API key
3. Instala el SDK de tu lenguaje
4. Haz tu primer request

Y si construyes algo interesante, el Parlamento Digital tiene un fondo de grants para proyectos que extiendan el ecosistema. No es inversión. Es financiación soberana.