Como criar webhooks na Arbitrum

A Alchemy agora suporta webhooks para Arbitrum, uma solução de escalonamento layer-2 baseada em optimistic rollup para Ethereum. Os webhooks do Arbitrum facilitam a configuração e o recebimento de notificações web3 importantes.

Neste artigo, mostramos como criar e ativar um webhook no Arbitrum, exploramos os eventos que podem ser rastreados usando webhooks do Arbitrum e compartilhamos alguns casos de uso.

O que é um webhook?

Webhook é um termo usado para fornecer informações em tempo real para aplicações. Webhooks também são chamados de web callbacks ou HTTP push API.

Com webhooks, você recebe dados de forma rápida e frequente, e eles costumam ser usados por usuários para receber notificações sobre determinados eventos. Webhooks permitem dados em tempo real tanto para provedores quanto para consumidores.

A única desvantagem de usar webhooks é configurá-los pela primeira vez. Webhooks funcionam usando uma URL para enviar notificações assim que um evento ocorre. Felizmente, a Alchemy permite que desenvolvedores do Arbitrum criem webhooks de forma rápida e fácil.

Quais eventos do Arbitrum podem ser rastreados com webhooks?

Existem três tipos principais de notificações que os desenvolvedores podem criar usando o Alchemy Notify para webhooks do Arbitrum: notificações de transação minerada, transação descartada e atividade de endereço.

1. Transações mineradas

Transações mineradas são usadas para notificar que as transações enviadas pela sua API foram mineradas com sucesso. Isso é útil se você quiser notificar clientes assim que suas transações forem processadas, como o recebimento de tokens, a conclusão de mints ou o envio de tokens.

2. Transações descartadas

Transações descartadas são usadas para notificar os usuários da sua aplicação quando uma transação enviada pela sua API key falha ou é descartada do mempool. A ansiedade em relação a transações ocorre quando os usuários não sabem o estado atual de sua transação.

Usando webhooks do Arbitrum, desenvolvedores de dApps podem notificar os usuários de que a transação foi descartada e permitir que eles tentem novamente.

3. Atividade de endereço

Atividade de Endereço é usada para rastrear tokens como ETH, ERC20 e ERC721. Estes são todos eventos de transferência usados para quantos endereços Ethereum você quiser. Usar esse webhook permite mudanças em tempo real sempre que um determinado endereço envia ou recebe um token.

Tipos de transferências de endereço

1. Transferências de tokens - exibe logs de qualquer transferência ERC20, ERC721 e ERC1155.
2. Transferências externas - essas transferências são usadas para transações de nível superior que ocorrem com um endereço de origem criado pelo usuário, ou seja, um endereço externo. Endereços externos possuem chaves privadas e são acessados por usuários.
3. Transferências internas - transferências que ocorrem a partir do fromAddress, que é um endereço de smart contract interno (ou seja, um smart contract chamando outro smart contract, ou um smart contract chamando outro endereço externo).
4. Preços de gas - obtenha os preços de gas atuais e seja notificado quando os preços de gas ficarem acima ou abaixo de um limite.

Exemplos de webhooks no Arbitrum

Existem muitos exemplos de casos de uso para webhooks do Arbitrum. Abaixo está uma lista com alguns:

• Notificações de carteira Arbitrum para atualizações de status de transação
• Atualizações de airdrop de NFT quando você recebe um novo NFT no Arbitrum
• Um bot do Discord que envia notificações sempre que uma whale do Arbitrum movimenta tokens
• Um bot do Twitter que posta um tweet toda vez que um NFT do Arbitrum é de uma coleção específica

Webhooks do Arbitrum dão aos desenvolvedores as ferramentas necessárias para manter os usuários informados sobre o status de suas transações.

Como configurar webhooks no Arbitrum

A Alchemy torna extremamente fácil criar webhooks para rastrear eventos; na verdade, é tão simples quanto adicionar uma nova URL à sua aplicação.

Existem duas formas principais de ativar o Alchemy Notify: pelo dashboard e programaticamente.

Abaixo, mostramos os passos para configurar um webhook usando o dashboard da Alchemy.

Passo 1 - crie uma conta gratuita na Alchemy

Para criar seus webhooks, caso ainda não tenha feito isso, certifique-se de criar uma conta gratuita na Alchemy.

Passo 2 - crie um webhook pelo dashboard da Alchemy

Certifique-se de estar no ecossistema "Ethereum + L2" no canto superior esquerdo do dashboard da Alchemy.

Navegue até a aba "Notify" e clique no botão "Create Webhook" na seção "Address Activity".

Passo 3 - escolha Arbitrum e Mainnet para adicionar notificações

Em seguida, preencha estes campos para criar o webhook:

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

Depois, cole a URL do webhook que você copiou do seu app, assim como o endereço que deseja rastrear.

Passo 4 - adicione a URL do seu webhook do Arbitrum

Aqui, você deve adicionar sua URL de webhook única; pode ser o link onde deseja receber as requisições (seu servidor, Slack, etc.).

Nota: o payload do webhook pode nem sempre ser compatível com integrações de terceiros.

Passo 5 - teste seu webhook do Arbitrum

Se você quiser testar se o webhook da Alchemy envia requisições com sucesso antes de confirmar a criação, clique em "Test Webhook" ao lado da URL do webhook.

Ou, se você já criou o webhook mas quer testar novamente, clique nos três pontos ao lado do seu webhook e selecione "Send Test Notification".

Passo 6 - clique em "create webhook"

A partir daqui, você deve verificar se as respostas estão chegando corretamente. Se quiser tornar seus webhooks ainda mais seguros com Webhook Signature and Security, você pode gerar um código hash HMAC SHA-256 usando sua chave de assinatura de webhook exclusiva. Isso verifica que os webhooks vêm da Alchemy.

Para aprender mais sobre como configurar webhooks programaticamente, consulte a página da Notify API na documentação.