mirror of
https://github.com/seigler/dash-docs
synced 2025-07-27 17:56:16 +00:00
367 lines
12 KiB
Markdown
367 lines
12 KiB
Markdown
---
|
|
# This file is licensed under the MIT License (MIT) available on
|
|
# http://opensource.org/licenses/MIT.
|
|
|
|
id: bitcoin-core-user-interface
|
|
layout: base-core
|
|
lang: en
|
|
columns: 1
|
|
title: User Interface - Bitcoin Core Features
|
|
breadcrumbs:
|
|
- bitcoin
|
|
- bcc
|
|
- bcc features
|
|
- Interface
|
|
---
|
|
# Bitcoin Core's User Interface
|
|
{:.not-displayed}
|
|
|
|
|
|
|
|
{% include bitcoin-core/download-bitcoin-core.html %}
|
|
|
|
Bitcoin Core has a built in wallet with [graphical](#graphical) and
|
|
[command line/API](#cli) modes. It can also simultaneously support multiple
|
|
lightweight wallets with similar [security][bcc validation] and
|
|
[privacy][bcc privacy] to its built-in wallet.
|
|
|
|
|
|
|
|
**Warning:** you only get the security and privacy benefits in supported
|
|
lightweight wallets if they make a secure and private connection to your
|
|
Bitcoin Core *every* time you use them. This usually requires special
|
|
configuration.
|
|
|
|
## Bitcoin Core Wallet GUI (Graphical) {#graphical}
|
|
|
|
{% comment %}<!-- Limit to a maximum of 10 features to avoid overwhelming the reader -->{% endcomment %}
|
|
<div markdown="block" class="two-column-list">
|
|
|
|
{:.fa-ul}
|
|
- <span class="fa fa-li fa-desktop fa-2x"></span> **<button class="popup js" data-container="gui_overview">Clear overview</button>**<br
|
|
>See your current balance and recent transactions
|
|
|
|
- <span class="fa fa-li fa-toggle-on fa-2x"></span> **<button class="popup js" data-container="gui_fee_slider">Fee slider</button>**<br
|
|
>Easily choose between low fees and fast confirmation
|
|
|
|
- <span class="fa fa-li fa-btc fa-2x"></span> **<button class="popup js" data-container="gui_coin_control">Coin control</button>**<br
|
|
>Enhance privacy or save money by choosing your inputs
|
|
|
|
- <span class="fa fa-li fa-qrcode fa-2x"></span> **<button class="popup js" data-container="gui_qr_codes">QR codes</button>**<br
|
|
>Generate QR codes to receive payment
|
|
|
|
- <span class="fa fa-li fa-file-text-o fa-2x"></span> **<button class="popup js" data-container="gui_unique_invoices">Unique invoices</button>**<br
|
|
>Easily track who paid you
|
|
|
|
- <span class="fa fa-li fa-shield fa-2x"></span> **<button class="popup js" data-container="gui_proxy_configuration">Proxy configuration</button>**<br
|
|
>Use Tor or a proxy for privacy
|
|
|
|
- <span class="fa fa-li fa-bar-chart fa-2x"></span> **<button class="popup js" data-container="gui_network_monitoring">Network monitoring</button>**<br
|
|
>Track how much bandwidth you use
|
|
|
|
- <span class="fa fa-li fa-power-off fa-2x"></span> **<button class="popup js" data-container="gui_watch_only">Watch-only support</button>**<br
|
|
>Track bitcoins stored safely offline
|
|
|
|
</div>
|
|
<br class="clear">
|
|
|
|
|
|
## Bitcoin Core Wallet RPC/REST (CLI) {#cli}
|
|
|
|
{% comment %}<!-- Limit to a maximum of 10 features to avoid overwhelming the reader -->{% endcomment %}
|
|
|
|
<div markdown="block" class="two-column-list">
|
|
|
|
{:.fa-ul}
|
|
- <span class="fa fa-li fa-plus-square-o fa-2x"></span> **<button class="popup js" data-container="rpc_getnewaddress">GetNewAddress</button>**<br
|
|
>Get a new address for receiving payment
|
|
|
|
- <span class="fa fa-li fa-area-chart fa-2x"></span> **<button class="popup js" data-container="rpc_getbalance">GetBalance</button>**<br
|
|
>Instantly see your available Bitcoin balance
|
|
|
|
- <span class="fa fa-li fa-arrows fa-2x"></span> **<button class="popup js" data-container="rpc_sendmany">SendMany</button>**<br
|
|
>Send a single payment to multiple addresses
|
|
|
|
- <span class="fa fa-li fa-list fa-2x"></span> **<button class="popup js" data-container="rpc_listunspent">ListUnspent</button>**<br
|
|
>See what received transactions you can spend
|
|
|
|
- <span class="fa fa-li fa-share-square-o fa-2x"></span> **<button class="popup js" data-container="rpc_rawtx">Create/Sign/Send</button>**<br
|
|
>Create and send raw transactions
|
|
|
|
- <span class="fa fa-li fa-bell-o fa-2x"></span> **<button class="popup js" data-container="notification">Notification</button>**<br
|
|
>Be notified of new blocks and transactions
|
|
|
|
|
|
</div>
|
|
<br class="clear">
|
|
|
|
**Learn more:** documentation for the [RPC][rpc] and [REST][rest] interfaces
|
|
|
|
## Lightweight Wallets Using Bitcoin Core {#lightweight}
|
|
|
|
Lightweight wallets usually connect to several random full nodes (like
|
|
Bitcoin Core) to send and receive all of their data. In the process they
|
|
[leak private data][bcc privacy data leaking] and make themselves more
|
|
[vulnerable to attacks][bcc validation protection].
|
|
|
|
|
|
|
|
But it's also possible to connect certain lightweight wallets solely to
|
|
your own Bitcoin Core full node, called a trusted peer. If you do this
|
|
with a secure and private connection every time you use that
|
|
lightweight wallet, you'll get most of the security and privacy
|
|
benefits of a full node as well as [help protect decentralization][bcc
|
|
validation decentralization].
|
|
|
|
|
|
|
|
<br>
|
|
|
|
### Trusted Peer Support {#trusted-peer}
|
|
|
|
The following wallets can securely connect to a trusted peer.
|
|
|
|
<div markdown="block" class="wallet_accordion">
|
|
{% comment %}<!-- Put wallets in alphabetical order -->{% endcomment %}
|
|
|
|
### Armory
|
|
|
|
<div markdown="block">
|
|
|
|
|
|
{% translate walletarmory choose-your-wallet %}
|
|
|
|
**No configuration necessary:** Armory uses a local Bitcoin Core full
|
|
node by default.
|
|
|
|
{% comment %}
|
|
<!-- TODO/Someday: move wallet yaml into _data directory so we can pull
|
|
URLs and other info from it -->
|
|
{% endcomment %}
|
|
|
|
{:.right-hanger}
|
|
[Get Armory <span class="fa fa-external-link-square"></span>](https://bitcoinarmory.com/)
|
|
|
|
</div>
|
|
|
|
### GreenBits
|
|
|
|
<div markdown="block">
|
|
|
|
|
|
GreenBits is a fast and easy to use wallet. Enjoy improved security with
|
|
a minimal/zero trust approach, optional hardware wallets support,
|
|
multisignature based 2FA and spending limits functionality.
|
|
|
|
**Requires you setup a [Tor .onion address][bcc tor hs].**
|
|
|
|
1. Open the GreenBits app
|
|
|
|
2. Go to the configuration screen
|
|
|
|
3. Choose to *Enable SPV* (default) and tap *Only connect to a
|
|
trusted peer*.
|
|
|
|
4. Enter your .onion address in the *trusted peer* field.
|
|
|
|
5. Restart the app.
|
|
|
|
Note that GreenAddress will still be able to see your payments; however,
|
|
you'll have enhanced security as well as privacy from random peers on
|
|
the Bitcoin network.
|
|
|
|
{:.right-hanger}
|
|
[Get GreenBits <span class="fa fa-external-link-square"></span>](https://play.google.com/store/apps/details?id=com.greenaddress.greenbits_android_wallet)
|
|
</div>
|
|
|
|
### mSigna
|
|
|
|
<div markdown="block">
|
|
|
|
|
|
{% translate walletmsigna choose-your-wallet %}
|
|
|
|
**No configuration necessary:** just install Bitcoin Core on the same
|
|
computer you plan to use mSigna, wait for Bitcoin Core to sync the block
|
|
chain, and then start mSigna---it will automatically connect to your
|
|
Bitcoin Core full node.
|
|
|
|
{:.right-hanger}
|
|
[Get mSigna <span class="fa fa-external-link-square"></span>](https://ciphrex.com/redirect/?referer=bitcoin.org)
|
|
</div>
|
|
|
|
</div>
|
|
|
|
<div class="not-displayed">
|
|
<div id="gui_overview" title="Wallet Overview" markdown="block">
|
|
|
|
</div>
|
|
|
|
<div id="gui_fee_slider" title="Fee Slider" markdown="block">
|
|
|
|
</div>
|
|
|
|
<div id="gui_coin_control" title="Coin Control" markdown="block">
|
|
|
|
</div>
|
|
|
|
<div id="gui_qr_codes" title="QR Codes" markdown="block">
|
|
|
|
</div>
|
|
|
|
<div id="gui_unique_invoices" title="Unique Invoices" markdown="block">
|
|
|
|
</div>
|
|
|
|
<div id="gui_proxy_configuration" title="Proxy Configuration" markdown="block">
|
|
|
|
</div>
|
|
|
|
<div id="gui_network_monitoring" title="Network monitoring" markdown="block">
|
|
|
|
</div>
|
|
|
|
<div id="gui_watch_only" title="Watching-only Wallets" markdown="block">
|
|
|
|
</div>
|
|
|
|
<div id="rpc_getnewaddress" title="GetNewAddress" markdown="block">
|
|
<div class="multicode" markdown="block">
|
|
{% highlight bash %}
|
|
bitcoin-cli -testnet getnewaddress "doc test"
|
|
{% endhighlight %}
|
|
{% highlight text %}
|
|
mft61jjkmiEJwJ7Zw3r1h344D6aL1xwhma
|
|
{% endhighlight %}
|
|
</div>
|
|
</div>
|
|
|
|
<div id="rpc_getbalance" title="GetBalance" markdown="block">
|
|
<div class="multicode" markdown="block">
|
|
{% highlight bash %}
|
|
bitcoin-cli -testnet getbalance
|
|
{% endhighlight %}
|
|
{% highlight json %}
|
|
1.99900000
|
|
{% endhighlight %}
|
|
</div>
|
|
</div>
|
|
|
|
<div id="rpc_sendmany" title="SendMany" markdown="block">
|
|
<div class="multicode" markdown="block">
|
|
{% highlight bash %}
|
|
bitcoin-cli -testnet sendmany \
|
|
"test1" \
|
|
'''
|
|
{
|
|
"mjSk1Ny9spzU2fouzYgLqGUD8U41iR35QN": 0.1,
|
|
"mgnucj8nYqdrPFh2JfZSB1NmUThUGnmsqe": 0.2
|
|
} ''' \
|
|
6 \
|
|
"Example Transaction"
|
|
{% endhighlight %}
|
|
{% highlight text %}
|
|
ec259ab74ddff199e61caa67a26e29b13b5688dc60f509ce0df4d044e8f4d63d
|
|
{% endhighlight %}
|
|
</div>
|
|
</div>
|
|
|
|
<div id="rpc_listunspent" title="ListUnspent" markdown="block">
|
|
<div class="multicode" markdown="block">
|
|
{% highlight bash %}
|
|
bitcoin-cli -testnet listunspent 6 99999999 '''
|
|
[
|
|
"mgnucj8nYqdrPFh2JfZSB1NmUThUGnmsqe"
|
|
]
|
|
'''
|
|
{% endhighlight %}
|
|
{% highlight json %}
|
|
[
|
|
{
|
|
"txid" : "d54994ece1d11b19785c7248868696250ab195605b469632b7bd68130e880c9a",
|
|
"vout" : 1,
|
|
"address" : "mgnucj8nYqdrPFh2JfZSB1NmUThUGnmsqe",
|
|
"account" : "test label",
|
|
"scriptPubKey" : "76a9140dfc8bafc8419853b34d5e072ad37d1a5159f58488ac",
|
|
"amount" : 0.00010000,
|
|
"confirmations" : 6210,
|
|
"spendable" : true
|
|
}
|
|
]
|
|
{% endhighlight %}
|
|
</div>
|
|
</div>
|
|
|
|
<div id="rpc_rawtx" title="Create/Sign/Spent Raw Transactions" markdown="block">
|
|
Create a raw transaction:
|
|
|
|
<div class="multicode" markdown="block">
|
|
{% highlight bash %}
|
|
bitcoin-cli -testnet createrawtransaction '''
|
|
[
|
|
{
|
|
"txid": "1eb590cd06127f78bf38ab4140c4cdce56ad9eb8886999eb898ddf4d3b28a91d",
|
|
"vout" : 0
|
|
}
|
|
]''' '{ "mgnucj8nYqdrPFh2JfZSB1NmUThUGnmsqe": 0.13 }'
|
|
{% endhighlight %}
|
|
{% highlight text %}
|
|
01000000011da9283b4ddf8d89eb996988b89ead56cecdc44041ab38bf787f1206cd90b51e0000000000ffffffff01405dc600000000001976a9140dfc8bafc8419853b34d5e072ad37d1a5159f58488ac00000000
|
|
{% endhighlight %}
|
|
</div>
|
|
|
|
Sign the above raw transaction:
|
|
|
|
<div class="multicode" markdown="block">
|
|
{% highlight bash %}
|
|
bitcoin-cli -testnet signrawtransaction 01000000011da9283b4ddf8d\
|
|
89eb996988b89ead56cecdc44041ab38bf787f1206cd90b51e0000000000ffff\
|
|
ffff01405dc600000000001976a9140dfc8bafc8419853b34d5e072ad37d1a51\
|
|
59f58488ac00000000
|
|
{% endhighlight %}
|
|
{% highlight json %}
|
|
{
|
|
"hex" : "01000000011da9283b4ddf8d89eb996988b89ead56cecdc44041ab38bf787f1206cd90b51e000000006a47304402200ebea9f630f3ee35fa467ffc234592c79538ecd6eb1c9199eb23c4a16a0485a20220172ecaf6975902584987d295b8dddf8f46ec32ca19122510e22405ba52d1f13201210256d16d76a49e6c8e2edc1c265d600ec1a64a45153d45c29a2fd0228c24c3a524ffffffff01405dc600000000001976a9140dfc8bafc8419853b34d5e072ad37d1a5159f58488ac00000000",
|
|
"complete" : true
|
|
}
|
|
{% endhighlight %}
|
|
</div>
|
|
|
|
Send the above signed raw transaction:
|
|
|
|
<div class="multicode" markdown="block">
|
|
{% highlight bash %}
|
|
bitcoin-cli -testnet sendrawtransaction 01000000011da9283b4ddf8d\
|
|
89eb996988b89ead56cecdc44041ab38bf787f1206cd90b51e000000006a4730\
|
|
4402200ebea9f630f3ee35fa467ffc234592c79538ecd6eb1c9199eb23c4a16a\
|
|
0485a20220172ecaf6975902584987d295b8dddf8f46ec32ca19122510e22405\
|
|
ba52d1f13201210256d16d76a49e6c8e2edc1c265d600ec1a64a45153d45c29a\
|
|
2fd0228c24c3a524ffffffff01405dc600000000001976a9140dfc8bafc84198\
|
|
53b34d5e072ad37d1a5159f58488ac00000000
|
|
{% endhighlight %}
|
|
{% highlight text %}
|
|
f5a5ce5988cc72b9b90e8d1d6c910cda53c88d2175177357cc2f2cf0899fbaad
|
|
{% endhighlight %}
|
|
</div>
|
|
|
|
The returned value is the transaction's identifier (TXID).
|
|
</div>
|
|
|
|
<div id="notification" title="Programmable Notification" markdown="block">
|
|
<div class="multicode" markdown="block">
|
|
{% highlight bash %}
|
|
bitcoind -daemon -walletnotify=your_notification_command
|
|
{% endhighlight %}
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
<br class="clear big">
|
|
<div class="prevnext">
|
|
<span markdown="1">**Previous Feature**<br>[Requirements][bcc requirements]</span>
|
|
<span markdown="1">**Next feature**<br>[Network Support][bcc network support]</span>
|
|
</div>
|
|
<br class="clear">
|
|
|
|
{% include references.md %}
|