Polecenia konsoli RPC dla portfela podstawowego Bitcoin – listy wywołań API klienta Bitcoin-qt

W tym artykule przedstawimy niektóre z podstawowych poleceń, których możesz użyć do interakcji z podstawową konsolą RPC Bitcoin.

Bitcoin core klient QT to oryginalny portfel Bitcoin i pełny węzeł, który ma funkcje, których nie ma większość innych portfeli Bitcoin. Tworzy szkielet sieci. Oferuje pełną walidację i wysoki poziom prywatności, bezpieczeństwa i stabilności.

Portfel jest dostępny dla systemów Windows, Mac i Linux. Jeśli nie masz jeszcze rdzenia Bitcoin zainstalowanego na swoim komputerze, możesz pobrać go stąd. https://bitcoin.org/en/download

Przed pobraniem i zainstalowaniem sprawdź przepustowość i miejsce. Podstawowy portfel musi w pełni weryfikować transakcje i bloki. W chwili pisania tego artykułu minimalne wymagania dotyczące miejsca na dysku do uruchomienia rdzenia Bitcoin to ponad 350 GB. Pobiera ogromne ilości danych, więc upewnij się, że masz dobre połączenie internetowe i wymagania dotyczące przepustowości.

Zobacz pełne podstawowe wymagania systemowe Bitcoin i koszty operacyjne tutaj: https://bitcoin.org/en/bitcoin-core/features/requirements

Sprawdź także sumę kontrolną portfela przed zainstalowaniem i użyciem.

Wskazówka dla profesjonalistów: Jeśli nie masz wystarczającej ilości miejsca na dysku, możesz uruchomić rdzeń Bitcoin w trybie przycinania.

Graficzny interfejs użytkownika i interfejs CLI / API z rdzeniem Bitcoin

Po pobraniu i zainstalowaniu portfela poczekaj, aż zostanie całkowicie zsynchronizowany. Jeśli masz problemy z synchronizacją portfela, zapoznaj się z tym przewodnikiem dotyczącym problemu z brakiem synchronizacji portfela.

Po pełnej synchronizacji portfel jest gotowy do użycia i możesz rozpocząć interakcję z klientem.

Oprogramowanie portfela podstawowego ma zarówno GUI (graficzny interfejs użytkownika), jak i interfejs konsoli. GUI jest wygodne dla początkujących. Można przeglądać ich aktualne saldo, ostatnie transakcje, wysyłać, odbierać Bitcoiny, regulować opłaty, kontrolować monety i inne podstawowe funkcje.

Ale aby w pełni wykorzystać potencjał oprogramowania i mieć pełną kontrolę nad swoimi Bitcoinami, musisz nauczyć się korzystać z okna konsoli.

Tutaj pokażemy, jak korzystać z okna konsoli debugowania w portfelu Bitcoin-qt.

Teraz, zanim przejdziesz do tego przewodnika i zanim wprowadzisz jakiekolwiek polecenia w oknie konsoli, mamy nadzieję, że Twój portfel jest zaszyfrowany i masz kopię zapasową.

Aby dowiedzieć się, jak szyfrować, zapoznaj się z tym przewodnikiem dla początkujących dotyczących portfela podstawowego. Również jeśli nie wiesz, oto przewodnik dotyczący tworzenia kopii zapasowych i przywracania portfela podstawowego.

Okno konsoli rdzenia Bitcoin

W starszej wersji klienta Bitcoin powinieneś zobaczyć okno debugowania w Pomocy > Okno debugowania, w którym możesz rozpocząć wprowadzanie poleceń bitcoin-cli.

W najnowszej wersji rozwijane menu windows i otwórz okno konsoli.

Powinieneś zobaczyć następujące ostrzeżenie.

Witamy w konsoli RPC Bitcoin Core.

Użyj strzałek w górę i w dół, aby poruszać się po historii, i Ctrl-L, aby wyczyścić ekran.

Wpisz pomoc, aby zapoznać się z przeglądem dostępnych poleceń.

