Docs
⌘ K

5 dakika

NFT Pazar Yerlerini Enums Kullanarak Kategorize Etme

Kodu daha temiz yapmak ve hata yapma riskini azaltmak için Enums kullanın. İşte NFT pazar yerlerinde Enums kullanımına bir örnek.

Enum’lar Nedir?

Enum’lar veya numaralandırma türleri, bir dizi izin verilen değeri tanımlamanıza olanak tanıyan belirli bir veri türüdür.

Şemanızda Enum Örnekleri

If you’re building a Subgraph to track the ownership history of tokens on a marketplace, each token might go through different ownerships, such as OriginalOwner, SecondOwner, and ThirdOwner. By using enums, you can define these specific ownerships, ensuring only predefined values are assigned.

Şemanızda enum tanımlayabilir ve bir kez tanımlandığında, bir varlık üzerinde bir enum alanı ayarlamak için enum değerlerinin dizi (string) gösterimini kullanabilirsiniz.

İşte yukarıdaki örneğe dayanarak, şemanızda bir enum tanımı şöyle görünebilir:

enum TokenStatus {  OriginalOwner  SecondOwner  ThirdOwner}

Bu, şemanızda TokenStatus türünü kullandığınızda, bunun tanımlı değerlerden tam olarak biri olmasını beklediğiniz anlamına gelir: OriginalOwner, SecondOwner veya ThirdOwner. Böylece tutarlılık ve geçerlilik sağlanmış olur.

Enum’lar hakkında daha fazla bilgi edinmek için Subgraph Oluşturma ve GraphQL dokümantasyonu⁠ kaynaklarına göz atın.

Enum Kullanmanın Faydaları

  • Anlaşılırlık: Enum’lar değerlere anlamlı isimler verir, veriyi daha anlaşılır hale getirir.
  • Doğrulama: Enum’lar katı değer tanımlamaları uygulayarak geçersiz veri girişlerini önler.
  • Bakım Kolaylığı: Yeni kategoriler eklemek veya mevcut olanları değiştirmek gerektiğinde, enum’lar bunu odaklı bir şekilde yapmanıza olanak tanır.

Enum’lar Olmadan

Türü Enum kullanmak yerine bir dize olarak tanımlamayı seçerseniz, kodunuz şöyle görünebilir:

