Bir Fan Token transferlerini takip et

Chiliz Chain üzerindeki Fan Token hareketlerini izlemek, favori tokenlerinizin etkinliğini takip etmenin harika bir yoludur. Bunu olası bir gösterge panosunun yapı taşı olarak kullanarak, popüler olan ve olmayan hakkında içgörüler sağlamak için verileri kolaylaştırabilirsiniz.

Fan Token™ hareketlerini izlerken, hızlıca bir zorlukla karşılaşırsınız: verileri doğrudan blokzincirinden okumak güncel durum için verimlidir ("X cüzdanının bakiyesi nedir?"), ancak tarihsel veriler için verimsizdir ("Bana geçen yıl içinde X cüzdanını içeren her transferi göster").

Bunu çözmek için subgraph'ları (alt grafikleri) kullanabiliriz.

Subgraph'lar hakkında

Bir Subgraph, bir blokzincirinden veri çıkaran, işleten ve kolay sorgulanabilmesi için depolayan özel bir API'dir. Veriye her ihtiyaç duyduğunuzda milyonlarca bloğu taraması için blokzincirine sormak yerine, bir subgraph belirli olayları gerçekleştiği anda indeksler ve bunları bir veritabanında saklar.

Chiliz Chain, endüstri standartı indeksleme protokollerini destekler. Projenizin ihtiyaçlarına en uygun sağlayıcıyı seçebilirsiniz:

• The Graph: Merkeziyetsiz indeksleme için endüstri standardı. Subgraph'ınızı indeksleyicilerden oluşan merkeziyetsiz bir ağa dağıtmanıza olanak tanır.

• Goldsky: Yüksek performanslı, barındırılan bir indeksleme hizmeti. The Graph'in koduyla tamamen uyumludur (çoğu zaman tam olarak aynı kodu kullanabilirsiniz) ancak daha hızlı indeksleme hızları ve gerçek zamanlı veri akışı özellikleri sunar.

Her iki araç da aynı geliştirme çerçevesini kullandığından, bu sayfadaki adımların çoğu her ikisi için de geçerli olabilir.

Örneğin PSG Fan Token transferlerini nasıl takip edebileceğimize bakalım...

0. Bir araç seçin

Chiliz Chain üzerinde bir subgraph dağıtmak için şunları kullanabilirsiniz The Graph (merkeziyetsiz ağ) veya Goldsky (barındırılan indeksleyici). Kod yapısı özdeştir; yalnızca dağıtım komutları farklıdır.

Elbette, kendi dokümantasyonlarına da güvenebilirsiniz:

Quick StartThe Graph

Deploy a subgraph - Goldsky DocsGoldsky Documentation

1. Bir subgraph projesi başlatın

Hem The Graph hem de Goldsky, grafiğinizi oluşturmak için CLI tabanlı yöntemler sunar.

The Graph'in Subgraph Studioadlı bir aracı var; Web3'ünüzle bağlanabilir ve sonra arayüz üzerinden bir subgraph oluşturabilirsiniz.

Goldsky size panel hesap oluşturduğunuzda bir gösterge panosu sağlar; buradan bir subgraph oluşturabilirsiniz.

Graph CLI'yi yükleyin⁠

Yerel makinenizde şu komutu çalıştırın:

npm install -g @graphprotocol/graph-cli

The Graph'in CLI aracını, The Graph-merkeziyetsiz subgraph'ları veya Goldsky-barındırılan subgraph'ları için subgraph oluşturmak üzere kullanabilirsiniz.

Goldsky'nin kendi CLI aracı vardır; Goldsky'ye dağıtım yapmak istiyorsanız buna ihtiyacınız olacak (aşağıya bakınız).

Subgraph'ınızı başlatın⁠

Bunu, belirli subgraph slug'ınızı içerecek şekilde subgraph sayfanızdan doğrudan kopyalayabilirsiniz:

graph init --studio <SUBGRAPH_SLUG>

The --studio etiketi isteğe bağlıdır.

PSG Fan Token örneğimizde şunu kullanabiliriz:

graph init chiliz-psg-fantoken-followup

Size subgraph hakkında bazı bilgiler sağlamanız istenecek, şu şekilde:

Sözleşmenizin blok gezgininde doğrulanmış olması gerekir ve CLI otomatik olarak ABI'yi alıp subgraph'ınızı kuracaktır. Varsayılan ayarlar her olay için bir varlık (entity) oluşturacaktır.

Not:

• Sözleşme, PSG Fan Token'da olduğu gibi bir proxy kullanıyorsa, uygulama sözleşmesinin adresini kullanın. Bunu sözleşmenin blok gezgini sayfasındaki "Okuma/yazma sözleşmesi" sekmesinde göreceksiniz. Örneğin, Chiliz Blok Gezgini'ndeki PSG Fan token sözleşmesi için buraya bakın.

  • Eğer bir proxy'nin uygulama sözleşme adresini girmeniz gerekti ise, proje kurulduktan sonra manifest dosyasına (subgraph.yaml) gidin ve sözleşme adresini proxy adresiyle değiştirin.

• Başlangıç Bloğu otomatik olarak alınmadıysa, sözleşmenin oluşturulduğu blok numarasını manuel olarak girebilirsiniz. Bunu blok gezgininden edinebilirsiniz.

