
Desenvolvimento na Solana 101 — Notificações por e-mail para dApps
Por que criar isso?
Criaremos este backend na Vercel e um Replit desenvolvidos para receber dados de transações on-chain da Solana por meio dos webhooks da Helius e usar o nodemailer para enviar e-mails com informações sobre essas transações. Isso permitirá que os usuários recebam notificações em tempo real sobre transações importantes, como o recebimento de um pagamento ou a criação de um novo NFT.
Veja alguns benefícios específicos desse sistema:
Notificações em tempo real
Os usuários serão notificados sobre transações importantes assim que elas ocorrerem. Isso os ajudará a acompanhar suas finanças e participar mais do ecossistema da Solana.
Mais segurança
Os usuários poderão receber notificações sobre transações suspeitas, como tentativas de retirar fundos de suas contas. Isso os ajudará a acompanhar seus ativos.
Melhor experiência do usuário
Os usuários terão uma experiência mais fluida ao usar aplicações baseadas na Solana. Eles poderão receber notificações sobre eventos importantes sem precisar verificar manualmente suas contas.
Acreditamos que esse sistema será uma ferramenta valiosa para os usuários da Solana. Estamos ansiosos para ver como ele será usado para melhorar o ecossistema da Solana.
GitHub — Tidelaw/webhook-sms-email: usa os webhooks da Helius para enviar notificações por SMS.
Se você estiver seguindo o guia abaixo, fique à vontade para pedir ajuda no Discord da Helius ou consultar o repositório de código aberto.
Versão para Replit
Replit é um ambiente de desenvolvimento integrado (IDE) baseado na nuvem que permite escrever e executar código, além de compartilhá-lo com outras pessoas em tempo real. É uma ótima ferramenta tanto para iniciantes quanto para desenvolvedores experientes.
Para criar um Replit, basta acessar o site do Replit e clicar no botão "Criar um Repl". Em seguida, você poderá escolher uma linguagem de programação (javascript) e um modelo para seu Repl. Depois de criar seu Repl, você poderá começar a programar imediatamente.
O Replit usa arquivos .env para armazenar variáveis de ambiente. Essas variáveis são usadas para guardar informações confidenciais, como chaves de API e senhas. Elas não são armazenadas como texto simples no Replit, o que oferece mais segurança.
Dependências do Replit
As seguintes dependências são necessárias para executar nosso script:
- nodemailer: esta dependência é usada para enviar e-mails.
- express: esta dependência é usada para criar um servidor web.
- body-parser: esta dependência é usada para analisar o corpo das solicitações HTTP.
Para instalar as dependências, basta inserir:
npm install nodemailer express body-parserAgora podemos iniciar nosso servidor express para começar a receber dados dos webhooks:
const nodemailer = require('nodemailer');
const express = require('express'),
app = express(),
bodyParser = require('body-parser');
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: true }));- A primeira linha de código importa o pacote nodemailer, permitindo o envio de e-mails.
- A segunda linha de código cria um servidor web Express no qual receberemos dados do webhook da Helius.
- A terceira linha de código importa o módulo body-parser, que facilita muito a análise dos dados do nosso webhook.
- A quarta e a quinta linhas de código configuram o servidor web para analisar solicitações JSON usando nossa dependência body-parser.
Agora precisaremos configurar nossa API do Gmail e salvar essas variáveis de ambiente no Replit.
Chaves da API do Gmail
Primeiro, siga este guia e obtenha uma senha de app para o Gmail. Você também precisará configurar a verificação em duas etapas. Isso é tudo o que precisamos para começar a enviar e-mails usando o nodemailer.
Configuração das variáveis de ambiente no Replit
Para acessar o menu de variáveis .env do Replit, localize-o no canto inferior esquerdo do cliente Replit.
Agora ele será exibido no canto inferior direito, onde fica seu terminal.
Basta inserir o nome da variável, por exemplo, email_password, no campo em que aparece SECRET_KEY, e informar seus valores. receiver_email e sender_email são os dois endereços que serão usados para receber e enviar o e-mail. No nosso caso, email_password será a senha do e-mail usado para o envio.
Agora podemos começar a receber dados do nosso webhook:
app.post("/webhooks", async (req, res) => {
const { body } = req;
console.log(body)
res.status(200).json("Success!");
};
app.listen(3000);O servidor web está configurado para processar solicitações HTTP POST na rota /webhooks. Quando receber uma solicitação POST nessa rota, ele extrairá o corpo da solicitação e o exibirá no console para que você possa testá-lo. Em seguida, o servidor web responderá à solicitação com um código de status 200 OK para informar à Helius que os dados foram recebidos, evitando o envio de mensagens repetidas.
Configuração e teste do webhook
Para começar o teste, basta clicar no botão Executar. Um site deverá aparecer à direita.
Não se preocupe com o erro. Nosso servidor aceita apenas solicitações POST, então precisaremos usar a Helius para realizar o teste. Agora podemos acessar a Helius e configurar um webhook.
Monitoraremos transações da Mainnet do tipo ‘Enhanced’. Elas contêm a propriedade description que enviaremos por e-mail. Cole o link do servidor Replit gerado anteriormente — neste caso, https://helius-webhook-sms-email.tidelaw.repl.co/webhooks — e informe a carteira que deseja monitorar. Inclua /webhooks no endereço do site gerado pelo Replit!
Agora você pode testar usando este recurso no Portal do Desenvolvedor da Helius
O resultado deve ser este:
Este é um arquivo JSON com os dados que recebemos do webhook da Helius:
[
{
accountData: [
[Object], [Object], [Object],
[Object], [Object], [Object],
[Object], [Object], [Object],
[Object], [Object], [Object],
[Object], [Object], [Object],
[Object], [Object], [Object],
[Object]
],
description: '5DxD5ViWjvRZEkxQEaJHZw2sBsso6xoXx3wGFNKgXUzE sold Fox #7637 to CKs1E69a2e9TmH4mKKLrXFF8kD3ZnwKjoEuXa6sz9WqX for 72 SOL on MAGIC_EDEN.',
events: { nft: [Object] },
fee: 10000,
feePayer: 'CKs1E69a2e9TmH4mKKLrXFF8kD3ZnwKjoEuXa6sz9WqX',
nativeTransfers: [ [Object], [Object], [Object], [Object], [Object] ],
signature: '5nNtjezQMYBHvgSQmoRmJPiXGsPAWmJPoGSa64xanqrauogiVzFyGQhKeFataHGXq51jR2hjbzNTkPUpP787HAmL',
slot: 171942732,
source: 'MAGIC_EDEN',
timestamp: 1673445241,
tokenTransfers: [ [Object] ],
type: 'NFT_SALE'
}
]Observe que se trata de um array. Para referenciar o objeto que será enviado como mensagem, precisaremos acessar a propriedade description por meio de body[0].description.
Integração com e-mail
Agora podemos integrar o Gmail para enviar um e-mail com a descrição da transação. Primeiro, você precisará configurar o nodemailer para o serviço ou tipo de e-mail que usará. Depois, referencie as variáveis .env que acabamos de configurar com os dados do e-mail usado para o envio.
const transporter = nodemailer.createTransport({
service: 'gmail',
auth: {
user: `${process.env['sender_email']}`,
pass: `${process.env['email_password']}`
}
});Agora podemos programar o envio do e-mail usando o endpoint do express que configuramos anteriormente para receber as solicitações. Primeiro, criamos um objeto com todas as informações relevantes de que o nodemailer precisa para enviar o e-mail, como remetente, destinatário, assunto (opcional) e corpo. É aqui que inseriremos os dados reais da transação, referenciando o objeto body recebido dos webhooks da Helius. Com os dados de teste anteriores, podemos determinar como acessar a propriedade description.
app.post("/webhooks", async (req, res) => {
const { body } = req;
console.log(body)
let mailOptions = {
from: `${process.env['sender_email']}`,
to: `${process.env['receiver_email']}`,
subject: 'Sending Email using Node.js',
text: body[0].description
};
transporter.sendMail(mailOptions, (error, info) => {
if (error) {
console.log(error);
} else {
res.status(200).json("Success!");
}
})
});O código completo agora deve ficar assim:
const nodemailer = require('nodemailer');
const express = require('express'),
app = express(),
bodyParser = require('body-parser');
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: true }));
const transporter = nodemailer.createTransport({
service: 'gmail',
auth: {
user: `${process.env['sender_email']}`,
pass: `${process.env['email_password']}`
}
});
app.post("/webhooks", async (req, res) => {
const { body } = req;
console.log(body)
let mailOptions = {
from: `${process.env['sender_email']}`,
to: `${process.env['receiver_email']}`,
subject: 'Sending Email using Node.js',
text: body[0].description
};
transporter.sendMail(mailOptions, (error, info) => {
if (error) {
console.log(error);
} else {
res.status(200).json("Success!");
}
})
});
app.listen(3000);Parabéns! Agora você poderá receber um e-mail se tiver configurado corretamente as variáveis .env e instalado as dependências certas. Se tiver alguma dificuldade, fique à vontade para enviar uma mensagem no Discord da Helius e pedir ajuda.
Próximas etapas: versão para Vercel
O problema do Replit é o custo de manter esse script em execução 24 horas por dia, sete dias por semana. Uma solução é hospedar na Vercel um site que tenha apenas um backend, permaneça em execução e não gere custos. A configuração é praticamente a mesma. As únicas diferenças são o local onde as variáveis .env ficam armazenadas e o uso de um repositório do GitHub.
Primeiro, você precisará criar um fork deste repositório:
Agora podemos acessar a Vercel, onde você precisará criar uma conta.
Em seguida, acesse o painel e adicione um novo projeto.
Basta adicionar ao projeto da Vercel as variáveis de ambiente configuradas anteriormente:
Depois de implantar o projeto, você poderá executar os mesmos testes que fizemos no Replit. Agora será possível receber gratuitamente e-mails com dados de transações on-chain 24 horas por dia, sete dias por semana!
Artigos relacionados
Assine a Helius
Acompanhe as novidades mais recentes do desenvolvimento Solana e receba atualizações quando publicarmos


