Explorador de bloques de Bitcoin

Resumen en 30 segundos

1. btc-rpc-explorer es un explorador de bloques que funciona sobre tu propio nodo: ves bloques, transacciones y la mempool sin preguntar a ninguna web de terceros.
2. Instálalo desde GitHub (versión 3.5.1) con Node.js 18 o superior. La versión de npm es de 2023 y falla con Bitcoin Core 28 o posterior.
3. Si lo ejecutas con el mismo usuario que tu nodo, se conecta solo con la cookie de Bitcoin Core: no hace falta configurar usuario ni contraseña.

BTC-RPC-EXPLORER

btc-rpc-explorer es un explorador desarrollado por janoside que permite visualizar la actividad de la red de Bitcoin desde tu propio nodo, me parece una excelente opción para continuar con el aprendizaje de Bitcoin y además para poder visualizar tus transacciones y las de la red.

Recordemos que puedes ver todas las operaciones que hay en la red, aunque no sepas de quién son y eso es lo genial!.

Además, cada consulta la responde tu nodo. Cuando buscas una transacción en una web de terceros, esa web sabe qué te interesa; con tu propio explorador, nadie más se entera.

He realizado esta guía para documentar los pasos que seguí para instalar btc-rpc-explorer y con ello poder conectarlo con mi nodo.

Antes de empezar

Paso 0. Lee todo antes de hacerlo, tal vez algún paso no sea tan claro y es mejor que lo entiendas antes de irlos ejecutando.

Necesitas:

• Un nodo de Bitcoin Core, a ser posible ya sincronizado. Puedes usar el explorador mientras sincroniza, pero algunas páginas fallarán.
• El servidor RPC del nodo activado. Si usas bitcoind, ya viene activado. Si usas la versión con ventanas (bitcoin-qt), añade server=1 a tu bitcoin.conf (en minúsculas: más abajo te explico por qué importa).
• Recomendado: el índice de transacciones (txindex=1 en bitcoin.conf). Sin él el explorador funciona, pero solo encuentra por su identificador las transacciones de la mempool, las muy recientes y las de tu cartera. El índice no es compatible con un nodo podado (prune).
• Node.js 18 o superior (se recomienda la 22) y git.

Comprueba qué versión de Node.js tienes:

node --version

Si no lo tienes o es antiguo:

• En Fedora: sudo dnf install nodejs git. Las versiones recientes de Fedora traen Node.js 22.
• En Debian 12 o Ubuntu 24.04: sudo apt install nodejs npm git. Traen Node.js 18, que es el mínimo.
• En cualquier sistema, también puedes usar nvm para instalar la versión que quieras sin tocar la del sistema.

HechoSi activas txindex=1 en un nodo que ya estaba sincronizado, no hace falta volver a descargar la cadena: al reiniciar, Bitcoin Core construye el índice en segundo plano. Tarda unas horas y ocupa algo más de espacio en disco.

Paso 1. Instalar el explorador

Instálalo desde GitHub, con la última versión publicada:

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

Abre en tu navegador http://127.0.0.1:3002. Si el nodo está en la misma máquina y con el mismo usuario, ya deberías ver el panel con los datos de tu nodo.

HechoLas instrucciones oficiales también ofrecen npm install -g btc-rpc-explorer, pero en npm sigue publicada la versión 3.4.0, de junio de 2023. La 3.5.0 (junio de 2025) arregló la página de detalles del nodo para Bitcoin Core 28 y posteriores¹. Por eso es mejor instalarlo desde GitHub.

Para pararlo, pulsa Ctrl+C en la terminal.

Paso 2. Conectarlo con tu nodo

Para hablar con tu nodo, el explorador necesita autenticarse en su servidor RPC. Hay tres situaciones.

Mismo usuario y misma máquina: no hagas nada

Bitcoin Core crea al arrancar un archivo .cookie con una contraseña aleatoria que cambia cada vez que arranca, en ~/.bitcoin/.cookie. El explorador lo busca ahí por defecto y lo usa. Es la forma más sencilla y segura: no hay contraseñas fijas en ningún archivo.

Si tu nodo usa otra carpeta de datos, indícale la ruta completa de la cookie en el archivo de configuración (paso 3):

BTCEXP_BITCOIND_COOKIE=/home/tuusuario/ruta-de-tu-nodo/.cookie

Otro usuario en la misma máquina