Alt grafınızda değişiklik yaparken çoğunlukla üç dosya ile çalışacaksınız:

• Manifest (subgraph.yaml): Alt grafınızın hangi veri kaynaklarını dizine ekleyeceğini tanımlar.

• Şema (schema.graphql): Alt graftan almak istediğiniz verileri tanımlar.

• AssemblyScript Eşlemeleri (mapping.ts): Veri kaynaklarınızdan gelen verileri şemada tanımlanan varlıklara çevirir.

Aç subgraph.yaml ve manifest dosyanızın doğru ağa işaret ettiğinden emin olun:

dataSources:
  - kind: ethereum
    name: FanToken
    network: chiliz  # Ana ağ için 'chiliz' kullanın, Spicy için chiliz-testnet
    source:
      address: "0x..." 
      abi: FanToken

Alt grafınızı derleyin

Son olarak, hata olmadığından emin olmak için alt grafınızı derleyin:

graph codegen && graph build

2. Dağıt & Yayınla

Alt grafınız oluşturulduktan sonra, dağıtmak için sağlayıcınızı seçin.

The Graph

1. Bağlan Subgraph Studio, bir alt grafik oluşturun ve deploy anahtarınızı kopyalayın.

2. CLI üzerinden kimlik doğrulayın: graph auth --studio <DEPLOY_KEY>

3. Alt grafınızı Subgraph Studio'ya dağıtın: graph deploy --studio <SUBGRAPH_SLUG>

4. Stüdyo'ya gidin, alt grafınızı açın ve alt grafınızı merkeziyetsiz ağa basmak için "Yayınla"ya tıklayın. Bu, alt grafınızı Arbitrum One ağında bir NFT olarak yayınlamak için cüzdanınız aracılığıyla bir işlemi tetikleyecektir.

Goldsky

1. Git Goldsky, "Proje Ayarları"nda bir API anahtarı oluşturun ve CLI üzerinden giriş yapın.

2. Şunu yükleyin goldsky komutunu: curl https://goldsky.com | sh Daha sonra CLI üzerinden kimlik doğrulayın: goldsky login

3. Alt grafınızı Goldsky'e yükleyin: goldsky subgraph deploy / --path

Goldsky alt grafikleri dağıtımdan hemen sonra canlı olur. Ek bir yayınlama adımı gerekmez.

Sizden bir sürüm etiketi istenecektir. Şu gibi bir şey girebilirsiniz v0.0.1, ancak formatı seçmekte özgürsünüz. Bu işlem tamamlandığında, Stüdyo sayfasında alt grafın eşitlemeye başladığını göreceksiniz.

The Graph'in akıllı sözleşmelerinin tamamı Arbitrum Oneüzerindedir, alt grafınız Chiliz Zinciri'nden veri dizinlese bile.

3. Alt Grafınıza Sorgu Yapın

Tebrikler! Artık seçtiğiniz hizmetin kontrol panelinde bulunabilen alt grafın sorgu URL'sine bir GraphQL sorgusu göndererek sorgulamaya başlayabilirsiniz.

Örnek:

The Graph

https://gateway-arbitrum.network.thegraph.com/api/[APIKEY]/subgraphs/id/[ID]

Goldsky

https://api.goldsky.com/api/public/project_[KEY]/subgraphs/[SLUG]/1.0.0/gn

Şimdi, bu uç noktaya GraphQL sorguları göndermeye başlamak için bilgilerinizi doldurmanız yeterli.

Ekler

Örnek Sorgu

Bu sorgu PSG Fan Token'in tüm işlemlerini gösterir.

const axios = require('axios');

// GraphQL sorgusu (Her iki sağlayıcı için de Aynı)
const graphqlQuery = `{
  transfers {
    from
    to
    value
    transactionHash
  }
}`;

// Sağlayıcıya bağlı olarak doğru URL formatını seçin:
// const queryUrl = 'https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/[id]'
// const queryUrl = 'https://api.goldsky.com/api/public/project_[key]/subgraphs/[slug]/1.0.0/gn';

const graphQLRequest = {
  method: 'post',
  url: queryUrl,
  data: {
    query: graphqlQuery,
  },
};

// GraphQL sorgusunu gönder
axios(graphQLRequest)
  .then((response) => {
    // Yanıtı burada işleyin
    const data = response.data.data
    console.log(data)

  })
  .catch((error) => {
    // Herhangi bir hatayı ele alın
    console.error(error);
  });

Örnek kod

{
  "data": {
    "transfers": [
      {
        "from": "0x26a3e78fa4d2cbebf6b59b2f84b8fb7c61b52d28",
        "to": "0xdca23d02923d01779fb22959bd2575d64eab4535",
        "value": "1500",
        "transactionHash": "0x000309e9cd3f550e8965381bbd83a35c5cee18f26c33a357f9dbb57450d594ea"
      },
//      ...
  }
}

Bunu sorgu URL'sine iletmek şu sonucu döndürür:

{
  transfers {
    from
    to
    value
    transactionHash
  }
}

Ek kaynaklar

Alt grafiğinizden GraphQL ile veri sorgulama hakkında daha fazla bilgi için:

Querying Best PracticesThe Graph