Hver HeroMiners-pool svarer på det samme settet med skrivebeskyttede HTTP-endepunkter. Det finnes ingen nøkkel, ingen konto og ingen registrering: be om en URL, så får du JSON tilbake, med Access-Control-Allow-Origin: * satt, slik at en side i en nettleser kan kalle den direkte. Bruk den til å lage en riggovervåking, et utbetalingsvarsel, din egen oversikt, eller til å hente poolens data inn i et regneark.
Hver coin har sin egen pool med egne tall og sitt eget adresseformat, så velg coin først, og skriv deretter inn en adresse for den coinen. Ingenting du skriver her, sendes noe annet sted enn til selve poolen, og bare når du trykker på Kjør.
Basis-URL
https://alephium.herominers.com
Endepunkter
GET/api/stats
Alt poolen vet om seg selv akkurat nå: poolens og nettverkets hashrate, tilkoblede minere og workers, den siste blokken, gebyrer, porter og utbetalingsinnstillingene.
Parametere
address
En utbetalingsadresse. Legger til den mineren under miner, og under solo_miner hvis vedkommende også miner solo. Utelates den, sendes ingen av nøklene.
Dette er endepunktet du bør starte med. Poolsiden, minersiden og hvert diagram på dette nettstedet er bygget på det.
Forespørsel
curl "https://alephium.herominers.com/api/stats"
Svar
Et objekt med pool, network, config, charts, lastblock, payments og visitors, det vil si hvor mange som er på nettstedet akkurat nå, som { windowMinutes, activeVisitors, activeLookups }. Beregnes på nytt én gang per statistikksyklus, så hyppigere forespørsler gir de samme tallene.
GET/api/live_stats
De samme dataene som /api/stats, men forespørselen holdes åpen til neste statistikksyklus er ferdig, og besvares da. Én forespørsel per oppdatering i stedet for forespørsler på en tidtaker.
Parametere
address
Ta med en miner i svaret, som med /api/stats.
Åpne én tilkobling, og åpne den på nytt når den svarer. Flere åpne samtidig fra samme IP avvises med 503, så ikke spre forespørslene ut i parallell.
Samme struktur som /api/stats, bortsett fra at miner og solo_miner alltid sendes, tomme når ingen adresse er oppgitt. Forespørselen holdes åpen i opptil én statistikksyklus.
GET/api/stats_address
Én miner: nåværende og gjennomsnittlig hashrate, gyldige shares og stale shares, saldo, utbetalt beløp og de samme tallene per worker.
Skriv inn address ovenfor for å kjøre denne. Kommandoen viser verdien fordi poolen svarer med en feil uten den.
Svar
Et objekt med stats (minerens totaler), payments, charts, unlocked og workers, et array med én oppføring per worker, navngitt etter sitt name. En adresse som aldri har minet her, får en feil i stedet for en tom miner.
GET/api/get_blocks
Blokker poolen har funnet som ikke lenger venter: utbetalt eller foreldreløse. status sier hvilket.
Parametere
heightpåkrevd
Returner blokker under denne høyden. Oppgi et tall langt over kjedens topp for den nyeste siden, og deretter den laveste høyden du fikk, for å bla bakover.
Finnerens adresse maskeres før den forlater poolen, så dette endepunktet kan ikke brukes til å samle inn adresser. time er i Unix-sekunder, reward i coinens minste enhet, og en soloblokk har en score på s0 når den ble utbetalt, eller s1 når den ble foreldreløs.
Betalinger poolen har sendt, enten for hele poolen eller for én adresse.
Parametere
timepåkrevd
Returner betalinger før dette Unix-tidsstempelet i sekunder. Bruk nåværende tidspunkt for den nyeste siden, og deretter det eldste tidsstempelet du fikk, for å bla bakover.
address
Begrens til én utbetalingsadresse. Utelat for alle betalinger poolen har gjort.
limit
Hvor mange som skal returneres. Begrenses til poolens egen sidestørrelse, så et større tall gir bare den.
format
Oppgi parsed for å få { tx, amount, time }-objekter i stedet for det rå arrayet.
conversions
Sammen med address oppgir du 1 for også å få vekslingsposten for hver utbetaling på siden som ble vekslet til en annen coin. Svaret blir da { payments, conversions }. Ignoreres med format=parsed.
Uten format et flatt array som veksler mellom verdi og tidsstempel, der hver verdi er txid:amount. Beløp er strenger i coinens minste enhet og må forbli strenger: tolkes et som et tall, går presisjon tapt på en kjede med 18 desimaler.
GET/api/get_miners_stats
De ti største minerne i poolen, pluss fordelingen per mining-programvare og region bak minersiden.
Et objekt med miners, agents, regions, regionHistory og statsDisplay. Adresser er maskert. Når et panel ikke er aktivert, kommer arrayet tomt tilbake, og statsDisplay sier det.
GET/api/get_blocks_search
Søk i poolens blokker etter høyde, blokk-hash eller finnerens adresse, blant ventende og utbetalte blokker på én gang.
Parametere
qpåkrevd
En høyde, en blokk-hash eller en adresse.
offset
Hopp over så mange resultater. Svaret inneholder hasMore, så du vet om du skal spørre igjen.
Søket er begrenset per IP, og den som går over grensen, får rateLimited med nøyaktig ventetid i retryMs i stedet for en naken feil. Kall /api/get_blocks_search_config først for å kjenne lengdegrensene, og om søket i det hele tatt er slått på.
Skriv inn q ovenfor for å kjøre denne. Kommandoen viser verdien fordi poolen svarer med en feil uten den.
Svar
Et objekt med pending og matured, begge vekslende mellom verdi og høyde som /api/get_blocks, pluss totalMatched, offset, limit og hasMore. En matured-blokk har formatet fra /api/get_blocks; en pending-blokk venter fortsatt på å modnes og bruker det lengre formatet for ventende blokker, så feltene står i en annen rekkefølge.
GET/api/get_blocks_search_config
Om blokksøket er slått på, og hvilke grenser et søk må holde seg innenfor, slik at et søkefelt kan settes opp før det første søket.
{ enabled, minQueryLength, maxQueryLength, frontendCooldownMs }. Lengdene er i tegn, og frontendCooldownMs er hvor lenge du må vente mellom to søk.
GET/api/get_miner_payout_level
Utbetalingsgrensen som for øyeblikket er satt for en adresse, i hele coins.
Parametere
addresspåkrevd
Utbetalingsadressen.
Det tilsvarende /api/set_miner_payout_level skriver den, og det er ikke åpent for alle: forespørselen må komme fra adressens egen mining-IP. Den kontrollen, og forespørselsgrensen foran den, er beskrevet på fanen Innstillinger i oversikten i stedet for her.
Skriv inn address ovenfor for å kjøre denne. Kommandoen viser verdien fordi poolen svarer med en feil uten den.
Svar
{ banned, minerMessage }, og ved en sperring også blockMining, blockPayments og reason. Det er meldingen minersiden viser for denne adressen: sperret for mining, for utbetalinger eller ingen av delene. minerMessage er operatørens melding til denne adressen, som { message, type, createdAt, expiresAt }, eller null når det ikke finnes noen.
Bruk den godt
Spør i poolens eget tempo. Tallene beregnes på nytt én gang per statistikksyklus, og config.updateInterval i svaret fra /api/stats sier hvor lang den er i sekunder. Å spørre oftere gir det samme svaret og koster båndbredde for oss begge.
Bruk heller /api/live_stats enn en rask tidtaker. Det svarer så snart det finnes noe nytt, noe som både er raskere for deg og lettere for poolen enn gjentatte forespørsler.
Behold beløp som strenger. Belønninger og saldoer kommer tilbake i coinens minste enhet. På en kjede med 18 desimaler blir disse heltallene større enn et JavaScript-tall kan holde nøyaktig, så tolkning av et av dem runder stille av en utbetaling.
Regn med maskerte adresser. Offentlige lister skjuler midten av hver adresse. Din egen fulle adresse trengs bare av deg, og bare der du selv oppgir den.
Behandle en forespørselsgrense som en ventetid, ikke en feil. Der en grense gjelder, inneholder svaret retryMs. Vent så lenge og prøv igjen i stedet for å bombardere poolen med forespørsler.
Si hvem du er. En User-Agent som navngir verktøyet ditt, er ikke påkrevd, men da kan vi fortelle deg om en endring i stedet for at du må gjette hva som gikk i stykker.