الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل
btc rpc explorer

مستكشف BTC RPC

مستكشف Bitcoin مستضاف ذاتيًا لكل شخص يستخدم Bitcoin Core.

الصفحة الرئيسية

هذا هو مستكشف ذاتي الاستضافة لـ Bitcoin blockchain، مدفوعًا باستدعاءات RPC إلى عقدة Bitcoin الخاصة بك. إنه سهل التشغيل ويمكن توصيله بأدوات أخرى (مثل خوادم Electrum) للحصول على مستكشف كامل المواصفات.

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

العروض الحية:

  • BitcoinExplorer.org / testnet / Signet

سمات

  • لوحة معلومات ملخص الشبكة
  • عرض تفاصيل الكتل والمعاملات والعناوين
  • أدوات التحليل لعرض الإحصائيات الخاصة بالكتل والمعاملات وأنشطة التعدين
  • واجهة برمجة تطبيقات JSON REST
  • شاهد محتوى JSON الخام من bitcoind المستخدم لإنشاء معظم الصفحات
  • البحث حسب معرف المعاملة، وتجزئة/ارتفاع الكتلة، والعنوان
  • سجل المعاملات الاختياري للعناوين عن طريق الاستعلام من خوادم بروتوكول Electrum (مثل Electrs أو ElectrumX) أو blockchain.com أو blockchair.com أو blockcypher.com
  • ملخص Mempool، مع تفاصيل الرسوم والحجم والعمر
  • متصفح أوامر RPC والمحطة الطرفية

سجل التغيير / ملاحظات الإصدار

راجع CHANGELOG.md.

ابدء

المتطلبات الأساسية

  1. تثبيت Bitcoin Core - التعليمات. تأكد من تمكين خادم RPC الخاص بـ Bitcoin Core ( server=1 ).
  2. السماح Bitcoin Core بالمزامنة مع شبكة Bitcoin ( يمكنك استخدام هذه الأداة أثناء المزامنة، ولكن قد تفشل بعض الصفحات).
  3. تثبيت Node.js (يتطلب 16+، ويوصى بـ 18+).

ملاحظة حول تشذيب وفهرسة التكوينات

تم تصميم هذه الأداة للعمل بشكل أفضل مع تمكين فهرسة المعاملات الكاملة ( txindex=1 ) وتعطيل التنقيح . ومع ذلك، إذا كنت تقوم بتشغيل Bitcoin Core v0.21+، فيمكنك تشغيله دون تمكين txindex و/أو مع تمكين pruning وستستمر هذه الأداة في العمل، ولكن بعض البيانات ستكون غير كاملة أو مفقودة. لاحظ أيضًا أن تكوينات Bitcoin Core هذه تتلقى اختبارات أقل شمولاً.

على وجه الخصوص، مع تمكين pruning و/أو تعطيل txindex ، يتم تغيير الوظيفة التالية:

  • لن تتمكن إلا من البحث عن معاملات mempool والمعاملات المؤكدة مؤخرًا والمحفظة من خلال txid الخاص بها. لا يمكن البحث عن المعاملات غير المتعلقة بالمحفظة والتي تم تأكيدها منذ أكثر من 3 كتل إلا إذا قمت بتوفير ارتفاع الكتلة المؤكد بالإضافة إلى txid.
  • ستعرض الكتل المقطوعة معلومات الرأس الأساسية، بدون قائمة المعاملات. لن تكون المعاملات في الكتل المقطوعة متاحة، إلا إذا كانت مرتبطة بالمحفظة. ستعمل إحصائيات الحظر فقط على الكتل غير المكررة.
  • لن يتم عرض عنوان ومبلغ مخرجات المعاملة السابقة، فقط txid:vout.
  • ستكون رسوم التعدين متاحة فقط للمعاملات غير المؤكدة.

تثبيت / تشغيل

إذا كنت تعمل على الشبكة الرئيسية باستخدام datadir والمنفذ الافتراضيين، فيجب أن يعمل التكوين الافتراضي فقط . بخلاف ذلك، راجع قسم التكوين أدناه.

التثبيت عبر npm :

ملاحظة: مطلوب npm v7+ 

npm install -g btc-rpc-explorer
btc-rpc-explorer

تشغيل من المصدر:

  1. git clone https://github.com/janoside/btc-rpc-explorer
  2. cd btc-rpc-explorer
  3. npm install
  4. npm start

التثبيت عبر AUR Arch Linux:

