
Solana Dev 101 – E-Mail-Benachrichtigungen für dApps
Warum solltest du das entwickeln?
Wir entwickeln dieses Vercel-Backend und Replit. Sie empfangen Daten zu Onchain-Transaktionen von Solana über die webhooks von Helius und senden mit node-mailer E-Mails, die Informationen zu diesen Transaktionen enthalten. So können sich Nutzer in Echtzeit über wichtige Transaktionen benachrichtigen lassen, etwa wenn sie eine Zahlung erhalten oder ein neuer NFT gemintet wird.
Dieses System bietet unter anderem folgende Vorteile:
Echtzeitbenachrichtigungen
Nutzer werden über wichtige Transaktionen informiert, sobald sie stattfinden. So behalten sie ihre Finanzen im Blick und können aktiver am Solana-Ökosystem teilnehmen.
Mehr Sicherheit
Nutzer können Benachrichtigungen über verdächtige Transaktionen erhalten, etwa über Versuche, Guthaben von ihrem Konto abzuheben. So können sie ihre Assets verfolgen.
Bessere Nutzererfahrung
Nutzer profitieren bei Solana-basierten Anwendungen von einer nahtloseren Erfahrung. Sie erhalten Benachrichtigungen über wichtige Ereignisse, ohne ihre Konten manuell prüfen zu müssen.
Wir glauben, dass dieses System ein wertvolles Tool für Solana-Nutzer sein wird. Wir sind gespannt, wie es das Solana-Ökosystem verbessert.
Wenn du der folgenden Anleitung folgst, kannst du im Helius Discord um Hilfe bitten oder das Open-Source-Repository prüfen.
Replit-Version
Replit ist eine cloudbasierte integrierte Entwicklungsumgebung (IDE), in der du Code schreiben, ausführen und in Echtzeit mit anderen teilen kannst. Sie eignet sich für Einsteiger genauso wie für erfahrene Entwickler.
Um ein Replit zu erstellen, rufst du einfach die Replit-Website auf und klickst auf „Create a Repl“. Anschließend kannst du eine Programmiersprache (javascript) und eine Vorlage für dein Repl auswählen. Sobald du dein Repl erstellt hast, kannst du direkt mit dem Programmieren beginnen.
Replit speichert Umgebungsvariablen in .env-Dateien. Umgebungsvariablen dienen dazu, sensible Informationen wie API-Schlüssel und Passwörter zu speichern. Da sie in deinem Replit nicht als Klartext gespeichert werden, sind sie besser geschützt.
Replit-Abhängigkeiten
Zum Ausführen unseres Skripts sind folgende Abhängigkeiten erforderlich:
- nodemailer: Diese Abhängigkeit wird zum Senden von E-Mails verwendet.
- express: Diese Abhängigkeit wird zum Erstellen eines Webservers verwendet.
- body-parser: Diese Abhängigkeit wird zum Parsen des Bodys von HTTP-Anfragen verwendet.
Gib zum Installieren der Abhängigkeiten einfach Folgendes ein:
npm install nodemailer express body-parserJetzt können wir unseren express-Server starten, um Daten von den webhooks zu empfangen:
const nodemailer = require('nodemailer');
const express = require('express'),
app = express(),
bodyParser = require('body-parser');
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: true }));- Die erste Codezeile importiert das nodemailer-Paket, mit dem wir E-Mails senden können.
- Die zweite Codezeile erstellt einen Express-Webserver, auf dem wir Daten vom webhook von Helius empfangen.
- Die dritte Codezeile importiert das body-parser-Modul, mit dem sich die Daten unseres webhooks deutlich einfacher parsen lassen.
- Die vierte und fünfte Codezeile konfigurieren den Webserver mithilfe unserer body-parser-Abhängigkeit zum Parsen von JSON-Anfragen.
Jetzt müssen wir unsere Gmail API einrichten und diese Umgebungsvariablen in Replit speichern.
Gmail API-Schlüssel
Folge zuerst dieser Anleitung und erstelle ein App-Passwort für Gmail. Außerdem musst du die Bestätigung in zwei Schritten einrichten. Mehr benötigen wir nicht, um mit node-mailer E-Mails zu senden.
Umgebungsvariablen in Replit einrichten
Das Menü für .env-Variablen findest du unten links in deinem Replit-Client.
Es wird nun unten rechts angezeigt, wo sich auch dein Terminal befindet.
Gib dort, wo SECRET_KEY steht, einfach den Namen der Variable ein, z. B. email_password, und trage deine Werte ein. receiver_email und sender_email sind die beiden E-Mail-Adressen zum Empfangen und Senden der E-Mail. email_password ist in unserem Fall das Passwort für die E-Mail-Adresse, über die du sie sendest.
Jetzt können wir Daten von unserem webhook empfangen:
app.post("/webhooks", async (req, res) => {
const { body } = req;
console.log(body)
res.status(200).json("Success!");
};
app.listen(3000);Der Webserver ist so konfiguriert, dass er HTTP-POST-Anfragen an die Route /webhooks verarbeitet. Wenn der Webserver eine POST-Anfrage an die Route /webhooks empfängt, extrahiert er den Body der Anfrage und zeigt ihn zum Testen in der Konsole an. Anschließend antwortet der Webserver mit dem Statuscode 200 OK. So weiß Helius, dass wir die Anfrage empfangen haben, und sendet keine wiederholten Nachrichten.
webhook einrichten und testen
Klicke zum Testen einfach auf die Schaltfläche Run. Daraufhin sollte rechts eine Website erscheinen.
Lass dich von der Fehlermeldung nicht irritieren. Unser Server akzeptiert nur POST-Anfragen, daher müssen wir zum Testen Helius verwenden. Jetzt können wir zu Helius wechseln und einen webhook einrichten.
Wir überwachen Mainnet-Transaktionen des Typs „Enhanced“. Sie enthalten die Eigenschaft description, die wir per E-Mail senden. Füge den Link des zuvor generierten Replit-Servers ein, in diesem Fall https://helius-webhook-sms-email.tidelaw.repl.co/webhooks, sowie die Wallet, die du überwachen möchtest. Füge /webhooks unbedingt an die von Replit generierte Website an!
Du kannst den webhook jetzt mit dieser Funktion im Helius Developer Portal testen.
Dabei sollte Folgendes zurückgegeben werden:
Hier ist eine JSON-Datei mit den Daten, die wir vom webhook von Helius empfangen haben:
[
{
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'
}
]Beachte, dass es sich um ein Array handelt. Um auf das Objekt zu verweisen, das wir als Nachricht senden möchten, müssen wir über body[0].description auf die Eigenschaft description zugreifen.
E-Mail-Integration
Jetzt können wir Gmail integrieren und eine E-Mail mit der Beschreibung der Transaktion senden. Zuerst musst du nodemailer für den verwendeten Dienst oder E-Mail-Typ konfigurieren. Verweise dann auf die gerade eingerichteten .env-Variablen und verwende die Daten der E-Mail-Adresse, von der aus du die Nachricht sendest.
const transporter = nodemailer.createTransport({
service: 'gmail',
auth: {
user: `${process.env['sender_email']}`,
pass: `${process.env['email_password']}`
}
});Jetzt können wir den eigentlichen E-Mail-Versand programmieren. Dafür verwenden wir den zuvor eingerichteten express-Endpunkt, der die Anfragen empfängt. Zuerst erstellen wir ein Objekt mit allen relevanten Informationen, die nodemailer zum Senden der E-Mail benötigt, z. B. Absender, Empfänger, Betreff (optional) und Body. Hier fügen wir die eigentlichen Transaktionsdaten ein, indem wir auf das Body-Objekt verweisen, das wir von den webhooks von Helius erhalten haben. Anhand der vorherigen Testdaten können wir ermitteln, wie wir auf die Eigenschaft description zugreifen.
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!");
}
})
});Der vollständige Code sollte jetzt so aussehen:
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);Glückwunsch! Wenn du die .env-Variablen richtig konfiguriert und die korrekten Abhängigkeiten installiert hast, solltest du jetzt E-Mails empfangen können. Falls du nicht weiterkommst, sende einfach eine Nachricht im Helius Discord und bitte um Hilfe.
Nächste Schritte: Vercel-Version
Das Problem bei Replit: Es kostet Geld, dieses Skript rund um die Uhr auszuführen. Eine Lösung besteht darin, eine Website mit reinem Backend auf Vercel zu hosten. Sie läuft dauerhaft und kostenlos. Die Einrichtung ist weitgehend identisch. Lediglich der Speicherort der .env-Variablen und ein GitHub-Repository unterscheiden sich.
Zuerst musst du dieses Repository forken:
Jetzt kannst du zu Vercel wechseln und dort ein Konto erstellen.
Öffne anschließend das Dashboard und füge ein neues Projekt hinzu.
Füge dem Vercel-Projekt einfach die zuvor verwendeten Umgebungsvariablen hinzu:
Nach dem Deployment des Projekts kannst du dieselben Tests wie bei Replit ausführen. Du kannst jetzt rund um die Uhr kostenlos E-Mails mit Onchain-Transaktionsdaten empfangen!
Ähnliche Artikel
Helius abonnieren
Bleib bei der Solana-Entwicklung auf dem Laufenden und erhalte Updates, wenn wir neue Beiträge veröffentlichen


