btc rpc explorer

BTC RPC エクスプローラー

Bitcoin Core を実行しているすべての人のためのセルフホスト型 Bitcoin エクスプローラー。

---

これは、独自のビットコイン ノードへの RPC 呼び出しによって駆動される、ビットコイン ブロックチェーンの自己ホスト型エクスプローラーです。実行は簡単で、他のツール (Electrum サーバーなど) に接続してフル機能のエクスプローラーを実現できます。

フルノードを実行する理由が何であれ (信頼性のなさ、技術的な好奇心、ネットワークのサポートなど)、ノードの充実度を評価することは重要です。このエクスプローラーを使用すると、ブロックチェーン データベースを探索するだけでなく、独自のノードのすべての機能を探索することもできます。

ライブデモ:

• BitcoinExplorer.org / テストネット / シグネット

特徴

• ネットワーク概要ダッシュボード
• ブロック、トランザクション、アドレスの詳細を表示する
• ブロック、トランザクション、マイナーアクティビティの統計を表示する分析ツール
• JSON REST API
• ほとんどのページの生成に使用される bitcoind の生の JSON コンテンツを参照する
• トランザクションID、ブロックハッシュ/高さ、アドレスによる検索
• Electrum プロトコル サーバー (Electrs、ElectrumX など)、blockchain.com、blockchair.com、または blockcypher.com からのクエリによるアドレスのオプションのトランザクション履歴
• Mempool の概要、料金、サイズ、年齢の内訳
• RPCコマンドブラウザとターミナル

変更履歴/リリースノート

CHANGELOG.mdを参照してください。

はじめる

前提条件

1. Bitcoin Coreのインストール - 手順。 Bitcoin Coreの RPC サーバーが有効になっていることを確認します ( 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 とポートを使用してメインネット上で実行している場合、デフォルト設定はJust Workになるはずです。それ以外の場合は、以下の「構成」セクションを参照してください。

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 引数を介して設定できます。

環境変数による設定

環境変数を使用して構成するには、次の 2 つのファイルのいずれかを作成し、そのファイルに値を入力する必要があります。

1. ~/.config/btc-rpc-explorer.env
2. 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

SSO認証

ThunderHub や RTL が提供するものと同様の SSO 認証を構成できます。これを有効にするには、 BTCEXP_BASIC_AUTH_PASSWORDが設定されていないことを確認し、 BTCEXP_SSO_TOKEN_FILE btc-rpc-explorer によって書き込みアクセス可能なファイルを指すように設定します。次に、 btc-rpc-explorer にアクセスするには、SSO プロバイダーがこのファイルからトークンを読み取り、URL パラメーターtokenに設定する必要があります。セキュリティ上の理由から、トークンはログインごとに変わるため、SSO プロバイダーは毎回トークンを読み取る必要があります。

トークンによるアクセスに成功すると、認証用に Cookie が設定されるため、もう心配する必要はありません。ユーザー エクスペリエンスを向上させるために、 BTCEXP_SSO_LOGIN_REDIRECT_URL SSO プロバイダーの URL に設定できます。これにより、必要に応じてユーザーがログイン ページにリダイレクトされます。

Docker経由で実行

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 を使用したリバース プロキシ

HTTPS アクセス可能なリバース プロキシ サイトで nginx+certbot (letsencrypt) を使用する手順については、こちらを参照してください。

サポート

このプロジェクトから価値を感じていただけましたら、寄付による私の仕事のサポートをご検討ください。すべてのご寄付に心より感謝申し上げます。

BTC ペイサーバー経由で寄付する:

• https://donate.bitcoinexplorer.org

または、ライトニング アドレス経由:

[email protected]