توثيق API

ابنِ عميلك الخاص للمجمع. كل نقطة نهاية مع طلباتها واستجاباتها وأخطائها.

نظرة عامة

واجهة 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}/rangeUserToken120 طلبًا كل 60 ثانية
PUT /puzzle/{puzzleCode}/rangeUserToken360 طلبًا كل 60 ثانية
PATCH /puzzle/{puzzleCode}/range/pingUserToken360 طلبًا كل 60 ثانية
POST /puzzle/{puzzleCode}/save-private-keyUserToken10 طلبات كل 180 ثانية
كل نقطة نهاية أخرىعنوان IP20 طلبًا في الثانية لكل نقطة نهاية، و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"
  ]
}

حقول الاستجابة

الحقلالنوعالوصف
hexstringالنطاق المراد فحصه، بأحرف كبيرة ودون حشو. وهو بداية المفاتيح الخاصة في النطاق.
puzzleCodeintegerpuzzle الذي ينتمي إليه النطاق (puzzle الافتراضي عندما يكون puzzle الذي طلبته مكتملًا).
workloadStartstringيُلحق بـ hex للحصول على أول مفتاح خاص في النطاق.
workloadEndstringيُلحق بـ hex للحصول على آخر مفتاح خاص في النطاق. قد يكون أطول من workloadStart في puzzle التي تمتد نطاقاتها على عدة معرّفات.
targetAddressstringعنوان puzzle الذي تبحث عنه. افحصه مع عناوين الإثبات.
proofOfWorkAddressesarray من 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 الخاص بك).
400validation problemترويسة مفقودة أو مشوّهة، أو رقم puzzle خارج المدى من 1 إلى 160.
429{"isSuccess": false, ...}حد المعدل: 120 في الدقيقة لكل توكن.

إثبات العمل

يريد المجمع أن يتأكد من أنك فحصت النطاق فعلًا. مع كل نطاق يختار ستة مفاتيح خاصة داخله ولا يعيد إلا عناوينها (proofOfWorkAddresses). أثناء فحص النطاق بحثًا عن العنوان المستهدف، ابحث عن هذه العناوين الستة أيضًا. عندما تعثر على المفاتيح الخاصة الستة كلها:

  1. اكتب كل مفتاح خاص كـ 64 حرفًا ست عشريًا بأحرف كبيرة، محشوًّا بالأصفار من اليسار.
  2. اربط السلاسل الست بترتيب العناوين، دون أي شيء بينها.
  3. احسب 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 غير نشط.
400validation 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"}توكن غير معروف أو محظور.
400problem 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 لمعرفة الحقول.

الأخطاء

الحالةالجسممتى
400problem detailspuzzle غير موجود أو ليس نشطًا ولا تاليًا.

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
  }
]

الأخطاء

الحالةالجسممتى
400problem detailspuzzle غير نشط.

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
  }
]

الأخطاء

الحالةالجسممتى
400problem detailspuzzle غير نشط.

GET/puzzle/{puzzleCode}/entrancefee

رسوم الدخول لـ puzzle بالدولار الأمريكي، عندما تكون الرسوم مفعّلة. تُخزَّن مؤقتًا لمدة 300 ثانية.

المعاملات

الاسمالموقعالنوعمطلوبالوصف
puzzleCodeالمسارintegerنعمpuzzle نشط له رسوم دخول.

مثال على الطلب

curl "https://btcpuzzle.info/api/puzzle/71/entrancefee"

مثال على الاستجابة

200 OK

{
  "fee": 25.0,
  "puzzle": 71
}

الأخطاء

الحالةالجسممتى
400problem detailspuzzle غير نشط أو ليست له رسوم دخول.

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
  }
]

الأخطاء

الحالةالجسممتى
400problem detailspuzzle غير نشط.

بيانات المجمع

نقاط نهاية عامة للقراءة عن المجمع ككل، وقائمة 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"
  }
]

حقول الاستجابة

