Сваки HeroMiners базен одговара на исти скуп HTTP крајњих тачака само за читање. Нема кључа, налога ни регистрације: затражите URL и добијате JSON, уз постављено Access-Control-Allow-Origin: *, па страница у прегледачу може директно да га позове. Користите га за надзор рига, обавештења о исплатама, сопствену контролну таблу или за пренос података базена у табелу.
Сваки новчић има свој базен, са својим бројевима и својим форматом адресе, па прво изаберите новчић и унесите адресу за тај новчић. Ништа што овде унесете не шаље се никуд осим самом базену, и то само када притиснете Покрени.
Основни URL
https://alephium.herominers.com
Крајње тачке
GET/api/stats
Све што базен тренутно зна о себи: хеш стопа базена и мреже, повезани рудари и радници, последњи блок, накнаде, портови и подешавања исплата.
Параметри
address
Адреса за исплату. Додаје тог рудара под miner, и под solo_miner ако рудари и соло. Без ње се не шаље ниједан од та два кључа.
Од ове крајње тачке треба почети. Страница базена, страница рудара и сваки графикон на овом сајту праве се из ње.
Захтев
curl "https://alephium.herominers.com/api/stats"
Одговор
Објекат са pool, network, config, charts, lastblock, payments и visitors, то јест колико је људи тренутно на сајту, као { windowMinutes, activeVisitors, activeLookups }. Поново се рачуна једном по циклусу статистике, па чешће испитивање враћа исте бројеве.
GET/api/live_stats
Исти подаци као /api/stats, али захтев остаје отворен док се следећи циклус статистике не заврши, и тада добија одговор. Један захтев по ажурирању уместо испитивања по тајмеру.
Параметри
address
Укључује рудара у одговор, као код /api/stats.
Отворите једну везу и поново је отворите када одговори. Више истовремено отворених веза са исте IP адресе одбија се са 503, зато их не умножавајте.
Иста структура као /api/stats, осим што се miner и solo_miner увек шаљу, празни када адреса није дата. Захтев остаје отворен најдуже један циклус статистике.
GET/api/stats_address
Један рудар: тренутна и просечна хеш стопа, важеће и застареле деонице, салдо, исплаћен износ и исти подаци по раднику.
Унесите изнад address да бисте покренули овај захтев. Команда то приказује јер базен без тога одговара грешком.
Одговор
Објекат са stats (збирови рудара), payments, charts, unlocked и workers, низом са по једним уносом за сваког радника, именованим по његовом name. Адреса која овде никада није рударила добија грешку уместо празног рудара.
GET/api/get_blocks
Блокови које је базен пронашао и који више нису на чекању: исплаћени или сирочад. status каже шта је од тога.
Параметри
heightобавезно
Враћа блокове испод ове висине. За најновију страну проследите број далеко изнад врха ланца, а затим најнижу примљену висину да бисте листали уназад.
Адреса проналазача се маскира пре него што напусти базен, па се ова крајња тачка не може користити за прикупљање адреса. time је у Unix секундама, reward у најмањој јединици новчића, а соло блок носи score вредности s0 када је исплаћен или s1 када је постао сироче.
Исплате које је базен послао, за цео базен или за једну адресу.
Параметри
timeобавезно
Враћа исплате пре овог Unix времена у секундама. За најновију страну користите тренутно време, а затим најстарије примљено време да бисте листали уназад.
address
Ограничава на једну адресу за исплату. Изоставите за све исплате које је базен икада извршио.
limit
Колико уноса вратити. Ограничено на величину стране базена, па већи број једноставно враћа толико.
format
Проследите parsed да бисте добили објекте { tx, amount, time } уместо сировог низа.
conversions
Уз address, проследите 1 да бисте добили и запис о конверзији сваке исплате на страни која је промењена у други новчић. Одговор тада постаје { payments, conversions }. Занемарује се уз format=parsed.
Без format, раван низ у коме се смењују вредност и време, а свака вредност је txid:amount. Износи су стрингови у најмањој јединици новчића и морају остати стрингови: ако се неки рашчлани као број, на ланцу са 18 децимала губи се прецизност.
GET/api/get_miners_stats
Десет највећих рудара у базену, плус подела по софтверу за рударење и по регионима иза странице рудара.
Објекат са miners, agents, regions, regionHistory и statsDisplay. Адресе су маскиране. Када панел није укључен, његов низ стиже празан и statsDisplay то наводи.
GET/api/get_blocks_search
Претрага блокова базена по висини, хешу блока или адреси проналазача, истовремено у блоковима на чекању и исплаћеним блоковима.
Параметри
qобавезно
Висина, хеш блока или адреса.
offset
Прескаче толико резултата. Одговор садржи hasMore, па знате да ли треба поново питати.
Претрага је ограничена по IP адреси, а прекорачење враћа rateLimited са тачним временом чекања у retryMs уместо голе грешке. Прво позовите /api/get_blocks_search_config да бисте сазнали границе дужине и да ли је претрага уопште укључена.
Унесите изнад q да бисте покренули овај захтев. Команда то приказује јер базен без тога одговара грешком.
Одговор
Објекат са pending и matured, оба са смењивањем вредности и висине као /api/get_blocks, плус totalMatched, offset, limit и hasMore. Блок matured је у формату /api/get_blocks; блок pending још чека да сазри и користи дужи формат за блокове на чекању, па су му поља другачијим редоследом.
GET/api/get_blocks_search_config
Да ли је претрага блокова укључена и које границе упит мора да испуни, како би поље за претрагу могло да се подеси пре прве претраге.
{ enabled, minQueryLength, maxQueryLength, frontendCooldownMs }. Дужине су у знаковима, а frontendCooldownMs је колико треба чекати између две претраге.
GET/api/get_miner_payout_level
Праг исплате тренутно подешен за адресу, у целим новчићима.
Параметри
addressобавезно
Адреса за исплату.
Одговарајући /api/set_miner_payout_level га уписује и није отворен свима: захтев мора доћи са рударске IP адресе те адресе. Та провера, и ограничење захтева испред ње, описани су на картици подешавања контролне табле, а не овде.
Унесите изнад address да бисте покренули овај захтев. Команда то приказује јер базен без тога одговара грешком.
Одговор
{ banned, minerMessage }, а када је блокирана и blockMining, blockPayments и reason. То је обавештење које страница рудара приказује за ову адресу: блокирано рударење, блокиране исплате или ништа од тога. minerMessage је порука оператера овој адреси, као { message, type, createdAt, expiresAt }, или null када је нема.
Како га добро користити
Испитујте у ритму базена. Бројеви се поново рачунају једном по циклусу статистике, а config.updateInterval у одговору /api/stats каже колико то траје у секундама. Чешће испитивање враћа исти одговор и троши пропусни опсег и Вама и нама.
Користите /api/live_stats уместо брзог тајмера. Одговара чим има нешто ново, што је и брже за Вас и лакше за базен од испитивања по тајмеру.
Чувајте износе као стрингове. Награде и салда стижу у најмањој јединици новчића. На ланцу са 18 децимала ти цели бројеви прелазе оно што JavaScript број може тачно да прикаже, па рашчлањивање неприметно заокружује исплату.
Очекујте маскиране адресе. Јавне листе крију средину сваке адресе. Вашу пуну адресу требате само Ви, и то само тамо где је сами унесете.
Ограничење захтева третирајте као чекање, а не као грешку. Где важи ограничење, одговор садржи retryMs. Сачекајте толико и покушајте поново, уместо да засипате базен захтевима.
Реците ко сте.User-Agent који именује Ваш алат није обавезан, али тако можемо да Вас обавестимо о промени уместо да погађате шта се покварило.