Thông báo Telegram cho Fan Token

Thiết lập bot Telegram theo dõi cá voi cho các giao dịch Fan Token bằng indexer của Envio, bắt các sự kiện chuyển nhượng trên Chiliz Chain và kích hoạt cảnh báo khi vượt ngưỡng.

Theo dõi các giao dịch Fan Token™ diễn ra trên Chiliz Chain là một cách tuyệt vời để cập nhật các động thái giá trị cao và giữ cho cộng đồng của bạn luôn được thông tin.

Với một chút cấu hình và code, bạn có thể thiết lập một bot Telegram để thông báo cho nhóm mỗi khi một giao dịch Fan Token™ vượt quá một ngưỡng nhất định.

Cách thực hiện bằng Envio?

Envio là một công cụ indexing mạnh mẽ cho phép các nhà phát triển lắng nghe các sự kiện smart contract trên Chiliz và thực hiện hành động dựa trên sự kiện đó.

Trong hướng dẫn này, bạn sẽ thấy cách cấu hình bot, bắt các sự kiện liên quan và tự động kích hoạt cảnh báo Telegram, biến thiết lập của bạn thành một "whale watcher" cho các giao dịch lớn.

Bước 1: Cài đặt các công cụ cần thiết

Trước khi bắt đầu, hãy đảm bảo bạn đã cài đặt các công cụ cần thiết:

• pnpm

• Node.js

• Docker

Toàn bộ dự án có thể tìm thấy trên GitHub repository này.

Bước 2: Khởi tạo Envio Indexer

Chạy lệnh sau để khởi tạo một Envio indexer và làm theo các hướng dẫn để tạo template ERC-20 trên Chiliz Chain (một blockchain tương thích EVM):

pnpx envio init

Dưới đây là các lựa chọn bạn nên thực hiện khi được nhắc:

Bước 3: Cấu hình config.yaml

Chỉnh sửa file config.yaml để chỉ định địa chỉ hợp đồng của FC Barcelona Fan Token™ (hoặc bất kỳ Fan Token™ nào bạn muốn theo dõi):

# yaml-language-server: $schema=./node_modules/envio/evm.schema.json
name: fan-token-watcher
description: A simple indexer for Fan Tokens that posts notifications to Telegram on large transfers
networks:
  - id: 8888 # Chiliz
    start_block: 0
    contracts:
      - name: ERC20
        address: "0xFD3C73b3B09D418841dd6Aff341b2d6e3abA433b" # FC Barcelona
        handler: src/EventHandlers.ts
        events:          
          - event: "Transfer(address indexed from, address indexed to, uint256 value)"
field_selection:
  transaction_fields:
    - "hash"

Lưu ý: Chúng ta bỏ sự kiện approval vì chúng ta chỉ quan tâm đến các giao dịch chuyển nhượng.

Bước 4: Đơn giản hóa GraphQL Schema

Chỉnh sửa file schema.graphql để chỉ theo dõi số dư tài khoản:

type Account {
  id: ID!   # Address of the account
  balance: BigInt! # Account balance of tokens
}

Đến đây, chúng ta đã có một ERC-20 indexer lắng nghe các sự kiện.

Bây giờ, hãy thêm logic để gửi thông báo Telegram.

Bước 5: Triển khai logic thông báo Telegram

Chỉnh sửa file /src/EventHandlers.ts để thêm logic phát hiện các giao dịch lớn và gửi cảnh báo Telegram.

import { ERC20 } from "generated";
import { isIndexingAtHead, indexBalances } from "./libs/helpers";
import { fetchEnsHandle } from "./libs/ens";
import { sendMessageToTelegram } from "./libs/telegram";
import { WHALE_THRESHOLD, explorerUrlAddress, explorerUrlTx } from "./constants";