الحقلالنوعالوصف
brandstringnvidia أو amd.
namestringالبطاقة.
keysPerSecondnumberالسرعة المقيسة.
dateUpdateddateآخر تحديث.

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"
  }
]

حقول الاستجابة

الحقلالنوعالوصف
idintegerرقم التوزيع.
dateProccesdateوقت تنفيذه. الاسم مكتوب بتهجئة خاطئة ومجمّد.
totalUsersintegerالمستخدمون الذين تلقوا توكنات.
totalAmountnumberBCPZ الموزَّع (1 لكل نطاق مفحوص).
descriptionstringنص النتيجة.

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
  }
]

حقول الاستجابة

الحقلالنوعالوصف
walletAddressstringعنوان مختصر.
balancenumberBCPZ الموجود في الحساب الآن.
totalnumberإجمالي BCPZ المكتسب.
mintednumberBCPZ المسحوب بالفعل إلى شبكة 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"
  }
]

حقول الاستجابة

الحقلالنوعالوصف
walletAddressstringالعنوان المختصر للحساب.
mintednumberBCPZ المرسَل.
datedateوقت الإرسال.
txIdstringتجزئة معاملة 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"
}
الحقلالنوعالوصف
hexstringHEX النطاق مع استبدال حرفه الثالث بـ X.
walletAddressstringالعنوان المختصر للحساب.
workerNamestring أو nullاسم العامل (default إذا لم يُرسل اسم). في scanned يكون الاسم المرسَل مع طلب التعليم، وقد يكون null.
puzzleCodeintegerpuzzle النطاق.
statusstringholded بعد توزيع نطاق، وscanned بعد تعليم نطاق. التهجئة مجمّدة.

تُسلَّم الأحداث ما دام الاتصال مفتوحًا؛ ولا يُعاد إرسال شيء بعد إعادة الاتصال. عندما يوقف المشغّل البث المباشر، تُرفض الاتصالات.

الكائنات

كائن Puzzle

تعيده نقاط نهاية قوائم puzzle و/puzzle/{puzzleCode}/info. تُحذف الخصائص التي لا قيمة لها.

الحقلالنوعالوصف
idintegerمعرّف قاعدة البيانات (هو نفسه code لـ puzzle النظام القديم).
namestringمثلًا Puzzle 71.
codeintegerرقم puzzle.
hexStart, hexEndstringأول وآخر مفتاح خاص في puzzle، بالنظام الست عشري.
targetWalletAddressstringالعنوان الذي يحمل المكافأة.
hexRangeLengthintegerطول HEX النطاق الذي يوزعه المجمع (الجزء الذي يختاره من المفتاح).
rewardnumberالمكافأة بـ BTC.
hexStartPool, hexEndPoolstringHEX أول نطاق وآخر نطاق. فارغ ما لم يكن puzzle في المجمع.
totalRangesintegerعدد نطاقات puzzle. 0 ما لم يكن puzzle في المجمع.
percentagenumberالنسبة المئوية للنطاقات المفحوصة.
totalScanned, rangesScannedLastHourintegerالنطاقات المفحوصة إجمالًا وفي الساعة الأخيرة (تُملأ في نقاط نهاية القوائم).
statisticsTotalScanned, statisticsFoundOnPool, statisticsFoundDate, statisticsFoundByمتنوعةالأرقام النهائية لـ puzzle مكتمل؛ statisticsFoundBy موجود فقط عندما يكون معروفًا.
rangeContainsKeys, rangeContainsKeyByDefaultintegerعدد المفاتيح الخاصة (ناقص واحد) في نطاق واحد. تختلف القيمتان عندما تمتد النطاقات على عدة معرّفات.
rangesPerKeyintegerعدد معرّفات النطاقات التي يمتد عليها نطاق واحد (1 لمعظم puzzle).
workloadStart, workloadEndstringجزء المفتاح الخاص الذي يفحصه العميل بعد HEX النطاق: راجع GET range.
customWorkloadStart, customWorkloadEndstringموجود عندما يستخدم puzzle عبء عمل مخصصًا.
dateStart, dateEnddateالتواريخ المخططة لـ puzzle.
isCompleted, isNextPuzzle, isActive, isDefault, isTestPool, isOnPoolbooleanحالة puzzle: منتهٍ، مُعلن، قابل للفحص الآن، افتراضي، مجمع الاختبار، موجود في المجمع.
isEntranceFeeActive, entranceFeeboolean، numberما إذا كانت رسوم الدخول مفعّلة وسعرها بالدولار الأمريكي (0 عند إيقافها).
nextScanAllowedInMinutesintegerمدة حجز النطاق الموزَّع قبل أن يمكن إعطاؤه لشخص آخر.
challengesarrayأحدث تحدٍّ، أو مصفوفة فارغة.
privateKey, publicKeystringلـ puzzle المحلولة فقط.
rewards, speedarray، objectموجود في بعض نقاط النهاية فقط.

