Explorador de RPC BTC

Explorador de Bitcoin auto-hospedado para todos que executam o Bitcoin Core.

página inicial

Este é um explorador auto-hospedado para o blockchain Bitcoin, conduzido por chamadas RPC para seu próprio nó Bitcoin. É fácil de executar e pode ser conectado a outras ferramentas (como servidores Electrum) para obter um explorador completo.

Quaisquer que sejam os motivos que você possa ter para executar um nó completo (falta de confiança, curiosidade técnica, suporte à rede, etc.), é valioso apreciar a plenitude do seu nó. Com este explorador, você pode explorar não apenas o banco de dados blockchain, mas também explorar todos os recursos funcionais do seu próprio nó.

Demonstrações ao vivo:

BitcoinExplorer.org/testnet/sinete

Características

Painel de resumo da rede
Veja detalhes de blocos, transações e endereços
Ferramentas de análise para visualizar estatísticas sobre blocos, transações e atividades de mineração
API REST JSON
Veja o conteúdo JSON bruto do bitcoind usado para gerar a maioria das páginas
Pesquise por ID de transação, hash/altura de bloco e endereço
Histórico de transações opcional para endereços consultando servidores do protocolo Electrum (por exemplo, Electrs, ElectrumX), blockchain.com, blockchair.com ou blockcypher.com
Resumo do Mempool, com detalhamento de taxas, tamanho e idade
Navegador e terminal de comandos RPC

Registro de alterações/notas de lançamento

Consulte CHANGELOG.md.

Começando

Pré-requisitos

Instale Bitcoin Core - instruções. Certifique-se de que o servidor RPC do Bitcoin Core esteja habilitado ( server=1 ).
Permita que Bitcoin Core sincronize com a rede Bitcoin (você pode usar esta ferramenta durante a sincronização, mas algumas páginas podem falhar).
Instale o Node.js (16+ obrigatório, 18+ recomendado).

Nota sobre configurações de remoção e indexação

Esta ferramenta foi projetada para funcionar melhor com a indexação completa de transações habilitada ( txindex=1 ) e a remoção desabilitada . No entanto, se você estiver executando o Bitcoin Core v0.21+, poderá executar sem txindex habilitado e/ou com pruning habilitada e esta ferramenta continuará funcionando, mas alguns dados estarão incompletos ou ausentes. Observe também que essas configurações do Bitcoin Core recebem testes menos completos.

Em particular, com pruning habilitada e/ou txindex desabilitado, a seguinte funcionalidade é alterada:

Você só poderá pesquisar mempool, recentemente confirmado, e transações de carteira por seu txid. A pesquisa de transações não relacionadas à carteira que foram confirmadas há mais de 3 blocos só é possível se você fornecer a altura do bloco confirmada além do txid.
Os blocos removidos exibirão informações básicas do cabeçalho, sem a lista de transações. As transações em blocos removidos não estarão disponíveis, a menos que sejam relacionadas à carteira. As estatísticas de bloco só funcionarão para blocos não podados.
O endereço e a quantidade de saídas de transações anteriores não serão mostrados, apenas o txid:vout.
A taxa de mineração estará disponível apenas para transações não confirmadas.

Instalar / Executar

Se você estiver executando na mainnet com datadir e porta padrão, a configuração padrão deve Just Work . Caso contrário, consulte a seção Configuração abaixo.

Instale via `npm` :

Nota: npm v7+ é necessário

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

Execute a partir da fonte:

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

Instale via AUR Arch Linux:

Nota: O pacote AUR abaixo foi criado e é mantido por @dougEfresh. Os detalhes e a história do pacote podem ser vistos aqui.

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

Após uma instalação + inicialização padrão usando qualquer um dos métodos acima, o aplicativo pode ser visualizado em http://127.0.0.1:3002/

Configuração

As opções de configuração podem ser definidas por meio de variáveis de ambiente ou argumentos CLI.

Configuração com variáveis de ambiente

Para configurar com variáveis de ambiente, você precisa criar um dos 2 arquivos a seguir e inserir valores nele:

~/.config/btc-rpc-explorer.env
.env no diretório de trabalho do btc-rpc-explorer

Em ambos os casos, consulte .env-sample para obter uma lista de opções e detalhes de formatação.

Configuração com argumentos CLI

Para configurar com argumentos CLI, execute btc-rpc-explorer --help para obter a lista completa de opções. Um exemplo de execução é:

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

Configurações do site de demonstração

Para corresponder aos recursos visíveis no site de demonstração em BitcoinExplorer.org, você precisará definir os seguintes valores de configuração não padrão:

 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

Autenticação SSO

Você pode configurar a autenticação SSO semelhante à fornecida pelo ThunderHub e RTL. Para habilitá-lo, certifique-se de que BTCEXP_BASIC_AUTH_PASSWORD não esteja definido e defina BTCEXP_SSO_TOKEN_FILE para apontar para um arquivo acessível por gravação pelo btc-rpc-explorer. Então, para acessar o btc-rpc-explorer, seu provedor de SSO precisa ler o token deste arquivo e defini-lo no parâmetro de URL token . Por motivos de segurança, o token muda a cada login, portanto, o provedor de SSO precisa lê-lo sempre!

Após o acesso bem-sucedido com o token, um cookie é definido para autenticação, então você não precisa mais se preocupar com isso. Para melhorar a experiência do usuário, você pode definir BTCEXP_SSO_LOGIN_REDIRECT_URL como o URL do seu provedor de SSO. Isso fará com que os usuários sejam redirecionados para sua página de login, se necessário.