
Solana Dev 101 - Thông báo qua email cho dApp
Tại sao nên xây dựng hệ thống này?
Chúng ta sẽ xây dựng backend Vercel và Replit để nhận dữ liệu giao dịch Solana trên chuỗi từ webhook của Helius, sau đó sử dụng node-mailer để gửi email chứa thông tin về các giao dịch này. Nhờ đó, người dùng có thể nhận thông báo theo thời gian thực về các giao dịch quan trọng, chẳng hạn như khi nhận được khoản thanh toán hoặc khi một NFT mới được đúc.
Sau đây là một số lợi ích cụ thể của hệ thống này:
Thông báo theo thời gian thực
Người dùng sẽ được thông báo về các giao dịch quan trọng ngay khi chúng diễn ra. Điều này giúp họ luôn nắm bắt tình hình tài chính và tham gia sâu hơn vào hệ sinh thái Solana.
Tăng cường bảo mật
Người dùng có thể nhận thông báo về các giao dịch đáng ngờ, chẳng hạn như hành vi cố gắng rút tiền khỏi tài khoản của họ. Điều này giúp họ theo dõi tài sản của mình.
Cải thiện trải nghiệm người dùng
Người dùng sẽ có trải nghiệm liền mạch hơn khi sử dụng các ứng dụng dựa trên Solana. Họ có thể nhận thông báo về những sự kiện quan trọng mà không cần kiểm tra tài khoản theo cách thủ công.
Chúng tôi tin rằng hệ thống này sẽ là một công cụ hữu ích cho người dùng Solana. Chúng tôi rất mong chờ cách hệ thống này được ứng dụng để cải thiện hệ sinh thái Solana.
GitHub - Tidelaw/webhook-sms-email: Sử dụng webhook của Helius để gửi thông báo SMS.
Nếu làm theo hướng dẫn dưới đây, bạn có thể yêu cầu trợ giúp trong Helius Discord hoặc tham khảo kho mã nguồn mở.
Phiên bản Replit
Replit là môi trường phát triển tích hợp (IDE) trên đám mây, cho phép bạn viết và chạy mã cũng như chia sẻ mã với người khác theo thời gian thực. Đây là công cụ hữu ích cho cả người mới bắt đầu lẫn nhà phát triển giàu kinh nghiệm.
Để tạo một Replit, chỉ cần truy cập trang web Replit và nhấp vào nút "Create a Repl". Sau đó, bạn có thể chọn ngôn ngữ lập trình (javascript) và mẫu cho Repl của mình. Sau khi tạo Repl, bạn có thể bắt đầu viết mã ngay lập tức.
Replit sử dụng tệp .env để lưu trữ các biến môi trường. Biến môi trường được dùng để lưu trữ thông tin nhạy cảm, chẳng hạn như khóa API và mật khẩu. Những thông tin này không được lưu dưới dạng văn bản thuần túy trong Replit nên an toàn hơn.
Phần phụ thuộc của Replit
Cần có các phần phụ thuộc sau để chạy tập lệnh:
- nodemailer: Phần phụ thuộc này được dùng để gửi email.
- express: Phần phụ thuộc này được dùng để tạo máy chủ web.
- body-parser: Phần phụ thuộc này được dùng để phân tích phần thân của yêu cầu HTTP.
Để cài đặt các phần phụ thuộc, chỉ cần nhập:
npm install nodemailer express body-parserBây giờ, chúng ta có thể khởi động máy chủ express để bắt đầu nhận dữ liệu từ các 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 }));- Dòng mã đầu tiên nhập gói nodemailer, cho phép chúng ta gửi email.
- Dòng mã thứ hai tạo một máy chủ web Express để nhận dữ liệu từ webhook của Helius.
- Dòng mã thứ ba nhập mô-đun body-parser, giúp việc phân tích dữ liệu từ webhook dễ dàng hơn nhiều.
- Dòng mã thứ tư và thứ năm cấu hình máy chủ web để phân tích các yêu cầu JSON bằng phần phụ thuộc body-parser.
Bây giờ, chúng ta cần thiết lập Gmail API và lưu các biến môi trường này vào Replit.
Khóa Gmail API
Trước tiên, hãy làm theo hướng dẫn này để lấy Mật khẩu ứng dụng cho Gmail. Bạn cũng cần thiết lập Xác minh 2 bước. Đó là tất cả những gì cần thiết để bắt đầu gửi email bằng node-mailer.
Thiết lập biến môi trường trong Replit
Để truy cập trình đơn biến .env của Replit, hãy tìm trình đơn này ở góc dưới bên trái của ứng dụng Replit.
Bây giờ, trình đơn sẽ hiển thị ở góc dưới bên phải, tại vị trí terminal.
Chỉ cần nhập tên biến, ví dụ email_password, vào vị trí SECRET_KEY rồi nhập các giá trị. receiver_email và sender_email là hai địa chỉ email dùng để gửi và nhận email. Trong trường hợp này, email_password sẽ là mật khẩu của địa chỉ email mà bạn dùng để gửi thư.
Bây giờ, chúng ta có thể bắt đầu nhận dữ liệu từ webhook:
app.post("/webhooks", async (req, res) => {
const { body } = req;
console.log(body)
res.status(200).json("Success!");
};
app.listen(3000);Máy chủ web được cấu hình để xử lý các yêu cầu HTTP POST gửi đến tuyến /webhooks. Khi nhận được yêu cầu POST gửi đến tuyến /webhooks, máy chủ web sẽ trích xuất phần thân yêu cầu và hiển thị trên bảng điều khiển để bạn kiểm thử. Sau đó, máy chủ web sẽ phản hồi yêu cầu bằng mã trạng thái 200 OK để cho Helius biết rằng chúng ta đã nhận được dữ liệu, nhờ đó Helius sẽ không gửi lại thông báo.
Thiết lập và kiểm thử webhook
Để bắt đầu kiểm thử, chỉ cần nhấp vào nút Run. Một trang web sẽ xuất hiện ở bên phải.
Đừng lo lắng về lỗi này. Máy chủ của chúng ta chỉ chấp nhận yêu cầu POST nên cần sử dụng Helius để kiểm thử. Bây giờ, chúng ta có thể truy cập Helius và thiết lập một webhook.
Chúng ta sẽ theo dõi các giao dịch Mainnet thuộc loại ‘Enhanced’. Những giao dịch này chứa thuộc tính description mà chúng ta sẽ gửi qua email. Hãy dán liên kết của máy chủ Replit đã tạo trước đó, trong trường hợp này là https://helius-webhook-sms-email.tidelaw.repl.co/webhooks, cùng với ví mà bạn muốn theo dõi. Hãy nhớ thêm /webhooks vào trang web do Replit tạo!
Bây giờ, bạn có thể kiểm thử bằng tính năng này trên Helius Developer Portal
Kết quả trả về sẽ như sau:
Sau đây là tệp JSON chứa dữ liệu nhận được từ webhook của 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'
}
]Lưu ý rằng đây là một mảng. Để tham chiếu đến đối tượng cần gửi dưới dạng thông báo, chúng ta phải truy cập thuộc tính description thông qua body[0].description.
Tích hợp email
Bây giờ, chúng ta có thể tích hợp Gmail để gửi email chứa phần mô tả giao dịch. Trước tiên, bạn cần cấu hình nodemailer cho dịch vụ hoặc loại email sẽ sử dụng. Sau đó, tham chiếu các biến .env vừa thiết lập bằng thông tin chi tiết của địa chỉ email gửi thư.
const transporter = nodemailer.createTransport({
service: 'gmail',
auth: {
user: `${process.env['sender_email']}`,
pass: `${process.env['email_password']}`
}
});Bây giờ, chúng ta có thể viết mã thực hiện việc gửi email bằng endpoint express đã thiết lập trước đó để nhận yêu cầu. Trước tiên, chúng ta tạo một đối tượng chứa mọi thông tin liên quan mà nodemailer cần để gửi email, chẳng hạn như người gửi, người nhận, chủ đề (không bắt buộc) và phần thân. Đây là nơi chúng ta sẽ chèn dữ liệu giao dịch thực tế bằng cách tham chiếu đối tượng body nhận được từ webhook của Helius. Dựa trên dữ liệu kiểm thử trước đó, chúng ta có thể xác định cách truy cập thuộc tính 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!");
}
})
});Mã hoàn chỉnh sẽ có dạng như sau:
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);Xin chúc mừng! Bây giờ, bạn có thể nhận email nếu đã cấu hình chính xác các biến .env và cài đặt đúng phần phụ thuộc. Nếu gặp khó khăn, hãy gửi tin nhắn trong Helius Discord để được trợ giúp.
Bước tiếp theo: Phiên bản Vercel
Vấn đề với Replit là bạn phải trả phí để duy trì tập lệnh này hoạt động 24/7. Một giải pháp là lưu trữ trên Vercel một trang web chỉ có backend, hoạt động liên tục mà không mất phí. Quy trình thiết lập gần như giống nhau, chỉ khác ở vị trí lưu các biến .env và việc sử dụng kho GitHub.
Trước tiên, bạn cần fork kho mã này:
Bây giờ, chúng ta có thể truy cập Vercel, nơi bạn cần tạo một tài khoản.
Sau đó, hãy truy cập bảng điều khiển và thêm một dự án mới.
Chỉ cần thêm các biến môi trường ở phần trước vào dự án Vercel:
Sau khi triển khai dự án, bạn có thể chạy các bước kiểm thử giống như đã thực hiện với Replit. Giờ đây, bạn có thể nhận email chứa dữ liệu giao dịch trên chuỗi miễn phí 24/7!
Bài viết liên quan
Đăng ký nhận tin từ Helius
Luôn cập nhật những thông tin mới nhất về phát triển Solana và nhận thông báo khi chúng tôi đăng bài


