Explorateur BTC RPC

Explorateur Bitcoin auto-hébergé pour tous ceux qui utilisent Bitcoin Core.

page d'accueil

Il s'agit d'un explorateur auto-hébergé pour la blockchain Bitcoin, piloté par des appels RPC vers votre propre nœud Bitcoin. Il est facile à exécuter et peut être connecté à d'autres outils (comme les serveurs Electrum) pour obtenir un explorateur complet.

Quelles que soient les raisons que vous pourriez avoir pour exécuter un nœud complet (manque de confiance, curiosité technique, prise en charge du réseau, etc.), il est utile d'apprécier la plénitude de votre nœud. Avec cet explorateur, vous pouvez explorer non seulement la base de données blockchain, mais également explorer toutes les capacités fonctionnelles de votre propre nœud.

Démonstrations en direct :

BitcoinExplorer.org/testnet/signet

Caractéristiques

Tableau de bord Résumé du réseau
Afficher les détails des blocs, des transactions et des adresses
Outils d'analyse pour afficher les statistiques sur les blocs, les transactions et l'activité des mineurs
API REST JSON
Voir le contenu JSON brut de Bitcoind utilisé pour générer la plupart des pages
Recherche par ID de transaction, hachage/hauteur de bloc et adresse
Historique des transactions facultatif pour les adresses en interrogeant les serveurs du protocole Electrum (par exemple Electrs, ElectrumX), blockchain.com, blockchair.com ou blockcypher.com
Résumé Mempool, avec répartition des frais, de la taille et de l'âge
Navigateur et terminal de commandes RPC

Journal des modifications / Notes de version

Voir CHANGELOG.md.

Commencer

Conditions préalables

Installez Bitcoin Core - instructions. Assurez-vous que le serveur RPC de Bitcoin Core est activé ( server=1 ).
Autorisez Bitcoin Core à se synchroniser avec le réseau Bitcoin (vous pouvez utiliser cet outil lors de la synchronisation, mais certaines pages peuvent échouer).
Installez Node.js (16+ requis, 18+ recommandés).

Remarque sur les configurations d'élagage et d'indexation

Cet outil est conçu pour fonctionner de manière optimale avec l'indexation complète des transactions activée ( txindex=1 ) et l'élagage désactivé . Cependant, si vous exécutez Bitcoin Core v0.21+, vous pouvez l'exécuter sans txindex activé et/ou avec pruning activé et cet outil continuera à fonctionner, mais certaines données seront incomplètes ou manquantes. Notez également que ces configurations Bitcoin Core font l’objet de tests moins approfondis.

En particulier, avec pruning activé et/ou txindex désactivé, la fonctionnalité suivante est modifiée :

Vous ne pourrez rechercher que les transactions mempool, récemment confirmées et portefeuille par leur txid. La recherche de transactions hors portefeuille confirmées il y a plus de 3 blocs n'est possible que si vous fournissez la hauteur du bloc confirmée en plus du txid.
Les blocs élagués afficheront des informations d'en-tête de base, sans la liste des transactions. Les transactions dans les blocs élagués ne seront pas disponibles, sauf si elles sont liées au portefeuille. Les statistiques de bloc ne fonctionneront que pour les blocs non élagués.
L'adresse et le montant des transactions précédentes ne seront pas affichés, uniquement le txid:vout.
Les frais miniers ne seront disponibles que pour les transactions non confirmées.

Installer/Exécuter

Si vous utilisez le réseau principal avec le répertoire de données et le port par défaut, la configuration par défaut devrait Just Work . Sinon, consultez la section Configuration ci-dessous.

Installer via `npm` :

Remarque : npm v7+ est requis

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

Exécuter à partir des sources :

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

Installer via AUR Arch Linux :

Remarque : le package AUR ci-dessous a été créé et est géré par @dougEfresh. Les détails et l’historique du package peuvent être consultés ici.

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

Après une installation et un démarrage par défaut à l'aide de l'une des méthodes ci-dessus, l'application peut être consultée sur http://127.0.0.1:3002/

Configuration

Les options de configuration peuvent être définies via des variables d'environnement ou des arguments CLI.

Configuration avec des variables d'environnement

Pour configurer avec des variables d'environnement, vous devez créer l'un des 2 fichiers suivants et y saisir des valeurs :

~/.config/btc-rpc-explorer.env
.env dans le répertoire de travail de btc-rpc-explorer

Dans les deux cas, reportez-vous à .env-sample pour une liste des options et des détails de formatage.

Configuration avec les arguments CLI

Pour la configuration avec les arguments CLI, exécutez btc-rpc-explorer --help pour la liste complète des options. Un exemple d'exécution est :

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

Paramètres du site de démonstration

Pour correspondre aux fonctionnalités visibles sur le site de démonstration de BitcoinExplorer.org, vous devrez définir les valeurs de configuration suivantes, autres que celles par défaut :

 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

Authentification SSO

Vous pouvez configurer l'authentification SSO similaire à celle fournie par ThunderHub et RTL. Pour l'activer, assurez-vous que BTCEXP_BASIC_AUTH_PASSWORD n'est pas défini et définissez BTCEXP_SSO_TOKEN_FILE pour qu'il pointe vers un fichier accessible en écriture par btc-rpc-explorer. Ensuite, pour accéder à btc-rpc-explorer, votre fournisseur SSO doit lire le jeton de ce fichier et le définir dans le paramètre URL token . Pour des raisons de sécurité, le token change à chaque connexion, le fournisseur SSO doit donc le lire à chaque fois !

Après un accès réussi avec le jeton, un cookie est défini pour l'authentification, vous n'avez donc plus à vous en soucier. Pour améliorer l'expérience utilisateur, vous pouvez définir BTCEXP_SSO_LOGIN_REDIRECT_URL sur l'URL de votre fournisseur SSO. Cela redirigera les utilisateurs vers votre page de connexion si nécessaire.