신규: Solana Privacy Rings가 이제 메인넷에서 정식 출시되었습니다
이메일 알림에 Solana webhook을 사용하는 방법
블로그/개발

Solana 개발 101 - dApp 이메일 알림

통합 엔지니어X의 Tidelaw
읽는 데 6분

왜 이것을 만들어야 할까요?

Helius의 webhook에서 Solana 온체인 트랜잭션 데이터를 받고, node-mailer를 사용해 해당 트랜잭션 정보가 담긴 이메일을 보내는 Vercel 백엔드와 Replit을 구축합니다. 사용자는 결제를 받거나 새 NFT가 민팅되는 경우처럼 중요한 트랜잭션을 실시간으로 알림받을 수 있습니다.

이 시스템의 주요 이점은 다음과 같습니다.

실시간 알림

중요한 트랜잭션이 발생하는 즉시 알림을 받을 수 있습니다. 재정 상태를 최신으로 유지하고 Solana 생태계에 더 적극적으로 참여하는 데 도움이 됩니다.

보안 강화

계정에서 자금을 인출하려는 시도와 같은 의심스러운 트랜잭션을 알림받을 수 있습니다. 이를 통해 자산을 추적하는 데 도움이 됩니다.

향상된 사용자 경험

Solana 기반 애플리케이션을 더 원활하게 사용할 수 있습니다. 계정을 직접 확인하지 않아도 중요한 이벤트에 대한 알림을 받을 수 있습니다.

이 시스템은 Solana 사용자에게 유용한 도구가 될 것입니다. Solana 생태계를 개선하는 데 어떻게 활용될지 기대됩니다.

GitHub - Tidelaw/webhook-sms-email: Helius의 webhook을 사용해 SMS 알림을 전송합니다.

아래 가이드를 진행하다 도움이 필요하면 Helius Discord에 문의하거나 오픈 소스 저장소를 확인하세요.

Replit 버전

Replit은 코드를 작성하고 실행하며 다른 사람과 실시간으로 공유할 수 있는 클라우드 기반 통합 개발 환경(IDE)입니다. 초보자와 숙련된 개발자 모두에게 유용한 도구입니다.

Replit을 만들려면 Replit 웹사이트로 이동해 "Create a Repl" 버튼을 클릭하세요. 그런 다음 Repl에 사용할 프로그래밍 언어(javascript)와 템플릿을 선택할 수 있습니다. Repl을 만들면 바로 코딩을 시작할 수 있습니다.

Replit은 환경 변수를 저장하는 데 .env 파일을 사용합니다. 환경 변수는 API 키와 비밀번호 같은 민감한 정보를 저장하는 데 사용됩니다. Replit에 일반 텍스트로 저장되지 않으므로 더 안전합니다.

Replit 종속성

스크립트를 실행하려면 다음 종속성이 필요합니다.

  • nodemailer: 이메일을 보내는 데 사용되는 종속성입니다.
  • express: 웹 서버를 만드는 데 사용되는 종속성입니다.
  • body-parser: HTTP 요청의 본문을 파싱하는 데 사용되는 종속성입니다.

종속성을 설치하려면 다음을 입력하세요.

코드
npm install nodemailer express body-parser

이제 webhook에서 데이터를 받도록 express 서버를 시작할 수 있습니다.

코드
const nodemailer = require('nodemailer');
const express = require('express'),
  app = express(),
  bodyParser = require('body-parser');

app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: true }));
  1. 첫 번째 코드 줄은 이메일을 보낼 수 있도록 nodemailer 패키지를 가져옵니다.
  2. 두 번째 코드 줄은 Helius의 webhook에서 데이터를 받을 Express 웹 서버를 만듭니다.
  3. 세 번째 코드 줄은 webhook 데이터를 훨씬 쉽게 파싱할 수 있게 해주는 body-parser 모듈을 가져옵니다.
  4. 네 번째와 다섯 번째 코드 줄은 body-parser 종속성을 사용해 JSON 요청을 파싱하도록 웹 서버를 구성합니다.

이제 Gmail API를 설정하고 이 환경 변수를 Replit에 저장해야 합니다.

Gmail API 키

먼저 이 가이드에 따라 Gmail 앱 비밀번호를 발급받으세요. 2단계 인증도 설정해야 합니다. node-mailer로 이메일을 보내기 위한 준비는 이것으로 충분합니다.

Replit 환경 변수 설정

Replit의 .env 변수 메뉴는 Replit 클라이언트 왼쪽 하단에서 찾을 수 있습니다.

이제 터미널이 있는 오른쪽 하단에 메뉴가 표시됩니다.