Por seguridad, la cookie solo la puede leer el usuario que ejecuta el nodo. Desde Bitcoin Core 28 puedes permitir que la lea también su grupo, añadiendo a bitcoin.conf:

rpccookieperms=group

Después, mete en ese grupo al usuario que ejecuta el explorador y reinicia el nodo.

Otra máquina, o si prefieres usuario y contraseña: rpcauth

En este caso hay que crear un usuario para el servidor RPC con rpcauth. Para obtener el rpcauth y la contraseña que vas a necesitar se usa el script rpcauth.py, que viene con el código fuente de Bitcoin Core (carpeta share/rpcauth). Si no lo tienes, descárgalo de la versión que uses:

wget https://raw.githubusercontent.com/bitcoin/bitcoin/v32.1/share/rpcauth/rpcauth.py
python3 rpcauth.py miusuario

Esto te devolverá como salida algo así:

String to be appended to bitcoin.conf:
rpcauth=miusuario:734726552070792922ceac7ca630c820$17f7d80df7ee7b9dab12d0c017de8c7379b4611de7338445ea5d31d8b3fa99dd
Your password:
yPL8WKwYoHu5e1qt7ka38TP6xlFssut5YnSpmxaqfdU=

Como podrás ver, la salida de ese comando te da dos cosas:

• La línea rpcauth=…, que va en el archivo bitcoin.conf del nodo. Guarda la contraseña de forma cifrada (con sal y HMAC), así que aunque alguien lea tu bitcoin.conf, no la verá.
• La contraseña (Your password), que no va en bitcoin.conf: guárdala, porque es la que usará el explorador. Genera la tuya: nunca copies la de este ejemplo.

Si el explorador está en otra máquina de tu red, añade también a bitcoin.conf en qué dirección escucha el nodo y desde qué direcciones acepta conexiones. Por ejemplo, con el nodo en 192.168.1.10 y el explorador en 192.168.1.20:

server=1
rpcauth=miusuario:734726552070792922ceac7ca630c820$17f7d80df7ee7b9dab12d0c017de8c7379b4611de7338445ea5d31d8b3fa99dd
rpcbind=192.168.1.10
rpcallowip=192.168.1.20

Con esto incluido en tu archivo bitcoin.conf (no olvides reiniciar el nodo), ya tenemos configurado el nodo para ejecutar comandos RPC.

?Escribe las opciones en minúsculasPara curiosos›

En la primera versión de esta guía escribí Server=1, con mayúscula. Bitcoin Core distingue mayúsculas y minúsculas en bitcoin.conf: una opción que no conoce la ignora y solo deja un aviso en el registro («Ignoring unknown configuration value Server»). Con bitcoind no se notaba, porque el servidor RPC ya viene activado; con bitcoin-qt, el RPC no se activaba y el explorador no podía conectarse.

Paso 3. El archivo de configuración

El explorador se configura con variables en un archivo de texto. Puedes ponerlo en una de estas dos rutas:

1. ~/.config/btc-rpc-explorer.env
2. .env, dentro de la carpeta btc-rpc-explorer.

En el archivo de ejemplo tienes todas las opciones. Estas son las que más vas a usar:

# Contraseña para entrar desde el navegador.
# Te pedirá usuario y contraseña: el usuario da igual, solo se comprueba la contraseña.
BTCEXP_BASIC_AUTH_PASSWORD=una-contraseña-larga

# Solo si usas rpcauth (si usas la cookie, no hacen falta):
#BTCEXP_BITCOIND_HOST=192.168.1.10
#BTCEXP_BITCOIND_USER=miusuario
#BTCEXP_BITCOIND_PASS=yPL8WKwYoHu5e1qt7ka38TP6xlFssut5YnSpmxaqfdU=

# Precio de bitcoin en el panel (desactivado por defecto):
#BTCEXP_NO_RATES=false

# Mensajes de depuración en la terminal, útil la primera vez:
#DEBUG=btcexp:*

