Fan Token Transferleri için Telegram Bildirimleri

Envio indeksleyicisini kullanarak Fan Token transferleri için Telegram balina izleme botu kurun; Chiliz Chain'deki transfer olaylarını yakalayın ve eşik ihlallerinde uyarı tetikleyin.

Chiliz Chain'de gerçekleşen Fan Token™ transferlerini izlemek, yüksek değerli hareketlerden haberdar olmanın ve topluluğunuzu bilgilendirmenin harika bir yoludur.

Biraz yapılandırma ve kodla, bir Fan Token™ transferi belirli bir eşiği aştığında bir gruba bildirim gönderen bir Telegram botu kurabilirsiniz.

Envio Kullanarak Nasıl Yapılır?

Envio, geliştiricilerin Chiliz üzerindeki akıllı sözleşme olaylarını dinlemesine ve olaya dayalı eylemler gerçekleştirmesine olanak tanıyan güçlü bir indeksleme aracıdır.

Bu rehberde botu nasıl yapılandıracağınızı, ilgili olayları nasıl yakalayacağınızı ve Telegram uyarılarını otomatik olarak nasıl tetikleyeceğinizi göreceksiniz; böylece kurulumunuz büyük transferler için bir "balina izleyiciye" dönüşecektir.

Adım 1: Ön Koşulların Kurulumu

Başlamadan önce gerekli araçların yüklü olduğundan emin olun:

• pnpm

• Node.js

• Docker

Tam projeyi bu GitHub deposunda bulabilirsiniz.

Adım 2: Envio İndeksleyicisini Başlatma

Bir Envio indeksleyicisi başlatmak ve Chiliz Chain'de (EVM uyumlu bir blockchain) ERC20 şablonu oluşturmak için yönlendirmeleri takip ederek aşağıdaki komutu çalıştırın:

pnpx envio init

İstemde yapmanız gereken seçimler şöyledir:

Adım 3: config.yaml Dosyasını Yapılandırma

config.yaml dosyasını, takip etmek istediğiniz FC Barcelona Fan Token™'ının (veya herhangi bir Fan Token™'ın) sözleşme adresini belirtecek şekilde değiştirin:

# 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"

Not: Yalnızca transferlerle ilgilendiğimiz için approval olayını kaldırıyoruz.

Adım 4: GraphQL Şemasını Basitleştirme

schema.graphql dosyasını yalnızca hesap bakiyelerini izleyecek şekilde değiştirin:

type Account {
  id: ID!   # Hesabın adresi
  balance: BigInt! # Token hesap bakiyesi
}

Bu noktada, olayları dinleyen bir ERC20 indeksleyicimiz var.

Şimdi Telegram bildirimi göndermek için mantık ekleyelim.

Adım 5: Telegram Bildirim Mantığını Uygulama

/src/EventHandlers.ts dosyasını büyük transferleri tespit etmek ve Telegram uyarıları göndermek için mantık içerecek şekilde değiştirin.

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);
});

Örnek /libs/ klasörünü helpers.ts ve ens.ts dosyaları dahil GitHub'da burada bulabilirsiniz.

Adım 6: Sabitleri Yapılandırma

Ortam değişkenlerini depolamak için bir constants.ts dosyası oluşturun:

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;

Adım 7: Telegram Mesajları Gönderme

Axios HTTP istemcisini yükleyin:

pnpm i axios

Axios kullanarak mesaj göndermek için libs/telegram.ts içinde bir yardımcı işlev oluşturun:

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);
  }
};

Adım 8: Son Yapılandırma ve İndeksleyiciyi Çalıştırma

.env Dosyasını Yapılandırma

cp .env.example .env

.env dosyasını Telegram bot kimlik bilgilerinizle düzenleyin:

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

Telegram Botu Oluşturma

1. Telegram'da @BotFather'a mesaj gönderin ve çalıştırın:

   /newbot

2. Bot token'ınızı almak için yönergeleri izleyin.

3. Botu Telegram grubunuza ekleyin ve /start komutunu çalıştırın.

4. Grup sohbet kimliğini bulmak için https://api.telegram.org/bot<BotToken'ınız>/getUpdates adresini ziyaret edin.

Grubu botla oluşturduysanız ve yalnızca {"ok":true,"result":[]} alıyorsanız, botu gruptan kaldırıp tekrar ekleyin.

Son olarak, bağımlılıkları yükleyin ve indeksleyiciyi başlatın

pnpm i
pnpm envio dev

Bu kurulumla artık Fan Token transferlerini dinleyen ve Telegram'a balina uyarıları gönderen Envio destekli bir indeksleyiciniz var.

Daha ileri gitmek için indeksleyiciyi kendi altyapınızda barındırabilir veya Envio'nun barındırılan hizmetine deploy edebilirsiniz.

Bakiyeleri kaydettiğimiz için bu sistem aynı zamanda bir GraphQL bakiye API'si olarak da kullanılabilir.