ملاحظة: تم إنشاء حزمة AUR أدناه ويتم صيانتها بواسطة @dougEfresh. يمكن الاطلاع على تفاصيل وتاريخ الحزمة هنا.
  1. git clone https://aur.archlinux.org/btc-rpc-explorer.git
  2. cd btc-rpc-explorer
  3. makepkg -csi
  4. systemctl enable --now btc-rpc-explorer

بعد التثبيت الافتراضي + بدء التشغيل باستخدام أي من الطرق المذكورة أعلاه، يمكن عرض التطبيق على http://127.0.0.1:3002/

إعدادات

يمكن تعيين خيارات التكوين عبر متغيرات البيئة أو وسيطات CLI.

التكوين مع متغيرات البيئة

للتكوين باستخدام متغيرات البيئة، تحتاج إلى إنشاء أحد الملفين التاليين وإدخال القيم فيه:

  1. ~/.config/btc-rpc-explorer.env
  2. .env في دليل العمل لـ btc-rpc-explorer

في كلتا الحالتين، راجع نموذج env. للحصول على قائمة بالخيارات وتفاصيل التنسيق.

التكوين مع وسيطات CLI

للتكوين باستخدام وسيطات CLI، قم بتشغيل btc-rpc-explorer --help للحصول على القائمة الكاملة للخيارات. مثال على التنفيذ هو: 

btc-rpc-explorer --port 8080 --bitcoind-port 18443 --bitcoind-cookie ~ /.bitcoin/regtest/.cookie

إعدادات الموقع التجريبي

لمطابقة الميزات المرئية على الموقع التجريبي على BitcoinExplorer.org، ستحتاج إلى تعيين قيم التكوين غير الافتراضية التالية: 

 BTCEXP_DEMO=true 		# enables some demo/informational aspects of the site
BTCEXP_NO_RATES=false		# enables querying of exchange rate data
BTCEXP_SLOW_DEVICE_MODE=false	# enables resource-intensive tasks (UTXO set query, 24hr volume querying) that are inappropriate for "slow" devices
BTCEXP_ADDRESS_API=electrum 	# use electrum-protocol servers for address lookups
BTCEXP_ELECTRUM_SERVERS=tcp://your-electrum-protocol-server-host:50001		# address(es) for my electrum-protocol server(s)
BTCEXP_IPSTACK_APIKEY=your-api-key		# enable peer ip geo-location
BTCEXP_MAPBOX_APIKEY=your-api-key		# enable map of peer locations

مصادقة الدخول الموحد (SSO).

يمكنك تكوين مصادقة الدخول الموحّد (SSO) بشكل مشابه لما يوفره ThunderHub وRTL. لتمكينه، تأكد من عدم تعيين BTCEXP_BASIC_AUTH_PASSWORD وقم بتعيين BTCEXP_SSO_TOKEN_FILE للإشارة إلى ملف يمكن الوصول إليه بواسطة btc-rpc-explorer. ثم للوصول إلى btc-rpc-explorer، يحتاج موفر الدخول الموحّد (SSO) الخاص بك إلى قراءة الرمز المميز من هذا الملف وتعيينه في token معلمة URL. لأسباب أمنية، يتغير الرمز المميز مع كل تسجيل دخول، لذلك يحتاج موفر تسجيل الدخول الموحّد (SSO) إلى قراءته في كل مرة!

بعد الوصول بنجاح باستخدام الرمز المميز، يتم تعيين ملف تعريف الارتباط للمصادقة، لذلك لا داعي للقلق بشأنه بعد الآن. لتحسين تجربة المستخدم، يمكنك تعيين BTCEXP_SSO_LOGIN_REDIRECT_URL على عنوان URL لموفر خدمة SSO لديك. سيؤدي هذا إلى إعادة توجيه المستخدمين إلى صفحة تسجيل الدخول الخاصة بك إذا لزم الأمر.

تشغيل عبر دوكر

  1. docker build -t btc-rpc-explorer .
  2. docker run -it -p 3002:3002 -e BTCEXP_HOST=0.0.0.0 btc-rpc-explorer

عكس الوكيل مع HTTPS

راجع التعليمات هنا لاستخدام nginx+certbot (letsencrypt) لموقع يمكن الوصول إليه بواسطة HTTPS، وله وكيل عكسي.

يدعم

إذا حصلت على قيمة من هذا المشروع، يرجى النظر في دعم عملي بالتبرع. جميع التبرعات موضع تقدير حقا.

التبرع عبر BTC Pay Server:

  • https://donate.bitcoinexplorer.org

أو عبر عنوان البرق:

شكرا@donate.btc21.org

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل