Әр 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
Бір майнер: ағымдағы және орташа хешрейт, жарамды және ескірген share-лер, баланс, төленген сома және әр воркер бойынша сол көрсеткіштер.
Мұны іске қосу үшін жоғарыда address енгізіңіз. Команда оны көрсетеді, өйткені онсыз пул қатемен жауап береді.
Жауап
stats (майнердің жиынтығы), payments, charts, unlocked және workers өрістері бар объект; соңғысы әр воркерге бір жазбадан тұратын, name бойынша аталған массив. Мұнда ешқашан майнинг жасамаған мекенжайға бос майнер емес, қате қайтарылады.
GET/api/get_blocks
Пул тапқан, енді күтуде емес блоктар: төленген немесе орфан блокқа айналған. Қайсысы екенін status көрсетеді.
Параметрлер
heightміндетті
Осы биіктіктен төмен блоктарды қайтару. Ең жаңа бет үшін тізбек ұшынан әлдеқайда үлкен сан беріңіз, содан кейін артқа парақтау үшін алған ең төменгі биіктікті беріңіз.
Тапқан майнердің мекенжайы пулдан шықпас бұрын бүркемеленеді, сондықтан бұл эндпоинтты мекенжайлар жинау үшін пайдалану мүмкін емес. time Unix секундтарымен, reward монетаның ең кіші бірлігімен беріледі, ал соло блок төленсе s0, орфан блокқа айналса s1 мәнді score алып жүреді.
Пул жіберген төлемдер: бүкіл пул бойынша немесе бір мекенжай үшін.
Параметрлер
timeміндетті
Осы Unix уақыт белгісіне (секундпен) дейінгі төлемдерді қайтару. Ең жаңа бет үшін ағымдағы уақытты, содан кейін артқа парақтау үшін алған ең ерте уақыт белгісін беріңіз.
address
Бір төлем мекенжайымен шектеу. Онсыз пулдың барлық төлемдері қайтарылады.
limit
Қанша жазба қайтару керек. Пулдың өз бет өлшемімен шектеледі, сондықтан үлкенірек сан жай сол өлшемді қайтарады.
format
Шикі массивтің орнына { tx, amount, time } объектілерін алу үшін parsed беріңіз.
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 үшін жиілік бойынша шектелген, шектен асқанда жай қате емес, retryMs ішінде нақты күту уақыты бар rateLimited қайтарылады. Сұрау ұзындығының шектерін және іздеудің қосулы екенін білу үшін алдымен /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.
Дұрыс пайдалану
Пулдың өз ырғағымен сұраңыз. Сандар статистика циклі сайын бір рет қайта есептеледі, ал /api/stats жауабындағы config.updateInterval оның ұзақтығын секундпен көрсетеді. Жиірек сұрасаңыз, сол жауап қайтады әрі екеуіміздің де трафигіміз босқа жұмсалады.
Жиі таймердің орнына /api/live_stats пайдаланыңыз. Ол жаңа бірдеңе пайда болған сәтте жауап береді, бұл сізге жылдамырақ әрі пулға сұраудан гөрі жеңілірек.
Сомаларды жол түрінде сақтаңыз. Сыйақылар мен баланстар монетаның ең кіші бірлігімен келеді. 18 ондық таңбасы бар тізбекте мұндай бүтін сандар JavaScript санының дәл сақтай алатын шегінен асады, сондықтан түрлендіру төлемді байқаусыз дөңгелектейді.
Мекенжайлар бүркемеленеді деп күтіңіз. Ашық тізімдер әр мекенжайдың ортасын жасырады. Толық мекенжайыңыз тек сізге және тек өзіңіз көрсеткен жерде ғана керек.
Жиілік шектеуін ақау емес, күту деп қабылдаңыз. Шектеу қолданылатын жерде жауапта retryMs болады. Пулды сұрауларға көмбей, сонша күтіп, қайталаңыз.
Өзіңізді таныстырыңыз. Құралыңыздың атауы көрсетілген User-Agent міндетті емес, бірақ ол болса, не бұзылғанын болжаудың орнына өзгеріс туралы сізге хабарлай аламыз.