Ümumi baxış
btcpuzzle.info API-si hovuz klientinin danışdığı tərəfdir. O, skan üçün açar aralıqları paylayır, skanın nəticəsini qəbul edir və hovuzun açıq statistikasını dərc edir. btcpuzzle.info açıq mənbəlidir və hər kəs klient yaza bilər: bu bələdçi bütün açıq endpoint-ləri, göndəriləcək məlumatları, geri aldığınız məlumatları və rastlaşa biləcəyiniz xətaları təsvir edir. Suallar: support@btcpuzzle.info.
Bu API qəsdən dondurulub: minerlər və üçüncü tərəf alətlər ondan asılıdır. Yollar, başlıqlar, sahə adları (dateProcces və holded kimi bir neçə köhnə yazılış daxil olmaqla) və xəta kodları dəyişmir. Cavablara yeni sahələr əlavə oluna bilər, ona görə də tanımadığınız sahələri nəzərə almayın.
Baza URL
Bu bələdçidəki hər yol baza URL-ə nisbətəndir:
https://btcpuzzle.info/apiSayt köçməzdən əvvəl yazılmış klientlər eyni yollarla və /api prefiksi olmadan köhnə hostdan istifadə etməyə davam edə bilər:
https://api.btcpuzzle.infoMəsələn, GET https://btcpuzzle.info/api/puzzle/codes və GET https://api.btcpuzzle.info/puzzle/codes eyni cavabı verir. Yeni klientlər /api ilə baza URL-dən istifadə etməlidir.
Sürətli başlanğıc
btcpuzzle.info-da pulsuz hesab yaradın, idarə panelindən miner tokeninizi kopyalayın, sonra aralıq istəyin:
curl "https://btcpuzzle.info/api/puzzle/71/range" \
-H "UserToken: <128-character miner token>" \
-H "WorkerName: rig1"Qaytarılan aralığı altı sübut ünvanı ilə birlikdə skan edin, sübutu PUT /puzzle/71/range ilə göndərin və təkrarlayın. İki çağırış arasında vaxtaşırı ping göndərin ki, hovuz işçinin işlədiyini bilsin.
Qaydalar
Versiyalaşdırma
Tək versiya var və URL-də versiya yoxdur. Köhnə API-nin müqaviləsi dəqiq qorunur; bax: Köhnə sənədlərlə müqayisədə dəyişikliklər.
Autentifikasiya
Miner endpoint-ləri UserToken başlığı ilə müəyyən edilir: hesabınızın 128 simvollu miner tokeni. Onlar üçün başqa giriş və sessiya yoxdur. İstənilən vaxt hesabınızdan yeni token yarada bilərsiniz; köhnəsi dərhal işləməyi dayandırır. Tokeni gizli saxlayın: ona sahib olan sizin adınızdan skan edir.
Bütün məlumat endpoint-ləri (puzzle'lar, statistika, hovuz, token) açıqdır və token tələb etmir.
Sorğular və cavablar
- Miner endpoint-ləri üçün sorğu məlumatları query string və ya body-də deyil, HTTP başlıqlarında göndərilir. Başlıq adları böyük-kiçik hərfə həssas deyil (
UserToken,usertokenvəuserTokeneyni başlıqdır). YalnızPOST /puzzle/{puzzleCode}/save-private-keyJSON body-yə malikdir (Content-Type: application/json). - Cavablar camelCase xüsusiyyət adları ilə UTF-8-də JSON-dur. Dəyəri olmayan xüsusiyyətlər buraxılır; API heç vaxt JSON
nullyazmır. Boşluqlara (indentasiyaya) etibar etməyin. - Tarixlər UTC-də ISO 8601 formatındadır (
2026-11-18T08:28:25.8176144Z). Pul və məbləğlər JSON ədədləridir. rangeContainsKeyskimi böyük ədədlər işarəsiz 64 bitlik tam ədədlərdir və 2^53-dən böyük ola bilər: double istifadə edən dillərdə onları 64 bitlik tam ədəd və ya sətir kimi oxuyun.- Açıq məlumatlarda pulqabı ünvanları qısaldılır (ilk 8 simvol,
..., son 8) və aralıq HEX-inin üçüncü simvoluXilə əvəz olunur (3AB84433AX8443olur).
Sorğu limitləri
Aşağıdakı limitlər cari standart dəyərlərdir. Onlar sabit zaman pəncərəsində sayılır; operator onları tənzimləyə bilər, ona görə də rəqəmləri koda yazmaq əvəzinə 429 cavabını oxuyun.
| Tətbiq olunur | Sayılma əsası | Limit |
|---|---|---|
GET /puzzle/{puzzleCode}/range | UserToken | 60 saniyədə 120 sorğu |
PUT /puzzle/{puzzleCode}/range | UserToken | 60 saniyədə 360 sorğu |
PATCH /puzzle/{puzzleCode}/range/ping | UserToken | 60 saniyədə 360 sorğu |
POST /puzzle/{puzzleCode}/save-private-key | UserToken | 180 saniyədə 10 sorğu |
| Bütün digər endpoint-lər | IP ünvanı | Hər endpoint üçün saniyədə 20 sorğu, cəmi saniyədə 200 |
Limiti aşan sorğuya 429 Too Many Requests, Retry-After başlığı və bu body ilə cavab verilir:
{
"isSuccess": false,
"details": "Quota exceeded."
}Xətalar
Uğursuz sorğular aşağıdakı status kodlarından istifadə edir. Body endpoint-dən asılıdır, ona görə də əvvəlcə status kodunu yoxlayın.
| Status | Body | Mənası |
|---|---|---|
400 | {"error": "<code>"} | Miner endpoint-i sorğunu rədd edib. Kod səbəbini bildirir: invalid_puzzle, invalid_user_token, reached_of_keyspace, too_much_request, not_eligable (yazılışı tarixidir), invalid_request. |
400 | {"isSuccess": false} | Aralığın işarələmə sorğusu rədd edilib (yanlış sübut, naməlum və ya artıq skan edilmiş aralıq, bloklanmış istifadəçi, aktiv olmayan puzzle). |
400 | validasiya problemi | Tələb olunan başlıq yoxdur və ya etibarsızdır, yaxud puzzle nömrəsi 1-160 aralığından kənardadır. Bu, errors sahəsi səhv adları sadalayan application/problem+json obyektidir. |
400 | problem detalları | Açıq məlumat endpoint-inin bu puzzle üçün cavabı yoxdur (naməlum və ya aktiv olmayan puzzle). type, title, status və traceId ilə application/problem+json. |
401 | {"error": "invalid_user_token"} | Miner tokeni naməlumdur və ya hesab bloklanıb (ping və save-private-key). |
404 | {"error": "range_not_found"} | Ping edilən aralıq bu işçidə deyil. |
429 | {"isSuccess": false, "details": "Quota exceeded."} | Sorğu limiti. Retry-After saniyə gözləyin. |
Validasiya problemi nümunəsi (UserToken başlığı olmadan GET /puzzle/71/range):
{
"type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
"title": "One or more validation errors occurred.",
"status": 400,
"errors": {
"UserToken": [
"The UserToken field is required."
]
},
"traceId": "00-e3fc704f799663ec7f42c140ab4c996d-8592b3515c26a5c2-00"
}Keşləmə və CORS
Açıq məlumat endpoint-ləri Cache-Control: public, max-age=N göndərir; dəyər hər endpoint ilə birlikdə göstərilir və keşlənmiş nüsxə bütün çağıranlar arasında paylaşılır, ona görə də N saniyədən tez sorğu göndərmək yalnız eyni məlumatı qaytarır. Miner endpoint-ləri heç vaxt keşlənmir. Brauzerlər API-ni https://btcpuzzle.info, https://www.btcpuzzle.info və http://localhost:3000 ünvanlarından çağıra bilər (sonuncusu köhnə frontend-in lokal inkişafı üçün mövcuddur); native klientlərə CORS təsir etmir.
Miner endpoint-ləri
Skan dövrünün üç çağırışı: aralıq alın, skan edərkən ping göndərin, onu skan edilmiş kimi işarələyin. Dördüncü çağırış tapılan açarı saxlayır. Dördü də UserToken başlığından istifadə edir.
GET/puzzle/{puzzleCode}/range
Puzzle'ın təsadüfi boş aralığını verir və onu sizin üçün saxlayır. Sizdə olan aralıq başqa heç kimə verilmir; onu işarələməsəniz, bir müddətdən sonra hovuza qayıdır (ping saxlama müddətini uzadır).
Parametrlər
| Ad | Yer | Tip | Məcburi | Təsvir |
|---|---|---|---|---|
puzzleCode | path | integer (1-160) | Bəli | Skan ediləcək puzzle, məsələn 71. 38 test hovuzudur. GET /puzzle/codes kodları sadalayır. Tamamlanmış puzzle əvəzinə səssizcə standart puzzle verilir və cavab puzzleCode sahəsində hansı puzzle'ı aldığınızı bildirir. |
UserToken | header | string (128 simvol) | Bəli | Miner tokeniniz. |
WorkerName | header | string (1-16 simvol) | Xeyr | Bu işçinin adı. Yalnız hərf və rəqəmlər. Heç nə göndərməsəniz, default kimi saxlanılır. |
SecurityHash | header | string | Xeyr | Aralıqla birlikdə saxlanılan sərbəst mətn. İstəyə bağlı. |
CustomRange | header | string | Xeyr | Aldığınız aralığı məhdudlaşdırır: HEX-in prefiksi (2D, 3BA) və ya start:end (3400000:38FFFFF). none və ya başlığın olmaması istənilən aralıq deməkdir. Çox dar pəncərəni hovuz genişləndirir, ona görə də göstərdiyinizdən fərqli aralıq ala bilərsiniz. |
Sorğu nümunəsi
curl "https://btcpuzzle.info/api/puzzle/71/range" \
-H "UserToken: <128-character miner token>" \
-H "WorkerName: rig1"Cavab nümunəsi
200 OK
{
"hex": "3AB8443",
"puzzleCode": 71,
"workloadStart": "00000000000",
"workloadEnd": "fffffffffff",
"targetAddress": "1MVDYgVaSN6iKKEsbzRUAYFrYJadLYZvvZ",
"proofOfWorkAddresses": [
"1QLLeQ3Hwp9ai7L4KM65e7SxS12skkYUsA",
"15mLWAX7Hno94fntWj6PEx5wCvZz2zAn8a",
"1DazU9YxVrojvnTrcZrymyc6ZrDkvezJEA",
"14Qada8GbVoKUXCtPHBgF7BPjdEhJWo1ph",
"1PmdgtX2NzoSsSf2ANAnFrBzdftyW3CThY",
"14it3UVGsK6JhsV2HPimD46VSpVcXipFwQ"
]
}Cavab sahələri
| Sahə | Tip | Təsvir |
|---|---|---|
hex | string | Skan ediləcək aralıq, böyük hərflərlə, doldurmasız. O, aralığın şəxsi açarlarının başlanğıcıdır. |
puzzleCode | integer | Aralığın aid olduğu puzzle (istədiyiniz puzzle tamamlanıbsa, standart puzzle). |
workloadStart | string | Aralığın ilk şəxsi açarını almaq üçün hex-ə əlavə olunur. |
workloadEnd | string | Aralığın son şəxsi açarını almaq üçün hex-ə əlavə olunur. Aralıqları bir neçə id-ni əhatə edən puzzle'larda onun uzunluğu workloadStart-dan uzun ola bilər. |
targetAddress | string | Axtardığınız puzzle ünvanı. Onu sübut ünvanları ilə birlikdə skan edin. |
proofOfWorkAddresses | 6 sətirlik massiv | Hovuzun aralığın içində yerləşdirdiyi altı şəxsi açarın ünvanları. Skanı sübut etmək üçün onların şəxsi açarlarını tapın: bax Proof of work. |
Yuxarıdakı nümunədə aralıq 3AB8443 + 00000000000 = 3AB844300000000000 ilə 3AB8443 + fffffffffff = 3AB8443FFFFFFFFFFF arasındadır. Şəxsi açarlar 64 onaltılıq simvoldur; solda sıfırlarla tamamlayın.
Xətalar
| Status | Body | Nə vaxt |
|---|---|---|
400 | {"error": "invalid_puzzle"} | Puzzle mövcud deyil və ya aktiv deyil. |
400 | {"error": "invalid_user_token"} | Token naməlumdur və ya bloklanıb. |
400 | {"error": "too_much_request"} | Skan etmədiyiniz həddən çox aralıq saxlayırsınız və ya bitirdiyinizdən sürətli istəyirsiniz. Əlinizdəkiləri skan edin; saxlanılan aralıqlar qısa müddətdən sonra hovuza qayıdır. |
400 | {"error": "not_eligable"} | Puzzle'ın giriş haqqı var və siz hələ onun şərtlərinə cavab vermirsiniz. |
400 | {"error": "reached_of_keyspace"} | Boş aralıq qalmayıb (və ya CustomRange-ə uyğun olan yoxdur). |
400 | validation problem | Başlıq yoxdur və ya səhv formatdadır, yaxud puzzle nömrəsi 1-160 aralığından kənardadır. |
429 | {"isSuccess": false, ...} | Sorğu limiti: token başına dəqiqədə 120. |
Proof of work
Hovuz aralığı həqiqətən skan etdiyinizə əmin olmaq istəyir. Hər aralıqla o, aralığın içində altı şəxsi açar seçir və yalnız onların ünvanlarını qaytarır (proofOfWorkAddresses). Aralığı hədəf ünvan üçün skan edərkən bu altı ünvanı da axtarın. Altı şəxsi açarın hamısını tapdıqda:
- Hər şəxsi açarı solda sıfırlarla tamamlanmış 64 böyük onaltılıq simvol kimi yazın.
- Altı sətri ünvanların ardıcıllığı ilə, aralarında heç nə qoymadan birləşdirin.
- UTF-8 mətninin SHA-256-sını götürün və onu 64 kiçik onaltılıq simvol kimi yazın. Bu, işarələmə sorğusunun
HashedProofKeydəyəridir.
ProofKey1 = 000000000000000000000000000000000000000000000003AB8443AB91BBAFE8 // for proofOfWorkAddresses[0]
ProofKey2 = 000000000000000000000000000000000000000000000003AB84435AF1E51FD1 // for proofOfWorkAddresses[1]
...
ProofKey6 = ...
HashedProofKey = lowercase_hex( SHA256( ProofKey1 + ProofKey2 + ProofKey3 + ProofKey4 + ProofKey5 + ProofKey6 ) )
= 892a38381912bcce412030d7a403de8a92c0e56f452ba5a865f0bf728ff3fa87Sübut hər aralıq üçün fərqlidir. Sübut ünvanlarının sayı bu gün altıdır; bunu fərz etmək əvəzinə proofOfWorkAddresses-in uzunluğunu oxuyun.
PUT/puzzle/{puzzleCode}/range
Aralığı skan edilmiş kimi işarələyir. Hovuz sübutu yoxlayır və düzgündürsə, aralığı sizin üçün bitmiş sayır. Aralıq yalnız bir dəfə işarələnə bilər.
Parametrlər
| Ad | Yer | Tip | Məcburi | Təsvir |
|---|---|---|---|---|
puzzleCode | path | integer (1-160) | Bəli | Aralığın puzzle'ı. |
UserToken | header | string (128 simvol) | Bəli | Miner tokeniniz. |
HEX | header | string | Bəli | Skan etdiyiniz aralığın hovuzun qaytardığı kimi hex dəyəri. Nümunə: 3AB8443. |
HashedProofKey | header | string | Bəli | Proof of work: bax Proof of work. |
WorkerName | header | string (1-16 simvol) | Xeyr | Aralığı skan edən işçi. |
GPUName | header | string | Xeyr | Videokart modeli. Açıq statistika üçün istifadə olunur. |
GPUCount | header | integer | Xeyr | İşçinin kart sayı. Standart 1. |
IsForceContinue | header | boolean | Xeyr | İşçi açar sahəsinin sonuna çatmasına baxmayaraq davam etdikdə təyin edin. Standart false. |
Sorğu nümunəsi
curl -X PUT "https://btcpuzzle.info/api/puzzle/71/range" \
-H "UserToken: <128-character miner token>" \
-H "WorkerName: rig1" \
-H "HEX: 3AB8443" \
-H "HashedProofKey: 892a38381912bcce412030d7a403de8a92c0e56f452ba5a865f0bf728ff3fa87" \
-H "GPUName: RTX 4090" \
-H "GPUCount: 1"Cavab nümunəsi
200 OK
{
"isSuccess": true
}Xətalar
| Status | Body | Nə vaxt |
|---|---|---|
400 | {"isSuccess": false} | İstənilən rədd: yanlış sübut, naməlum aralıq, artıq işarələnmiş aralıq, bloklanmış hesab, aktiv olmayan puzzle. |
400 | validation problem | Tələb olunan başlıq yoxdur və ya səhv formatdadır. |
429 | {"isSuccess": false, ...} | Sorğu limiti: token başına dəqiqədə 360. |
PATCH/puzzle/{puzzleCode}/range/ping
Hovuza işçinin hələ də öz aralığını skan etdiyini bildirir. Ping aralığın saxlanmasını davam etdirir və işçini saytda aktiv göstərir. Təxminən hər 2 dəqiqədən bir göndərin; interval 30 dəqiqədən uzun olmamalıdır, əks halda hovuz aralığı geri alır.
Parametrlər
| Ad | Yer | Tip | Məcburi | Təsvir |
|---|---|---|---|---|
puzzleCode | path | integer | Bəli | Aralığın puzzle'ı. |
Hex | header | string | Bəli | İşçinin hazırda skan etdiyi aralıq. |
UserToken | header | string (128 simvol) | Bəli | Miner tokeniniz. |
WorkerName | header | string | Bəli | Aralıq istənilərkən istifadə edilmiş işçi adı (heç nə göndərilməyibsə, default). |
Sorğu nümunəsi
curl -X PATCH "https://btcpuzzle.info/api/puzzle/71/range/ping" \
-H "Hex: 3AB8443" \
-H "UserToken: <128-character miner token>" \
-H "WorkerName: rig1"Cavab nümunəsi
Boş body ilə 200 OK.
Xətalar
| Status | Body | Nə vaxt |
|---|---|---|
400 | {"error": "invalid_request"} | Başlıq boşdur. |
401 | {"error": "invalid_user_token"} | Naməlum və ya bloklanmış token. |
404 | {"error": "range_not_found"} | Bu işçidə həmin puzzle üzrə həmin HEX ilə skan edilməmiş aralıq yoxdur. |
429 | {"isSuccess": false, ...} | Sorğu limiti: token başına dəqiqədə 360. |
POST/puzzle/{puzzleCode}/save-private-key
Tapılan şəxsi açarı hesabınızda şifrələnmiş şəkildə saxlayır. Klient açarı ona verdiyiniz RSA açıq açarı ilə şifrələyir; sayt yalnız şifrələnmiş mətni saxlayır və siz onu şəxsi açarınızla deşifrə edirsiniz. Açar idarə panelinizin tapılan açarlar səhifəsində görünür.
Parametrlər
| Ad | Yer | Tip | Məcburi | Təsvir |
|---|---|---|---|---|
puzzleCode | path | integer | Bəli | Açarın aid olduğu puzzle. |
UserToken | header | string (128 simvol) | Bəli | Miner tokeniniz. |
Content-Type | header | string | Bəli | application/json. |
name | body | string | Xeyr | Etiket, məsələn işçi adı. Puzzle71 - rig1 kimi saxlanılır. |
encryptedKey | body | string | Bəli | Şifrələnmiş şəxsi açar (klient onu base64-də göndərir). |
Sorğu nümunəsi
curl -X POST "https://btcpuzzle.info/api/puzzle/71/save-private-key" \
-H "UserToken: <128-character miner token>" \
-H "Content-Type: application/json" \
-d '{"name": "rig1","encryptedKey": "<encrypted key, base64>"}'Cavab nümunəsi
200 OK Diqqət edin ki, xüsusiyyət isSuccess deyil, success-dir.
{
"success": true,
"message": "Key saved successfully."
}Xətalar
| Status | Body | Nə vaxt |
|---|---|---|
401 | {"error": "invalid_user_token"} | Naməlum və ya bloklanmış token. |
400 | problem details | Heç nə saxlanılmadı: eyni açar bu hesab üçün artıq saxlanılıb və ya body yoxdur. |
429 | {"isSuccess": false, ...} | Sorğu limiti: token başına 180 saniyədə 10. |
Puzzle məlumatları
Hovuzun puzzle'ları haqqında açıq oxu endpoint-ləri. Token tələb olunmur. Puzzle obyekti və digər obyektlər bu bələdçinin sonunda təsvir olunur.
GET/puzzle
Hovuzda olan puzzle'lar: aktivlər, növbətilər və test hovuzu (və tarixçə üçün saxlanılan tamamlanmışlar). 300 saniyə keşlənir.
Sorğu nümunəsi
curl "https://btcpuzzle.info/api/puzzle"Cavab nümunəsi
200 OK Puzzle obyektləri massivi, burada birinə qədər qısaldılıb.
[
{
"id": 71,
"name": "Puzzle 71",
"code": 71,
"hexStart": "400000000000000000",
"hexEnd": "7fffffffffffffffff",
"targetWalletAddress": "1MVDYgVaSN6iKKEsbzRUAYFrYJadLYZvvZ",
"hexRangeLength": 7,
"reward": 7.1,
"hexStartPool": "4000000",
"hexEndPool": "7ffffff",
"totalRanges": 67108864,
"percentage": 0.4172,
"rangesScannedLastHour": 612,
"totalScanned": 279997,
"statisticsTotalScanned": 0,
"statisticsFoundOnPool": false,
"statisticsFoundDate": "2026-11-18T08:27:56.937996Z",
"rangeContainsKeyByDefault": 17592186044415,
"rangeContainsKeys": 17592186044415,
"rangesPerKey": 1,
"workloadStart": "00000000000",
"workloadEnd": "fffffffffff",
"dateStart": "2026-01-01T00:00:00Z",
"dateEnd": "2027-01-01T00:00:00Z",
"isCompleted": false,
"isNextPuzzle": false,
"isActive": true,
"isEntranceFeeActive": false,
"entranceFee": 0,
"isDefault": true,
"isTestPool": false,
"isOnPool": true,
"nextScanAllowedInMinutes": 360,
"challenges": []
}
]Xətalar
| Status | Body | Nə vaxt |
|---|---|---|
404 | [] | Hovuzda heç bir puzzle yoxdur. |
GET/puzzle/all
Bazadakı bütün puzzle'lar, tamamlanmışlar da daxil olmaqla. 300 saniyə keşlənir.
Sorğu nümunəsi
curl "https://btcpuzzle.info/api/puzzle/all"200 və Puzzle obyektləri massivi ilə cavab verir.
GET/puzzle/available
Hovuzda skan edilə bilən puzzle'lar. 300 saniyə keşlənir.
Sorğu nümunəsi
curl "https://btcpuzzle.info/api/puzzle/available"200 və Puzzle obyektləri massivi ilə cavab verir.
GET/puzzle/default
Standart puzzle: tamamlanmış puzzle üçün sorğunun yönləndirildiyi puzzle. 300 saniyə keşlənir.
Sorğu nümunəsi
curl "https://btcpuzzle.info/api/puzzle/default"Cavab nümunəsi
200 OK Tək Puzzle obyekti.
{
"id": 71,
"name": "Puzzle 71",
"code": 71,
"hexStart": "400000000000000000",
"hexEnd": "7fffffffffffffffff",
"targetWalletAddress": "1MVDYgVaSN6iKKEsbzRUAYFrYJadLYZvvZ",
"hexRangeLength": 7,
"reward": 7.1,
"hexStartPool": "4000000",
"hexEndPool": "7ffffff",
"totalRanges": 67108864,
"percentage": 0.4172,
"rangesScannedLastHour": 612,
"totalScanned": 279997,
"statisticsTotalScanned": 0,
"statisticsFoundOnPool": false,
"statisticsFoundDate": "2026-11-18T08:27:56.937996Z",
"rangeContainsKeyByDefault": 17592186044415,
"rangeContainsKeys": 17592186044415,
"rangesPerKey": 1,
"workloadStart": "00000000000",
"workloadEnd": "fffffffffff",
"dateStart": "2026-01-01T00:00:00Z",
"dateEnd": "2027-01-01T00:00:00Z",
"isCompleted": false,
"isNextPuzzle": false,
"isActive": true,
"isEntranceFeeActive": false,
"entranceFee": 0,
"isDefault": true,
"isTestPool": false,
"isOnPool": true,
"nextScanAllowedInMinutes": 360,
"challenges": []
}Xətalar
| Status | Body | Nə vaxt |
|---|---|---|
404 | {"error": "puzzle_not_found"} | Standart puzzle təyin edilməyib. |
GET/puzzle/codes
Aktiv və ya növbəti olan puzzle'ların nömrələri, əvvəlcə adi puzzle'lar, sonda test hovuzu. 300 saniyə keşlənir.
Sorğu nümunəsi
curl "https://btcpuzzle.info/api/puzzle/codes"Cavab nümunəsi
200 OK
[71, 72, 73, 38]GET/puzzle/{puzzleCode}/info
Bazadan oxunan bir puzzle. 10 saniyə keşlənir.
Parametrlər
| Ad | Yer | Tip | Məcburi | Təsvir |
|---|---|---|---|---|
puzzleCode | path | integer | Bəli | Puzzle nömrəsi. |
Sorğu nümunəsi
curl "https://btcpuzzle.info/api/puzzle/71/info"Cavab nümunəsi
200 OK Puzzle obyekti. rangesScannedLastHour kimi işləmə vaxtı dəyərləri yalnız siyahı endpoint-lərində doldurulur.
{
"id": 71,
"name": "Puzzle 71",
"code": 71,
"hexStart": "400000000000000000",
"hexEnd": "7fffffffffffffffff",
"targetWalletAddress": "1MVDYgVaSN6iKKEsbzRUAYFrYJadLYZvvZ",
"hexRangeLength": 7,
"reward": 7.1,
"hexStartPool": "4000000",
"hexEndPool": "7ffffff",
"totalRanges": 67108864,
"percentage": 0.4172,
"rangesScannedLastHour": 612,
"totalScanned": 279997,
"statisticsTotalScanned": 0,
"statisticsFoundOnPool": false,
"statisticsFoundDate": "2026-11-18T08:27:56.937996Z",
"rangeContainsKeyByDefault": 17592186044415,
"rangeContainsKeys": 17592186044415,
"rangesPerKey": 1,
"workloadStart": "00000000000",
"workloadEnd": "fffffffffff",
"dateStart": "2026-01-01T00:00:00Z",
"dateEnd": "2027-01-01T00:00:00Z",
"isCompleted": false,
"isNextPuzzle": false,
"isActive": true,
"isEntranceFeeActive": false,
"entranceFee": 0,
"isDefault": true,
"isTestPool": false,
"isOnPool": true,
"nextScanAllowedInMinutes": 360,
"challenges": []
}Xətalar
| Status | Body | Nə vaxt |
|---|---|---|
204 | boş | Belə puzzle yoxdur. |
GET/puzzle/{puzzleCode}/statistics
Puzzle səhifəsinin göstərdiyi hər şey: cəmlər, reytinqlər, aktiv işçilər, son 200 skan edilmiş aralıq və saatlıq qrafik. 60 saniyə keşlənir (server isə bir nüsxəni 5 dəqiqə saxlayır).
Parametrlər
| Ad | Yer | Tip | Məcburi | Təsvir |
|---|---|---|---|---|
puzzleCode | path | integer | Bəli | Aktiv puzzle (və ya test hovuzu). |
Sorğu nümunəsi
curl "https://btcpuzzle.info/api/puzzle/71/statistics"Cavab nümunəsi
200 OK Qısaldılıb: massivlər burada bir element saxlayır, lastRanges isə 200-ə qədər.
{
"puzzle": {
"name": "Puzzle 71",
"code": 71,
"hexStart": "400000000000000000",
"hexEnd": "7fffffffffffffffff",
"targetWalletAddress": "1MVDYgVaSN6iKKEsbzRUAYFrYJadLYZvvZ",
"hexStartPool": "4000000",
"hexEndPool": "7ffffff",
"totalRanges": 67108864,
"totalScanned": 279997,
"rangeContainsKeys": 17592186044415,
"workloadStart": "00000000000",
"workloadEnd": "fffffffffff",
"rangesPerKey": 1,
"isCompleted": false,
"isActive": true,
"isEntranceFeeActive": false,
"entranceFee": 0,
"isDefault": true,
"isTestPool": false,
"reward": 7.1
},
"scannedLast24H": 14702,
"entranceFeesPaidTotal": 0,
"topWorkersAlltime": [
{
"userId": 0,
"walletAddress": "1BvBMSEY...7xJaNVN2",
"totalScanned": 5120
}
],
"topWorkersLast24h": [
{
"userId": 2051875,
"walletAddress": "1BvBMSEY...7xJaNVN2",
"totalScanned": 412
}
],
"activeWorkers": [
{
"walletAddress": "1BvBMSEY...7xJaNVN2",
"workerName": "rig1"
}
],
"challenges": [],
"kingdom": {
"walletAddress": "1BvBMSEY...7xJaNVN2",
"message": "Hello pool",
"image": 3,
"isPublished": true
},
"topSpeed": {
"date": "2026-11-10T14:00:00Z",
"scanned": 912,
"keysPerSecond": 4456789012345
},
"chartData": [
{
"date": "2026-11-18T08:00:00Z",
"dateOnly": "2026-11-18",
"hoursOnly": 8,
"rangesScanned": 640
}
],
"lastRanges": [
{
"hex": "10X0",
"walletAddress": "1BvBMSEY...7xJaNVN2",
"startTime": "2026-11-18T07:27:57.603786Z",
"endTime": "2026-11-18T08:22:57.603786Z",
"pingTime": "2026-11-18T08:20:57.603786Z",
"gpuModel": "RTX 4090",
"gpuCount": 1,
"workerName": "rig1",
"isPremiumUser": false,
"isScanned": true,
"isPinged": false,
"keysInSeconds": 20824083.85909091,
"totalSeconds": 3300
}
],
"rewards": [],
"dateUpdated": "2026-11-18T08:28:25.8176144Z",
"currentSpeed": {
"activeWorkerCount": 38,
"keysPerSecondFormatted": "162.3 Bkeys/s",
"keysPerSecondRaw": "162300000000"
}
}Hələ aktiv olmayan puzzle (növbətilər) üçün yalnız puzzle, scannedLast24H, entranceFeesPaidTotal, lastRanges və dateUpdated qaytarılır. Sahələr üçün Statistics obyektinə baxın.
Xətalar
| Status | Body | Nə vaxt |
|---|---|---|
400 | problem details | Puzzle mövcud deyil və ya nə aktivdir, nə də növbətidir. |
GET/puzzle/{puzzleCode}/speed
Hovuzun hazırda puzzle üzrə sürəti. 60 saniyə keşlənir.
Parametrlər
| Ad | Yer | Tip | Məcburi | Təsvir |
|---|---|---|---|---|
puzzleCode | path | integer | Bəli | Puzzle nömrəsi. |
Sorğu nümunəsi
curl "https://btcpuzzle.info/api/puzzle/71/speed"Cavab nümunəsi
200 OK Bax: CurrentSpeed. Naməlum puzzle heç vaxt xəta ilə deyil, sıfır dəyərlərlə cavab verir.
{
"puzzleCode": 71,
"currentSpeed": {
"activeWorkerCount": 38,
"keysPerSecondFormatted": "162.3 Bkeys/s",
"keysPerSecondRaw": "162300000000"
}
}GET/puzzle/{puzzleCode}/workers
Hazırda skan edən işçilər: son 30 dəqiqədə aralığını ping etmiş olanlar. Brauzer tərəfindən keşlənmir; server cavabı 60 saniyə saxlayır. puzzleCode 0 standart puzzle deməkdir.
Parametrlər
| Ad | Yer | Tip | Məcburi | Təsvir |
|---|---|---|---|---|
puzzleCode | path | integer | Bəli | Puzzle nömrəsi. |
Sorğu nümunəsi
curl "https://btcpuzzle.info/api/puzzle/71/workers"Cavab nümunəsi
200 OK Heç kim skan etmədikdə və ya puzzle naməlum olduqda boş massiv.
[
{
"walletAddress": "1BvBMSEY...7xJaNVN2",
"workerName": "rig1"
}
]GET/puzzle/{puzzleCode}/workers-pinging
/workers ilə eyni siyahı (klientlər hər ikisindən istifadə etdiyi üçün ayrıca yol kimi saxlanılır).
Sorğu nümunəsi
curl "https://btcpuzzle.info/api/puzzle/71/workers-pinging"GET /puzzle/{puzzleCode}/workers ilə eyni parametrlər və cavab.
GET/puzzle/{puzzleCode}/rewards
Aktiv puzzle'ın hovuz mükafatları: sponsorların aralıqların içindəki şəxsi açarlara qoyduğu əlavə mükafatlar (ən yenisi əvvəldə, 32-yə qədər). Mükafatın şəxsi açarı yalnız həll edildikdən sonra göstərilir. 600 saniyə keşlənir.
Parametrlər
| Ad | Yer | Tip | Məcburi | Təsvir |
|---|---|---|---|---|
puzzleCode | path | integer | Bəli | Aktiv puzzle. |
Sorğu nümunəsi
curl "https://btcpuzzle.info/api/puzzle/71/rewards"Cavab nümunəsi
200 OK Bax: Reward. Puzzle'da yoxdursa, boş massiv.
[
{
"id": 12,
"puzzleCode": 71,
"targetAddress": "1ExampleRewardAddress0000000000000",
"rewardDescription": "Hardware wallet",
"provider": "Sponsor",
"brand": "Example",
"dateCreated": "2026-11-01T00:00:00Z",
"dateSolved": "0001-01-01T00:00:00",
"puzzleId": 71
}
]Xətalar
| Status | Body | Nə vaxt |
|---|---|---|
400 | problem details | Puzzle aktiv deyil. |
GET/puzzle/{puzzleCode}/challenge
Aktiv puzzle'ın son çağırış başlanğıc nöqtələri (ən yenisi əvvəldə, 32-yə qədər). 600 saniyə keşlənir.
Parametrlər
| Ad | Yer | Tip | Məcburi | Təsvir |
|---|---|---|---|---|
puzzleCode | path | integer | Bəli | Aktiv puzzle. |
Sorğu nümunəsi
curl "https://btcpuzzle.info/api/puzzle/71/challenge"Cavab nümunəsi
200 OK Bax: Challenge. Yoxdursa, boş massiv.
[
{
"hex": "3A",
"dateCreated": "2026-11-18T06:00:00Z",
"puzzleId": 71
}
]Xətalar
| Status | Body | Nə vaxt |
|---|---|---|
400 | problem details | Puzzle aktiv deyil. |
GET/puzzle/{puzzleCode}/entrancefee
Haqq aktiv olduqda puzzle'ın USD ilə giriş haqqı. 300 saniyə keşlənir.
Parametrlər
| Ad | Yer | Tip | Məcburi | Təsvir |
|---|---|---|---|---|
puzzleCode | path | integer | Bəli | Giriş haqqı olan aktiv puzzle. |
Sorğu nümunəsi
curl "https://btcpuzzle.info/api/puzzle/71/entrancefee"Cavab nümunəsi
200 OK
{
"fee": 25.0,
"puzzle": 71
}Xətalar
| Status | Body | Nə vaxt |
|---|---|---|
400 | problem details | Puzzle aktiv deyil və ya giriş haqqı yoxdur. |
GET/puzzle/{puzzleCode}/statistics-by-hex-prefix
Aralıq HEX-inin hər iki simvollu prefiksi üzrə puzzle'ın nə qədərinin skan edildiyi (puzzle səhifəsinin istilik xəritəsi). 3600 saniyə keşlənir.
Parametrlər
| Ad | Yer | Tip | Məcburi | Təsvir |
|---|---|---|---|---|
puzzleCode | path | integer | Bəli | Aktiv puzzle. |
Sorğu nümunəsi
curl "https://btcpuzzle.info/api/puzzle/71/statistics-by-hex-prefix"Cavab nümunəsi
200 OK Hər prefiks üçün bir element, hexStarts üzrə sıralanıb. pertantageShow xüsusiyyəti qəsdən səhv yazılıb (dondurulub). 70%-dən etibarən rəqəmlər 70%-də dayanır və isLimitExceeded true olur.
[
{
"hexStarts": "40",
"maxRanges": 1048576,
"scannedShow": 4411,
"pertantageShow": 0.37,
"isLimitExceeded": false
}
]Xətalar
| Status | Body | Nə vaxt |
|---|---|---|
400 | problem details | Puzzle aktiv deyil. |
Hovuz məlumatları
Bütövlükdə hovuz, GPU siyahısı və BCPZ token haqqında açıq oxu endpoint-ləri.
GET/pool/homepage
Ana səhifənin puzzle siyahısı: GET /puzzle ilə eyni massiv, standart puzzle isə öz speed dəyərini daşıyır. 60 saniyə keşlənir.
Sorğu nümunəsi
curl "https://btcpuzzle.info/api/pool/homepage"200 və Puzzle obyektləri massivi ilə cavab verir.
GET/pool/gpus
GPU benchmark siyahısı, ən sürətlisi əvvəldə (hovuzda saniyədə açar). 300 saniyə keşlənir.
Sorğu nümunəsi
curl "https://btcpuzzle.info/api/pool/gpus"Cavab nümunəsi
200 OK
[
{
"brand": "nvidia",
"name": "RTX 4090",
"keysPerSecond": 4491469067.71,
"dateUpdated": "2026-11-18T08:27:53.190819Z"
}
]Cavab sahələri
| Sahə | Tip | Təsvir |
|---|---|---|
brand | string | nvidia və ya amd. |
name | string | Kart. |
keysPerSecond | number | Ölçülmüş sürət. |
dateUpdated | date | Son yeniləmə. |
GET/pool/token-distribute-history
Gündəlik BCPZ paylanmaları, ən yenisi əvvəldə (180-ə qədər). 300 saniyə keşlənir.
Sorğu nümunəsi
curl "https://btcpuzzle.info/api/pool/token-distribute-history"Cavab nümunəsi
200 OK
[
{
"id": 412,
"dateProcces": "2026-11-17T03:00:19Z",
"totalUsers": 85,
"totalAmount": 516,
"description": "Success: 85/85"
}
]Cavab sahələri
| Sahə | Tip | Təsvir |
|---|---|---|
id | integer | Paylanma nömrəsi. |
dateProcces | date | Nə vaxt icra olunub. Ad səhv yazılıb və dondurulub. |
totalUsers | integer | Token alan istifadəçilər. |
totalAmount | number | Paylanmış BCPZ (hər skan edilmiş aralıq üçün 1). |
description | string | Nəticə mətni. |
GET/pool/token-top-50-holders
Ən çox BCPZ qazanmış 50 hesab, pulqabı ünvanları qısaldılıb. 600 saniyə keşlənir.
Sorğu nümunəsi
curl "https://btcpuzzle.info/api/pool/token-top-50-holders"Cavab nümunəsi
200 OK
[
{
"walletAddress": "1BvBMSEY...7xJaNVN2",
"balance": 2500.25,
"total": 400,
"minted": 200
}
]Cavab sahələri
| Sahə | Tip | Təsvir |
|---|---|---|
walletAddress | string | Qısaldılmış ünvan. |
balance | number | Hazırda hesabdakı BCPZ. |
total | number | Cəmi qazanılmış BCPZ. |
minted | number | Artıq Polygon şəbəkəsinə çıxarılmış BCPZ. |
GET/pool/token-mint-history
Polygon şəbəkəsinə son BCPZ çıxarışları, ən yenisi əvvəldə (180-ə qədər). 600 saniyə keşlənir.
Sorğu nümunəsi
curl "https://btcpuzzle.info/api/pool/token-mint-history"Cavab nümunəsi
200 OK
[
{
"walletAddress": "1BvBMSEY...7xJaNVN2",
"minted": 100,
"date": "2026-11-15T08:27:58.123754Z",
"txId": "0x1609149d1d218ff590c738ca97b9cac42613c2a248393d66dfad36c3702c3fee"
}
]Cavab sahələri
| Sahə | Tip | Təsvir |
|---|---|---|
walletAddress | string | Hesabın qısaldılmış ünvanı. |
minted | number | Göndərilmiş BCPZ. |
date | date | Nə vaxt göndərilib. |
txId | string | Polygon tranzaksiya hash-i. Köçürmə bitməyibsə, buraxılır. |
GET/pool/btc-price
Birjadan alınan USD və EUR ilə Bitcoin qiyməti. 600 saniyə keşlənir.
Sorğu nümunəsi
curl "https://btcpuzzle.info/api/pool/btc-price"Cavab nümunəsi
200 OK Qiymət mənbəyi əlçatan olmadıqda hər iki dəyər 0 olur.
{"usd":66739.06,"eur":60607.25}Real vaxt axını (SignalR)
Hovuz götürülmüş və bitmiş hər aralığı SignalR hub-ına dərc edir. Sayt ondan canlı status səhifəsi üçün istifadə edir. Hub açıqdır, token tələb etmir və yalnız göndərir: klientin çağıra biləcəyi metod yoxdur.
| Hub URL | https://btcpuzzle.info/api/hex_socket |
| Köhnə host | https://api.btcpuzzle.info/hex_socket |
| Protokol | Standart JSON protokolu ilə SignalR; WebSockets, Server-Sent Events və Long Polling təklif olunur. |
| Hadisə | PoolStatus |
| Limit | Negotiate sorğusu IP sorğu limitinə daxildir. Qoşulduqdan sonra hub-ın özü məhdudlaşdırılmır. |
Qoşulma
SignalR klient kitabxanasından istifadə edin (JavaScript: @microsoft/signalr; .NET: Microsoft.AspNetCore.SignalR.Client). Arxa planda o, əvvəlcə negotiate edir:
Sorğu nümunəsi
curl -X POST "https://btcpuzzle.info/api/hex_socket/negotiate?negotiateVersion=1"Cavab nümunəsi
200 OK
{
"negotiateVersion": 1,
"connectionId": "s7dzEsrMHQKQsCHjvm2faQ",
"connectionToken": "A9SBLfct2OZrZZkvaQMLZw",
"availableTransports": [
{
"transport": "WebSockets",
"transferFormats": [
"Text",
"Binary"
]
},
{
"transport": "ServerSentEvents",
"transferFormats": [
"Text"
]
},
{
"transport": "LongPolling",
"transferFormats": [
"Text",
"Binary"
]
}
]
}import { HubConnectionBuilder } from '@microsoft/signalr';
const hub = new HubConnectionBuilder()
.withUrl('https://btcpuzzle.info/api/hex_socket')
.withAutomaticReconnect()
.build();
hub.on('PoolStatus', (event) => console.log(event));
await hub.start();PoolStatus hadisəsi
Bir arqument, JSON obyekti. Hadisə aralıq paylandıqda və aralıq skan edilmiş kimi işarələndikdə bütün qoşulmuş klientlərə göndərilir.
{
"hex": "3AX8443",
"walletAddress": "1BvBMSEY...7xJaNVN2",
"workerName": "rig1",
"puzzleCode": 71,
"status": "holded"
}| Sahə | Tip | Təsvir |
|---|---|---|
hex | string | Üçüncü simvolu X ilə əvəz edilmiş aralıq HEX-i. |
walletAddress | string | Hesabın qısaldılmış ünvanı. |
workerName | string və ya null | İşçi adı (heç nə göndərilməyibsə, default). scanned zamanı bu, işarələmə sorğusu ilə göndərilmiş addır və null ola bilər. |
puzzleCode | integer | Aralığın puzzle'ı. |
status | string | Aralıq paylandıqdan sonra holded, aralıq işarələndikdən sonra scanned. Yazılış dondurulub. |
Hadisələr bağlantı açıq olduğu müddətdə çatdırılır; yenidən qoşulduqdan sonra heç nə təkrar göndərilmir. Operator canlı axını söndürdükdə bağlantılar rədd edilir.
Obyektlər
Puzzle obyekti
Puzzle siyahısı endpoint-ləri və /puzzle/{puzzleCode}/info tərəfindən qaytarılır. Dəyəri olmayan xüsusiyyətlər buraxılır.
| Sahə | Tip | Təsvir |
|---|---|---|
id | integer | Baza id-si (köhnə sistemin puzzle'ları üçün code ilə eynidir). |
name | string | Məsələn Puzzle 71. |
code | integer | Puzzle nömrəsi. |
hexStart, hexEnd | string | Puzzle'ın onaltılıq formada ilk və son şəxsi açarı. |
targetWalletAddress | string | Mükafatı saxlayan ünvan. |
hexRangeLength | integer | Hovuzun paylandığı aralıq HEX-inin uzunluğu (açarın onun seçdiyi hissəsi). |
reward | number | BTC ilə mükafat. |
hexStartPool, hexEndPool | string | İlk və son aralıq HEX-i. Puzzle hovuzda deyilsə, boşdur. |
totalRanges | integer | Puzzle'ın aralıq sayı. Puzzle hovuzda deyilsə, 0. |
percentage | number | Skan edilmiş aralıqların faizi. |
totalScanned, rangesScannedLastHour | integer | Cəmi və son bir saatda skan edilmiş aralıqlar (siyahı endpoint-lərində doldurulur). |
statisticsTotalScanned, statisticsFoundOnPool, statisticsFoundDate, statisticsFoundBy | müxtəlif | Tamamlanmış puzzle'ın yekun rəqəmləri; statisticsFoundBy yalnız məlum olduqda mövcuddur. |
rangeContainsKeys, rangeContainsKeyByDefault | integer | Bir aralıqdakı şəxsi açarların sayı (bir çıxılmaqla). Aralıqlar bir neçə id-ni əhatə etdikdə ikisi fərqlənir. |
rangesPerKey | integer | Bir aralığın neçə aralıq id-sini əhatə etdiyi (əksər puzzle'lar üçün 1). |
workloadStart, workloadEnd | string | Klientin aralıq HEX-indən sonra skan etdiyi şəxsi açar hissəsi: bax GET range. |
customWorkloadStart, customWorkloadEnd | string | Puzzle xüsusi iş yükündən istifadə etdikdə mövcuddur. |
dateStart, dateEnd | date | Puzzle'ın planlaşdırılmış tarixləri. |
isCompleted, isNextPuzzle, isActive, isDefault, isTestPool, isOnPool | boolean | Puzzle'ın vəziyyəti: bitib, elan edilib, indi skan edilə bilər, standartdır, test hovuzudur, hovuzdadır. |
isEntranceFeeActive, entranceFee | boolean, number | Giriş haqqının aktiv olub-olmaması və onun USD ilə qiyməti (söndürülübsə, 0). |
nextScanAllowedInMinutes | integer | Paylanmış aralığın başqasına verilə bilməzdən əvvəl nə qədər saxlandığı. |
challenges | array | Son çağırış və ya boş massiv. |
privateKey, publicKey | string | Yalnız həll edilmiş puzzle'lar üçün. |
rewards, speed | array, object | Yalnız bəzi endpoint-lərdə mövcuddur. |
Statistics obyekti
| Sahə | Tip | Təsvir |
|---|---|---|
puzzle | object | Puzzle'ın əsas rəqəmləri (ad, kod, aralıq sayları, iş yükü, vəziyyət, mükafat). |
scannedLast24H | integer | Son 24 saatda skan edilmiş aralıqlar. |
entranceFeesPaidTotal | number | Puzzle üçün ödənilmiş giriş haqları, USD. |
topWorkersAlltime | array | 50-yə qədər {userId, walletAddress, totalScanned}; burada userId 0-dır. |
topWorkersLast24h | array | Son 24 saat üçün eynisi. |
activeWorkers | array | Son 30 dəqiqədə ping edən işçilərin {walletAddress, workerName} dəyərləri. |
challenges | array | 32-yə qədər çağırış. |
kingdom | object | Puzzle'ın kralı: walletAddress, message, image və isPublished. |
topSpeed | object | Bütün zamanların ən yaxşı saatı: date, scanned aralıqlar və keysPerSecond. |
chartData | array | Son ay saat-saat, ən yenisi əvvəldə: date, dateOnly, hoursOnly və rangesScanned. |
lastRanges | array | Son 200 skan edilmiş aralıq, ən yenisi əvvəldə: hex (maskalanmış), walletAddress (maskalanmış), startTime, endTime, pingTime, gpuModel, gpuCount, workerName, isPremiumUser, isScanned, isPinged, keysInSeconds və totalSeconds. |
rewards | array | Puzzle'ın mükafatları (şəxsi açarlar olmadan). |
dateUpdated | date | Rəqəmlərin nə vaxt hesablandığı. |
currentSpeed | object | CurrentSpeed. |
CurrentSpeed obyekti
| Sahə | Tip | Təsvir |
|---|---|---|
activeWorkerCount | integer | Son 6 saatda skan etmiş və son bir saatda ping etmiş işçilər. |
keysPerSecondFormatted | string | Vahidli sürət: keys/s, Kkeys/s, Mkeys/s, Bkeys/s, Tkeys/s və s. |
keysPerSecondRaw | string | Tam ədəd mətni kimi saniyədə açar sürəti. |
Challenge obyekti
| Sahə | Tip | Təsvir |
|---|---|---|
hex | string | Hər çağırış iştirakçısının skan etdiyi başlanğıc simvollar. |
dateCreated | date | Çağırışın başladığı vaxt. |
puzzleId | integer | Puzzle. |
Reward obyekti
| Sahə | Tip | Təsvir |
|---|---|---|
id, puzzleCode, puzzleId | integer | İdentifikasiya. |
targetAddress | string | Mükafat açarının ünvanı. |
rewardContent, rewardDescription, provider, providerDesc, brand | string | Mükafatın nə olduğu və onu kimin verdiyi. Dəyəri olmayan xüsusiyyətlər buraxılır. |
privateKey | string | Yalnız mükafat həll edildikdən sonra mövcuddur. |
dateCreated, dateSolved | date | Nə vaxt yaradıldığı və həll edildiyi (həll edilməyibsə, 0001-01-01T00:00:00). |
Köhnə sənədlərlə müqayisədə dəyişikliklər
Müqavilədə heç nə dəyişməyib: köhnə API-nin hər endpoint-i, başlığı, sahəsi və xəta kodu hələ də işləyir və eyni cavab verir. Bu bələdçi üç endpoint-i təsvir edən köhnə səhifəni əvəz edir. Burada yeni olanlar:
- Açıq məlumat endpoint-ləri, real vaxt axını, xəta kodları və sorğu limitləri sənədləşdirilib. Köhnə səhifə onları qeyd etmirdi.
- Köhnə mətnə düzəlişlər: işarələmə sorğusunun
UserTokenbaşlığı miner tokenidir (köhnə səhifə onu pulqabı ünvanı adlandırırdı); ping intervalı təxminən 2 dəqiqə və ən çox 30 dəqiqədir, limit isə saatda 60 deyil, token başına dəqiqədə 360 ping-dir; test hovuzu puzzle'ı38-dir. - Baza URL
https://btcpuzzle.info/api-dir; köhnəapi.btcpuzzle.infohostu işləməyə davam edir. - SignalR hub-ında artıq klientdən serverə metod yoxdur, ona görə də heç kim saxta hadisə göndərə bilməz. Hadisənin özü dəyişməyib.
- Puzzle'ın son boş aralığı da artıq paylanır və çox dar
CustomRangepəncərəsi genişləndirilir ki, düz bir aralıq istəməklə aralıq seçmək mümkün olmasın. - Açıq statistika artıq minerin IP ünvanını göstərmir.