btc rpc explorer

BTC RPC Explorer

Selbstgehosteter Bitcoin-Explorer für alle, die Bitcoin Core nutzen.

---

Dies ist ein selbst gehosteter Explorer für die Bitcoin-Blockchain, der durch RPC-Aufrufe an Ihren eigenen Bitcoin-Knoten gesteuert wird. Es ist einfach auszuführen und kann mit anderen Tools (wie Electrum-Servern) verbunden werden, um einen voll ausgestatteten Explorer zu erhalten.

Welche Gründe Sie auch immer für den Betrieb eines vollständigen Knotens haben mögen (Unzuverlässigkeit, technische Neugier, Unterstützung des Netzwerks usw.), es ist wertvoll, die Fülle Ihres Knotens zu schätzen. Mit diesem Explorer können Sie nicht nur die Blockchain-Datenbank erkunden, sondern auch alle funktionalen Möglichkeiten Ihres eigenen Knotens erkunden.

Live-Demos:

• BitcoinExplorer.org/testnet/signet

Merkmale

• Dashboard „Netzwerkzusammenfassung“.
• Sehen Sie sich Details zu Blöcken, Transaktionen und Adressen an
• Analysetools zum Anzeigen von Statistiken zu Blöcken, Transaktionen und Miner-Aktivitäten
• JSON-REST-API
• Sehen Sie sich den JSON-Rohinhalt von Bitcoind an, der zum Generieren der meisten Seiten verwendet wird
• Suche nach Transaktions-ID, Block-Hash/Höhe und Adresse
• Optionaler Transaktionsverlauf für Adressen durch Abfrage von Electrum-Protokollservern (z. B. Electrs, ElectrumX), Blockchain.com, Blockchair.com oder Blockcypher.com
• Zusammenfassung des Mempools mit Aufschlüsselung nach Gebühren, Größe und Alter
• RPC-Befehlsbrowser und Terminal

Änderungsprotokoll / Versionshinweise

Siehe CHANGELOG.md.

Erste Schritte

Voraussetzungen

1. Bitcoin Core installieren – Anleitung. Stellen Sie sicher, dass der RPC-Server von Bitcoin Core aktiviert ist ( server=1 ).
2. Ermöglichen Sie Bitcoin Core die Synchronisierung mit dem Bitcoin-Netzwerk (Sie können dieses Tool während der Synchronisierung verwenden, einige Seiten können jedoch fehlschlagen).
3. Installieren Sie Node.js (16+ erforderlich, 18+ empfohlen).

Hinweis zu Bereinigungs- und Indizierungskonfigurationen

Dieses Tool funktioniert am besten, wenn die vollständige Transaktionsindizierung aktiviert ( txindex=1 ) und die Bereinigung deaktiviert ist . Wenn Sie jedoch Bitcoin Core v0.21+ verwenden, können Sie es ohne aktivierten txindex und/oder mit aktiviertem pruning ausführen und dieses Tool wird weiterhin funktionieren, aber einige Daten werden unvollständig sein oder fehlen. Beachten Sie auch, dass solche Bitcoin Core-Konfigurationen weniger gründlichen Tests unterzogen werden.

Insbesondere wenn pruning aktiviert und/oder txindex deaktiviert ist, ändert sich die folgende Funktionalität:

• Sie können nur nach Mempool-, kürzlich bestätigten und Wallet-Transaktionen anhand ihrer TXID suchen. Die Suche nach Nicht-Wallet-Transaktionen, die vor mehr als 3 Blöcken bestätigt wurden, ist nur möglich, wenn Sie zusätzlich zur txid die bestätigte Blockhöhe angeben.
• Bereinigte Blöcke zeigen grundlegende Header-Informationen ohne die Liste der Transaktionen an. Transaktionen in bereinigten Blöcken sind nicht verfügbar, es sei denn, sie beziehen sich auf die Wallet. Blockstatistiken funktionieren nur für ungekürzte Blöcke.
• Die Adresse und der Betrag früherer Transaktionsausgaben werden nicht angezeigt, sondern nur die txid:vout.
• Die Mining-Gebühr wird nur für unbestätigte Transaktionen erhoben.

