Explorador BTC RPC

Explorador de Bitcoin autohospedado para todos los que ejecutan Bitcoin Core.

página principal

Este es un explorador autohospedado para la cadena de bloques de Bitcoin, impulsado por llamadas RPC a su propio nodo de Bitcoin. Es fácil de ejecutar y se puede conectar a otras herramientas (como servidores Electrum) para lograr un explorador con todas las funciones.

Cualesquiera que sean las razones que pueda tener para ejecutar un nodo completo (desconfianza, curiosidad técnica, soporte de la red, etc.), es valioso apreciar la plenitud de su nodo. Con este explorador, puede explorar no solo la base de datos de blockchain, sino también todas las capacidades funcionales de su propio nodo.

Demostraciones en vivo:

BitcoinExplorer.org/testnet/signet

Características

Panel de resumen de red
Ver detalles de bloques, transacciones y direcciones
Herramientas de análisis para ver estadísticas sobre bloques, transacciones y actividad minera.
API REST JSON
Vea el contenido JSON sin procesar de bitcoind utilizado para generar la mayoría de las páginas
Busque por ID de transacción, hash/altura de bloque y dirección
Historial de transacciones opcional para direcciones mediante consultas desde servidores de protocolo Electrum (por ejemplo, Electrs, ElectrumX), blockchain.com, blockchair.com o blockcypher.com.
Resumen de Mempool, con desgloses de tarifas, tamaño y edad
Navegador y terminal de comandos RPC

Registro de cambios/notas de la versión

Consulte CHANGELOG.md.

Empezando

Requisitos previos

Instalar Bitcoin Core - instrucciones. Asegúrese de que el servidor RPC de Bitcoin Core esté habilitado ( server=1 ).
Permita que Bitcoin Core se sincronice con la red Bitcoin ( puede usar esta herramienta mientras sincroniza, pero algunas páginas pueden fallar).
Instale Node.js (se requieren 16+, se recomiendan 18+).

Nota sobre las configuraciones de poda e indexación

Esta herramienta está diseñada para funcionar mejor con la indexación completa de transacciones habilitada ( txindex=1 ) y la poda deshabilitada . Sin embargo, si está ejecutando Bitcoin Core v0.21+, puede ejecutarlo sin txindex habilitado y/o con pruning habilitada y esta herramienta seguirá funcionando, pero algunos datos estarán incompletos o faltarán. También tenga en cuenta que dichas configuraciones de Bitcoin Core reciben pruebas menos exhaustivas.

En particular, con pruning habilitada y/o txindex deshabilitado, se altera la siguiente funcionalidad:

Solo podrá buscar transacciones de mempool, confirmadas recientemente y de billetera por su txid. La búsqueda de transacciones fuera de la billetera que se confirmaron hace más de 3 bloques solo es posible si proporciona la altura del bloque confirmado además del txid.
Los bloques eliminados mostrarán información básica del encabezado, sin la lista de transacciones. Las transacciones en bloques eliminados no estarán disponibles, a menos que estén relacionadas con la billetera. Las estadísticas de bloques solo funcionarán para bloques no podados.
La dirección y el monto de los resultados de transacciones anteriores no se mostrarán, solo el txid:vout.
La tarifa de minería solo estará disponible para transacciones no confirmadas.

Instalar / Ejecutar

Si está ejecutando en la red principal con el directorio de datos y el puerto predeterminados, la configuración predeterminada debería funcionar . De lo contrario, consulte la sección Configuración a continuación.

Instalar a través de `npm` :

Nota: se requiere npm v7+

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

Ejecutar desde la fuente:

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

Instalar a través de AUR Arch Linux:

Nota: El siguiente paquete AUR fue creado y mantenido por @dougEfresh. Los detalles y el historial del paquete se pueden ver aquí.

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

Después de una instalación e inicio predeterminados utilizando cualquiera de los métodos anteriores, la aplicación se puede ver en http://127.0.0.1:3002/

Configuración

Las opciones de configuración se pueden establecer mediante variables de entorno o argumentos CLI.

Configuración con variables de entorno.

Para configurar con variables de entorno, debe crear uno de los 2 archivos siguientes e ingresar valores en él:

~/.config/btc-rpc-explorer.env
.env en el directorio de trabajo de btc-rpc-explorer

En cualquier caso, consulte .env-sample para obtener una lista de opciones y detalles de formato.

Configuración con argumentos CLI

Para configurar con argumentos CLI, ejecute btc-rpc-explorer --help para obtener la lista completa de opciones. Un ejemplo de ejecución es:

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

Configuración del sitio de demostración

Para que coincida con las funciones visibles en el sitio de demostración en BitcoinExplorer.org, deberá establecer los siguientes valores de configuración no predeterminados:

 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

Autenticación SSO

Puede configurar la autenticación SSO similar a la que proporcionan ThunderHub y RTL. Para habilitarlo, asegúrese de que BTCEXP_BASIC_AUTH_PASSWORD no esté configurado y configure BTCEXP_SSO_TOKEN_FILE para que apunte a un archivo accesible mediante escritura mediante btc-rpc-explorer. Luego, para acceder a btc-rpc-explorer, su proveedor de SSO debe leer el token de este archivo y configurarlo en el parámetro URL token . Por razones de seguridad, el token cambia con cada inicio de sesión, por lo que el proveedor de SSO debe leerlo cada vez.

Después de un acceso exitoso con el token, se configura una cookie para la autenticación, por lo que ya no necesita preocuparse por eso. Para mejorar la experiencia del usuario, puede configurar BTCEXP_SSO_LOGIN_REDIRECT_URL en la URL de su proveedor de SSO. Esto hará que los usuarios sean redirigidos a su página de inicio de sesión si es necesario.