type Token @entity {  id: ID!  tokenId: BigInt!  owner: Bytes! # Token Sahibi  tokenStatus: String! # Token Durumunu Takip Eden Dize Alanı  timestamp: BigInt!}

Bu şemada, TokenStatus belirli, alabileceği değerler sınırlandırılmış olmayan basit bir dizedir.

Bu neden bir sorun?

  • TokenStatus değerleri için bir kısıtlama yoktur. Bu yüzden yanlışlıkla herhangi bir dize atanabilir. Bu, yalnızca OriginalOwner, SecondOwner veya ThirdOwner gibi geçerli durumların ayarlandığını sağlamayı zorlaştırır.
  • OriginalOwner yerine Orgnalowner gibi yazım hataları yaparak verilerin ve potansiyel sorguların güvenilmez hale gelmesine sebep olmak kolaydır.

Enum Kullanımıyla

Serbest formda dizeler atamak yerine, TokenStatus için OriginalOwner, SecondOwner veya ThirdOwner gibi belirli değerlerle bir enum tanımlanabilir. Bir enum kullanmak, yalnızca izin verilen değerlerin kullanılmasını sağlar.

Enumlar; tür güvenliği sağlar, yazım hatası riskini en aza indirir ve tutarlı ve güvenilir sonuçlar sağlar.

NFT Pazar Yerleri için Enum Tanımlama

Not: Aşağıdaki kılavuz CryptoCoven NFT akıllı sözleşmesini kullanmaktadır.

To define enums for the various marketplaces where NFTs are traded, use the following in your Subgraph schema:

# CryptoCoven sözleşmesinin etkileşimde bulunduğu pazar yerleri için Enum (muhtemel bir Takas/Basım)enum Marketplace {  OpenSeaV1 # CryptoCoven NFT'sinin bu pazar yerinde takas yapılmasını temsil eder  OpenSeaV2 # CryptoCoven NFT'si ninOpenSeaV2 pazar yerinde takas yapılmasını temsil eder  SeaPort # CryptoCoven NFT'sinin SeaPort pazar yerinde takas yapılmasını temsil eder  LooksRare # CryptoCoven NFT'sinin LookRare pazar yerinde takas yapılmasını temsil eder  # ...ve diğer pazar yerleri}

NFT Pazar Yerleri için Enum Kullanımı

Once defined, enums can be used throughout your Subgraph to categorize transactions or events.

Örneğin, NFT satışlarını kaydederken takasta yer alan pazar yerini enum kullanarak belirleyebilirsiniz.

NFT Pazar Yerleri için Bir Fonksiyon İmplementasyonu

Enum’dan pazar yeri adını bir dize olarak almak için bir fonksiyonu şöyle uygulayabilirsiniz:

export function getMarketplaceName(marketplace: Marketplace): string {  // Enum değerini bir dizeye eşlemek için if-else ifadelerini kullanma  if (marketplace === Marketplace.OpenSeaV1) {    return 'OpenSeaV1' // I Eğer pazar yeri OpenSea ise, onun dize temsilini döndür  } else if (marketplace === Marketplace.OpenSeaV2) {    return 'OpenSeaV2'  } else if (marketplace === Marketplace.SeaPort) {    return 'SeaPort' // Eğer pazar yeri SeaPort ise, onun dize temsilini döndür  } else if (marketplace === Marketplace.LooksRare) {    return 'LooksRare' // Eğer pazar yeri LooksRare ise, onun dize temsilini döndür    // ... ve diğer pazar yerleri  }}

Enum Kullanımı için En İyi Uygulamalar

  • Tutarlı İsimlendirme: Okunabilirliği artırmak için enum değerleri için net, açıklayıcı isimler kullanın.
  • Merkezi Yönetim: Tutarlılık için enum’ları tek bir dosyada tutun. Böylece enum’ların güncellenmesi kolaylaşmış olur ve onların tek bir doğru bilgi kaynağı olmasını sağlar.
  • Dokümantasyon: Amaçlarını ve kullanımını açıklamak için enum’a yorumlar ekleyin.

Sorgularda Enum Kullanımı

Sorgulardaki enum’lar verilerin kalitesini artırmanıza ve sonuçları daha kolay yorumlamanıza yardımcı olur. Enumlar filtreleme ve yanıt ögeleri olarak işlev görürler, tutarlılığı sağlarlar ve pazar yerlerindeki hataları azaltırlar.

Ayrıntılar

  • Enum ile Filtreleme: Enum’lar net filtreler sağlar, belirli pazarları güvenle dahil etmenizi veya hariç tutmanızı mümkün kılar.
  • Yanıtlarda Enum’lar: Enum’lar yalnızca tanınan pazar adlarının döndürülmesini garanti eder, bu da sonuçları standart ve isabetli hale getirir.

Örnek Sorgular

Sorgu 1: En Yüksek NFT Pazar Yeri Etkileşimine Sahip Hesap

Bu sorgu şunları yapar:

  • Farklı pazar yerlerinde en yüksek benzersiz NFT etkileşimlerine sahip hesabı bulur. Bu da çapraz pazar yeri aktivitelerini analiz etmek için mükemmeldir.
  • Pazar yerleri alanı, yanıt içerisindeki pazar yeri değerlerini tutarlı ve doğrulanmış hale getiren pazar yeri enum’ını kullanır.
{  accounts(first: 1, orderBy: uniqueMarketplacesCount, orderDirection: desc) {    id    sendCount    receiveCount    totalSpent    uniqueMarketplacesCount    marketplaces {      marketplace # Bu alan, pazar yerini temsil eden enum değerini döndürür.    }  }}

Dönüşler

Bu yanıt; hesap detaylarını, ve netlik sağlamak amacıyla enum değerlerine sahip benzersiz pazar yeri etkileşimlerinin listesini sağlar:

{  "data": {    "accounts": [      {        "id": "0xb3abc96cb9a61576c03c955d75b703a890a14aa0",        "sendCount": "44",        "receiveCount": "44",        "totalSpent": "1197500000000000000",        "uniqueMarketplacesCount": "7",        "marketplaces": [          {            "marketplace": "OpenSeaV1"          },          {            "marketplace": "OpenSeaV2"          },          {            "marketplace": "GenieSwap"          },          {            "marketplace": "CryptoCoven"          },          {            "marketplace": "Unknown"          },          {            "marketplace": "LooksRare"          },          {            "marketplace": "NFTX"          }        ]      }    ]  }}

Sorgu 2: CryptoCoven İşlemleri için En Aktif Pazar Yeri

Bu sorgu şunları yapar:

  • CryptoCoven işlemlerinin en yüksek hacimli olduğu pazar yerini belirler.
  • Yalnızca geçerli pazar yeri türlerinin yanıt olarak görünmesini sağlamak için pazar yeri enum’ını kullanarak verilerinize güvenilirlik ve tutarlılık katar.
{  marketplaceInteractions(first: 1, orderBy: transactionCount, orderDirection: desc) {    marketplace    transactionCount  }}

Sonuç 2

Beklenen yanıt, pazar yerini ve ilgili işlem sayısını içerir; pazar yeri türünü belirtmek için enum kullanır:

{  "data": {    "marketplaceInteractions": [      {        "marketplace": "Unknown",        "transactionCount": "222"      }    ]  }}

Sorgu 3: Yüksek İşlem Sayısına Sahip Pazar Etkileşimleri

Bu sorgu şunları yapar:

  • “Unknown” pazarlarını hariç tutarak, 100’den fazla işlemi olan ilk dört pazarı getirir.
  • Yalnızca geçerli pazar türlerinin dahil edilmesini sağlamak için filtre olarak enum’lar kullanır. Böylece doğruluk oranı arttırılmış olur.
{  marketplaceInteractions(    first: 4    orderBy: transactionCount    orderDirection: desc    where: { transactionCount_gt: "100", marketplace_not: "Unknown" }  ) {    marketplace    transactionCount  }}

Sonuç 3

Beklenen çıktı, her biri bir enum değeri ile temsil edilen, kriterleri karşılayan pazarları içerir:

{  "data": {    "marketplaceInteractions": [      {        "marketplace": "NFTX",        "transactionCount": "201"      },      {        "marketplace": "OpenSeaV1",        "transactionCount": "148"      },      {        "marketplace": "CryptoCoven",        "transactionCount": "117"      },      {        "marketplace": "OpenSeaV1",        "transactionCount": "111"      }    ]  }}

Ek Kaynaklar

Ek bilgi için bu rehberin deposuna⁠ göz atın.