Aby uzyskać więcej informacji na temat korzystania z tej konsoli typu help-console.

OSTRZEŻENIE: Oszuści byli aktywni, nakazując użytkownikom wpisywanie tutaj poleceń, kradnąc zawartość ich portfela. Nie używaj tej konsoli bez pełnego zrozumienia konsekwencji polecenia.

Jak sugeruje ostrzeżenie, nie wpisuj komentarzy, których nie znasz i nie udostępniaj nikomu informacji, które zwraca okno konsoli, szczególnie tej, która obejmuje hasło do portfela i klucze prywatne.

Polecenia konsoli Bitcoin

Okno konsoli Bitcoin RPC akceptuje różne polecenia. Wpisz pomoc i wprowadź. Powinieneś zobaczyć listę poleceń, które są obecnie akceptowane przez konsolę. Poniżej udostępniliśmy wszystkie dostępne listy poleceń.

Nie będziemy się tym szczegółowo zajmować. Aby zapoznać się z oknem konsoli, pokażemy Ci kilka podstawowych poleceń.

> getblockcount

Zwraca bieżący najlepszy indeks bloku

653646

> zrównoważyć

Wyświetla całkowite dostępne saldo w portfelu

0,00000000

> getconnectioncount

Zwraca liczbę aktywnych połączeń z siecią Bitcoin

10

> getwalletinfo

Zwraca obiekt zawierający informacje o Twoim portfelu

{

"nazwa portfela": "",

"wersja portfela": xxxxxxx,

"saldo": 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": prawdziwe,

"unikaj ponownego użycia": fałszywy,

"łów": fałszywy

}

> getblockchaininfo

Zwraca informacje o aktualnym łańcuchu bloków Bitcoin. Możesz użyć tego polecenia, aby zidentyfikować rozmiar łańcucha bloków, poziom trudności itp.

{

"łańcuch": "Główny",

"Bloki": 653527,

"nagłówki": 653587,

"bestblockhash": "0000000000000000000313ef2b2930ecbc3fe05de391bc439xxxxxxxxxxxxxx",

"trudność": 19996789994446.11,

"mediantime": yyyyyyyyyyyy,

"postęp weryfikacji": 0,4544565953577,

"initialblockdownload": fałszywy,

"praca łańcuchowa": "0000000000000000000000000000000000000000454dff6n25j34597dfvjkn45",

"rozmiar dysku": 656738766,

"przycięte": prawdziwe,

"śliwka": 653202,

"automatyczne_pruning": prawdziwe,

"prune_target_size": 576716800,

"softforks": {

"bip34": {

"rodzaj": "pochowany",

"aktywny": prawdziwe,

"wysokość": 227931

},

"bip66": {

"rodzaj": "pochowany",

"aktywny": prawdziwe,

"wysokość": 363725

},

"bip65": {

"rodzaj": "pochowany",

"aktywny": prawdziwe,

"wysokość": 388381

},

"csv": {

"rodzaj": "pochowany",

"aktywny": prawdziwe,

"wysokość": 419328

},

"segwit": {

"rodzaj": "pochowany",

"aktywny": prawdziwe,

"wysokość": 481824

}

},

"ostrzeżenia": ""

}

Możesz także użyć polecenia

> getmininginfo

Aby uzyskać dokładniejsze informacje o liczbie bloków, bieżącym poziomie trudności sieci i znaleźć liczbę transakcji w puli transakcji (mempool).

{

"Bloki": 653597,

"trudność": 19994576894446.11,

"sieciowe": 1.24389066767887e + 020,

"pooledtx": 1637,

"łańcuch": "Główny",

"ostrzeżenia": ""

}

Istnieje wiele informacji, które możesz pobrać z podstawowego okna konsoli Bitcoin za pomocą poleceń wymienionych poniżej. Nie musisz znać wszystkich tych poleceń. Jeśli jednak jesteś programistą i chcesz tworzyć aplikacje Bitcoin, takie jak eksplorator bloków lub pule wydobywcze, zrozumienie tych poleceń jest niezbędne.

