Команды консоли RPC кошелька Bitcoin core - списки вызовов API клиента Bitcoin-qt
В этой статье мы расскажем про некоторые основные команды, которые вы можете использовать для взаимодействия с консолью RPC Bitcoin core.
Клиент QT Bitcoin core - это оригинальный Биткойн-кошелек. Он имеет функции, которых нет у большинства других Биткойн-кошельков. Bitcoin core обеспечивает высокий уровень конфиденциальности, безопасности и стабильности.
Кошелек доступен для следующих операционных систем: Windows, Mac и Linux. Если на вашем компьютере еще не установлен Bitcoin core, вы можете скачать его отсюда.
Перед загрузкой и установкой обязательно проверьте пропускную способность и место на жестком диске (SSD).
Core Walle должен полностью подтверждать транзакции и блоки – поэтому он выкачивает весь блокчейн криптовалюты Bitcoin.
На момент написания этой статьи минимальные требования к месту на диске для работы Bitcoin core составляют более 350 ГБ. Он обрабатывает огромные объемы данных, поэтому убедитесь, что у вас хорошее подключение к Интернету.
Графический интерфейс Bitcoin core и CLI / API
После загрузки и установки кошелька дождитесь его полной синхронизации. Если у вас возникли проблемы с синхронизацией кошелька, ознакомьтесь с этим руководством:
После полной синхронизации ваш кошелек готов к использованию, и вы можете начать взаимодействие с ним.
Программное обеспечение Core wallet имеет как графический интерфейс (GUI), так и консольный интерфейс (CLI).
Графический интерфейс удобен для новичков. Можно легко и быстро просматривать текущий баланс, последние транзакции, отправлять и получать монеты BTC, настраивать комиссии, есть контроль монет и некоторые другие основные функции.
Но чтобы использовать программное обеспечение в полной мере и иметь полный контроль над своими Биткоинами, вам нужно научиться использовать окно консоли.
Далее мы покажем вам, как использовать окно консоли отладки в кошельке Bitcoin-qt.
Но, прежде чем вы перейдете к этому руководству и перед тем, как начнете вводить какие-либо команды в окне консоли, мы надеемся, что ваш кошелек зашифрован и у вас есть резервная копия.
Кошелек зашифрован и в данный момент заблокирован - правильная разблокировка кошелька
Как сделать резервную копию wallet.dat кошелька и перенести его на другой компьютер
Окно консоли 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.
ВНИМАНИЕ: существуют мошенники, которые просят пользователей вводить команды, которые крадут содержимое кошельков. Не используйте эту консоль, не понимая полностью смысл команды.
Как следует из предупреждения, не вводите команды, с которыми вы не знакомы, и не передавайте никому информацию, которая в вашем окне консоли, особенно ту, которая включает кодовую фразу кошелька и приватные ключи.
Команды консоли Bitcoin
Окно консоли Bitcoin RPC принимает множество команд. Введите «help». Вы увидите список команд, которые в настоящее время работают в консоли. Ниже мы перечислим все доступные команды.
Мы не будем вдаваться в подробности, чтобы познакомить вас с окном консоли, мы покажем несколько основных команд.
getblockcount
Отображает текущий блок
653646
getbalance
Отображает общий доступный баланс вашего кошелька
0,00000000
getconnectioncount
Отображает количество активных подключений к сети Биткойн.
10
getwalletinfo
Отображает объект, содержащий информацию о вашем кошельке
{
"walletname": "",
"walletversion": xxxxxxx,
"balance": 0.00000000,
"unconfirmed_balance": 0.00000000,
"immature_balance": 0.00000000,
"txcount": 0,
"keypoololdest": xxxxxxxxxx,
"keypoolsize": xxxx,
"hdseedid": "xxxxxxxxxxxxxxxxxxxxxxxxxx",
"keypoolsize_hd_internal": xxxx,
"unlocked_until": x,
"paytxfee": 0.00000000,
"private_keys_enabled": true,
"avoid_reuse": false,
"scanning": false
}
getblockchaininfo
Отображает информацию о текущем блокчейне Биткойна. Вы можете использовать эту команду для определения размера блокчейна, сложности и т. д.
{
"chain": "main",
"blocks": 653527,
"headers": 653587,
"bestblockhash": "0000000000000000000313ef2b2930ecbc3fe05de391bc439xxxxxxxxxxxxxx",
"difficulty": 19996789994446.11,
"mediantime": yyyyyyyyyyyy,
"verificationprogress": 0.4544565953577,
"initialblockdownload": false,
"chainwork": "0000000000000000000000000000000000000000454dff6n25j34597dfvjkn45",
"size_on_disk": 656738766,
"pruned": true,
"pruneheight": 653202,
"automatic_pruning": true,
"prune_target_size": 576716800,
"softforks": {
"bip34": {
"type": "buried",
"active": true,
"height": 227931
},
"bip66": {
"type": "buried",
"active": true,
"height": 363725
},
"bip65": {
"type": "buried",
"active": true,
"height": 388381
},
"csv": {
"type": "buried",
"active": true,
"height": 419328
},
"segwit": {
"type": "buried",
"active": true,
"height": 481824
}
},
"warnings": ""
}
Вы также можете использовать команду
getmininginfo
Чтобы получить более точную информацию о количестве блоков, текущей сложности сети и найти количество транзакций в пуле транзакций (mempool).
{
"blocks": 653597,
"difficulty": 19994576894446.11,
"networkhashps": 1.24389066767887e+020,
"pooledtx": 1637,
"chain": "main",
"warnings": ""
}
Есть много информации, которую вы можете получить из окна консоли Bitcoin core, используя команды, перечисленные ниже.
Вам не обязательно знать все эти команды. Однако, если вы разработчик и хотите разрабатывать приложения Биткойн, такие как block explorer или пулы для майнинга, понимание этих команд имеет важное значение.
Консоль RPC - отличный способ узнать о блокчейне Биткойн, сети, транзакциях и информации о майнинге.
Список команд консоли Bitcoin Core
Ниже мы пречислим все команды, которые нужны для различных решений: Блокчейн, Контроль, Создание (кошелька), Майнинг, Сеть (информация), Необработанные транзакции, Утилита, Кошелек, Zmq.
Блокчейн
Ниже перечислены все команды для блокчейн проверок
getbestblockhash
getblock "blockhash" ( verbosity )
getblockchaininfo
getblockcount
getblockhash (высота)
getblockheader "blockhash" ( verbose )
getblockstats hash_or_height ( stats )
getchaintips
getchaintxstats ( nblocks "blockhash" )
getdifficulty
getmempoolancestors "txid" ( verbose )
getmempooldescendants "txid" ( verbose )
getmempoolentry "txid"
getmempoolinfo
getrawmempool ( verbose )
gettxout "txid" n ( include_mempool )
gettxoutproof ["txid",...] ( "blockhash" )
gettxoutsetinfo
preciousblock "blockhash"
pruneblockchain height
savemempool
scantxoutset "action" ( [scanobjects,...] )
verifychain ( checklevel nblocks )
verifytxoutproof "proof"
Контроль
Команды контроля
getmemoryinfo ( "mode" )
getrpcinfo
help ( "command" )
logging ( ["include_category",...] ["exclude_category",...] )
stop
uptime
Создание
Команды создания кошелька и другие функции
generatetoaddress nblocks "address" ( maxtries )
generatetodescriptor num_blocks "descriptor" ( maxtries )
Майнинг
Команды для майнинга
getblocktemplate ( "template_request" )
getmininginfo
getnetworkhashps ( nblocks height )
prioritisetransaction "txid" ( dummy ) fee_delta
submitblock "hexdata" ( "dummy" )
submitheader "hexdata"
Сеть
Команды сети
addnode "node" "command"
clearbanned
disconnectnode ( "address" nodeid )
getaddednodeinfo ( "node" )
getconnectioncount
getnettotals
getnetworkinfo
getnodeaddresses ( count )
getpeerinfo
listbanned
ping
setban "subnet" "command" ( bantime absolute )
setnetworkactive state
Необработанные транзакции
Список команд
analyzepsbt "psbt"
combinepsbt ["psbt",...]
combinerawtransaction ["hexstring",...]
converttopsbt "hexstring" ( permitsigdata iswitness )
createpsbt [{"txid":"hex","vout":n,"sequence":n},...] [{"address":amount},{"data":"hex"},...] ( locktime replaceable )
createrawtransaction [{"txid":"hex","vout":n,"sequence":n},...] [{"address":amount},{"data":"hex"},...] ( locktime replaceable )
decodepsbt "psbt"
decoderawtransaction "hexstring" ( iswitness )
decodescript "hexstring"
finalizepsbt "psbt" ( extract )
fundrawtransaction "hexstring" ( options iswitness )
getrawtransaction "txid" ( verbose "blockhash" )
joinpsbts ["psbt",...]
sendrawtransaction "hexstring" ( maxfeerate )
signrawtransactionwithkey "hexstring" ["privatekey",...] ( [{"txid":"hex","vout":n,"scriptPubKey":"hex","redeemScript":"hex","witnessScript":"hex","amount":amount},...] "sighashtype" )
testmempoolaccept ["rawtx",...] ( maxfeerate )
utxoupdatepsbt "psbt" ( ["",{"desc":"str","range":n or [n,n]},...] )
Утилиты
Список команд
createmultisig nrequired ["key",...] ( "address_type" )
deriveaddresses "descriptor" ( range )
estimatesmartfee conf_target ( "estimate_mode" )
getdescriptorinfo "descriptor"
signmessagewithprivkey "privkey" "message"
validateaddress "address"
verifymessage "address" "signature" "message"
Кошелек
Список команд
abandontransaction "txid"
abortrescan
addmultisigaddress nrequired ["key",...] ( "label" "address_type" )
backupwallet "destination"
bumpfee "txid" ( options )
createwallet "wallet_name" ( disable_private_keys blank "passphrase" avoid_reuse )
dumpprivkey "address"
dumpwallet "filename"
encryptwallet "passphrase"
getaddressesbylabel "label"
getaddressinfo "address"
getbalance ( "dummy" minconf include_watchonly avoid_reuse )
getbalances
getnewaddress ( "label" "address_type" )
getrawchangeaddress ( "address_type" )
getreceivedbyaddress "address" ( minconf )
getreceivedbylabel "label" ( minconf )
gettransaction "txid" ( include_watchonly verbose )
getunconfirmedbalance
getwalletinfo
importaddress "address" ( "label" rescan p2sh )
importmulti "requests" ( "options" )
importprivkey "privkey" ( "label" rescan )
importprunedfunds "rawtransaction" "txoutproof"
importpubkey "pubkey" ( "label" rescan )
importwallet "filename"
keypoolrefill ( newsize )
listaddressgroupings
listlabels ( "purpose" )
listlockunspent
listreceivedbyaddress ( minconf include_empty include_watchonly "address_filter" )
listreceivedbylabel ( minconf include_empty include_watchonly )
listsinceblock ( "blockhash" target_confirmations include_watchonly include_removed )
listtransactions ( "label" count skip include_watchonly )
listunspent ( minconf maxconf ["address",...] include_unsafe query_options )
listwalletdir
listwallets
loadwallet "filename"
lockunspent unlock ( [{"txid":"hex","vout":n},...] )
removeprunedfunds "txid"
rescanblockchain ( start_height stop_height )
sendmany "" {"address":amount} ( minconf "comment" ["address",...] replaceable conf_target "estimate_mode" )
sendtoaddress "address" amount ( "comment" "comment_to" subtractfeefromamount replaceable conf_target "estimate_mode" avoid_reuse )
sethdseed ( newkeypool "seed" )
setlabel "address" "label"
settxfee amount
setwalletflag "flag" ( value )
signmessage "address" "message"
signrawtransactionwithwallet "hexstring" ( [{"txid":"hex","vout":n,"scriptPubKey":"hex","redeemScript":"hex","witnessScript":"hex","amount":amount},...] "sighashtype" )
unloadwallet ( "wallet_name" )
walletcreatefundedpsbt [{"txid":"hex","vout":n,"sequence":n},...] [{"address":amount},{"data":"hex"},...] ( locktime options bip32derivs )
walletlock
walletpassphrase "passphrase" timeout
walletpassphrasechange "oldpassphrase" "newpassphrase"
walletprocesspsbt "psbt" ( sign "sighashtype" bip32derivs )
Zmq
Список команд
getzmqnotifications
Сейчас смотрят
