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) paginationTokenile 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:- İşlem imzalarının listesini almak için
getSignaturesForAddressçağrılır - Tam işlem verisini almak için her imza için
getTransactionçağrılır
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.blockTimekullanarak belirli bir tarih aralığındaki işlemleri alın - Slota göre filtreleme: Aralık operatörleriyle
filters.slotkullanarak 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
StandartgetSignaturesForAddress 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.
tokenAccounts: "none" (varsayılan) kullanın.
Parametreler
string
gerekli
Sorgulanacak Solana adresi (base-58 kodlu genel anahtar, 32 bayt)
object
Yanıt
Yanıttakiresult, 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çinsortOrder: "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ıttakipaginationToken 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
-
Saymak için
signaturesmodunu kullanın: Yalnızca işlemleri saymanız veya listelemeniz gerekiyorsa daha iyi performans ve daha yüksek limitler (en fazla 1000) içintransactionDetails: "signatures"(varsayılan) kullanın. -
Erken filtreleyin: Taranan veri miktarını azaltmak ve yanıt sürelerini iyileştirmek için
blockTime,slotveyastatusfiltreleri uygulayın. -
Sayfalama uygulayın: Çok sayıda işlemi olan adreslerde her zaman yanıttaki
paginationTokenile sayfalama yapın. - 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.
-
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
429aldığınızda üstel geri çekilme uygulayın.