Quita la almohadilla (#) de las líneas que quieras activar. Cada vez que cambies el archivo, reinicia el explorador.

Precio de bitcoin. Una cosa que también puedes ver desde el cuadro de mando es el precio de bitcoin. Antes había que tocar el código para activarlo; ahora basta con BTCEXP_NO_RATES=false. Ten en cuenta que, para obtener el precio, el explorador consulta servicios externos. Si prefieres que no salga ninguna consulta de tu máquina, añade BTCEXP_PRIVACY_MODE=true.

Historial de direcciones. Bitcoin Core no guarda un índice por direcciones, así que el explorador, por sí solo, no puede enseñarte el historial de una dirección. Si tienes un servidor Electrum en tu nodo (Electrs o Fulcrum), puedes conectarlo con BTCEXP_ADDRESS_API=electrum y BTCEXP_ELECTRUM_SERVERS.

Paso 4. Que arranque solo

Para no tener que estar ejecutando esto desde un terminal todo el tiempo, lo más cómodo hoy es crear un servicio de systemd. Crea el archivo /etc/systemd/system/btc-rpc-explorer.service (cambia tuusuario por tu usuario):

[Unit]
Description=BTC RPC Explorer
After=network.target

[Service]
User=tuusuario
WorkingDirectory=/home/tuusuario/btc-rpc-explorer
ExecStart=/usr/bin/npm start
Restart=on-failure

[Install]
WantedBy=multi-user.target

Y actívalo:

sudo systemctl daemon-reload
sudo systemctl enable --now btc-rpc-explorer

Si instalaste Node.js con nvm, cambia /usr/bin/npm por la ruta que te devuelva which npm. Para ver sus mensajes, como si estuviera en una terminal: journalctl -u btc-rpc-explorer -f.

Alternativa: un acceso directo en el escritorio

Lo que hice en 2020 fue crear un archivo para ejecutarlo como si fuera una aplicación. La ventaja es que no tienes una terminal abierta; la desventaja, que no verás los mensajes si algo va mal. Crea ~/.local/share/applications/btc-explorer.desktop con:

[Desktop Entry]
Type=Application
Name=btc explorer
Comment=Explorador de bloques
Categories=Utility;
Exec=sh -c "cd ~/btc-rpc-explorer && npm start"
Terminal=false

Las contraseñas van en el archivo de configuración del paso 3, no en el acceso directo.

Paso 5. Actualizarlo

Cuando salga una versión nueva (las tienes en la página de versiones):

cd ~/btc-rpc-explorer
git fetch --tags
git checkout vX.Y.Z
npm install

Y reinícialo (sudo systemctl restart btc-rpc-explorer si usas el servicio).

Si algo falla

• Error: no auth mechanism defined: el explorador no encuentra ni la cookie ni un usuario y contraseña. Comprueba que el nodo está arrancado (la cookie solo existe mientras funciona), que la ruta de la cookie es correcta y que el archivo de configuración está en una de las dos rutas del paso 3.
• ECONNREFUSED 127.0.0.1:8332: el nodo no está escuchando. O no está arrancado, o usas bitcoin-qt sin server=1, o el nodo está en otra máquina y falta BTCEXP_BITCOIND_HOST.
• 401 Unauthorized: el usuario o la contraseña de rpcauth no coinciden. Recuerda que el explorador usa la contraseña que te dio rpcauth.py, no la línea larga de bitcoin.conf.
• No encuentra transacciones antiguas: falta txindex=1 (o el índice aún se está construyendo).
• Opciones de la línea de comandos: llevan dos guiones (--bitcoind-user, --bitcoind-pass, --bitcoind-cookie). Si copias de una web que convierte -- en una raya (–), fallarán. Con btc-rpc-explorer --help tienes la lista completa.

Si después de esto tienes problemas, lamento decirte que tienes que investigar qué más podría ser o avísame y estaré dispuesto a ayudarte (Telegram).

Si todo ha ido bien, enhorabuena, tienes que darle las gracias a janoside que es quien ha desarrollado este magnífico explorador.

Otras opciones

Opiniónbtc-rpc-explorer sigue siendo la forma más ligera de tener tu propio explorador: solo necesita tu nodo, sin base de datos ni servidor Electrum. Eso sí, su desarrollo va despacio: la última versión es de julio de 2025.

• mempool: el mismo explorador de mempool.space, en tu nodo. Es más completo y vistoso, pero necesita además una base de datos y, para buscar direcciones, un servidor Electrum (Electrs o Fulcrum).
• Umbrel o Start9: si tu nodo corre en uno de estos sistemas, tanto btc-rpc-explorer como mempool se instalan con un clic desde su tienda de aplicaciones.

Referencias

1. Notas de versión de btc-rpc-explorer (CHANGELOG): https://github.com/janoside/btc-rpc-explorer/blob/master/CHANGELOG.md. Versión publicada en npm: https://www.npmjs.com/package/btc-rpc-explorer ↩