Поиск

У биткоина есть как графический интерфейс именумеый bitcoin-qt так и консольный, bitcoind. Если первый удобен для использования человеком, то без текствого довольно сложно сделать интернет магазин или какой-либо иной сервис, принимающий биткоины в качестве оплаты. О нем и пойдет речь. Для работы нужно запустить один экземпляр bitcoind в качестве демона, чтобы он работал в качестве полноценного узла сети и отдавать ему команды с помощью еще одной копии bitcoind. Взаимодействие между ними происходит по JSON-RPC через 8332й tcp порт. Для того чтобы они узнавали и доверяли друг другу нужно задать rpcpassword, который прописывается в файле ~/.bitcoin/bitcoin.conf как rpcpassword=blah-blah-blah. Если у вас нет такого файла то его нужно создать. Туда же можно прописать и другие параметры из тех, что указываются при запуске демона. Полный список параметров можно получить запустив bitcoind с ключем --help или -?, вот пример того, что мы увидим в ответ: Bitcoin version 0.5.2-beta Usage: bitcoind [options] bitcoind [options] <command> [params] Send command to -server or bitcoind bitcoind [options] help List commands bitcoind [options] help <command> Get help for a command Options: -conf=<file> Specify configuration file (default: bitcoin.conf) -pid=<file> Specify pid file (default: bitcoind.pid) -gen Generate coins -gen=0 Don't generate coins -min Start minimized -datadir=<dir> Specify data directory -timeout=<n> Specify connection timeout (in milliseconds) -proxy=<ip:port> Connect through socks4 proxy -dns Allow DNS lookups for addnode and connect -port=<port> Listen for connections on <port> (default: 8333 or testnet: 18333) -maxconnections=<n> Maintain at most <n> connections to peers (default: 125) -addnode=<ip> Add a node to connect to -connect=<ip> Connect only to the specified node -noirc Don't find peers using internet relay chat -nolisten Don't accept connections from outside -nodnsseed Don't bootstrap list of peers using DNS -banscore=<n> Threshold for disconnecting misbehaving peers (default: 100) -bantime=<n> Number of seconds to keep misbehaving peers from reconnecting (default: 86400) -maxreceivebuffer=<n> Maximum per-connection receive buffer, <n>*1000 bytes (default: 10000) -maxsendbuffer=<n> Maximum per-connection send buffer, <n>*1000 bytes (default: 10000) -upnp Attempt to use UPnP to map the listening port -paytxfee=<amt> Fee per KB to add to transactions you send -daemon Run in the background as a daemon and accept commands -testnet Use the test network -debug Output extra debugging information -logtimestamps Prepend debug output with timestamp -printtoconsole Send trace/debug info to console instead of debug.log file -rpcuser=<user> Username for JSON-RPC connections -rpcpassword=<pw> Password for JSON-RPC connections -rpcport=<port> Listen for JSON-RPC connections on <port> (default: 8332) -rpcallowip=<ip> Allow JSON-RPC connections from specified IP address -rpcconnect=<ip> Send commands to node running on <ip> (default: 127.0.0.1) -keypool=<n> Set key pool size to <n> (default: 100) -rescan Rescan the block chain for missing wallet transactions SSL options: (see the Bitcoin Wiki for SSL setup instructions) -rpcssl Use OpenSSL (https) for JSON-RPC connections -rpcsslcertificatechainfile=<file.cert> Server certificate file (default: server.cert) -rpcsslprivatekeyfile=<file.pem> Server private key (default: server.pem) -rpcsslciphers=<ciphers> Acceptable ciphers (default: TLSv1+HIGH:!SSLv2:!aNULL:!eNULL:!AH:!3DES:@STRENGTH) -? This help message Вот описание некоторых из них: -conf - позволяет задать файл конфигурации отличный от ~/.bitcoin/bitcoin.conf -pid - указать файл, в который будет писаться pid процесса демона -gen - после старта начать майнить биткоины (он это будет пытаться делать на cpu, что крайне неэффективно) -gen=0 - не майнить биткоины (если в файле конфигурации указано иное) -datadir= - использовать вместо ~/.bitcoin/ указанный путь -timeout= - таймаут tcp соединения -proxy=<ip:port> - соединятся через указанный SOCKS4 прокси-сервер, например через tor -port= - использовать указанный порт вместо 8333 -maxconnections= - ограничить число одновременных соединений, по умолчанию 125 -addnode= - так же подключится и к указанному узлу, тут полезно указать адреса пулов для ускорения транзакций, можно использовать несколько раз -connect= - подключится только к указанному узлу, полезно, если вы хотите загрузить блоки с другого компьютера в локальной сети не загружая интернет-канал -noirc - не использовать irc для поиска узлов и анонса собственного адреса (например irc запрещен хостингом, что встречается довольно часто) -nolisten - не принимать входящие соединения -nodnsseed - не использовать DNS для поиска узлов -upnp - Пытаться использовать UPnP для того чтобы пробросить порт. Полезно, если вы заначены роутером, использующим внешний ip и поддерживающим UPnP. Не нужно, если вы имеете внешний ip напрямую и не имеет смысла, если ваш роутер не имеет внешнего ip. -paytxfee= - установить размер комиссию (в биткоинах), собственная логика клиента имеет приоритет над этим значением -daemon - запускаться в фоне -testnet - использовать тестовую сеть -debug - писать отладочную информацию -logtimestamps - снабжать лог временными метками -printtoconsole - использовать stdout вместо debug.log -rpcuser= и -rpcpassword - имя пользователя и пароль для JSON-RPC, как для лемона так и для клиента -rpcport= - использовать для JSON-RPC порт, отличный от 8332 -rpcallowip= - разрешить принимать команды с указанного ip, по умолчанию команды принимаются только с 127.0.0.1, можно использовать несколько раз -rpcconnect= - отправлять команды на указанный узел а не на 127.0.0.1 -keypool= - сгенерировать указанное количество ключей при старте, по умолчанию - 100 -rescan - перечитать цепочку блоков, полезно если у вас поврежден blkindex.dat или есть зависшие транзакции в кошельке Так же в 0.6 версии появилась довольно полезная опция -blocknotify=, которая запускает указанную команду при получении нового блока, например для обработчика платежей. Большую часть перечисленных параметров можно указывать и в bitcoin.conf. При работе в режиме демона клиент использует множество "виртуальных" аккаунтов, для каждого из которых ведет свой учет баланса. Такая логика может существенно упростить создание какого-либо сервиса, поскольку достаточно привязать пользователей сервиса к аккаунтам bitcoind. Баланс на аккаунте может быть как положительным так и отрицательным. Аккаунт, используемый по умолчанию - "" (пустая строка). После запуска демона должно пройти какое-то время, чтобы он проинициализировался и начал ожидать команд. Список команд, которые можно отдать демону, можно получить, запустив bitcoind с аргументом help (без --). Вот пример вывода: backupwallet <destination> encryptwallet <passphrase> getaccount <bitcoinaddress> getaccountaddress <account> getaddressesbyaccount <account> getbalance [account] [minconf=1] getblockcount getconnectioncount getdifficulty getgenerate gethashespersec getinfo getmemorypool [data] getnewaddress [account] getreceivedbyaccount <account> [minconf=1] getreceivedbyaddress <bitcoinaddress> [minconf=1] gettransaction <txid> getwork [data] help [command] keypoolrefill listaccounts [minconf=1] listreceivedbyaccount [minconf=1] [includeempty=false] listreceivedbyaddress [minconf=1] [includeempty=false] listsinceblock [blockid] [target-confirmations] listtransactions [account] [count=10] [from=0] move <fromaccount> <toaccount> <amount> [minconf=1] [comment] sendfrom <fromaccount> <tobitcoinaddress> <amount> [minconf=1] [comment] [comment-to] sendmany <fromaccount> {address:amount,...} [minconf=1] [comment] sendtoaddress <bitcoinaddress> <amount> [comment] [comment-to] setaccount <bitcoinaddress> <account> setgenerate <generate> [genproclimit] settxfee <amount> signmessage <bitcoinaddress> <message> stop validateaddress <bitcoinaddress> verifymessage <bitcoinaddress> <signature> <message> Описание некоторых комманд: backupwallet - сделать резервную копию wallet.dat encryptwallet - зашифровать кошелек (необратимо!) getaccount - Узнать, какому аккаунту принадлежит указанный адрес. Пареметр - bitcoin адрес, результат - строка с именем аккаунта. getaddressesbyaccount - Вывести список адресов, принадлежащих указанному аккаунту. Параметр - имя аккаунта, результат - список bitcoin-адресов в формате JSON. getaccountaddress - Сгенерировать еще один адрес для указанного аккаунта. Параметр - имя аккаунта, результат - строка с bitcoin-адресом. getbalance - Вывести баланс аккаунта для указанного количества подтверждений. Первый необязательный параметр - имя аккаунта, второй необязательный параметр - количество подтверждений, результат - положительное или отрицательное число c 8ю знаками после точки. getblockcount - Вывести текущее колиечество блоков. Результат - целое число. getconnectioncount - Вывести текущее количество соединений. Результат - целое число. getdifficulty - Вывести текущую сложность. Результат - число с 8ю знаками после точки. getgenerate - Вывести состояние генерации. Результат - true или false. getinfo - Вывести ряд текущих параметров в виде JSON-массива. getnewaddress - Сгенерировать еще один адрес для указанного аккаунта. Параметр - имя аккаунта, результат - строка с bitcoin-адресом. getreceivedbyaccount - Вывести общее количество принятых средств на аккаунт без учета отправленных. Первый параметр - имя аккаунта, второй необязательный параметр - количество подтверждений, результат - число с 8ю знаками после точки. getreceivedbyaddress - Вывести список входящих транзакций на указанный адрес. Первый параметр - bitcoin-адрес, второй необязательный параметр - количество подтверждений, результат - JSON массив с входящими транзакциями на указанный адрес. gettransaction - Вывести информацию по транзакции. help - Вывести список доступных комманд или описание команды, если она указана аргументом. listaccounts - Вывести список аккаунтов с балансом на них. Результат - JSON-массив. listreceivedbyaccount - Вывести JSON-массив с аккантами, общим количеством принятых на них средств без учета отправленных и количеством подтверждений. listreceivedbyaddress - Тожесамое, но с детализацией по bitcoin-адресам. listtransactions - Вывести список транзакций в JSON формате. move - Перевести средства с одного аккаунта на другой без осуществления транзакции в сети. sendfrom - Отправить сресдва с указанного аккаунта. sendmany - Отправить сресдва с указанного аккаунта на множество адресов. sendtoaddress - Отправить средства с аккаунта по умолчанию. setaccount - Сделать адрес принадлежащим аккаунту. setgenerate - Включить/выключить генерацию блоков. Параметр - true или false, не возвращает ничего. settxfee - Установить комиссию. signmessage - Подписать сообщение, полезно для подтверждения принадлежности адреса. stop - Остановить демон. До полной остановки должно пройти какое-то время. validateaddress - Проверить правильность адреса. Так же возвращает аккаунт, которому он принадлежит, если таковой имеется. verifymessage - Проверить подпись сообщения.