Fan Token transferleri için Telegram bildirimleri alın

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

Biraz yapılandırma ve kod ile, bir Fan Token™ transferi belirli bir eşiği aştığında bir grubu bilgilendirmek için bir Telegram botu kurabilirsiniz.

Envio kullanarak bunu nasıl yaparsınız?

Envio Chiliz’de akıllı sözleşme olaylarını dinlemesine ve olaya dayalı olarak bir işlem gerçekleştirmesine olanak tanıyan güçlü bir indeksleme aracıdır.

Bu nasıl yapılır rehberinde, 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 kurulumunuzu büyük transferler için bir “balina gözlemcisine” dönüştüreceksiniz.

1. Adım: Ön Gereksinimleri Yükleyin

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

• pnpm

• Node.js

• Docker

Projenin tamamını bu GitHub deposunda.

2. Adım: Envio Indexer’ı Başlatın

Bir Envio indexer’ını başlatmak ve Chiliz Chain üzerinde (EVM uyumlu bir blok zinciri olan) bir ERC20 şablonu oluşturmak için aşağıdaki komutu çalıştırın ve yönergeleri izleyin:

pnpx envio init

İstendiğinde yapmanız gereken çeşitli seçimler şunlardır:

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

Dosyasını config.yaml FC Barcelona Fan Token™ sözleşme adresini (veya izlemek istediğiniz başka bir Fan Token™’ı) belirtmek için değiştirin:

# yaml-language-server: $schema=./node_modules/envio/evm.schema.json
name: fan-token-watcher
description: Büyük transferlerde Telegram’a bildirim gönderen Fan Token’lar için basit bir indexer
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: Biz approval olayını kaldırıyoruz çünkü yalnızca transferlerle ilgileniyoruz.

4. Adım: GraphQL Şemasını Basitleştirin

Dosyasını schema.graphql dosyasını yalnızca hesap bakiyelerini izlemek için:

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

Bu noktada, olayları dinleyen bir ERC20 indexer’ımız var.

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

5. Adım: Telegram Bildirim Mantığını Uygulayın

Dosyasını /src/EventHandlers.ts dosyasına büyük transferleri algılamak ve Telegram uyarıları göndermek için mantık ekleyin.

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 BALINA UYARISI 🐋: <a href="${explorerUrlAddress(
      event.params.from
     )}">${ensHandleOrFromAddress}</a> tarafından <a href="${explorerUrlAddress(
      event.params.to
     )}">${ensHandleOrToAddress}</a> adresine ${event.params.value} FC Barcelona için yeni bir transfer yapıldı! 🔥 - <a href="${explorerUrlTx(
      event.transaction.hash
     )}">işlem</a>`;

    await sendMessageToTelegram(msg);
  }

  await indexBalances(context, event);
});

Örnek /libs/ klasörü tam burada GitHub’da bulunabilir, dahil olmak üzere helpers.ts ve ens.ts dosyaları.

6. Adım: Sabitleri Yapılandırın

Bir constants.ts dosyasını ortam değişkenlerini saklamak için kullanın:

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;

7. Adım: Telegram Mesajları Gönderme

Yükleyin Axios HTTP istemcisini:

pnpm i axios

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

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("Mesaj gönderilirken hata oluştu:", error);
  }
};

8. Adım: Son Yapılandırma ve Indexer’ı Çalıştırma

Yapılandırın .env Dosyayı

cp .env.example .env

Düzenleyin .env Telegram bot kimlik bilgilerinizle:

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

Bir Telegram Botu Oluşturun

1. Mesaj @BotFather Telegram’da ve şunu çalıştırın:

   /newbot

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

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

4. Şurayı ziyaret edin https://api.telegram.org/bot<YourBOTToken>/getUpdates grup sohbet kimliğini bulmak için.

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

Son olarak, bağımlılıkları yükleyin ve indexer’ı 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 indexer’ınız var.

Daha ileri gitmek için, indexer’ı kendi sunucunuzda barındırabilir veya Envio’nun barındırılan hizmetine dağıtabilirsiniz.

Ve bakiyeleri kaydettiğimiz için, bir GraphQL bakiye API’si olarak da kullanılabilir.