كائن Statistics

الحقلالنوعالوصف
puzzleobjectالأرقام الرئيسية لـ puzzle (الاسم، الرمز، أعداد النطاقات، عبء العمل، الحالة، المكافأة).
scannedLast24Hintegerالنطاقات المفحوصة خلال آخر 24 ساعة.
entranceFeesPaidTotalnumberرسوم الدخول المدفوعة لـ puzzle، بالدولار الأمريكي.
topWorkersAlltimearrayحتى 50 عنصرًا من {userId, walletAddress, totalScanned}؛ وuserId هنا 0.
topWorkersLast24harrayالشيء نفسه لآخر 24 ساعة.
activeWorkersarray{walletAddress, workerName} للعمّال الذين أرسلوا ping خلال آخر 30 دقيقة.
challengesarrayحتى 32 تحديًا.
kingdomobjectملك puzzle: walletAddress وmessage وimage وisPublished.
topSpeedobjectأفضل ساعة على الإطلاق: date والنطاقات scanned وkeysPerSecond.
chartDataarrayالشهر الأخير ساعة بساعة، الأحدث أولًا: date وdateOnly وhoursOnly وrangesScanned.
lastRangesarrayآخر 200 نطاق مفحوص، الأحدث أولًا: hex (مُقنَّع)، walletAddress (مُقنَّع)، startTime, endTime, pingTime, gpuModel, gpuCount, workerName, isPremiumUser, isScanned, isPinged, keysInSeconds وtotalSeconds.
rewardsarrayمكافآت puzzle (دون المفاتيح الخاصة).
dateUpdateddateوقت حساب الأرقام.
currentSpeedobjectCurrentSpeed.

كائن CurrentSpeed

الحقلالنوعالوصف
activeWorkerCountintegerالعمّال الذين فحصوا خلال آخر 6 ساعات وأرسلوا ping خلال الساعة الأخيرة.
keysPerSecondFormattedstringالسرعة مع وحدة: keys/s، Kkeys/s، Mkeys/s، Bkeys/s، Tkeys/s وهكذا.
keysPerSecondRawstringالسرعة بالمفاتيح في الثانية كنص لعدد صحيح.

كائن Challenge

الحقلالنوعالوصف
hexstringأحرف البداية التي يفحصها كل مشارك في التحدي.
dateCreateddateوقت بدء التحدي.
puzzleIdintegerpuzzle.

كائن Reward

الحقلالنوعالوصف
id, puzzleCode, puzzleIdintegerالتعريف.
targetAddressstringعنوان مفتاح المكافأة.
rewardContent, rewardDescription, provider, providerDesc, brandstringما هي الجائزة ومن يقدّمها. تُحذف الخصائص التي لا قيمة لها.
privateKeystringموجود فقط بعد حل المكافأة.
dateCreated, dateSolveddateوقت إنشائها وحلّها (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 لبرنامج الفحص.

اشترِ لي قهوة

puzzle المجمع

ما يفحصه المجمع الآن، وما يأتي بعده، وpuzzle التي عمل عليها من قبل.

يجري فحصه الآن1

التالي2

فُحص سابقًا4

كل puzzle (⁨160⁩)