btc rpc explorer

BTC RPC Explorer

Самостоятельный обозреватель биткойнов для всех, кто использует Bitcoin Core.

---

Это автономный обозреватель блокчейна Биткойн, управляемый вызовами RPC к вашему собственному узлу Биткойн. Его легко запустить, и его можно подключить к другим инструментам (например, серверам Electrum), чтобы получить полнофункциональный проводник.

Какие бы причины у вас ни были для запуска полного узла (ненадежность, техническое любопытство, поддержка сети и т. д.), важно оценить полноту вашего узла. С помощью этого обозревателя вы сможете изучить не только базу данных блокчейна, но и изучить все функциональные возможности вашего собственного узла.

Живые демонстрации:

• BitcoinExplorer.org/testnet/signet

Функции

• Панель сводной информации о сети
• Просмотр подробностей блоков, транзакций и адресов
• Инструменты анализа для просмотра статистики по блокам, транзакциям и активности майнеров
• JSON REST API
• Посмотрите необработанный контент JSON из bitcoind, используемый для создания большинства страниц.
• Поиск по идентификатору транзакции, хешу/высоте блока и адресу
• Дополнительная история транзакций для адресов путем запроса с серверов протокола Electrum (например, Electrs, ElectrumX), Blockchain.com, Blockchair.com или Blockcypher.com
• Сводка мемпула с разбивкой по размеру, размеру и возрасту
• Браузер и терминал команд RPC

Журнал изменений / Примечания к выпуску

См. CHANGELOG.md.

Начиная

Предварительные условия

1. Установите Bitcoin Core — инструкция. Убедитесь, что RPC-сервер Bitcoin Core включен ( server=1 ).
2. Разрешите Bitcoin Core синхронизироваться с сетью Биткойн (вы можете использовать этот инструмент во время синхронизации, но на некоторых страницах может произойти сбой).
3. Установите Node.js (требуется 16+, рекомендуется 18+).

Примечание о конфигурациях сокращения и индексирования

Этот инструмент предназначен для наилучшей работы при включенной полной индексации транзакций ( txindex=1 ) и отключенной обрезке. Однако, если вы используете Bitcoin Core v0.21+, вы можете работать без включенного txindex и/или с включенной pruning , и этот инструмент продолжит работать, но некоторые данные будут неполными или отсутствующими. Также обратите внимание, что такие конфигурации Bitcoin Core проходят менее тщательное тестирование.

В частности, при включенном pruning и/или отключении txindex изменяются следующие функции:

• Вы сможете искать только недавно подтвержденные транзакции в мемпуле и кошельке по их txid. Поиск транзакций, не связанных с кошельком, которые были подтверждены более 3 блоков назад, возможен только в том случае, если вы укажете подтвержденную высоту блока в дополнение к txid.
• В обрезанных блоках будет отображаться основная информация заголовка без списка транзакций. Транзакции в сокращенных блоках будут недоступны, если они не связаны с кошельком. Статистика блоков будет работать только для необрезанных блоков.
• Адрес и сумма выводов предыдущих транзакций не будут показаны, только txid:vout.
• Комиссия за майнинг будет доступна только для неподтвержденных транзакций.

Установить/Запустить

Если вы работаете в основной сети с каталогом данных и портом по умолчанию, конфигурация по умолчанию должна просто работать . В противном случае см. раздел «Конфигурация» ниже.

Установить через npm :

Примечание: требуется npm v7+.

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

Запустить из источника:

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

Установить через AUR Arch Linux:

Примечание. Приведенный ниже пакет AUR был создан и поддерживается @dougEfresh. Подробности и историю пакета можно увидеть здесь.

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

После установки по умолчанию + запуска с использованием любого из вышеперечисленных методов приложение можно просмотреть по адресу http://127.0.0.1:3002/.

Конфигурация

Параметры конфигурации могут быть установлены с помощью переменных среды или аргументов CLI.

Конфигурация с переменными среды

Чтобы настроить переменные среды, вам необходимо создать один из двух следующих файлов и ввести в него значения:

1. ~/.config/btc-rpc-explorer.env
2. .env в рабочем каталоге btc-rpc-explorer

В любом случае обратитесь к .env-sample для получения списка параметров и деталей форматирования.

Конфигурация с помощью аргументов CLI

Для настройки с помощью аргументов CLI запустите btc-rpc-explorer --help чтобы получить полный список параметров. Пример выполнения:

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

Настройки демо-сайта

Чтобы соответствовать функциям, представленным на демонстрационном сайте BitcoinExplorer.org, вам необходимо установить следующие значения конфигурации, отличные от значений по умолчанию:

 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, аналогичную той, которую предоставляют ThunderHub и RTL. Чтобы включить его, убедитесь, что BTCEXP_BASIC_AUTH_PASSWORD не установлен, и установите BTCEXP_SSO_TOKEN_FILE , чтобы он указывал на файл, доступный для записи для btc-rpc-explorer. Затем, чтобы получить доступ к btc-rpc-explorer, вашему провайдеру единого входа необходимо прочитать токен из этого файла и установить его в параметре URL-адреса token . По соображениям безопасности токен меняется при каждом входе в систему, поэтому провайдеру единого входа необходимо каждый раз его читать!

После успешного доступа с помощью токена для аутентификации устанавливается файл cookie, поэтому вам больше не нужно об этом беспокоиться. Чтобы улучшить взаимодействие с пользователем, вы можете установить BTCEXP_SSO_LOGIN_REDIRECT_URL на URL-адрес вашего поставщика единого входа. При необходимости пользователи будут перенаправлены на вашу страницу входа.

Запуск через Докер

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

Обратный прокси с HTTPS

См. инструкции здесь по использованию nginx+certbot (letsencrypt) для сайта с обратным прокси-сервером, доступного по протоколу HTTPS.

Поддерживать

Если вы получаете пользу от этого проекта, пожалуйста, рассмотрите возможность поддержать мою работу пожертвованием. Все пожертвования действительно ценны.

Пожертвовать через BTC Pay Server:

• https://donate.bitcoinexplorer.org

Или через молниеносный адрес:

спасибо@donate.btc21.org