Ana içeriğe atla

Genel Bakış

getTransactionsForAddress, işlem imzası aramasını ve tam işlem verisinin alınmasını tek ve verimli bir çağrıda birleştirir. Önce getSignaturesForAddress, ardından her imza için getTransaction şeklinde ayrı istekler yapmak yerine her şeyi tek bir istekte alırsınız. Bu metod şunları destekler:
  • Çift yönlü sıralama (en eskiden yeniye veya en yeniden eskiye)
  • Aralık operatörleriyle zamana ve slota göre filtreleme
  • İşlem durumuna göre filtreleme (başarılı/başarısız)
  • Token hesabı filtreleme (none, balanceChanged, all)
  • paginationToken ile imleç tabanlı sayfalama
  • Dört ayrıntı seviyesi: signatures, none, accounts, full
Bir getTransactionsForAddress çağrısının arşivden okuması gerektiğinde, arşiv sınırına sayılır: planınızın RPS değerinin %10’u (örneğin, Geliştirici planında 5 RPS). Sınır aşıldığında archival rate limit exceeded mesajıyla HTTP 429 döner. Ayrıca JSON-RPC toplu isteği içinde gönderilemez: her çağrıyı ayrı bir istek olarak gönderin. Bkz. Kimlik Doğrulama ve Limitler.

Bu Metod Neden Kullanılmalı

N+1 Sorunu

Standart Solana RPC metodlarıyla işlem geçmişini almak birden fazla çağrı gerektirir:
  1. İşlem imzalarının listesini almak için getSignaturesForAddress çağrılır
  2. Tam işlem verisini almak için her imza için getTransaction çağrılır
100 işlemi olan bir cüzdan için bu 101 API çağrısı demektir. 1.000 işlem için 1.001 çağrı gerekir. Bu da gecikmeye, karmaşıklığa ve daha yüksek maliyete yol açar. getTransactionsForAddress bu sorunu tam işlem verisini tek bir çağrıda döndürerek çözer: istek başına en fazla 100 tam işlem veya 1.000 imza.

Ek Yetenekler

Verimliliğin ötesinde, bu metod standart RPC’de bulunmayan özellikler sunar:
  • Çift yönlü sıralama: Bir adresi ilk işleminden itibaren izlemek için en eskiden başlayarak (asc) sorgulayın
  • Zamana göre filtreleme: Aralık operatörleriyle filters.blockTime kullanarak belirli bir tarih aralığındaki işlemleri alın
  • Slota göre filtreleme: Aralık operatörleriyle filters.slot kullanarak belirli blok aralıklarındaki işlemleri sorgulayın
  • Duruma göre filtreleme: Yalnızca başarılı veya yalnızca başarısız işlemleri alın
  • Token hesaplarını dahil etme: İlişkili token hesaplarından gelen işlemleri de yakalayın

Token Hesabı Desteği

Standart getSignaturesForAddress yalnızca sorgulanan adrese doğrudan referans veren işlemleri döndürür. Bu, önemli bir kategoriyi atlar: token transferleri. Bir cüzdana token gönderildiğinde işlem, cüzdan adresinin kendisine değil, cüzdanın İlişkili Token Hesabına (ATA) referans verir. Bu nedenle standart metodlar size eksik bir tablo sunar. tokenAccounts: "all" ile kullanılan getTransactionsForAddress, adresin sahip olduğu tüm token hesaplarındaki işlemleri otomatik olarak dahil eder ve size eksiksiz işlem geçmişini verir.
Yalnızca adrese doğrudan referans veren işlemleri istiyorsanız tokenAccounts: "none" (varsayılan) kullanın.

Parametreler

string
gerekli
Sorgulanacak Solana adresi (base-58 kodlu genel anahtar, 32 bayt)
object

Yanıt

Yanıttaki result, bir data dizisi ve isteğe bağlı bir paginationToken içeren bir nesnedir:
paginationToken yalnızca daha fazla sonuç olduğunda bulunur. Sonraki sayfayı almak için bunu bir sonraki istekte iletin.