Installieren/Ausführen

Wenn Sie im Mainnet mit dem Standarddatenverzeichnis und -port arbeiten, sollte die Standardkonfiguration einfach funktionieren . Andernfalls lesen Sie den Abschnitt „Konfiguration“ weiter unten.

Installation über npm :

Hinweis: NPM v7+ ist erforderlich

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

Von der Quelle ausführen:

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

Installation über AUR Arch Linux:

Hinweis: Das folgende AUR-Paket wurde von @dougEfresh erstellt und wird von @dougEfresh verwaltet. Die Details und der Verlauf des Pakets können hier eingesehen werden.

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

Nach einer Standardinstallation und einem Start mit einer der oben genannten Methoden kann die App unter http://127.0.0.1:3002/ angezeigt werden.

Konfiguration

Konfigurationsoptionen können über Umgebungsvariablen oder CLI-Argumente festgelegt werden.

Konfiguration mit Umgebungsvariablen

Um mit Umgebungsvariablen zu konfigurieren, müssen Sie eine der beiden folgenden Dateien erstellen und darin Werte eingeben:

1. ~/.config/btc-rpc-explorer.env
2. .env im Arbeitsverzeichnis für btc-rpc-explorer

In beiden Fällen finden Sie unter .env-sample eine Liste der Optionen und Formatierungsdetails.

Konfiguration mit CLI-Argumenten

Führen Sie zum Konfigurieren mit CLI-Argumenten btc-rpc-explorer --help aus, um die vollständige Liste der Optionen anzuzeigen. Eine Beispielausführung ist:

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

Demo-Site-Einstellungen

Um den auf der Demo-Site unter BitcoinExplorer.org sichtbaren Funktionen zu entsprechen, müssen Sie die folgenden nicht standardmäßigen Konfigurationswerte festlegen:

 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-Authentifizierung

Sie können die SSO-Authentifizierung ähnlich wie bei ThunderHub und RTL konfigurieren. Um es zu aktivieren, stellen Sie sicher, BTCEXP_BASIC_AUTH_PASSWORD nicht festgelegt ist, und stellen Sie BTCEXP_SSO_TOKEN_FILE so ein, dass es auf eine Datei verweist, auf die der btc-rpc-explorer schreiben kann. Um dann auf btc-rpc-explorer zuzugreifen, muss Ihr SSO-Anbieter das Token aus dieser Datei lesen und es im URL-Parameter token festlegen. Aus Sicherheitsgründen ändert sich der Token bei jedem Login, daher muss der SSO-Anbieter ihn jedes Mal lesen!

Nach erfolgreichem Zugriff mit dem Token wird ein Cookie zur Authentifizierung gesetzt, sodass Sie sich darüber keine Sorgen mehr machen müssen. Um die Benutzererfahrung zu verbessern, können Sie BTCEXP_SSO_LOGIN_REDIRECT_URL auf die URL Ihres SSO-Anbieters setzen. Dadurch werden Benutzer bei Bedarf auf Ihre Anmeldeseite weitergeleitet.

Über Docker ausführen

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

Reverse-Proxy mit HTTPS

Hier finden Sie Anweisungen zur Verwendung von nginx+certbot (letsencrypt) für eine über HTTPS zugängliche Site mit Reverse-Proxy.

Unterstützung

Wenn Sie von diesem Projekt profitieren, denken Sie bitte darüber nach, meine Arbeit mit einer Spende zu unterstützen. Alle Spenden sind wirklich willkommen.

Spenden Sie über den BTC Pay Server:

• https://donate.bitcoinexplorer.org

Oder über eine Blitzadresse:

[email protected]