crypto-gateway-project
Gateway de pagos autoalojado en Rust para USDT TRC20. No custodia claves privadas, verifica bloques independientes y usa webhooks firmados. Ideal para comercios que requieren seguridad financiera sin intermediarios financieros tradicionales.
Ficha actualizada 28 sept 2026, 8:17 · upstream 28 sept 2026, 8:15 · release sin release detectada
Qué es crypto-gateway-project
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este proyecto es una pasarela de pago autoalojada construida en Rust con base de datos PostgreSQL. Su objetivo principal es procesar pagos entrantes de stablecoins (actualmente USDT TRC20) verificando la cadena de bloques de forma independiente sin custodiar claves privadas. El sistema garantiza integridad financiera mediante verificación cruzada de múltiples proveedores y un registro de auditoría reconcilable.
La arquitectura separa roles en contenedores únicos: API, observadores, verificadores y administradores. Implementa seguridad robusta con webhooks firmados HMAC-SHA256, claves derivadas por endpoint y manejo estricto de dinero entero para evitar errores de punto flotante. El despliegue requiere Docker Compose, PostgreSQL y scripts de inicialización manuales para configurar la rail (ruta de pago) y las políticas de recolección.
Es adecuado para entornos donde el control total sobre los fondos es prioritario. Ofrece ejemplos de integración en TypeScript y Python, documentación de arquitectura detallada y un modelo de amenazas documentado. Requiere configuración inicial mediante CLI administrativa y gestión manual de claves operadoras antes del uso productivo.
- Procesar pagos entrantes de USDT TRC20 para órdenes de comercio electrónico
- Verificar integridad de transacciones mediante múltiples proveedores de cadena
- Integrar webhooks firmados en sistemas externos para notificaciones de pago
- Monitorear salud de la red y precios de activos mediante API de operador
- Arquitectura no custodial que nunca almacena claves privadas
- Verificación independiente de bloques con relectura propia del gateway
- Manejo estricto de dinero entero (NUMERIC, U256) sin punto flotante
- Webhooks firmados con rotación segura de secretos por endpoint
- Idempotencia en todas las operaciones de escritura de la API
- Soporte actual limitado a USDT TRC20; ERC20 y TON están planificados pero no disponibles
- No permite pagos salientes, reembolsos ni cancelación de intenciones vía API
- Requiere configuración manual inicial con CLI administrativa y scripts SQL
- Dependencia de proveedores externos para lectura de la cadena (TronGrid/Nile)
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Requiere Docker Compose y PostgreSQL. Ejecutar gateway-worker admin para crear comercios y claves API. Inicializar base de datos con scripts/seed-dev-rail.sql. Configurar GATEWAY_WEBHOOK_MASTER_KEY en .env. Necesita 4 núcleos CPU, 4GB RAM y 20GB disco. Puerto 8080 para API, 54329 para DB.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.