Графический интерфейс Bitcoin core и CLI / API
После загрузки и установки кошелька дождитесь его полной синхронизации. Если у вас возникли проблемы с синхронизацией кошелька, ознакомьтесь с этим руководством:
Почему кошелек не синхронизируется и как это исправить?
После полной синхронизации ваш кошелек готов к использованию, и вы можете начать взаимодействие с ним.
Программное обеспечение Core wallet имеет как графический интерфейс (GUI), так и консольный интерфейс (CLI).
Графический интерфейс удобен для новичков. Можно легко и быстро просматривать текущий баланс, последние транзакции, отправлять и получать монеты BTC, настраивать комиссии, есть контроль монет и некоторые другие основные функции.
Но чтобы использовать программное обеспечение в полной мере и иметь полный контроль над своими Биткоинами, вам нужно научиться использовать окно консоли.
Далее мы покажем вам, как использовать окно консоли отладки в кошельке Bitcoin-qt.
Но, прежде чем вы перейдете к этому руководству и перед тем, как начнете вводить какие-либо команды в окне консоли, мы надеемся, что ваш кошелек зашифрован и у вас есть резервная копия.
Кошелек зашифрован и в данный момент заблокирован — правильная разблокировка кошелька
Как сделать резервную копию wallet.dat кошелька и перенести его на другой компьютер
Как принимать к оплате биткоин используя API Blockchain
30.09.2015 kaplan
#API#Blockchain.info#Биткоин#интеграция платежей
Прием платежей в биткоинах становится популярней и востребованней, а значит уважающий себя интернет-магазин должен иметь такую возможность.
По аналогии с известными методами оплаты, такими как PayPal, WebMoney, VISA и Mastercard, Klarna и прочие, есть разные методы приема оплаты в биткоинах на своем сайте. Один из удобнейших методов в случае с биткоином — использование API биржи Blockchain. Вам не нужно привязываться к конкретному языку или SDK, не нужно даже там регистрироваться как в обычных мерчантах (которые, к тому же, становятся все привередливее).
Все что вам необходимо: иметь кошелек для приема биткоинов (или несколько, если будет угодно) и некоторое время на подключение довольно простых API в вашу систему. К тому же, клиент увидит не ваш родной кошелек, а временный кошелек биржи (что тоже приятно, не так ли?).
Прежде чем говорить непосредственно о коде (я буду в примерах использовать PHP, однако все это легко реализуется на JAVA, Python и т.д.), следует прояснить сам механизм приема оплат.
Тут все довольно просто и укладывается в следующую последовательность:
1. Вы запрашиваете у Blockchain временный кошелек, отправив ряд данных. 2. Blockchain возвращает свой временный кошелек для приема оплат вам. 3. Вы показываете этот кошелек клиенту, а также небольшую инструкцию что с этим делать. 4. Клиент оплачивает (переводит средства на кошелек). 5. Дальше следует подождать валидации платежа в системе Bitcoin. 6. В случае успешной валидации системой Blockchain будет вызван скрипт на вашем сайте (вы сами указываете какой) и переданы все данные транзакции. 7. После этого можно спокойно подтверждать факт оплаты уже внутри вашей системы.
Теперь о деталях реализации. Исходить будем из того, что у вас один кошелек (вариант с несколькими сводится в любом случае к выбору одного, а метод их хранения — любой, на ваше усмотрение).
Для получения временного кошелька следует отправить ряд данных:
1. URL скрипта, который будет вызван в случае успешного подтверждения транзакции. Следует заметить, что рекомендуется указывать некий параметр, или даже несколько для возможности идентификации платежа в текущей системе. Можно, конечно, просто указать идентификатор клиента в вашей системе и при получении подтверждения транзакции уже тогда вносить какие-либо данные в БД. Однако я (а также официальная документация) рекомендую использовать заранее созданный номер платежа и какую-либо проверочную фразу. Суммарно получится URL с параметрами как при обычной передаче GET запросом. Для системы Blockchain этот параметр носит название callback. Значение же следует закодировать как URL-строку. 2. Ваш кошелек, для приема платежа. Собственно, на него Blockchain и переведет полученные деньги. Параметр носит название address. 3. Последний из параметров носит название method и для создания временного кошелька всегда имеет значение create.
Эти данные отправляются скрипту Blockchain по адресу https://blockchain.info/api/receive, при этом каждый из параметров идет обычным GET параметром, а результат его выполнения обрабатывается вашей системой (результат будет в формате JSON). Обо всем этом говорится в документации Blockchain API .
Проще всего это рассмотреть на примере:
Все, мы готовы принять оплату на свой кошелек, однако не способны зарегистрировать факт ее получения у нас в системе.
И пока мы не перешли к следующему шагу, внесу ряд замечаний:
1. Этот код — максимально прост. В реальной системе я бы советовал использовать грамотно продуманный и написанный класс, а также использовать базу данных для хранения подготовленных платежей (как минимум, важно хранить номер платежа, идентификатор пользователя в системе, проверочную фразу или ее составляющие). 2. Функции file_get_contents будет достаточно. Использование cURL или даже чистых сокетов — дело личное и зависит от реализации получения данных от сервиса. 3. Время на валидацию платежа может быть разным и весьма существенным (доходило до 6 часов у меня). А курс биткоина может поменяться. Так что тут есть два варианта: или хранить курс на момент создания платежа (что может сыграть как в плюс, так и в минус) или же запрашивать его по факту получения подтверждения транзакции. Я использую второй метод для спокойствия. Это если вы конечно будете конвертировать биткоин в какую-нибудь другую валюту. Как конвертировать и получать курс я расскажу в конце.
А теперь — получение подтверждения транзакции (деньги к тому моменту на ваш кошелек уже поступят).
Файл должен именоваться receive_payment.php и лежать в корне сайта, так как при запросе временного кошелька мы указали именно такое именование при формировании $callback_url.
На этом второй шаг можно считать оконченным, так как детали работы с базой — на вашей совести, как в плане получения данных ранее созданного платежа, так и сохранения результатов получения транзакции.
Однако, как и в предыдущем шаге внесу ряд замечаний:
1. ВАЖНО! На самом деле скрипт для одного и того же платежа будет вызван не один раз, а по количеству его подтверждений на отдельных нодах. Отсюда следует, что вам следует проверять, а не было ли раньше подтверждения. Иначе получится накрутка. 2. Blockchain отдает гораздо больше параметров, чем я указал в скрипте: transaction_hash — хэш транзакции (он уникален); input_transaction_hash — хэш оригинальной транзакции (он уникален); input_address — кошелек Blockchain, на который придет платеж; destination_address — ваш кошелек, на который придет платеж; confirmations — количество подтверждения нодами (рекомендуется принимать подтверждение платежа в случае, если этот параметр имеет значение большее или равное 6). 3. Параметр value отдает значения не в биткоинах, а в satoshi (1 Satoshi = 0.00000001 BTC). Поэтому следует приводить полученное значение к биткоинам (по указаной в примере скрипта формуле выше). 4. Параметры invoice_id и secret являются кастомными, то есть задаются вами еще на этапе получения кошелька от Blockchain. Соответственно их может быть больше, меньше, вообще не быть, а также они могут иметь любые названия. 5. Рекомендую хранить в истории платежей полученное значение в биткоинах, однако конвертировать его в другую валюту (доллары, например), которая используется у вас в системе. Если же ваша система работает только с биткоинами — ничего конвертировать не нужно.
На этом можно было бы завершить статью — получать биткоины вы теперь умеете, однако я не могу не затронуть вопрос конвертации биткоина в другие валюты по курсу биржи Blockchain. По этому вопросу существует отдельная документация: Exchange Rates API.
Этот сервис может ровно две вещи: 1. Дать сводку текущего курса. Вернет JSON. Как этим пользоваться на своем сайте — решать вам. Я приведу только примитивный пример:
Полная распечатка результата есть в документации. 2. Конвертировать для вас из указанной валюты необходимое указанное количество денежных единиц в биткоины. Я б сказал — сервис для ленивых. Пример:
Сервису надо отдать два параметра: currency — название валюты (список валют есть в документации, а также его можно получить самостоятельно, используя код из предыдущего пункта, просто вызвав там print_r($exchange_data_obj);). value — сколько меняем.
Все. Вернет только число биткоинов.
Также, этот сервис полезен в виде калькулятора как можно ближе к тому месту на сайте, где вы будете показывать кошелек Blockchain для приема денег (при условии, что вам нужна конвертация). Указанного в статье достаточно (более чем) для организации приема платежей в биткоинах у вас на сайте. Дальше все зависит от грамотно спроектированного кода и осторожности.
Moon Labs специально для ForkLog
Нашли ошибку в тексте? Выделите ее и нажмите CTRL+ENTER
Окно консоли Bitcoin core
В более старой версии кошелька Bitcoin вы должны увидеть окно отладки в разделе «Help> Debug window», где вы можете начать вводить команды bitcoin-cli.
В последней версии выберете выпадающее меню «window» и откройте «console».
Вы должны увидеть следующее предупреждение.
«Welcome to the Bitcoin Core RPC console.
Use up and down arrows to navigate history, and Ctrl-L to clear screen. Type help for an overview of available commands. For more information on using this console type help-console.»
«WARNING: Scammers have been active, telling users to type commands here, stealing their wallet contents. Do not use this console without fully understanding the ramifications of a command.»
Перевод:
Добро пожаловать в консоль Bitcoin Core RPC.
Используйте стрелки вверх и вниз для навигации по истории и Ctrl-L для очистки экрана. Введите help для обзора доступных команд. Для получения дополнительной информации об использовании этой консоли введите help-console.
ВНИМАНИЕ: существуют мошенники, которые просят пользователей вводить команды, которые крадут содержимое кошельков. Не используйте эту консоль, не понимая полностью смысл команды.
Как следует из предупреждения, не вводите команды, с которыми вы не знакомы, и не передавайте никому информацию, которая в вашем окне консоли, особенно ту, которая включает кодовую фразу кошелька и приватные ключи.
Как получить ключ API?
Чтобы использовать API Blockchain.info, вы должны заполнить форму заявки по адресу:
https://api.blockchain.info/v2/apikey/request/
Обратите внимание, что этот ключ API предназначен только для получения платежей. Существует стандартный API кошелька, который доступен в Python, Java, .NET (C #), Ruby, PHP и Node и может использоваться для отправки и получения платежей. Однако он отличается от Receive Payments V2 API тем, что не подходит для генерации разных адресов для разных пользователей.
На рисунке ниже показана форма заявки на получение Receive Payments V2 API. Вам нужно будет ввести свое имя, адрес электронной почты, URL-адрес сайта, на котором вы будете внедрять API, а также описание товаров, которые вы продаете, или услуг, которые предлагаете на своем веб-сайте. В большинстве случаев заявка рассматривается в течение 2-3 рабочих дней.
Рисунок 1. Форма заявки на получение Receive Payments V2 API
Создание новых адресов для ваших клиентов
Для каждого клиента у нас будет свой уникальный адрес, на который он будет отправлять платежи. При получении денег на любой из таких адресов вам будет отправлено HTTP-уведомление. Обратите внимание, что каждый вызов, сделанный на сервере, приведет к увеличению параметра index, это делается для того, чтобы убедиться, что один и тот же адрес не назначен более чем одному клиенту. Тем не менее все средства, отправленные на любой из созданных адресов, будут добавлены в один и тот же кошелек.
https://api.blockchain.info/v2/receive?xpub=$xpub&callback=$callback_url&key=$key
Следует учесть, что существует программное ограничение — кошелек не сканирует более 20 неиспользуемых адресов. Таким образом, API будет возвращать ошибку, если более 20 из ранее созданных адресов не были использованы. Если вы столкнулись с этой ошибкой, вам придется либо перейти на новый xPub (в том же блоке blockchain.info), либо начать получать платежи на один из ранее созданных неиспользуемых 20 адресов.
Это можно опционально контролировать, добавляя gap_limit в качестве дополнительного параметра URL, что не приведет к увеличению числа биткоин-адресов, которые могут отслеживаться серверами Blockahin.info. Добавление параметра gap_limit изменяет максимально допустимый интервал, после которого API больше не будет генерировать новые адреса.
https://api.blockchain.info/v2/receive?xpub=$xpub&callback=$callback_url&key=$key&gap_limit=$gap_limit
Ниже рассмотрим параметры, используемые в приведенном URL:
- xpub: ваш xPub (пункт назначения, куда будут отправляться платежи ваших клиентов).
- callback_url: это URL-адрес обратной связи, на который будут приходить уведомления при получении платежа.
- key: ваш ключ API-интерфейса получения платежей, который вы получите после того, как приложение будет успешно принято.
- gap_limit: необязательный параметр, который определяет количество неиспользуемых адресов биткоинов, разрешенных до того, как будет возвращена ошибка.
С помощью xPub создаем неиспользуемый биткойн-адрес:
curl https://api.blockchain.info/v2/receive?xpub=xpub6CWiJoiwxPQni3DFbrQNHWq8…
Теперь пусть ваши клиенты отправляют средства по адресу, указанному в ответе:
RESPONSE: 200 OK, APPLICATION/JSON
{«address»:»19jJyiC6DnKyKvPg38eBE8R6yCSXLLEjqw»,»index»:23,»callback»:»https://mystore.com?invoice_id=058921123″}
Ниже приведен пример реализации на PHP:
$secret = ‘ZzsMLGKe162CfA5EcG6j’;
$my_xpub = ‘{YOUR XPUB ADDRESS}’;
$my_api_key = ‘{YOUR API KEY}’;
$my_callback_url = ‘INSERT YOUR CALLBACK URL HERE +/- that can include customer identification parameters such as ?invoice_id=058921123&secret=’.$secret;
$root_url = ‘https://api.blockchain.info/v2/receive’;
$parameters = ‘xpub=’ .$my_xpub. ‘&callback=’ .urlencode($my_callback_url). ‘&key=’ .$my_api_key;
$response = file_get_contents($root_url . ‘?’ . $parameters);
$object = json_decode($response);
echo ‘Send Payment To : ‘ . $object->address;