Konsola RPC to świetny sposób na poznanie łańcucha bloków Bitcoin, sieci, transakcji i informacji wydobywczych.

Lista poleceń konsoli

• == Blockchain ==

getbestblockhash

getblock "blockhash" (gadatliwość)

getblockchaininfo

getblockcount

getblockfilter "blockhash" ( "typ filtra" )

getblockhash height

getblockheader "blockhash" (gadatliwy)

getblockstats hash_or_height (statystyki)

getchaintips

getchaintxstats (nblocks "blockhash" )

getdifficulty

getmempoolancestors "txid" (gadatliwy)

getmempooldescendants "txid" (gadatliwy)

getmempoolentry "txid"

getmempoolinfo

getrawmempool (rozwlekłe)

gettxout "txid" n (include_mempool)

gettxoutproof ["txid",…] ( "blockhash" )

gettxoutsetinfo

cenny blok "blockhash"

wysokość pruneblockchain

savemempool

scantxoutset "akcja" ([scanobjects, …])

verifychain (nblocks poziomu kontrolnego)

verifytxoutproof "dowód"

• == Kontrola ==

getmemoryinfo ( "tryb" )

getrpcinfo

Wsparcie ( "Komenda" )

Logowanie ( ["include_category",…] ["exclude_category",…])

zatrzymać

uptime

• == Generowanie ==

generatetoaddress nblocks "adres" (maxtries)

generatetodescriptor num_blocks "deskryptor" (maxtries)

• == Górnictwo ==

getblocktemplate ( "template_request" )

getmininginfo

getnetworkhashps (wysokość nblocków)

Prioritisetransaction "txid" (atrapa) fee_delta

submitblock "hexdata" ( "manekin" )

submitheader "hexdata"

• == Sieć ==

addnode "węzeł" "Komenda"

wyraźnie zbanowany

rozłącznik ( "adres" nodeid)

getaddednodeinfo ( "węzeł" )

getconnectioncount

getnettotals

getnetworkinfo

getnodeaddresses (liczba)

getpeerinfo

listbanned

świst

setban "podsieć" "Komenda" (absolut bantime)

setnetworkactive state

• == Rawtransactions ==

analepsbt "psbt"

combinepsbt ["psbt",…]

combinerawtransaction ["szesnastkowy",…]

converttopsbt "szesnastkowy" (dozwolone dane są świadkiem)

createpsbt [{"txid":"klątwa","vout": n,"sekwencja": n}, …] [{"adres":ilość},{"dane":"klątwa"}, …] (możliwość wymiany czasu blokady)

createrawtransaction [{"txid":"klątwa","vout": n,"sekwencja": n}, …] [{"adres":ilość},{"dane":"klątwa"}, …] (możliwość wymiany czasu blokady)

decodepsbt "psbt"

decoderawtransaction "szesnastkowy" (jest świadkiem)

decodescript "szesnastkowy"

finalizepsbt "psbt" ( wyciąg )

fundrawtransaction "szesnastkowy" (opcje to świadek)

getrawtransaction "txid" (gadatliwy "blockhash" )

joinpsbts ["psbt",…]

sendrawtransaction "szesnastkowy" (maxfeerate)

signrawtransactionwithkey "szesnastkowy" ["prywatny klucz",…] ([{"txid":"klątwa","vout": n,"scriptPubKey":"klątwa","redeemScript":"klątwa","świadek skryptów":"klątwa","ilość":ilość},…] "sighashtype" )

testmempoolaccept ["rawtx",…] (maxfeerate)

utxoupdatepsbt "psbt" (["",{"desc":"str","zasięg": n lub [n, n]}, …])

• == Util ==

createmultisig nrequired ["klucz",…] ( "Typ adresu" )

wyprowadzićadresy "deskryptor" ( zasięg )

