Cómo crear webhooks de Arbitrum

Alchemy ahora es compatible con webhooks para Arbitrum, una solución de escalado de layer-2 basada en optimistic rollups para Ethereum. Los webhooks de Arbitrum facilitan la recepción de notificaciones web3 importantes.

En este artículo, te mostramos cómo crear y lanzar un webhook en Arbitrum, exploramos los eventos que se pueden rastrear usando webhooks de Arbitrum, y compartimos varios casos de uso.

¿Qué es un webhook?

Webhook es un término usado para proveer información en tiempo real para aplicaciones. Los webhooks también se conocen como web callbacks o HTTP push API.

Con webhooks, podrás recibir datos de manera rápida y frecuente, y suelen usarse para recibir notificaciones sobre ciertos eventos. Los webhooks tienen la capacidad de entregar datos en tiempo real tanto para proveedores como para consumidores.

La única desventaja de usar webhooks es configurarlos por primera vez. Los webhooks funcionan usando una URL para enviar notificaciones cuando ocurre un evento. Por suerte, Alchemy permite a los desarrolladores de Arbitrum crear webhooks de forma rápida y sencilla.

¿Qué eventos de Arbitrum se pueden rastrear con webhooks?

Existen tres tipos principales de notificaciones que los desarrolladores pueden crear usando Alchemy Notify para webhooks de Arbitrum: notificaciones de transacciones minadas, transacciones descartadas y actividad de dirección.

1. Transacciones minadas

Las notificaciones de transacciones minadas se usan para avisar que las transacciones enviadas a través de tu API fueron minadas exitosamente. Esto es útil si quieres notificar a los usuarios cuando sus transacciones se procesan, como al recibir tokens, completar mints o enviar tokens.

2. Transacciones descartadas

Las notificaciones de transacciones descartadas se usan para avisar a los usuarios de tu aplicación cuando una transacción enviada a través de tu API key falla o es descartada del mempool. La incertidumbre sobre una transacción ocurre cuando los usuarios no saben el estado actual de la misma.

Usando webhooks de Arbitrum, los desarrolladores de dApps pueden notificar a los usuarios que su transacción fue descartada y permitirles reintentarla.

3. Actividad de dirección

La actividad de dirección se usa para rastrear tokens como ETH, ERC20 y ERC721. Estos son eventos de transferencia que se pueden usar con tantas direcciones de Ethereum como se necesite. Usar este webhook permite recibir cambios en tiempo real cada vez que una dirección determinada envía o recibe un token.

Tipos de transferencias de dirección

1. Transferencias de tokens - muestra logs de cualquier transferencia ERC20, ERC721 y ERC1155.
2. Transferencias externas - estas transferencias se usan para transacciones de nivel superior donde la dirección de origen es una dirección externa creada por el usuario. Las direcciones externas tienen claves privadas y son accedidas por usuarios.
3. Transferencias internas - transferencias que ocurren desde el fromAddress, que es una dirección de smart contract interna (es decir, un smart contract llamando a otro smart contract, o un smart contract llamando a otra dirección externa).
4. Precios de gas - obtén los precios de gas actuales y recibe notificaciones cuando el precio del gas suba o baje de un umbral.

Ejemplos de webhooks de Arbitrum

Hay muchos ejemplos de casos de uso para los webhooks de Arbitrum. A continuación, una lista con algunos:

• Notificaciones de wallet de Arbitrum para actualizaciones de estado de transacciones
• Actualizaciones de airdrop de NFT cuando recibes un nuevo NFT de Arbitrum
• Un bot de Discord que envía notificaciones cada vez que una ballena de Arbitrum mueve tokens
• Un bot de Twitter que tuitea cada vez que se transfiere un NFT de Arbitrum de una colección específica

Los webhooks de Arbitrum les dan a los desarrolladores las herramientas necesarias para mantener a los usuarios informados sobre el estado de sus transacciones.

Cómo configurar webhooks en Arbitrum

Alchemy hace que crear webhooks para rastrear eventos sea extremadamente sencillo; de hecho, es tan simple como agregar una nueva URL a tu aplicación.

Hay dos formas principales de activar Alchemy Notify: desde el dashboard y de forma programática.

A continuación, mostramos los pasos para configurar un webhook usando el dashboard de Alchemy.

Paso 1 - crea una cuenta gratuita de Alchemy

Para crear tus webhooks, si aún no lo has hecho, asegúrate de crear una cuenta gratuita de Alchemy.

Paso 2 - crea un webhook desde el dashboard de Alchemy

Asegúrate de estar en el ecosistema "Ethereum + L2" en la esquina superior izquierda del dashboard de Alchemy.

Ve a la pestaña "Notify" y haz clic en el botón "Create Webhook" en la sección "Address Activity".

Paso 3 - selecciona Arbitrum y Mainnet para agregar notificaciones

Luego, completa estos campos para crear el webhook:

• Selecciona "Chain" como "Arbitrum",
• Selecciona "Network" como "Mainnet",

Luego, pega la URL del webhook que copiaste desde tu app, así como la dirección que quieres rastrear.

Paso 4 - agrega la URL de tu webhook de Arbitrum

Aquí, agregarías tu URL de webhook única, que puede ser el enlace donde quieres recibir las solicitudes (tu servidor, Slack, etc.).

Nota: el payload del webhook podría no ser siempre compatible con integraciones de terceros.

Paso 5 - prueba tu webhook de Arbitrum

Si quieres probar si el webhook de Alchemy envía solicitudes correctamente antes de confirmar su creación, haz clic en "Test Webhook" junto a la URL del webhook.

O si ya creaste el webhook pero quieres probarlo de nuevo, haz clic en los tres puntos junto a tu webhook y selecciona "Send Test Notification".

Paso 6 - haz clic en "create webhook"

Desde aquí, deberías verificar si tus respuestas están llegando. Si quieres hacer tus webhooks aún más seguros con Webhook Signature and Security, puedes generar un código hash HMAC SHA-256 usando tu clave de firma de webhook única. Esto verifica que los webhooks provienen de Alchemy.

Para aprender más sobre cómo configurar webhooks de forma programática, consulta la página de Notify API en la documentación.