
Solana Dev 101 - Notifikasi Email untuk dApps
Mengapa Anda perlu membuat ini?
Kita akan membuat backend Vercel dan Replit yang dirancang untuk menerima data transaksi on-chain Solana dari webhook Helius dan menggunakan node-mailer untuk mengirim email berisi informasi tentang transaksi tersebut. Dengan demikian, pengguna dapat menerima notifikasi transaksi penting secara real-time, seperti saat mereka menerima pembayaran atau ketika NFT baru dicetak.
Berikut beberapa manfaat spesifik sistem ini:
Notifikasi real-time
Pengguna akan menerima notifikasi transaksi penting segera setelah transaksi terjadi. Ini akan membantu mereka terus mengetahui kondisi keuangan dan lebih terlibat dalam ekosistem Solana.
Keamanan yang lebih baik
Pengguna dapat menerima notifikasi tentang transaksi mencurigakan, seperti upaya penarikan dana dari akun mereka. Ini akan membantu mereka memantau aset.
Pengalaman pengguna yang lebih baik
Pengguna akan mendapatkan pengalaman yang lebih lancar saat menggunakan aplikasi berbasis Solana. Mereka dapat menerima notifikasi tentang peristiwa penting tanpa perlu memeriksa akun secara manual.
Kami yakin sistem ini akan menjadi alat yang bermanfaat bagi pengguna Solana. Kami antusias melihat bagaimana sistem ini digunakan untuk meningkatkan ekosistem Solana.
GitHub - Tidelaw/webhook-sms-email: Menggunakan webhook Helius untuk mengirim notifikasi SMS.
Jika Anda mengikuti panduan di bawah ini, jangan ragu meminta bantuan di Discord Helius atau melihat repositori sumber terbuka.
Versi Replit
Replit adalah lingkungan pengembangan terintegrasi (IDE) berbasis cloud yang memungkinkan Anda menulis dan menjalankan kode serta membagikannya kepada orang lain secara real-time. Ini adalah alat yang sangat baik bagi pemula maupun developer berpengalaman.
Untuk membuat Replit, cukup buka situs web Replit dan klik tombol "Create a Repl". Setelah itu, Anda dapat memilih bahasa pemrograman (javascript) dan template untuk Repl Anda. Setelah Repl dibuat, Anda dapat langsung mulai menulis kode.
Replit menggunakan file .env untuk menyimpan variabel lingkungan. Variabel lingkungan digunakan untuk menyimpan informasi sensitif, seperti kunci API dan kata sandi. Informasi tersebut tidak disimpan sebagai teks biasa di Replit Anda sehingga lebih aman.
Dependensi Replit
Dependensi berikut diperlukan untuk menjalankan skrip kita:
- nodemailer: Dependensi ini digunakan untuk mengirim email.
- express: Dependensi ini digunakan untuk membuat server web.
- body-parser: Dependensi ini digunakan untuk mengurai isi permintaan HTTP.
Untuk menginstal dependensi, cukup masukkan:
npm install nodemailer express body-parserSekarang, kita dapat menjalankan server express untuk mulai menerima data dari webhook:
const nodemailer = require('nodemailer');
const express = require('express'),
app = express(),
bodyParser = require('body-parser');
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: true }));- Baris kode pertama mengimpor paket nodemailer sehingga kita dapat mengirim email.
- Baris kode kedua membuat server web Express tempat kita akan menerima data dari webhook Helius.
- Baris kode ketiga mengimpor modul body-parser yang mempermudah penguraian data dari webhook kita.
- Baris kode keempat dan kelima mengonfigurasi server web agar mengurai permintaan JSON menggunakan dependensi body-parser.
Sekarang kita perlu menyiapkan API Gmail serta menyimpan variabel lingkungan ini ke Replit.
Kunci API Gmail
Pertama, ikuti panduan ini dan dapatkan Sandi Aplikasi untuk Gmail. Anda juga perlu menyiapkan Verifikasi 2 Langkah. Hanya itu yang kita perlukan untuk mulai mengirim email menggunakan node-mailer.
Menyiapkan variabel lingkungan Replit
Untuk mengakses menu variabel .env Replit, temukan menu tersebut di kiri bawah klien Replit Anda.
Sekarang Anda akan melihatnya ditampilkan di kanan bawah, tempat terminal Anda berada.
Cukup masukkan nama variabel, misalnya email_password, di tempat SECRET_KEY berada, lalu masukkan nilainya. receiver_email dan sender_email adalah dua alamat email yang akan digunakan untuk mengirim dan menerima email. Dalam kasus kita, email_password adalah kata sandi untuk email yang akan Anda gunakan sebagai pengirim.
Sekarang kita dapat mulai menerima data dari webhook:
app.post("/webhooks", async (req, res) => {
const { body } = req;
console.log(body)
res.status(200).json("Success!");
};
app.listen(3000);Server web dikonfigurasi untuk menangani permintaan HTTP POST ke rute /webhooks. Saat server web menerima permintaan POST ke rute /webhooks, server akan mengambil isi permintaan dan menampilkannya di konsol agar dapat Anda uji. Server web kemudian merespons permintaan dengan kode status 200 OK untuk memberi tahu Helius bahwa kita telah menerimanya sehingga Helius tidak akan mengirim pesan berulang.
Penyiapan dan Pengujian Webhook
Untuk mulai menguji, cukup klik tombol Run dan sebuah situs web akan muncul di sebelah kanan.
Jangan khawatir dengan pesan error tersebut. Server kita hanya menerima permintaan POST sehingga kita perlu menggunakan Helius untuk mengujinya. Sekarang kita dapat membuka Helius dan menyiapkan webhook.
Kita akan memantau transaksi Mainnet berjenis ‘Enhanced’ yang memuat properti description untuk dikirim sebagai email. Tempelkan tautan server Replit yang dibuat sebelumnya, dalam hal ini https://helius-webhook-sms-email.tidelaw.repl.co/webhooks, serta wallet yang ingin Anda pantau. Pastikan Anda menyertakan /webhooks bersama situs yang dibuat Replit!
Sekarang Anda dapat mengujinya menggunakan fitur ini di Portal Developer Helius
Yang akan menghasilkan output berikut:
Berikut adalah file JSON berisi data yang kita terima dari webhook 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'
}
]Perhatikan bahwa data tersebut berupa array. Agar dapat merujuk objek yang akan dikirim sebagai pesan, kita perlu mengakses properti description melalui body[0].description.
Integrasi Email
Sekarang kita dapat mengintegrasikan Gmail sehingga kita dapat mengirim email yang berisi deskripsi transaksi. Pertama, Anda perlu mengonfigurasi nodemailer untuk layanan atau jenis email yang akan digunakan. Kemudian, rujuk variabel .env yang baru saja kita siapkan dengan detail alamat email yang akan digunakan sebagai pengirim.
const transporter = nodemailer.createTransport({
service: 'gmail',
auth: {
user: `${process.env['sender_email']}`,
pass: `${process.env['email_password']}`
}
});Sekarang kita dapat menulis kode untuk mengirim email menggunakan endpoint express yang sebelumnya disiapkan untuk menerima permintaan. Pertama, kita membuat objek berisi semua informasi relevan yang diperlukan nodemailer untuk mengirim email, misalnya pengirim, penerima, subjek (tidak wajib), dan isi pesan. Di bagian inilah kita akan memasukkan data transaksi aktual dengan merujuk objek body yang diterima dari webhook Helius. Dengan menggunakan data pengujian sebelumnya, kita dapat menentukan cara mengakses properti 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!");
}
})
});Kode lengkapnya sekarang akan terlihat seperti ini:
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);Selamat! Sekarang Anda seharusnya dapat menerima email jika telah mengonfigurasi variabel .env dengan benar dan menginstal dependensi yang tepat. Jika mengalami kendala, jangan ragu mengirim pesan di Discord Helius untuk mendapatkan bantuan.
Langkah Berikutnya, Versi Vercel
Masalah pada Replit adalah adanya biaya untuk menjalankan skrip ini 24/7. Salah satu solusinya adalah meng-host situs web di Vercel yang hanya memiliki backend. Situs tersebut akan terus berjalan tanpa biaya. Penyiapannya sebagian besar sama. Perbedaannya hanya terletak pada lokasi penyimpanan variabel .env dan penggunaan repositori GitHub.
Pertama, Anda perlu melakukan fork pada repositori ini:
Sekarang kita dapat membuka Vercel, tempat Anda perlu membuat akun.
Kemudian, buka dashboard dan tambahkan proyek baru.
Cukup tambahkan variabel lingkungan dari sebelumnya ke proyek Vercel:
Setelah menerapkan proyek, Anda dapat menjalankan pengujian yang sama seperti yang dilakukan untuk Replit. Sekarang Anda dapat menerima email berisi data transaksi on-chain secara gratis 24/7!
Artikel Terkait
Berlangganan Helius
Ikuti perkembangan terbaru dalam pengembangan Solana dan dapatkan pembaruan saat kami memublikasikan postingan