oszacowaniamartfee ​​conf_target ( "estimate_mode" )

getdescriptorinfo "deskryptor"

signmessagewithprivkey "privkey" "wiadomość"

validateaddress "adres"

verifymessage "adres" "podpis" "wiadomość"

• == Portfel ==

zrezygnować z transakcji "txid"

abortrescan

addmultisigaddress nrequired ["klucz",…] ( "etykieta" "Typ adresu" )

backupwallet "Miejsce docelowe"

bumpfee "txid" (opcje)

createwallet "nazwa_portfela" (disable_private_keys puste "hasło" unikaj ponownego użycia)

dumpprivkey "adres"

dumpwallet "Nazwa pliku"

encryptwallet "hasło"

getaddressesbylabel "etykieta"

getaddressinfo "adres"

getbalance ( "manekin" minconf include_watchonly unique_reuse)

salda

getnewaddress ( "etykieta" "Typ adresu" )

getrawchangeaddress ( "Typ adresu" )

getreceivedbyaddress "adres" (minconf)

getreceivedbylabel "etykieta" (minconf)

gettransaction "txid" (include_watchonly verbose)

getunconfirmedbalance

getwalletinfo

importaddress "adres" ( "etykieta" przeskanuj p2sh)

importmulti "upraszanie" ( "opcje" )

importprivkey "privkey" ( "etykieta" ponowne skanowanie)

importprunedfunds "rawtransaction" "txoutproof"

importpubkey "pubkey" ( "etykieta" ponowne skanowanie)

importwallet "Nazwa pliku"

keypoolrefill (newsize)

listaddressgroupings

listlabels ( "cel, powód" )

listlockunspent

listreceivedbyaddress (minconf include_empty include_watchonly "address_filter" )

listreceivedbylabel (minconf include_empty include_watchonly)

listinceblock ( "blockhash" target_confirmations include_watchonly include_removed)

listtransactions ( "etykieta" count pomiń include_watchonly)

listunspent (minconf maxconf ["adres",…] include_unsafe query_options)

listwalletdir

listwallets

loadwallet "Nazwa pliku"

lockunspent unlock ([{"txid":"klątwa","vout": n}, …])

removeprunedfunds "txid"

rescanblockchain (start_height stop_height)

sendmany "" {"adres": amount} (minconf "komentarz" ["adres",…] wymienny conf_target "estimate_mode" )

sendtoaddress "adres" ilość ( "komentarz" "comment_to" odejmowanie od kwoty zastępowalnej conf_target "estimate_mode" unikaj ponownego użycia)

sethdseed (newkeypool "nasionko" )

setlabel "adres" "etykieta"

kwota ustalonej opłaty

setwalletflag "flaga" (wartość)

signmessage "adres" "wiadomość"

signrawtransactionwithwallet "szesnastkowy" ([{"txid":"klątwa","vout": n,"scriptPubKey":"klątwa","redeemScript":"klątwa","świadek skryptów":"klątwa","ilość":ilość},…] "sighashtype" )

unloadwallet ( "nazwa_portfela" )

walletcreatefundedpsbt [{"txid":"klątwa","vout": n,"sekwencja": n}, …] [{"adres":ilość},{"dane":"klątwa"}, …] (opcje czasu blokady bip32derivs)

portfel

walletpassphrase "hasło" koniec czasu

walletpassphrasechange "oldpassphrase" "newpassphrase"

walletprocesspsbt "psbt" ( znak "sighashtype" bip32derivs)

• == Zmq ==

getzmqnotifications

Pełną listę poleceń konsoli Bitcoin z wyjaśnieniem można znaleźć pod adresem https://developer.bitcoin.org/reference/rpc/

Również do sprawdzenia referencji: https://en.bitcoin.it/wiki/Original_Bitcoin_client/API_calls_list

Artykuł podobny do tego:

• Lista poleceń do zarządzania vps masternode
• Dodawanie węzłów portfela
• Tworzenie pliku konfiguracyjnego portfela podstawowego