BTC RPC 瀏覽器

適合每個運行 Bitcoin Core 的人的自架比特幣瀏覽器。

這是比特幣區塊鏈的自託管瀏覽器，由對您自己的比特幣節點的 RPC 呼叫驅動。它易於運行，並且可以連接到其他工具（如 Electrum 伺服器）以實現功能齊全的瀏覽器。

無論您運行完整節點的原因是什麼（不信任、技術好奇心、支持網路等），欣賞節點的完整性都是有價值的。透過這個瀏覽器，您不僅可以探索區塊鏈資料庫，還可以探索您自己的節點的所有功能。

現場示範：

BitcoinExplorer.org/測試網/signet

特徵

網路摘要儀表板
查看區塊、交易和地址的詳細信息
用於查看區塊、交易和礦工活動統計數據的分析工具
JSON REST API
查看用於產生大多數頁面的 bitcoind 的原始 JSON 內容
按交易 ID、區塊哈希/高度和地址搜索
透過從 Electrum 協定伺服器（例如 Electrs、ElectrumX）、blockchain.com、blockchair.com 或 blockcypher.com 查詢來取得位址的可選交易歷史記錄
記憶體池摘要，包含費用、規模和年齡細分
RPC命令瀏覽器和終端

變更日誌/發行說明

請參閱 CHANGELOG.md。

入門

先決條件

安裝Bitcoin Core - 說明。確保Bitcoin Core的 RPC 伺服器已啟用 ( server=1 )。
允許Bitcoin Core與比特幣網路同步（同步時可以使用此工具，但某些頁面可能會失敗）。
安裝 Node.js（需要 16+，推薦 18+）。

關於修剪和索引配置的注意事項

該工具設計為在啟用完整事務索引 ( txindex=1 ) 和停用修剪的情況下發揮最佳作用。但是，如果您運行的是 Bitcoin Core v0.21+，則可以在不啟用txindex和/或啟用pruning情況下運行，並且該工具將繼續運行，但某些資料將不完整或遺失。另請注意，此類比特幣核心配置接受的測試不太徹底。

特別是，在啟用pruning和/或停用txindex的情況下，以下功能會發生變化：

您只能透過 txid 搜尋 mempool、最近確認的交易和錢包交易。只有當您除了 txid 之外還提供已確認的區塊高度時，才可以搜尋超過 3 個區塊之前確認的非錢包交易。
修剪後的區塊將顯示基本的標頭訊息，但不顯示交易列表。修剪區塊中的交易將不可用，除非它們與錢包相關。區塊統計資訊僅適用於未修剪的區塊。
不會顯示先前交易輸出的地址和金額，僅顯示 txid:vout。
挖礦費僅適用於未確認的交易。

安裝/運行

如果您使用預設資料目錄和連接埠在主網路上執行，則預設配置應該Just Work 。否則，請參閱下面的配置部分。

透過`npm`安裝：

注意：需要 npm v7+

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

從源運行：

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

透過 AUR Arch Linux 安裝：

注意：以下 AUR 套件由 @dougEfresh 建立和維護。可以在此處查看該包的詳細資訊和歷史記錄。

git clone https://aur.archlinux.org/btc-rpc-explorer.git
cd btc-rpc-explorer
makepkg -csi
systemctl enable --now btc-rpc-explorer

使用上述任何一種方法預設安裝+啟動後，可以在http://127.0.0.1:3002/查看該應用程式

配置

配置選項可以透過環境變數或 CLI 參數設定。

使用環境變數進行配置

要配置環境變量，您需要建立以下 2 個檔案之一並在其中輸入值：

~/.config/btc-rpc-explorer.env
btc-rpc-explorer 工作目錄中的.env

無論哪種情況，請參閱 .env-sample 以取得選項清單和格式詳細資訊。

使用 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

單一登入認證

您可以設定類似 ThunderHub 和 RTL 提供的 SSO 驗證。若要啟用它，請確保未設定BTCEXP_BASIC_AUTH_PASSWORD並將BTCEXP_SSO_TOKEN_FILE設定為指向 btc-rpc-explorer 可寫入存取的檔案。然後，要存取 btc-rpc-explorer，您的 SSO 提供者需要從此檔案讀取令牌並將其設定在 URL 參數token中。出於安全原因，令牌會隨著每次登入而變化，因此 SSO 提供者每次都需要讀取它！

使用token存取成功後，會設定一個cookie進行身份驗證，不用再擔心了。為了改善使用者體驗，您可以將BTCEXP_SSO_LOGIN_REDIRECT_URL設定為 SSO 提供者的 URL。如果需要，這將導致使用者被重新導向到您的登入頁面。