Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions _compress_images_cache.yml
Original file line number Diff line number Diff line change
Expand Up @@ -1468,6 +1468,16 @@ assets/images/guide/how-it-works/lightning-services/Offline-payment-mobile.png:
assets/images/guide/how-it-works/lightning-services/Offline-payment-mobile@2x.png: Offline-payment-mobile@2x.png
assets/images/guide/how-it-works/lightning-services/Offline-payment.png: Offline-payment.png
assets/images/guide/how-it-works/lightning-services/Offline-payment@2x.png: Offline-payment@2x.png
assets/images/guide/glossary/address/address-compact.png: address-compact.png
assets/images/guide/glossary/address/address-compact@2x.png: address-compact@2x.png
assets/images/guide/glossary/address/address-expanded.png: address-expanded.png
assets/images/guide/glossary/address/address-expanded@2x.png: address-expanded@2x.png
assets/images/guide/glossary/address/address-invalid.png: address-invalid.png
assets/images/guide/glossary/address/address-invalid@2x.png: address-invalid@2x.png
assets/images/guide/glossary/address/address-valid.png: address-valid.png
assets/images/guide/glossary/address/address-valid@2x.png: address-valid@2x.png
assets/images/guide/glossary/address/address-reuse.png: address-reuse.png
assets/images/guide/glossary/address/address-reuse@2x.png: address-reuse@2x.png
assets/images/guide/resources/design-files/bitcoin-for-local-business-trifold.png: bitcoin-for-local-business-trifold.png
assets/images/guide/resources/design-files/bitcoin-for-local-business-trifold@2x.png: bitcoin-for-local-business-trifold@2x.png
assets/images/guide/daily-spending-wallet/sending/confirm-high-fees.png: confirm-high-fees.png
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
51 changes: 50 additions & 1 deletion guide/glossary/address.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,14 @@ parent: Glossary
nav_order: 1
permalink: /guide/glossary/address/
main_classes: -no-top-padding
image_base: /assets/images/guide/glossary/address/
images_validation:
- file: address-valid
alt: Send confirmation screen with a checkbox next to the address
caption: Confirmation that an address is valid can be subtle.
- file: address-invalid
alt: Send confirmation screen with the address highlighted in red and disabled send button
caption: Invalid addresses should be clearly highlighted and sending should not be possible.
---

<!--
Expand Down Expand Up @@ -99,9 +107,50 @@ The receiver should then have the ability to switch to a Script or Taproot addre

</div>

## Visual formatting

<div class="center" markdown="1">

{% include image.html
image = "/assets/images/guide/glossary/address/address-expanded.png"
retina = "/assets/images/guide/glossary/address/address-expanded@2x.png"
width = 250
height = 541
caption = "Visual formatting can make it easier to compare addresses character by character."
alt-text = "Screen showing a modal with a bitcoin address in large type."
layout = "float-right-desktop -background -shadow"
%}

Handling addresses can be stressful when sending bitcoin. Transactions cannot be reversed, and sending to an incorrect address may mean loss of funds. While address formats are what they are, visual formatting can make it easier for users to compare addresses and ensure their accuracy.

Especially when addresses are displayed in a compacted way, make sure to offer a more easily readable alternative. Spacing, subtle coloration, and use of mono-space fonts help users identify chunks of the address to compare, and distinguish characters better.

</div>

## Address validation

Validation with visual feedback can reduce user anxiety about making mistakes. While addresses look like randomly assembled characters, there are patterns that can be used to identify whether an address is valid or not. For [segwit]({{'/guide/glossary/address/#segwit-address---p2wpkh' | relative_url}}) and [taproot]({{'/guide/glossary/address/#taproot-address---p2tr' | relative_url}}) addresses, it may be possible to identify which characters are incorrect. However, there are limits to this. Too many mistakes may result in an address that is valid but different from what the user intended to enter.

{% include image-gallery.html pages = page.images_validation %}


## Address reuse

Address reuse is the practice of receiving more than one transaction to a single bitcoin address. Although there are obvious usability benefits of reusing an address, this practice is not recommended due to the negative impact on privacy and security. Reusing an address makes it easier to correlate transactions with a particular user, thus hurting the pseudonymity of the user and thus the overall censorship resistance of the network. More on address re-use [here](https://en.bitcoin.it/wiki/Address_reuse)
<div class="center" markdown="1">

{% include image.html
image = "/assets/images/guide/glossary/address/address-reuse.png"
retina = "/assets/images/guide/glossary/address/address-reuse@2x.png"
width = 250
height = 541
caption = "Address reuse can be highlighted and explained to users so they can make an informed decision."
alt-text = "Screen showing a modal advising against bitcoin address re-use."
layout = "float-right-desktop -background -shadow"
%}

Address reuse is the practice of receiving more than one transaction to a single bitcoin address. Although there are obvious usability benefits of reusing an address, this practice is not recommended due to the negative impact on privacy and security. Reusing an address makes it easier to correlate transactions with a particular user, thus hurting the pseudonymity of the user and thus the overall censorship resistance of the network. More on address reuse [here](https://en.bitcoin.it/wiki/Address_reuse).

</div>

---

Expand Down