نظرة عامة
واجهة API الخاصة بـ btcpuzzle.info هي ما يتواصل معه عميل المجمع. توزّع نطاقات المفاتيح للفحص، وتستقبل نتيجة الفحص، وتنشر الإحصاءات العامة للمجمع. btcpuzzle.info مفتوح المصدر ويمكن لأي شخص كتابة عميل: يصف هذا الدليل كل نقطة نهاية عامة، والبيانات التي ترسلها، والبيانات التي تعود إليك، والأخطاء التي قد تواجهها. للأسئلة: support@btcpuzzle.info.
هذه الواجهة مجمّدة عن قصد: تعتمد عليها برامج الفحص وأدوات الأطراف الثالثة. المسارات والترويسات وأسماء الحقول (بما فيها بعض التهجئات القديمة مثل dateProcces وholded) ورموز الأخطاء لا تتغير. قد تُضاف حقول جديدة إلى الاستجابات، لذا تجاهل الحقول التي لا تعرفها.
عنوان URL الأساسي
كل مسار في هذا الدليل نسبي إلى عنوان URL الأساسي:
https://btcpuzzle.info/apiيمكن للعملاء المكتوبين قبل انتقال الموقع الاستمرار في استخدام المضيف القديم، بالمسارات نفسها ودون البادئة /api:
https://api.btcpuzzle.infoمثلًا GET https://btcpuzzle.info/api/puzzle/codes وGET https://api.btcpuzzle.info/puzzle/codes يعطيان الإجابة نفسها. ينبغي للعملاء الجدد استخدام عنوان URL الأساسي مع /api.
بداية سريعة
أنشئ حسابًا مجانيًا على btcpuzzle.info، وانسخ توكن برنامج الفحص (miner token) من لوحة التحكم، ثم اطلب نطاقًا:
curl "https://btcpuzzle.info/api/puzzle/71/range" \
-H "UserToken: <128-character miner token>" \
-H "WorkerName: rig1"افحص النطاق المُعاد مع عناوين الإثبات الستة، وأرسل الإثبات بـ PUT /puzzle/71/range، ثم كرّر. بين الاستدعاءين أرسل ping من وقت لآخر حتى يعرف المجمع أن العامل ما زال يعمل.
الاصطلاحات
الإصدارات
يوجد إصدار واحد ولا يوجد رقم إصدار في عنوان URL. يُحافَظ على عقد الواجهة القديمة كما هو تمامًا؛ راجع التغييرات مقارنةً بالتوثيق القديم.
المصادقة
تُعرَّف الهوية في نقاط نهاية برنامج الفحص بالترويسة UserToken: توكن برنامج الفحص الخاص بحسابك المكوّن من 128 حرفًا. لا يوجد تسجيل دخول آخر ولا جلسة لها. يمكنك إنشاء توكن جديد من حسابك في أي وقت؛ ويتوقف القديم عن العمل فورًا. أبقِ التوكن سريًا: من يملكه يفحص باسمك.
كل نقاط نهاية البيانات (puzzle، الإحصاءات، المجمع، التوكن) عامة ولا تحتاج إلى توكن.
الطلبات والاستجابات
- في نقاط نهاية برنامج الفحص تُرسل بيانات الطلب في ترويسات HTTP، لا في سلسلة الاستعلام ولا في الجسم. أسماء الترويسات غير حساسة لحالة الأحرف (
UserTokenوusertokenوuserTokenترويسة واحدة). وحدهاPOST /puzzle/{puzzleCode}/save-private-keyلها جسم JSON (Content-Type: application/json). - الاستجابات JSON بترميز UTF-8 وأسماء خصائص بصيغة camelCase. تُحذف الخصائص التي لا قيمة لها؛ ولا تكتب الواجهة أبدًا قيمة JSON
null. لا تعتمد على المسافات البادئة. - التواريخ بصيغة ISO 8601 بتوقيت UTC (
2026-11-18T08:28:25.8176144Z). المبالغ والكميات أعداد JSON. - الأعداد الكبيرة مثل
rangeContainsKeysأعداد صحيحة بلا إشارة بطول 64 بت وقد تتجاوز 2^53: حلّلها كأعداد صحيحة 64 بت أو كسلاسل نصية في اللغات التي تستخدم doubles. - عناوين المحافظ في البيانات العامة مختصرة (أول 8 أحرف، ثم
...، ثم آخر 8)، والحرف الثالث من HEX النطاق يُستبدل بـX(3AB8443يصبح3AX8443).
حدود المعدل
الحدود أدناه هي القيم الافتراضية الحالية. تُحسب ضمن نافذة زمنية ثابتة؛ ويمكن للمشغّل تعديلها، لذا اقرأ إجابة 429 بدلًا من تثبيت الأرقام في الشيفرة.
| ينطبق على | يُحسب لكل | الحد |
|---|---|---|
GET /puzzle/{puzzleCode}/range | UserToken | 120 طلبًا كل 60 ثانية |
PUT /puzzle/{puzzleCode}/range | UserToken | 360 طلبًا كل 60 ثانية |
PATCH /puzzle/{puzzleCode}/range/ping | UserToken | 360 طلبًا كل 60 ثانية |
POST /puzzle/{puzzleCode}/save-private-key | UserToken | 10 طلبات كل 180 ثانية |
| كل نقطة نهاية أخرى | عنوان IP | 20 طلبًا في الثانية لكل نقطة نهاية، و200 في الثانية إجمالًا |
يُجاب على الطلب الذي يتجاوز الحد بـ 429 Too Many Requests، مع ترويسة Retry-After وهذا الجسم:
{
"isSuccess": false,
"details": "Quota exceeded."
}الأخطاء
تستخدم حالات الفشل رموز الحالة أدناه. يعتمد الجسم على نقطة النهاية، لذا تحقّق من رمز الحالة أولًا.
| الحالة | الجسم | المعنى |
|---|---|---|
400 | {"error": "<code>"} | رفضت نقطة نهاية لبرنامج الفحص الطلب. يبيّن الرمز السبب: invalid_puzzle، invalid_user_token، reached_of_keyspace، too_much_request، not_eligable (التهجئة تاريخية)، invalid_request. |
400 | {"isSuccess": false} | رُفض طلب تعليم نطاق (إثبات خاطئ، أو نطاق غير معروف أو مفحوص بالفعل، أو مستخدم محظور، أو puzzle غير نشط). |
400 | مشكلة تحقق (validation problem) | ترويسة مطلوبة مفقودة أو غير صالحة، أو رقم puzzle خارج المدى من 1 إلى 160. وهو كائن application/problem+json تسرد errors فيه الأسماء الخاطئة. |
400 | تفاصيل المشكلة (problem details) | ليس لدى نقطة نهاية البيانات العامة ما تجيب به عن هذا puzzle (puzzle غير معروف أو غير نشط). application/problem+json مع type وtitle وstatus وtraceId. |
401 | {"error": "invalid_user_token"} | توكن برنامج الفحص غير معروف أو الحساب محظور (ping وsave-private-key). |
404 | {"error": "range_not_found"} | النطاق المراد إرسال ping له ليس محجوزًا لهذا العامل. |
429 | {"isSuccess": false, "details": "Quota exceeded."} | حد المعدل. انتظر عدد الثواني في Retry-After. |
مثال على مشكلة تحقق (GET /puzzle/71/range دون الترويسة UserToken):
{
"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"
}التخزين المؤقت وCORS
ترسل نقاط نهاية البيانات العامة Cache-Control: public, max-age=N؛ القيمة مذكورة مع كل نقطة نهاية، والنسخة المخزّنة مشتركة بين كل المستدعين، لذا فالاستعلام بوتيرة أسرع من N ثانية لا يعيد إلا البيانات نفسها. نقاط نهاية برنامج الفحص لا تُخزَّن مؤقتًا أبدًا. يمكن للمتصفحات استدعاء الواجهة من https://btcpuzzle.info وhttps://www.btcpuzzle.info وhttp://localhost:3000 (الأخير موجود للتطوير المحلي للواجهة الأمامية القديمة)؛ أما العملاء الأصليون فلا يتأثرون بـ CORS.
نقاط نهاية برنامج الفحص
الاستدعاءات الثلاثة لدورة الفحص: احصل على نطاق، وأرسل ping أثناء فحصه، وعلّمه كمفحوص. واستدعاء رابع يخزّن مفتاحًا مكتشفًا. الأربعة كلها تستخدم الترويسة UserToken.
GET/puzzle/{puzzleCode}/range
يوزّع نطاقًا متاحًا عشوائيًا من puzzle ويحجزه لك. لا يُعطى أحد غيرك نطاقًا تحجزه؛ وإذا لم تعلّمه، يعود إلى المجمع بعد فترة (ping يمدّد الحجز).
المعاملات
| الاسم | الموقع | النوع | مطلوب | الوصف |
|---|---|---|---|---|
puzzleCode | المسار | integer (من 1 إلى 160) | نعم | puzzle المراد فحصه، مثلًا 71. 38 هو مجمع الاختبار. GET /puzzle/codes يسرد الرموز. يُخدَم puzzle المكتمل بصمت من puzzle الافتراضي، وتذكر الإجابة في puzzleCode puzzle الذي حصلت عليه. |
UserToken | الترويسة | string (128 حرفًا) | نعم | توكن برنامج الفحص الخاص بك. |
WorkerName | الترويسة | string (من 1 إلى 16 حرفًا) | لا | اسم هذا العامل. حروف وأرقام فقط. يُخزَّن كـ default إذا لم ترسل اسمًا. |
SecurityHash | الترويسة | string | لا | نص حر يُحفظ مع النطاق. اختياري. |
CustomRange | الترويسة | string | لا | يقيّد النطاق الذي تحصل عليه: بادئة من HEX (2D، 3BA) أو start:end (3400000:38FFFFF). none أو غياب الترويسة يعني أي نطاق. النافذة الضيقة جدًا يوسّعها المجمع، لذا قد تحصل على نطاق غير الذي حدّدته. |
مثال على الطلب
curl "https://btcpuzzle.info/api/puzzle/71/range" \
-H "UserToken: <128-character miner token>" \
-H "WorkerName: rig1"مثال على الاستجابة
200 OK
{
"hex": "3AB8443",
"puzzleCode": 71,
"workloadStart": "00000000000",
"workloadEnd": "fffffffffff",
"targetAddress": "1MVDYgVaSN6iKKEsbzRUAYFrYJadLYZvvZ",
"proofOfWorkAddresses": [
"1QLLeQ3Hwp9ai7L4KM65e7SxS12skkYUsA",
"15mLWAX7Hno94fntWj6PEx5wCvZz2zAn8a",
"1DazU9YxVrojvnTrcZrymyc6ZrDkvezJEA",
"14Qada8GbVoKUXCtPHBgF7BPjdEhJWo1ph",
"1PmdgtX2NzoSsSf2ANAnFrBzdftyW3CThY",
"14it3UVGsK6JhsV2HPimD46VSpVcXipFwQ"
]
}حقول الاستجابة
| الحقل | النوع | الوصف |
|---|---|---|
hex | string | النطاق المراد فحصه، بأحرف كبيرة ودون حشو. وهو بداية المفاتيح الخاصة في النطاق. |
puzzleCode | integer | puzzle الذي ينتمي إليه النطاق (puzzle الافتراضي عندما يكون puzzle الذي طلبته مكتملًا). |
workloadStart | string | يُلحق بـ hex للحصول على أول مفتاح خاص في النطاق. |
workloadEnd | string | يُلحق بـ hex للحصول على آخر مفتاح خاص في النطاق. قد يكون أطول من workloadStart في puzzle التي تمتد نطاقاتها على عدة معرّفات. |
targetAddress | string | عنوان puzzle الذي تبحث عنه. افحصه مع عناوين الإثبات. |
proofOfWorkAddresses | array من 6 سلاسل | عناوين ستة مفاتيح خاصة وضعها المجمع داخل النطاق. اعثر على مفاتيحها الخاصة لإثبات الفحص: راجع إثبات العمل. |
في المثال أعلاه يمتد النطاق من 3AB8443 + 00000000000 = 3AB844300000000000 إلى 3AB8443 + fffffffffff = 3AB8443FFFFFFFFFFF. المفاتيح الخاصة 64 حرفًا ست عشريًا؛ احشُ اليسار بالأصفار.
الأخطاء
| الحالة | الجسم | متى |
|---|---|---|
400 | {"error": "invalid_puzzle"} | puzzle غير موجود أو غير نشط. |
400 | {"error": "invalid_user_token"} | التوكن غير معروف أو محظور. |
400 | {"error": "too_much_request"} | تحجز عددًا كبيرًا جدًا من النطاقات التي لم تفحصها، أو تطلب أسرع مما تنهي. افحص ما تحجزه؛ تعود النطاقات المحجوزة إلى المجمع بعد وقت قصير. |
400 | {"error": "not_eligable"} | لـ puzzle رسوم دخول ولا تستوفي شروطها بعد. |
400 | {"error": "reached_of_keyspace"} | لم يتبقَّ نطاق متاح (أو لا يوجد ما يناسب CustomRange الخاص بك). |
400 | validation problem | ترويسة مفقودة أو مشوّهة، أو رقم puzzle خارج المدى من 1 إلى 160. |
429 | {"isSuccess": false, ...} | حد المعدل: 120 في الدقيقة لكل توكن. |
إثبات العمل
يريد المجمع أن يتأكد من أنك فحصت النطاق فعلًا. مع كل نطاق يختار ستة مفاتيح خاصة داخله ولا يعيد إلا عناوينها (proofOfWorkAddresses). أثناء فحص النطاق بحثًا عن العنوان المستهدف، ابحث عن هذه العناوين الستة أيضًا. عندما تعثر على المفاتيح الخاصة الستة كلها:
- اكتب كل مفتاح خاص كـ 64 حرفًا ست عشريًا بأحرف كبيرة، محشوًّا بالأصفار من اليسار.
- اربط السلاسل الست بترتيب العناوين، دون أي شيء بينها.
- احسب SHA-256 للنص بترميز UTF-8 واكتبه كـ 64 حرفًا ست عشريًا بأحرف صغيرة. هذا هو
HashedProofKeyلطلب التعليم.
ProofKey1 = 000000000000000000000000000000000000000000000003AB8443AB91BBAFE8 // for proofOfWorkAddresses[0]
ProofKey2 = 000000000000000000000000000000000000000000000003AB84435AF1E51FD1 // for proofOfWorkAddresses[1]
...
ProofKey6 = ...
HashedProofKey = lowercase_hex( SHA256( ProofKey1 + ProofKey2 + ProofKey3 + ProofKey4 + ProofKey5 + ProofKey6 ) )
= 892a38381912bcce412030d7a403de8a92c0e56f452ba5a865f0bf728ff3fa87الإثبات مختلف لكل نطاق. عدد عناوين الإثبات ستة اليوم؛ اقرأ طول proofOfWorkAddresses بدلًا من افتراضه.
PUT/puzzle/{puzzleCode}/range
يعلّم نطاقًا كمفحوص. يتحقق المجمع من الإثبات، وإذا كان صحيحًا يحتسب النطاق منجزًا لك. لا يمكن تعليم النطاق إلا مرة واحدة.
المعاملات
| الاسم | الموقع | النوع | مطلوب | الوصف |
|---|---|---|---|---|
puzzleCode | المسار | integer (من 1 إلى 160) | نعم | puzzle النطاق. |
UserToken | الترويسة | string (128 حرفًا) | نعم | توكن برنامج الفحص الخاص بك. |
HEX | الترويسة | string | نعم | hex النطاق الذي فحصته، كما أعاده المجمع. مثال: 3AB8443. |
HashedProofKey | الترويسة | string | نعم | إثبات العمل: راجع إثبات العمل. |
WorkerName | الترويسة | string (من 1 إلى 16 حرفًا) | لا | العامل الذي فحص النطاق. |
GPUName | الترويسة | string | لا | طراز بطاقة الرسومات. يُستخدم للإحصاءات العامة. |
GPUCount | الترويسة | integer | لا | عدد بطاقات العامل. الافتراضي 1. |
IsForceContinue | الترويسة | boolean | لا | اضبطه عندما يواصل العامل رغم وصوله إلى نهاية مساحة مفاتيحه. الافتراضي false. |
مثال على الطلب
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"مثال على الاستجابة
200 OK
{
"isSuccess": true
}الأخطاء
| الحالة | الجسم | متى |
|---|---|---|
400 | {"isSuccess": false} | أي رفض: إثبات خاطئ، أو نطاق غير معروف، أو نطاق مُعلَّم بالفعل، أو حساب محظور، أو puzzle غير نشط. |
400 | validation problem | ترويسة مطلوبة مفقودة أو مشوّهة. |
429 | {"isSuccess": false, ...} | حد المعدل: 360 في الدقيقة لكل توكن. |
PATCH/puzzle/{puzzleCode}/range/ping
يخبر المجمع بأن العامل ما زال يفحص نطاقه. يحافظ ping على حجز النطاق ويُظهر العامل نشطًا على الموقع. أرسل واحدًا كل دقيقتين تقريبًا؛ ويجب ألا تتجاوز الفترة 30 دقيقة، وإلا استعاد المجمع النطاق.
المعاملات
| الاسم | الموقع | النوع | مطلوب | الوصف |
|---|---|---|---|---|
puzzleCode | المسار | integer | نعم | puzzle النطاق. |
Hex | الترويسة | string | نعم | النطاق الذي يفحصه العامل الآن. |
UserToken | الترويسة | string (128 حرفًا) | نعم | توكن برنامج الفحص الخاص بك. |
WorkerName | الترويسة | string | نعم | اسم العامل المستخدم عند طلب النطاق (default إذا لم يُرسل اسم). |
مثال على الطلب
curl -X PATCH "https://btcpuzzle.info/api/puzzle/71/range/ping" \
-H "Hex: 3AB8443" \
-H "UserToken: <128-character miner token>" \
-H "WorkerName: rig1"مثال على الاستجابة
200 OK بجسم فارغ.
الأخطاء
| الحالة | الجسم | متى |
|---|---|---|
400 | {"error": "invalid_request"} | إحدى الترويسات فارغة. |
401 | {"error": "invalid_user_token"} | توكن غير معروف أو محظور. |
404 | {"error": "range_not_found"} | لا يحجز هذا العامل نطاقًا غير مفحوص بهذا HEX في ذلك puzzle. |
429 | {"isSuccess": false, ...} | حد المعدل: 360 في الدقيقة لكل توكن. |
POST/puzzle/{puzzleCode}/save-private-key
يخزّن مفتاحًا خاصًا مكتشفًا في حسابك، مشفّرًا. يشفّر العميل المفتاح بمفتاح RSA العام الذي أعطيته إياه؛ ولا يحتفظ الموقع إلا بالنص المشفّر، الذي تفك تشفيره بمفتاحك الخاص. يظهر المفتاح في صفحة المفاتيح المكتشفة في لوحة التحكم.
المعاملات
| الاسم | الموقع | النوع | مطلوب | الوصف |
|---|---|---|---|---|
puzzleCode | المسار | integer | نعم | puzzle الذي ينتمي إليه المفتاح. |
UserToken | الترويسة | string (128 حرفًا) | نعم | توكن برنامج الفحص الخاص بك. |
Content-Type | الترويسة | string | نعم | application/json. |
name | الجسم | string | لا | تسمية، مثل اسم العامل. تُخزَّن كـ Puzzle71 - rig1. |
encryptedKey | الجسم | string | نعم | المفتاح الخاص المشفّر (يرسله العميل بصيغة base64). |
مثال على الطلب
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>"}'مثال على الاستجابة
200 OK لاحظ أن الخاصية هي success، وليست isSuccess.
{
"success": true,
"message": "Key saved successfully."
}الأخطاء
| الحالة | الجسم | متى |
|---|---|---|
401 | {"error": "invalid_user_token"} | توكن غير معروف أو محظور. |
400 | problem details | لم يُحفظ شيء: المفتاح نفسه مخزّن بالفعل لهذا الحساب، أو الجسم مفقود. |
429 | {"isSuccess": false, ...} | حد المعدل: 10 كل 180 ثانية لكل توكن. |
بيانات puzzle
نقاط نهاية عامة للقراءة عن puzzle المجمع. لا حاجة إلى توكن. كائن Puzzle والكائنات الأخرى موصوفة في نهاية هذا الدليل.
GET/puzzle
puzzle الموجودة في المجمع: النشطة، والتالية، ومجمع الاختبار (والمكتملة المحفوظة للتاريخ). تُخزَّن مؤقتًا لمدة 300 ثانية.
مثال على الطلب
curl "https://btcpuzzle.info/api/puzzle"مثال على الاستجابة
200 OK مصفوفة من كائنات Puzzle، مختصرة هنا إلى عنصر واحد.
[
{
"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": []
}
]الأخطاء
| الحالة | الجسم | متى |
|---|---|---|
404 | [] | لا يوجد في المجمع أي puzzle. |
GET/puzzle/all
كل puzzle قاعدة البيانات، بما فيها المكتملة. تُخزَّن مؤقتًا لمدة 300 ثانية.
مثال على الطلب
curl "https://btcpuzzle.info/api/puzzle/all"يجيب بـ 200 مع مصفوفة من كائنات Puzzle.
GET/puzzle/available
puzzle التي يمكن فحصها في المجمع. تُخزَّن مؤقتًا لمدة 300 ثانية.
مثال على الطلب
curl "https://btcpuzzle.info/api/puzzle/available"يجيب بـ 200 مع مصفوفة من كائنات Puzzle.
GET/puzzle/default
puzzle الافتراضي: الذي يُرجع إليه طلب puzzle مكتمل. يُخزَّن مؤقتًا لمدة 300 ثانية.
مثال على الطلب
curl "https://btcpuzzle.info/api/puzzle/default"مثال على الاستجابة
200 OK كائن Puzzle واحد.
{
"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": []
}الأخطاء
| الحالة | الجسم | متى |
|---|---|---|
404 | {"error": "puzzle_not_found"} | لم يُعيَّن puzzle افتراضي. |
GET/puzzle/codes
أرقام puzzle النشطة أو التالية، puzzle العادية أولًا ومجمع الاختبار أخيرًا. تُخزَّن مؤقتًا لمدة 300 ثانية.
مثال على الطلب
curl "https://btcpuzzle.info/api/puzzle/codes"مثال على الاستجابة
200 OK
[71, 72, 73, 38]GET/puzzle/{puzzleCode}/info
puzzle واحد، يُقرأ من قاعدة البيانات. يُخزَّن مؤقتًا لمدة 10 ثوانٍ.
المعاملات
| الاسم | الموقع | النوع | مطلوب | الوصف |
|---|---|---|---|---|
puzzleCode | المسار | integer | نعم | رقم puzzle. |
مثال على الطلب
curl "https://btcpuzzle.info/api/puzzle/71/info"مثال على الاستجابة
200 OK كائن Puzzle. لا تُملأ قيم وقت التشغيل مثل rangesScannedLastHour إلا في نقاط نهاية القوائم.
{
"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": []
}الأخطاء
| الحالة | الجسم | متى |
|---|---|---|
204 | فارغ | لا يوجد puzzle كهذا. |
GET/puzzle/{puzzleCode}/statistics
كل ما تعرضه صفحة puzzle: المجاميع، والتصنيفات، والعمّال النشطون، وآخر 200 نطاق مفحوص، ورسم بياني بالساعة. يُخزَّن مؤقتًا لمدة 60 ثانية (ويحتفظ الخادم بنسخة واحدة لمدة 5 دقائق).
المعاملات
| الاسم | الموقع | النوع | مطلوب | الوصف |
|---|---|---|---|---|
puzzleCode | المسار | integer | نعم | puzzle نشط (أو مجمع الاختبار). |
مثال على الطلب
curl "https://btcpuzzle.info/api/puzzle/71/statistics"مثال على الاستجابة
200 OK مختصرة: المصفوفات تحتوي هنا على عنصر واحد، وlastRanges حتى 200.
{
"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"
}
}لـ puzzle غير النشط بعد (puzzle التالية) لا يُعاد إلا puzzle وscannedLast24H وentranceFeesPaidTotal وlastRanges وdateUpdated. راجع كائن Statistics لمعرفة الحقول.
الأخطاء
| الحالة | الجسم | متى |
|---|---|---|
400 | problem details | puzzle غير موجود أو ليس نشطًا ولا تاليًا. |
GET/puzzle/{puzzleCode}/speed
سرعة المجمع في puzzle ما الآن. تُخزَّن مؤقتًا لمدة 60 ثانية.
المعاملات
| الاسم | الموقع | النوع | مطلوب | الوصف |
|---|---|---|---|---|
puzzleCode | المسار | integer | نعم | رقم puzzle. |
مثال على الطلب
curl "https://btcpuzzle.info/api/puzzle/71/speed"مثال على الاستجابة
200 OK راجع CurrentSpeed. puzzle غير المعروف يُجاب عنه بقيم صفرية، ولا يُجاب بخطأ أبدًا.
{
"puzzleCode": 71,
"currentSpeed": {
"activeWorkerCount": 38,
"keysPerSecondFormatted": "162.3 Bkeys/s",
"keysPerSecondRaw": "162300000000"
}
}GET/puzzle/{puzzleCode}/workers
العمّال الذين يفحصون الآن: من لديهم نطاق أرسلوا له ping خلال آخر 30 دقيقة. لا يخزّنها المتصفح مؤقتًا؛ ويحتفظ الخادم بالإجابة لمدة 60 ثانية. puzzleCode 0 يعني puzzle الافتراضي.
المعاملات
| الاسم | الموقع | النوع | مطلوب | الوصف |
|---|---|---|---|---|
puzzleCode | المسار | integer | نعم | رقم puzzle. |
مثال على الطلب
curl "https://btcpuzzle.info/api/puzzle/71/workers"مثال على الاستجابة
200 OK مصفوفة فارغة عندما لا يفحص أحد أو يكون puzzle غير معروف.
[
{
"walletAddress": "1BvBMSEY...7xJaNVN2",
"workerName": "rig1"
}
]GET/puzzle/{puzzleCode}/workers-pinging
القائمة نفسها التي يعيدها /workers (أُبقي كمسار منفصل لأن العملاء يستخدمون الاثنين).
مثال على الطلب
curl "https://btcpuzzle.info/api/puzzle/71/workers-pinging"المعاملات والإجابة نفسها كما في GET /puzzle/{puzzleCode}/workers.
GET/puzzle/{puzzleCode}/rewards
مكافآت المجمع لـ puzzle نشط: جوائز إضافية يضعها الرعاة على مفاتيح خاصة داخل النطاقات (الأحدث أولًا، حتى 32). لا يُعرض المفتاح الخاص للمكافأة إلا بعد حلّها. تُخزَّن مؤقتًا لمدة 600 ثانية.
المعاملات
| الاسم | الموقع | النوع | مطلوب | الوصف |
|---|---|---|---|---|
puzzleCode | المسار | integer | نعم | puzzle نشط. |
مثال على الطلب
curl "https://btcpuzzle.info/api/puzzle/71/rewards"مثال على الاستجابة
200 OK راجع Reward. مصفوفة فارغة عندما لا توجد لـ puzzle أي مكافأة.
[
{
"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
}
]الأخطاء
| الحالة | الجسم | متى |
|---|---|---|
400 | problem details | puzzle غير نشط. |
GET/puzzle/{puzzleCode}/challenge
أحدث نقاط بداية التحدي لـ puzzle نشط (الأحدث أولًا، حتى 32). تُخزَّن مؤقتًا لمدة 600 ثانية.
المعاملات
| الاسم | الموقع | النوع | مطلوب | الوصف |
|---|---|---|---|---|
puzzleCode | المسار | integer | نعم | puzzle نشط. |
مثال على الطلب
curl "https://btcpuzzle.info/api/puzzle/71/challenge"مثال على الاستجابة
200 OK راجع Challenge. مصفوفة فارغة عندما لا يوجد أي تحدٍّ.
[
{
"hex": "3A",
"dateCreated": "2026-11-18T06:00:00Z",
"puzzleId": 71
}
]الأخطاء
| الحالة | الجسم | متى |
|---|---|---|
400 | problem details | puzzle غير نشط. |
GET/puzzle/{puzzleCode}/entrancefee
رسوم الدخول لـ puzzle بالدولار الأمريكي، عندما تكون الرسوم مفعّلة. تُخزَّن مؤقتًا لمدة 300 ثانية.
المعاملات
| الاسم | الموقع | النوع | مطلوب | الوصف |
|---|---|---|---|---|
puzzleCode | المسار | integer | نعم | puzzle نشط له رسوم دخول. |
مثال على الطلب
curl "https://btcpuzzle.info/api/puzzle/71/entrancefee"مثال على الاستجابة
200 OK
{
"fee": 25.0,
"puzzle": 71
}الأخطاء
| الحالة | الجسم | متى |
|---|---|---|
400 | problem details | puzzle غير نشط أو ليست له رسوم دخول. |
GET/puzzle/{puzzleCode}/statistics-by-hex-prefix
مقدار ما فُحص من puzzle لكل بادئة من حرفين في HEX النطاق (الخريطة الحرارية في صفحة puzzle). تُخزَّن مؤقتًا لمدة 3600 ثانية.
المعاملات
| الاسم | الموقع | النوع | مطلوب | الوصف |
|---|---|---|---|---|
puzzleCode | المسار | integer | نعم | puzzle نشط. |
مثال على الطلب
curl "https://btcpuzzle.info/api/puzzle/71/statistics-by-hex-prefix"مثال على الاستجابة
200 OK عنصر واحد لكل بادئة، مرتبة حسب hexStarts. الخاصية pertantageShow مكتوبة بتهجئة خاطئة عن قصد (مجمّدة). ابتداءً من 70% تتوقف الأرقام عند 70% وتكون isLimitExceeded بقيمة true.
[
{
"hexStarts": "40",
"maxRanges": 1048576,
"scannedShow": 4411,
"pertantageShow": 0.37,
"isLimitExceeded": false
}
]الأخطاء
| الحالة | الجسم | متى |
|---|---|---|
400 | problem details | puzzle غير نشط. |
بيانات المجمع
نقاط نهاية عامة للقراءة عن المجمع ككل، وقائمة GPU، وتوكن BCPZ.
GET/pool/homepage
قائمة puzzle في الصفحة الرئيسية: المصفوفة نفسها التي يعيدها GET /puzzle، ويحمل puzzle الافتراضي speed الخاصة به. تُخزَّن مؤقتًا لمدة 60 ثانية.
مثال على الطلب
curl "https://btcpuzzle.info/api/pool/homepage"يجيب بـ 200 مع مصفوفة من كائنات Puzzle.
GET/pool/gpus
قائمة اختبار أداء GPU، الأسرع أولًا (المفاتيح في الثانية في المجمع). تُخزَّن مؤقتًا لمدة 300 ثانية.
مثال على الطلب
curl "https://btcpuzzle.info/api/pool/gpus"مثال على الاستجابة
200 OK
[
{
"brand": "nvidia",
"name": "RTX 4090",
"keysPerSecond": 4491469067.71,
"dateUpdated": "2026-11-18T08:27:53.190819Z"
}
]حقول الاستجابة
| الحقل | النوع | الوصف |
|---|---|---|
brand | string | nvidia أو amd. |
name | string | البطاقة. |
keysPerSecond | number | السرعة المقيسة. |
dateUpdated | date | آخر تحديث. |
GET/pool/token-distribute-history
توزيعات BCPZ اليومية، الأحدث أولًا (حتى 180). تُخزَّن مؤقتًا لمدة 300 ثانية.
مثال على الطلب
curl "https://btcpuzzle.info/api/pool/token-distribute-history"مثال على الاستجابة
200 OK
[
{
"id": 412,
"dateProcces": "2026-11-17T03:00:19Z",
"totalUsers": 85,
"totalAmount": 516,
"description": "Success: 85/85"
}
]حقول الاستجابة
| الحقل | النوع | الوصف |
|---|---|---|
id | integer | رقم التوزيع. |
dateProcces | date | وقت تنفيذه. الاسم مكتوب بتهجئة خاطئة ومجمّد. |
totalUsers | integer | المستخدمون الذين تلقوا توكنات. |
totalAmount | number | BCPZ الموزَّع (1 لكل نطاق مفحوص). |
description | string | نص النتيجة. |
GET/pool/token-top-50-holders
الحسابات الخمسون الأكثر كسبًا لـ BCPZ، مع عناوين محافظ مختصرة. تُخزَّن مؤقتًا لمدة 600 ثانية.
مثال على الطلب
curl "https://btcpuzzle.info/api/pool/token-top-50-holders"مثال على الاستجابة
200 OK
[
{
"walletAddress": "1BvBMSEY...7xJaNVN2",
"balance": 2500.25,
"total": 400,
"minted": 200
}
]حقول الاستجابة
| الحقل | النوع | الوصف |
|---|---|---|
walletAddress | string | عنوان مختصر. |
balance | number | BCPZ الموجود في الحساب الآن. |
total | number | إجمالي BCPZ المكتسب. |
minted | number | BCPZ المسحوب بالفعل إلى شبكة Polygon. |
GET/pool/token-mint-history
أحدث سحوبات BCPZ إلى شبكة Polygon، الأحدث أولًا (حتى 180). تُخزَّن مؤقتًا لمدة 600 ثانية.
مثال على الطلب
curl "https://btcpuzzle.info/api/pool/token-mint-history"مثال على الاستجابة
200 OK
[
{
"walletAddress": "1BvBMSEY...7xJaNVN2",
"minted": 100,
"date": "2026-11-15T08:27:58.123754Z",
"txId": "0x1609149d1d218ff590c738ca97b9cac42613c2a248393d66dfad36c3702c3fee"
}
]حقول الاستجابة
| الحقل | النوع | الوصف |
|---|---|---|
walletAddress | string | العنوان المختصر للحساب. |
minted | number | BCPZ المرسَل. |
date | date | وقت الإرسال. |
txId | string | تجزئة معاملة Polygon. تُحذف ما دام التحويل لم يكتمل. |
GET/pool/btc-price
سعر Bitcoin بالدولار الأمريكي واليورو، من إحدى المنصات. يُخزَّن مؤقتًا لمدة 600 ثانية.
مثال على الطلب
curl "https://btcpuzzle.info/api/pool/btc-price"مثال على الاستجابة
200 OK القيمتان 0 عندما يتعذّر الوصول إلى مصدر السعر.
{"usd":66739.06,"eur":60607.25}البث المباشر (SignalR)
ينشر المجمع كل نطاق مُطالب به ومنتهٍ إلى مركز SignalR (hub). يستخدمه الموقع لصفحة الحالة المباشرة. المركز عام، ولا يحتاج إلى توكن، ويرسل فقط: لا توجد دوال يمكن للعميل استدعاؤها.
| عنوان URL للمركز | https://btcpuzzle.info/api/hex_socket |
| المضيف القديم | https://api.btcpuzzle.info/hex_socket |
| البروتوكول | SignalR مع بروتوكول JSON الافتراضي؛ وتتوفر WebSockets وServer-Sent Events وLong Polling. |
| الحدث | PoolStatus |
| الحد | يُحتسب طلب negotiate ضمن حد المعدل حسب IP. المركز نفسه غير محدود بعد الاتصال. |
الاتصال
استخدم مكتبة عميل SignalR (JavaScript: @microsoft/signalr؛ .NET: Microsoft.AspNetCore.SignalR.Client). داخليًا تبدأ بعملية negotiate:
مثال على الطلب
curl -X POST "https://btcpuzzle.info/api/hex_socket/negotiate?negotiateVersion=1"مثال على الاستجابة
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
وسيطة واحدة، كائن JSON. يُرسل الحدث إلى كل العملاء المتصلين عند توزيع نطاق وعند تعليم نطاق كمفحوص.
{
"hex": "3AX8443",
"walletAddress": "1BvBMSEY...7xJaNVN2",
"workerName": "rig1",
"puzzleCode": 71,
"status": "holded"
}| الحقل | النوع | الوصف |
|---|---|---|
hex | string | HEX النطاق مع استبدال حرفه الثالث بـ X. |
walletAddress | string | العنوان المختصر للحساب. |
workerName | string أو null | اسم العامل (default إذا لم يُرسل اسم). في scanned يكون الاسم المرسَل مع طلب التعليم، وقد يكون null. |
puzzleCode | integer | puzzle النطاق. |
status | string | holded بعد توزيع نطاق، وscanned بعد تعليم نطاق. التهجئة مجمّدة. |
تُسلَّم الأحداث ما دام الاتصال مفتوحًا؛ ولا يُعاد إرسال شيء بعد إعادة الاتصال. عندما يوقف المشغّل البث المباشر، تُرفض الاتصالات.
الكائنات
كائن Puzzle
تعيده نقاط نهاية قوائم puzzle و/puzzle/{puzzleCode}/info. تُحذف الخصائص التي لا قيمة لها.
| الحقل | النوع | الوصف |
|---|---|---|
id | integer | معرّف قاعدة البيانات (هو نفسه code لـ puzzle النظام القديم). |
name | string | مثلًا Puzzle 71. |
code | integer | رقم puzzle. |
hexStart, hexEnd | string | أول وآخر مفتاح خاص في puzzle، بالنظام الست عشري. |
targetWalletAddress | string | العنوان الذي يحمل المكافأة. |
hexRangeLength | integer | طول HEX النطاق الذي يوزعه المجمع (الجزء الذي يختاره من المفتاح). |
reward | number | المكافأة بـ BTC. |
hexStartPool, hexEndPool | string | HEX أول نطاق وآخر نطاق. فارغ ما لم يكن puzzle في المجمع. |
totalRanges | integer | عدد نطاقات puzzle. 0 ما لم يكن puzzle في المجمع. |
percentage | number | النسبة المئوية للنطاقات المفحوصة. |
totalScanned, rangesScannedLastHour | integer | النطاقات المفحوصة إجمالًا وفي الساعة الأخيرة (تُملأ في نقاط نهاية القوائم). |
statisticsTotalScanned, statisticsFoundOnPool, statisticsFoundDate, statisticsFoundBy | متنوعة | الأرقام النهائية لـ puzzle مكتمل؛ statisticsFoundBy موجود فقط عندما يكون معروفًا. |
rangeContainsKeys, rangeContainsKeyByDefault | integer | عدد المفاتيح الخاصة (ناقص واحد) في نطاق واحد. تختلف القيمتان عندما تمتد النطاقات على عدة معرّفات. |
rangesPerKey | integer | عدد معرّفات النطاقات التي يمتد عليها نطاق واحد (1 لمعظم puzzle). |
workloadStart, workloadEnd | string | جزء المفتاح الخاص الذي يفحصه العميل بعد HEX النطاق: راجع GET range. |
customWorkloadStart, customWorkloadEnd | string | موجود عندما يستخدم puzzle عبء عمل مخصصًا. |
dateStart, dateEnd | date | التواريخ المخططة لـ puzzle. |
isCompleted, isNextPuzzle, isActive, isDefault, isTestPool, isOnPool | boolean | حالة puzzle: منتهٍ، مُعلن، قابل للفحص الآن، افتراضي، مجمع الاختبار، موجود في المجمع. |
isEntranceFeeActive, entranceFee | boolean، number | ما إذا كانت رسوم الدخول مفعّلة وسعرها بالدولار الأمريكي (0 عند إيقافها). |
nextScanAllowedInMinutes | integer | مدة حجز النطاق الموزَّع قبل أن يمكن إعطاؤه لشخص آخر. |
challenges | array | أحدث تحدٍّ، أو مصفوفة فارغة. |
privateKey, publicKey | string | لـ puzzle المحلولة فقط. |
rewards, speed | array، object | موجود في بعض نقاط النهاية فقط. |
كائن Statistics
| الحقل | النوع | الوصف |
|---|---|---|
puzzle | object | الأرقام الرئيسية لـ puzzle (الاسم، الرمز، أعداد النطاقات، عبء العمل، الحالة، المكافأة). |
scannedLast24H | integer | النطاقات المفحوصة خلال آخر 24 ساعة. |
entranceFeesPaidTotal | number | رسوم الدخول المدفوعة لـ puzzle، بالدولار الأمريكي. |
topWorkersAlltime | array | حتى 50 عنصرًا من {userId, walletAddress, totalScanned}؛ وuserId هنا 0. |
topWorkersLast24h | array | الشيء نفسه لآخر 24 ساعة. |
activeWorkers | array | {walletAddress, workerName} للعمّال الذين أرسلوا ping خلال آخر 30 دقيقة. |
challenges | array | حتى 32 تحديًا. |
kingdom | object | ملك puzzle: walletAddress وmessage وimage وisPublished. |
topSpeed | object | أفضل ساعة على الإطلاق: date والنطاقات scanned وkeysPerSecond. |
chartData | array | الشهر الأخير ساعة بساعة، الأحدث أولًا: date وdateOnly وhoursOnly وrangesScanned. |
lastRanges | array | آخر 200 نطاق مفحوص، الأحدث أولًا: hex (مُقنَّع)، walletAddress (مُقنَّع)، startTime, endTime, pingTime, gpuModel, gpuCount, workerName, isPremiumUser, isScanned, isPinged, keysInSeconds وtotalSeconds. |
rewards | array | مكافآت puzzle (دون المفاتيح الخاصة). |
dateUpdated | date | وقت حساب الأرقام. |
currentSpeed | object | CurrentSpeed. |
كائن CurrentSpeed
| الحقل | النوع | الوصف |
|---|---|---|
activeWorkerCount | integer | العمّال الذين فحصوا خلال آخر 6 ساعات وأرسلوا ping خلال الساعة الأخيرة. |
keysPerSecondFormatted | string | السرعة مع وحدة: keys/s، Kkeys/s، Mkeys/s، Bkeys/s، Tkeys/s وهكذا. |
keysPerSecondRaw | string | السرعة بالمفاتيح في الثانية كنص لعدد صحيح. |
كائن Challenge
| الحقل | النوع | الوصف |
|---|---|---|
hex | string | أحرف البداية التي يفحصها كل مشارك في التحدي. |
dateCreated | date | وقت بدء التحدي. |
puzzleId | integer | puzzle. |
كائن Reward
| الحقل | النوع | الوصف |
|---|---|---|
id, puzzleCode, puzzleId | integer | التعريف. |
targetAddress | string | عنوان مفتاح المكافأة. |
rewardContent, rewardDescription, provider, providerDesc, brand | string | ما هي الجائزة ومن يقدّمها. تُحذف الخصائص التي لا قيمة لها. |
privateKey | string | موجود فقط بعد حل المكافأة. |
dateCreated, dateSolved | date | وقت إنشائها وحلّها (0001-01-01T00:00:00 ما دامت غير محلولة). |
التغييرات مقارنةً بالتوثيق القديم
لم يتغير شيء في العقد: كل نقطة نهاية وترويسة وحقل ورمز خطأ في الواجهة القديمة ما زال يعمل ويجيب بالطريقة نفسها. يحل هذا الدليل محل الصفحة القديمة التي كانت تصف ثلاث نقاط نهاية. الجديد هنا:
- نقاط نهاية البيانات العامة، والبث المباشر، ورموز الأخطاء، وحدود المعدل موثّقة. الصفحة القديمة لم تذكرها.
- تصحيحات للنص القديم: الترويسة
UserTokenفي طلب التعليم هي توكن برنامج الفحص (سمّتها الصفحة القديمة عنوان محفظة)؛ فترة ping نحو دقيقتين و30 دقيقة كحد أقصى، والحد 360 ping في الدقيقة لكل توكن، وليس 60 في الساعة؛ puzzle مجمع الاختبار هو38. - عنوان URL الأساسي هو
https://btcpuzzle.info/api؛ ويستمر المضيف القديمapi.btcpuzzle.infoفي العمل. - لم يعد في مركز SignalR أي دالة من العميل إلى الخادم، فلا يستطيع أحد إرسال أحداث مزيفة. الحدث نفسه لم يتغير.
- أصبح آخر نطاق متاح في puzzle يُوزَّع أيضًا، وتُوسَّع نافذة
CustomRangeالضيقة جدًا حتى لا يمكن اختيار نطاق بطلبه بالتحديد. - لم تعد الإحصاءات العامة تعرض عنوان IP لبرنامج الفحص.