transactionDetails: "signatures" veya "none" ile

object

transactionDetails: "accounts" ile

signatures modundaki alanların aynısı, ek olarak:
string[]
İşleme dahil olan base-58 genel anahtarlarının dizisi; lookup table’lardan yüklenen adresler de dahildir.

transactionDetails: "full" ile

object

Kod Örnekleri

Temel İstek

Bir adresin en son imzalarını alın (varsayılan mod):

Tam İşlemleri Alma

En fazla 100 tam işlem alın:

Yalnızca İmzaları Alma

Tam işlem verisi olmadan en fazla 1000 imza alın:

Zaman Filtresiyle En Eskiden Başlayarak

Belirli bir zaman aralığındaki işlemleri en eskiden başlayarak sıralanmış şekilde alın:

Yalnızca Başarılı İşlemler

Yalnızca başarılı olan işlemleri döndürecek şekilde filtreleyin:

Sayfalı İstek

Daha fazla sonuç almak için imleç tabanlı sayfalama kullanın:

TypeScript Örneği

Kullanım Alanları

Token Lansman Analizi

İlk mint edenleri ve erken sahipleri belirlemek için bir token mint’inin en erken işlemlerini bulun. En baştan başlamak için sortOrder: "asc" kullanın:

Cüzdan Fonlama Geçmişi

Bir cüzdanın eksiksiz işlem geçmişini sorgulayarak fonlarının nereden geldiğini izleyin:

Başarısız İşlem Analizi

Yalnızca başarısız işlemleri filtreleyerek işlem hatalarında hata ayıklayın:

Cüzdan İşlem Akışı Oluşturma

Bir cüzdan arayüzü için sayfalı bir işlem geçmişi oluşturun:

Alım Satım Örüntüsü Analizi

Belirli bir zaman aralığındaki başarılı alım satımları filtreleyin:

Uyumluluk Denetimi

Yasal uyumluluk için eksiksiz bir işlem geçmişi oluşturun:

Sayfalama

Çok sayıda işlemi olan adresler için sonraki sayfayı almak üzere yanıttaki paginationToken değerini kullanın. Token, sunucuya nereden devam edeceğini söyleyen "slot:txIndex" biçiminde bir dizedir.

Önce Yeni İşlemleri Alma (Varsayılan)

sortOrder: "desc" (varsayılan) ile işlemler en yeniden başlayarak döndürülür. paginationToken daha eski işlemlere doğru devam eder:

Önce Eski İşlemleri Alma

sortOrder: "asc" ile işlemler en eskiden başlayarak döndürülür. paginationToken daha yeni işlemlere doğru devam eder:

Eksiksiz Sayfalama Örneği

Bir adresin tüm imzalarını alın:

En İyi Uygulamalar

  1. Saymak için signatures modunu kullanın: Yalnızca işlemleri saymanız veya listelemeniz gerekiyorsa daha iyi performans ve daha yüksek limitler (en fazla 1000) için transactionDetails: "signatures" (varsayılan) kullanın.
  2. Erken filtreleyin: Taranan veri miktarını azaltmak ve yanıt sürelerini iyileştirmek için blockTime, slot veya status filtreleri uygulayın.
  3. Sayfalama uygulayın: Çok sayıda işlemi olan adreslerde her zaman yanıttaki paginationToken ile sayfalama yapın.
  4. Sonuçları önbelleğe alın: İşlem verisi kesinleştikten sonra değişmez. Gereksiz isteklerden kaçınmak için geçmiş sonuçları önbelleğe alın.
  5. Arşiv sınırının altında kalın: Arşivden okuyan çağrılar planınızın RPS değerinin %10’u ile sınırlıdır. Ardışık istekleri bu sınırın altında kalacak şekilde aralıklandırın ve 429 aldığınızda üstel geri çekilme uygulayın.

Yaygın Hatalar

Standart Metodlarla Karşılaştırma