SECRET_KEY가 있는 곳에 email_password 같은 변수 이름을 입력한 다음 값을 입력하세요. receiver_email과 sender_email은 이메일을 보내고 받을 때 사용할 두 이메일 주소입니다. 여기서 email_password는 이메일을 보낼 계정의 비밀번호입니다.

이제 webhook에서 데이터를 받을 수 있습니다.

코드
app.post("/webhooks", async (req, res) => {

  const { body } = req;
	console.log(body)
  res.status(200).json("Success!");
  
};

app.listen(3000);

웹 서버는 /webhooks 경로에 대한 HTTP POST 요청을 처리하도록 구성되어 있습니다. 웹 서버가 /webhooks 경로에서 POST 요청을 받으면 요청 본문을 추출해 테스트할 수 있도록 콘솔에 표시합니다. 그런 다음 Helius가 요청이 수신되었음을 인식하고 같은 메시지를 반복해서 보내지 않도록 200 OK 상태 코드로 응답합니다.

Webhook 설정 및 테스트

테스트를 시작하려면 Run 버튼을 클릭하세요. 오른쪽에 웹사이트가 표시됩니다.

오류가 표시되어도 걱정하지 마세요. 서버는 POST 요청만 허용하므로 Helius를 사용해 테스트해야 합니다. 이제 Helius로 이동해 webhook을 설정할 수 있습니다.

‘Enhanced’ 유형의 Mainnet 트랜잭션을 수신합니다. 여기에는 이메일로 보낼 description 속성이 포함되어 있습니다. 앞서 생성한 Replit 서버 링크(이 예에서는 https://helius-webhook-sms-email.tidelaw.repl.co/webhooks)와 수신하려는 지갑을 입력하세요. Replit에서 생성한 사이트 주소 뒤에 /webhooks를 반드시 포함해야 합니다!

이제 Helius Developer Portal의 이 기능을 사용해 테스트할 수 있습니다.

그러면 다음 결과가 반환됩니다.

Helius의 webhook에서 받은 데이터의 JSON 파일은 다음과 같습니다.

코드
[
  {
    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'
  }
]

배열이라는 점에 주의하세요. 메시지로 보낼 객체를 참조하려면 body[0].description을 통해 description 속성에 접근해야 합니다.

이메일 통합

이제 Gmail을 통합해 트랜잭션 설명이 담긴 이메일을 보낼 수 있습니다. 먼저 사용할 서비스 또는 이메일 유형에 맞게 nodemailer를 구성해야 합니다. 그런 다음 방금 설정한 .env 변수에서 발신 이메일 정보를 참조하세요.

코드
const transporter = nodemailer.createTransport({
  service: 'gmail',
  auth: {
    user: `${process.env['sender_email']}`,
    pass: `${process.env['email_password']}`
  }
});

이제 앞에서 요청을 받도록 설정한 express 엔드포인트를 사용해 실제 이메일 전송 코드를 작성할 수 있습니다. 먼저 nodemailer가 이메일을 보내는 데 필요한 모든 정보가 담긴 객체를 만듭니다. 예를 들어 발신자, 수신자, 제목(필수 아님), 본문이 필요합니다. 여기에서 Helius의 webhook으로 받은 body 객체를 참조해 실제 트랜잭션 데이터를 삽입합니다. 앞서 사용한 테스트 데이터를 통해 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!");
    }
  })
});

완성된 코드는 다음과 같습니다.

코드
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);

축하합니다! .env 변수를 올바르게 구성하고 필요한 종속성을 설치했다면 이제 이메일을 받을 수 있습니다. 문제가 생기면 Helius Discord에 메시지를 보내 도움을 요청하세요.

다음 단계: Vercel 버전

Replit의 문제는 이 스크립트를 연중무휴로 실행하는 데 비용이 든다는 점입니다. 한 가지 해결책은 백엔드만 있는 웹사이트를 Vercel에 호스팅하는 것입니다. 그러면 비용 없이 계속 실행할 수 있습니다. 설정 방식은 대부분 같으며, .env 변수가 저장되는 위치와 github 저장소만 다릅니다.

먼저 이 저장소를 포크해야 합니다.

이제 Vercel로 이동해 계정을 만드세요.

그런 다음 대시보드로 이동해 새 프로젝트를 추가하세요.

앞에서 사용한 환경 변수를 Vercel 프로젝트에 추가하기만 하면 됩니다.

프로젝트를 배포한 후 Replit에서 진행했던 것과 같은 테스트를 실행할 수 있습니다. 이제 온체인 트랜잭션 데이터가 담긴 이메일을 연중무휴 무료로 받을 수 있습니다!

Helius 구독하기

최신 Solana 개발 소식을 확인하고 새 게시물 알림을 받아보세요

확대 이미지