← Blog
10 min de lectura
|
Publicado
|
Actualizado

API de blockchain frente a nodo: cuál usar

Un nodo sincroniza y guarda la cadena completa. Una API de blockchain aloja nodos y añade datos decodificados y webhooks. Costes y cuándo elegir cada uno.

Capítulos
C
Chaingateway Team
Expertos en blockchain

Revisado por Maurice Sobiera

Un nodo blockchain es un software que sincroniza, valida y guarda una blockchain, y responde consultas de bajo nivel sobre ella. Una API de blockchain es un servicio alojado que ejecuta nodos por usted y devuelve JSON decodificado, a menudo con webhooks. Elija un nodo si quiere control total, y una API si quiere lanzar pagos sin operar infraestructura.

¿Qué necesita para interactuar con una blockchain?

Cualquier aplicación que lea saldos, envíe transacciones o reaccione a depósitos necesita una conexión a un nodo. Tome un depósito en un exchange: un usuario ve una dirección de Tron y envía 100 TRX a ella. El exchange debe enterarse de que la transferencia llegó. Puede escanear cada bloque nuevo por su cuenta, o pedir a un servicio que le llame cuando una dirección recibe fondos. Leer un saldo funciona igual. Cuando consulta una dirección en un explorador de bloques como Etherscan, el explorador obtuvo ese número de un nodo.

¿Qué supone ejecutar su propio nodo?

Instala un cliente, espera la sincronización inicial y mantiene la máquina parcheada, con copias de seguridad y monitorizada. El hardware depende de la cadena. Para Ethereum, la documentación oficial de nodos indica como mínimo 2 núcleos de CPU, 16 GB de RAM, un SSD NVMe de 2 TB y 25 Mbit/s de ancho de banda (comprobado el 5 de noviembre de 2026). Esas cifras cambian con las versiones del cliente y el crecimiento de la cadena, y la propia página advierte de que es probable que el requisito de disco se supere en 2027. Un nodo de Ethereum necesita dos programas, un cliente de ejecución y un cliente de consenso (ethereum.org). Otras cadenas tienen sus propios requisitos: un nodo completo de Bitcoin y un nodo completo de Tron necesitan cada uno su propio cliente, disco y tiempo de sincronización.

Un nodo devuelve datos en bruto. En la interfaz JSON-RPC de Ethereum, las cantidades son cadenas hexadecimales. Una petición de saldo devuelve algo como 0x2386f26fc10000, que son 10^16 wei o 0,01 ETH, y su código debe convertirlo. Las transferencias de tokens son entradas de log que se decodifican con la ABI del contrato.

Detectar depósitos es la parte más difícil. Los nodos de Ethereum pueden enviar eventos por una suscripción WebSocket, pero una conexión caída deja un hueco que hay que rellenar escaneando bloques. Un escáner escrito por usted mismo tiene que hacer lo siguiente:

  1. Obtener cada bloque nuevo, o los logs que coinciden con el evento Transfer del token.
  2. Comparar el destinatario de cada transferencia con su lista de direcciones de clientes.
  3. Esperar suficientes confirmaciones y gestionar los bloques que se reemplazan en una reorganización de la cadena.
  4. Guardar el número del último bloque procesado, para que un reinicio no salte bloques.
  5. Repetir todo esto para cada cadena que soporte, porque cada una tiene su propio cliente y su propio formato de datos.

Para Tron, la documentación de suscripción a eventos describe la ruta de plug-ins, que también tiene que operar usted.

¿En qué se diferencia una API de blockchain?

Ejecuta los nodos, decodifica los datos y los expone como endpoints JSON. En Chaingateway, un webhook sustituye al escaneo de bloques. Esta petición registra una URL que se llama cuando una dirección concreta recibe un token TRC20:

Terminal window
curl -X POST https://app.chaingateway.io/api/v2/tron/webhooks \
-H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to": "TWrTTVizHkF3LxTiWE9vCnhWC7CBpNXe22",
"url": "https://example.com/hooks/deposit",
"type": "TRC20",
"reference": "order-1042"
}'

Hay webhooks para Tron, Ethereum, BNB Smart Chain, Polygon, Arbitrum y Bitcoin. Solana no tiene ninguno, así que en Solana consulta las transacciones.

¿Qué pasa cuando falla un webhook?

Las notificaciones fallidas no se reintentan automáticamente. Aparecen en una lista que se lee con GET /api/v2/<chain>/webhooks/notifications/failed. Después llama a POST /api/v2/<chain>/webhooks/notifications/{id}/retry para cada entrada. Una notificación que vuelve a fallar regresa a la lista. Cada notificación guardada lleva el ID de la transacción, el tipo (por ejemplo TRC20), la dirección del contrato, el remitente, el destinatario, el número de bloque y el número de intentos.

Dos consecuencias para su servidor receptor. Debe responder rápido con un código de éxito, y debe tolerar que el mismo evento llegue dos veces, por ejemplo tras un reintento manual. Use el ID de la transacción como clave para eliminar duplicados.

¿Qué es mejor, nodo o API?

Ninguno gana en general. La tabla muestra en qué se diferencian.

Nodo propioAPI de blockchain
Puesta en marchaInstalar el cliente, sincronizar, asegurar el servidorCrear una cuenta y un token
Hardware y mantenimientoSuyos: disco, parches, actualizaciones del cliente, monitorizaciónDel proveedor
Formato de datosEn bruto (cantidades hexadecimales, logs codificados)JSON decodificado
Notificaciones de depósitoLas construye ustedWebhooks, donde la API los soporta
ControlTotal: versión del cliente, configuración, sin límites compartidosLimitado a lo que expone la API
CosteServidores y tiempo de ingenieríaPrecio del plan, por uso o mensual
Gestión de fallosSu equipoLa infraestructura del proveedor, pero depende de ella

Elija un nodo si necesita métodos que una API no expone, si debe controlar la versión del cliente o si tiene razones regulatorias para mantener toda la infraestructura en casa. Elija una API si su producto es otra cosa distinta de infraestructura. Los equipos que ya emplean ingenieros de blockchain a veces siguen usando una API para cadenas en las que no se especializan.

¿Cómo empezar con Chaingateway?

Cree una cuenta para la prueba gratuita de 7 días, que no requiere tarjeta ni KYC, y use la testnet añadiendo X-Network: testnet a sus peticiones. Los planes empiezan en 49 € al mes.

Empiece gratis

Cómo escribimos estos artículos

¿Listo para construirlo tú mismo? Obtenga su clave de API — prueba de 7 días, sin tarjeta — o consulte API Blockchain para la referencia completa de los endpoints.

C
Chaingateway Team
Expertos en blockchain

El equipo de Chaingateway se dedica a simplificar la integración blockchain para desarrolladores de todo el mundo.