Her HeroMiners havuzu aynı salt okunur HTTP uç noktalarını yanıtlar. Anahtar, hesap ya da kayıt yoktur: bir URL isteyin, JSON yanıt alın. Yanıtta Access-Control-Allow-Origin: * ayarlıdır, bu yüzden tarayıcıdaki bir sayfa onu doğrudan çağırabilir. Bir rig izleyici, bir ödeme bildiricisi, kendi paneliniz için kullanın ya da havuzu bir tabloya çekin.
Her coin'in kendi rakamları ve kendi adres biçimi olan kendi havuzu vardır, bu yüzden önce coin'i seçin ve o coin için bir adres girin. Buraya yazdığınız hiçbir şey havuzun kendisinden başka bir yere gönderilmez, o da yalnızca Çalıştır'a bastığınızda.
Temel URL
https://alephium.herominers.com
Uç noktalar
GET/api/stats
Havuzun şu anda kendisi hakkında bildiği her şey: havuz ve ağ hashrate'i, bağlı madenciler ve işçiler, son blok, ücretler, portlar ve ödeme ayarları.
Sorgu
address
Bir ödeme adresi. O madenciyi miner altına, solo da kazıyorsa solo_miner altına ekler. Verilmezse bu anahtarların hiçbiri gönderilmez.
Başlangıç noktası bu uç noktadır. Havuz sayfası, madenciler sayfası ve bu sitedeki her grafik bundan oluşturulur.
İstek
curl "https://alephium.herominers.com/api/stats"
Yanıt
pool, network, config, charts, lastblock, payments ve şu anda sitede kaç kişi olduğunu { windowMinutes, activeVisitors, activeLookups } olarak veren visitors alanlarını içeren bir nesne. Her istatistik döngüsünde bir kez yeniden hesaplanır, bu yüzden daha sık sorgulamak aynı rakamları döndürür.
GET/api/live_stats
/api/stats ile aynı içerik, ancak bir sonraki istatistik döngüsü bitene kadar açık tutulur ve sonra yanıtlanır. Bir zamanlayıcıyla sorgulamak yerine güncelleme başına tek istek.
Sorgu
address
/api/stats ile olduğu gibi, bir madenciyi içeriğe ekler.
Tek bir bağlantı açın ve yanıt geldiğinde yeniden açın. Aynı IP'den aynı anda açık birden fazla bağlantı 503 ile reddedilir, bu yüzden çoğaltmayın.
/api/stats ile aynı yapı, tek fark miner ve solo_miner her zaman gönderilir, adres verilmediğinde boştur. İstek en fazla bir istatistik döngüsü boyunca açık kalır.
GET/api/stats_address
Tek bir madenci: anlık ve ortalama hashrate, geçerli ve bayat share'ler, bakiye, ödenen miktar ve işçi başına aynı rakamlar.
Bunu çalıştırmak için yukarıya address girin. Komut bunu gösterir, çünkü havuz onsuz hata ile yanıt verir.
Yanıt
stats (madenci toplamları), payments, charts, unlocked ve her işçi için name ile adlandırılmış bir girdi içeren workers dizisini içeren bir nesne. Burada hiç madencilik yapmamış bir adres, boş bir madenci yerine hata ile yanıtlanır.
GET/api/get_blocks
Havuzun bulduğu ve artık beklemede olmayan bloklar: ödenmiş ya da yetim kalmış. Hangisi olduğunu status söyler.
Sorgu
heightzorunlu
Bu yüksekliğin altındaki blokları döndürür. En yeni sayfa için zirvenin çok üstünde bir sayı verin, sonra geriye doğru sayfalamak için aldığınız en düşük yüksekliği verin.
Bulan adres havuzdan çıkmadan önce maskelenir, bu yüzden bu uç nokta adres toplamak için kullanılamaz. time Unix saniyesidir, reward coin'in en küçük birimindedir ve bir solo blok ödendiyse s0, yetim kaldıysa s1 değerinde bir score taşır.
Havuzun gönderdiği ödemeler, havuzun tamamı ya da tek bir adres için.
Sorgu
timezorunlu
Saniye cinsinden bu Unix zaman damgasından önceki ödemeleri döndürür. En yeni sayfa için şu anki zamanı, sonra geriye doğru sayfalamak için aldığınız en eski zaman damgasını kullanın.
address
Tek bir ödeme adresiyle sınırlar. Havuzun yaptığı tüm ödemeler için verilmez.
limit
Kaç tane döndürüleceği. Havuzun kendi sayfa boyutuyla sınırlanır, bu yüzden daha büyük bir sayı yalnızca o kadarını döndürür.
format
Ham dizi yerine { tx, amount, time } nesneleri almak için parsed verin.
conversions
address ile birlikte, sayfadaki başka bir coin'e dönüştürülmüş her ödemenin dönüşüm kaydını da almak için 1 verin. Yanıt o zaman { payments, conversions } olur. format=parsed ile yok sayılır.
format olmadan, değer ve zaman damgasının sırayla geldiği düz bir dizi, her değer txid:amount biçimindedir. Miktarlar coin'in en küçük birimindeki metinlerdir ve metin olarak kalmalıdır: birini sayı olarak ayrıştırmak 18 ondalıklı bir zincirde hassasiyet kaybettirir.
GET/api/get_miners_stats
Havuzdaki en büyük on madenci, ayrıca madenciler sayfasının arkasındaki madencilik yazılımı ve bölge dağılımları.
miners, agents, regions, regionHistory ve statsDisplay içeren bir nesne. Adresler maskelenir. Bir bölüm etkin değilse dizisi boş döner ve statsDisplay bunu belirtir.
GET/api/get_blocks_search
Havuzun bloklarında yüksekliğe, blok hash'ine ya da bulan adrese göre arama yapın; bekleyen ve ödenmiş blokların ikisinde birden.
Sorgu
qzorunlu
Bir yükseklik, bir blok hash'i ya da bir adres.
offset
Bu kadar sonucu atlar. Yanıt hasMore taşır, böylece yeniden sorup sormayacağınızı bilirsiniz.
Arama IP başına sınırlıdır ve sınırı aşmak çıplak bir hata yerine rateLimited ile birlikte retryMs içinde tam bekleme süresini döndürür. Uzunluk sınırlarını ve aramanın açık olup olmadığını öğrenmek için önce /api/get_blocks_search_config çağırın.
Bunu çalıştırmak için yukarıya q girin. Komut bunu gösterir, çünkü havuz onsuz hata ile yanıt verir.
Yanıt
/api/get_blocks gibi değer ve yüksekliğin sırayla geldiği pending ve matured alanlarını, ayrıca totalMatched, offset, limit ve hasMore içeren bir nesne. matured bir blok /api/get_blocks biçimindedir; pending bir blok hâlâ olgunlaşmayı bekler ve daha uzun bekleyen biçimini kullanır, bu yüzden alanlarının sırası farklıdır.
GET/api/get_blocks_search_config
Blok aramasının açık olup olmadığı ve bir sorgunun uyması gereken sınırlar; böylece bir arama kutusu ilk aramadan önce hazırlanabilir.
{ enabled, minQueryLength, maxQueryLength, frontendCooldownMs }. Uzunluklar karakter cinsindendir ve frontendCooldownMs iki arama arasında ne kadar bekleneceğidir.
GET/api/get_miner_payout_level
Bir adres için şu anda ayarlı ödeme eşiği, tam coin cinsinden.
Sorgu
addresszorunlu
Ödeme adresi.
Karşılığı olan /api/set_miner_payout_level bunu yazar ve herkese açık değildir: istek adresin kendi madencilik IP'sinden gelmelidir. Bu kontrol ve önündeki istek sınırı burada değil, panelin ayarlar sekmesinde anlatılır.
Bunu çalıştırmak için yukarıya address girin. Komut bunu gösterir, çünkü havuz onsuz hata ile yanıt verir.
Yanıt
{ banned, minerMessage }, engelliyse ayrıca blockMining, blockPayments ve reason. Madenci sayfasının bu adres için gösterdiği bildirimdir: madencilikten, ödeme almaktan ya da hiçbirinden engellenmemiş. minerMessage operatörün bu adrese mesajıdır, { message, type, createdAt, expiresAt } olarak, yoksa null.
İyi kullanmak için
Havuzun kendi saatine göre sorgulayın. Rakamlar her istatistik döngüsünde bir kez yeniden hesaplanır ve /api/stats yanıtındaki config.updateInterval bunun kaç saniye olduğunu söyler. Daha sık sormak aynı yanıtı döndürür ve ikimize de bant genişliğine mal olur.
Hızlı bir zamanlayıcı yerine /api/live_stats tercih edin. Yeni bir şey olduğu anda yanıt verir; bu hem sizin için daha hızlı hem de havuz için sorgulamaktan daha hafiftir.
Miktarları metin olarak tutun. Ödüller ve bakiyeler coin'in en küçük biriminde gelir. 18 ondalıklı bir zincirde bu tam sayılar bir JavaScript sayısının tam olarak tutabileceğini aşar, bu yüzden birini ayrıştırmak bir ödemeyi sessizce yuvarlar.
Adreslerin maskeli gelmesini bekleyin. Herkese açık listeler her adresin ortasını gizler. Kendi tam adresinize yalnızca siz ihtiyaç duyarsınız, o da yalnızca onu verdiğiniz yerde.
Bir istek sınırını hata değil, bekleme olarak ele alın. Bir sınırın geçerli olduğu yerde yanıt retryMs taşır. Durmadan yüklenmek yerine o kadar bekleyin ve yeniden deneyin.
Kim olduğunuzu söyleyin. Aracınızı adlandıran bir User-Agent zorunlu değildir, ama ne bozulduğunu tahmin etmek yerine size bir değişiklik hakkında haber verebilmemizi sağlar.