ყველა 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, რომელიც თქვენს ხელსაწყოს ასახელებს, სავალდებულო არ არის, მაგრამ ასე ცვლილების შესახებ შეგვიძლია გაცნობოთ, ნაცვლად იმისა, რომ გამოიცნოთ, რა გაფუჭდა.