ERC20.Transfer.handler(async ({ event, context }) => {
  if (isIndexingAtHead(event.block.timestamp) && event.params.value >= BigInt(WHALE_THRESHOLD)) {
    const ensHandleOrFromAddress = await fetchEnsHandle(event.params.from); 
    const ensHandleOrToAddress = await fetchEnsHandle(event.params.to);
    const msg = `FC Barcelona WHALE ALERT 🐋: A new transfer has been made by <a href="${explorerUrlAddress(
      event.params.from
    )}">${ensHandleOrFromAddress}</a> to <a href="${explorerUrlAddress(
      event.params.to
    )}">${ensHandleOrToAddress}</a> for ${event.params.value} FC Barcelona! 🔥 - <a href="${explorerUrlTx(
      event.transaction.hash
    )}">transaction</a>`;

    await sendMessageToTelegram(msg);
  }

  await indexBalances(context, event);
});

Thư mục mẫu /libs/ có thể tìm thấy ngay tại đây trên GitHub, bao gồm các file helpers.ts và ens.ts.

Bước 6: Cấu hình các hằng số

Tạo file constants.ts để lưu trữ các biến môi trường:

export const EXPLORER_URL_MONAD = process.env.ENVIO_EXPLORER_URL_MONAD;
export const WHALE_THRESHOLD: string = process.env.ENVIO_WHALE_THRESHOLD ?? "1000";
export const BOT_TOKEN = process.env.ENVIO_BOT_TOKEN;
export const CHANNEL_ID = process.env.ENVIO_TELEGRAM_CHANNEL_ID;
export const MESSAGE_THREAD_ID = process.env.ENVIO_TELEGRAM_MESSAGE_THREAD_ID;

export const explorerUrlAddress = (address: string) =>
  EXPLORER_URL_MONAD + "address/" + address;
export const explorerUrlTx = (txHash: string) =>
  EXPLORER_URL_MONAD + "tx/" + txHash;

Bước 7: Gửi tin nhắn Telegram

Cài đặt Axios HTTP client:

pnpm i axios

Tạo một hàm helper trong libs/telegram.ts để gửi tin nhắn bằng Axios:

import axios from "axios";
import { CHANNEL_ID, MESSAGE_THREAD_ID, BOT_TOKEN } from "../constants";

export const sendMessageToTelegram = async (message: string): Promise<void> => {
  try {
    const apiUrl = `https://api.telegram.org/bot${BOT_TOKEN}/sendMessage`;
    await axios.post(apiUrl, {
      chat_id: CHANNEL_ID,
      text: message,
      parse_mode: "HTML",
    });
  } catch (error) {
    console.error("Error sending message:", error);
  }
};

Bước 8: Cấu hình cuối cùng và chạy Indexer

Cấu hình file .env

cp .env.example .env

Chỉnh sửa .env với thông tin xác thực bot Telegram của bạn:

ENVIO_BOT_TOKEN=
ENVIO_TELEGRAM_CHANNEL_ID=
ENVIO_TELEGRAM_MESSAGE_THREAD_ID=
ENVIO_EXPLORER_URL="https://chiliscan.com/"
ENVIO_WHALE_THRESHOLD=1000

Tạo một bot Telegram

1. Nhắn tin cho @BotFather trên Telegram và chạy:

   /newbot

2. Làm theo các hướng dẫn để lấy token của bot.

3. Thêm bot vào nhóm Telegram của bạn và chạy /start.

4. Truy cập https://api.telegram.org/bot<YourBOTToken>/getUpdates để tìm ID chat của nhóm.

Nếu bạn đã tạo nhóm mới cùng với bot và chỉ nhận được {"ok":true,"result":[]}, hãy xóa bot khỏi nhóm và thêm lại.

Cuối cùng, cài đặt các dependency và khởi động indexer

pnpm i
pnpm envio dev

Với thiết lập này, bạn đã có một indexer chạy trên Envio lắng nghe các giao dịch Fan Token và đăng cảnh báo cá voi lên Telegram.

Để tiến xa hơn, bạn có thể tự host indexer hoặc triển khai lên dịch vụ hosted của Envio.

Và vì chúng ta đang lưu số dư, nó cũng có thể được sử dụng như một GraphQL balance API.