diff --git a/_compress_images_cache.yml b/_compress_images_cache.yml
index 2be098d8b..4e5d14114 100644
--- a/_compress_images_cache.yml
+++ b/_compress_images_cache.yml
@@ -1,6 +1,12 @@
---
assets/android-chrome-192x192.png: android-chrome-192x192.png
assets/android-chrome-512x512.png: android-chrome-512x512.png
+assets/animations/astronaut/images/img_0.png: img_0.png
+assets/animations/astronaut/images/img_1.png: img_1.png
+assets/animations/contribute/formatting/bitcoin-design-seal-miami-edition.png: bitcoin-design-seal-miami-edition.png
+assets/animations/contribute/formatting/bitcoin-design-seal-miami-edition@2x.png: bitcoin-design-seal-miami-edition@2x.png
+assets/animations/contribute/formatting/bitcoin-design-seal.png: bitcoin-design-seal.png
+assets/animations/contribute/formatting/bitcoin-design-seal@2x.png: bitcoin-design-seal@2x.png
assets/apple-touch-icon.png: apple-touch-icon.png
assets/favicon-16x16.png: favicon-16x16.png
assets/favicon-32x32.png: favicon-32x32.png
@@ -118,6 +124,8 @@ assets/images/guide/daily-spending-wallet/activity/annotated-activity.png: annot
assets/images/guide/daily-spending-wallet/activity/annotated-activity@2x.png: annotated-activity@2x.png
assets/images/guide/daily-spending-wallet/activity/budgeting.png: budgeting.png
assets/images/guide/daily-spending-wallet/activity/budgeting@2x.png: budgeting@2x.png
+assets/images/guide/daily-spending-wallet/activity/expanded-micropayments.png: expanded-micropayments.png
+assets/images/guide/daily-spending-wallet/activity/expanded-micropayments@2x.png: expanded-micropayments@2x.png
assets/images/guide/daily-spending-wallet/activity/grouped-micropayments.png: grouped-micropayments.png
assets/images/guide/daily-spending-wallet/activity/grouped-micropayments@2x.png: grouped-micropayments@2x.png
assets/images/guide/daily-spending-wallet/activity/invoice.png: invoice.png
@@ -338,9 +346,17 @@ assets/images/guide/daily-spending-wallet/privacy/coin-join.jpg: coin-join.jpg
assets/images/guide/daily-spending-wallet/privacy/coin-join@2x.jpg: coin-join@2x.jpg
assets/images/guide/daily-spending-wallet/privacy/header.jpg: header.jpg
assets/images/guide/daily-spending-wallet/privacy/header@2x.jpg: header@2x.jpg
+assets/images/guide/daily-spending-wallet/privacy/hidden-balance-pin-reveal.png: hidden-balance-pin-reveal.png
+assets/images/guide/daily-spending-wallet/privacy/hidden-balance-pin-reveal@2x.png: hidden-balance-pin-reveal@2x.png
+assets/images/guide/daily-spending-wallet/privacy/hidden-balance-reveal-timer.png: hidden-balance-reveal-timer.png
+assets/images/guide/daily-spending-wallet/privacy/hidden-balance-reveal-timer@2x.png: hidden-balance-reveal-timer@2x.png
+assets/images/guide/daily-spending-wallet/privacy/privacy-and-security-settings.png: privacy-and-security-settings.png
+assets/images/guide/daily-spending-wallet/privacy/privacy-and-security-settings@2x.png: privacy-and-security-settings@2x.png
assets/images/guide/daily-spending-wallet/privacy/privacy-header-mobile.jpg: privacy-header-mobile.jpg
assets/images/guide/daily-spending-wallet/privacy/privacy-header-mobile@2x.jpg: privacy-header-mobile@2x.jpg
assets/images/guide/daily-spending-wallet/privacy/privacy-preview.jpg: privacy-preview.jpg
+assets/images/guide/daily-spending-wallet/privacy/quick-hide-access.png: quick-hide-access.png
+assets/images/guide/daily-spending-wallet/privacy/quick-hide-access@2x.png: quick-hide-access@2x.png
assets/images/guide/daily-spending-wallet/requesting/confirming.png: confirming.png
assets/images/guide/daily-spending-wallet/requesting/confirming@2x.png: confirming@2x.png
assets/images/guide/daily-spending-wallet/requesting/contact-card.png: contact-card.png
@@ -396,10 +412,6 @@ assets/images/guide/daily-spending-wallet/security/enter-pin.png: enter-pin.png
assets/images/guide/daily-spending-wallet/security/enter-pin@2x.png: enter-pin@2x.png
assets/images/guide/daily-spending-wallet/security/face-id-info.png: face-id-info.png
assets/images/guide/daily-spending-wallet/security/face-id-info@2x.png: face-id-info@2x.png
-assets/images/guide/daily-spending-wallet/privacy/hidden-balance-pin-reveal.png: hidden-balance-pin-reveal.png
-assets/images/guide/daily-spending-wallet/privacy/hidden-balance-pin-reveal@2x.png: hidden-balance-pin-reveal@2x.png
-assets/images/guide/daily-spending-wallet/privacy/hidden-balance-reveal-timer.png: hidden-balance-reveal-timer.png
-assets/images/guide/daily-spending-wallet/privacy/hidden-balance-reveal-timer@2x.png: hidden-balance-reveal-timer@2x.png
assets/images/guide/daily-spending-wallet/security/home-security-reminder.png: home-security-reminder.png
assets/images/guide/daily-spending-wallet/security/home-security-reminder@2x.png: home-security-reminder@2x.png
assets/images/guide/daily-spending-wallet/security/inadequate-security.png: inadequate-security.png
@@ -408,8 +420,6 @@ assets/images/guide/daily-spending-wallet/security/lightning-network-settings.pn
assets/images/guide/daily-spending-wallet/security/lightning-network-settings@2x.png: lightning-network-settings@2x.png
assets/images/guide/daily-spending-wallet/security/privacy-and-security-settings.png: privacy-and-security-settings.png
assets/images/guide/daily-spending-wallet/security/privacy-and-security-settings@2x.png: privacy-and-security-settings@2x.png
-assets/images/guide/daily-spending-wallet/privacy/privacy-and-security-settings.png: privacy-and-security-settings.png
-assets/images/guide/daily-spending-wallet/privacy/privacy-and-security-settings@2x.png: privacy-and-security-settings@2x.png
assets/images/guide/daily-spending-wallet/security/privacy-checklist.png: privacy-checklist.png
assets/images/guide/daily-spending-wallet/security/privacy-checklist@2x.png: privacy-checklist@2x.png
assets/images/guide/daily-spending-wallet/security/protecting-a-wallet-mobile.png: protecting-a-wallet-mobile.png
@@ -417,8 +427,6 @@ assets/images/guide/daily-spending-wallet/security/protecting-a-wallet-mobile@2x
assets/images/guide/daily-spending-wallet/security/protecting-a-wallet-preview.png: protecting-a-wallet-preview.png
assets/images/guide/daily-spending-wallet/security/protecting-a-wallet.png: protecting-a-wallet.png
assets/images/guide/daily-spending-wallet/security/protecting-a-wallet@2x.png: protecting-a-wallet@2x.png
-assets/images/guide/daily-spending-wallet/privacy/quick-hide-access.png: quick-hide-access.png
-assets/images/guide/daily-spending-wallet/privacy/quick-hide-access@2x.png: quick-hide-access@2x.png
assets/images/guide/daily-spending-wallet/security/security-checklist.png: security-checklist.png
assets/images/guide/daily-spending-wallet/security/security-checklist@2x.png: security-checklist@2x.png
assets/images/guide/daily-spending-wallet/security/wallet-limit-reached.png: wallet-limit-reached.png
@@ -434,6 +442,8 @@ assets/images/guide/daily-spending-wallet/sending/bitcoin-payments.jpg: bitcoin-
assets/images/guide/daily-spending-wallet/sending/bitcoin-payments@2x.jpg: bitcoin-payments@2x.jpg
assets/images/guide/daily-spending-wallet/sending/confirm-fees.png: confirm-fees.png
assets/images/guide/daily-spending-wallet/sending/confirm-fees@2x.png: confirm-fees@2x.png
+assets/images/guide/daily-spending-wallet/sending/confirm-high-fees.png: confirm-high-fees.png
+assets/images/guide/daily-spending-wallet/sending/confirm-high-fees@2x.png: confirm-high-fees@2x.png
assets/images/guide/daily-spending-wallet/sending/confirm.png: confirm.png
assets/images/guide/daily-spending-wallet/sending/confirm@2x.png: confirm@2x.png
assets/images/guide/daily-spending-wallet/sending/donation-page-copy.png: donation-page-copy.png
@@ -488,6 +498,35 @@ assets/images/guide/daily-spending.png: daily-spending.png
assets/images/guide/daily-spending@2x.png: daily-spending@2x.png
assets/images/guide/designing-bitcoin-products.png: designing-bitcoin-products.png
assets/images/guide/designing-bitcoin-products@2x.png: designing-bitcoin-products@2x.png
+assets/images/guide/designing-products/accessibility/accessibility-mobile.jpg: accessibility-mobile.jpg
+assets/images/guide/designing-products/accessibility/accessibility-mobile@2x.jpg: accessibility-mobile@2x.jpg
+assets/images/guide/designing-products/accessibility/accessibility-preview.jpg: accessibility-preview.jpg
+assets/images/guide/designing-products/accessibility/accessibility.jpg: accessibility.jpg
+assets/images/guide/designing-products/accessibility/accessibility@2x.jpg: accessibility@2x.jpg
+assets/images/guide/designing-products/accessibility/annotations-bad-big.png: annotations-bad-big.png
+assets/images/guide/designing-products/accessibility/annotations-bad-isolated-big.png: annotations-bad-isolated-big.png
+assets/images/guide/designing-products/accessibility/annotations-bad-isolated.png: annotations-bad-isolated.png
+assets/images/guide/designing-products/accessibility/annotations-bad-isolated@2x.png: annotations-bad-isolated@2x.png
+assets/images/guide/designing-products/accessibility/annotations-bad.png: annotations-bad.png
+assets/images/guide/designing-products/accessibility/annotations-bad@2x.png: annotations-bad@2x.png
+assets/images/guide/designing-products/accessibility/annotations-good-big.png: annotations-good-big.png
+assets/images/guide/designing-products/accessibility/annotations-good-isolated-big.png: annotations-good-isolated-big.png
+assets/images/guide/designing-products/accessibility/annotations-good-isolated.png: annotations-good-isolated.png
+assets/images/guide/designing-products/accessibility/annotations-good-isolated@2x.png: annotations-good-isolated@2x.png
+assets/images/guide/designing-products/accessibility/annotations-good.png: annotations-good.png
+assets/images/guide/designing-products/accessibility/annotations-good@2x.png: annotations-good@2x.png
+assets/images/guide/designing-products/accessibility/color-vision-defficiencies.png: color-vision-defficiencies.png
+assets/images/guide/designing-products/accessibility/color-vision-defficiencies@2x.png: color-vision-defficiencies@2x.png
+assets/images/guide/designing-products/accessibility/dynamic-type.png: dynamic-type.png
+assets/images/guide/designing-products/accessibility/dynamic-type@2x.png: dynamic-type@2x.png
+assets/images/guide/designing-products/accessibility/multi-sensory-feedback.png: multi-sensory-feedback.png
+assets/images/guide/designing-products/accessibility/multi-sensory-feedback@2x.png: multi-sensory-feedback@2x.png
+assets/images/guide/designing-products/accessibility/ordering-bad-big.png: ordering-bad-big.png
+assets/images/guide/designing-products/accessibility/ordering-bad.png: ordering-bad.png
+assets/images/guide/designing-products/accessibility/ordering-bad@2x.png: ordering-bad@2x.png
+assets/images/guide/designing-products/accessibility/ordering-good-big.png: ordering-good-big.png
+assets/images/guide/designing-products/accessibility/ordering-good.png: ordering-good.png
+assets/images/guide/designing-products/accessibility/ordering-good@2x.png: ordering-good@2x.png
assets/images/guide/designing-products/common-user-flows/app-store-bluewallet.jpg: app-store-bluewallet.jpg
assets/images/guide/designing-products/common-user-flows/app-store-bluewallet@2x.jpg: app-store-bluewallet@2x.jpg
assets/images/guide/designing-products/common-user-flows/bitcoincore-com.jpg: bitcoincore-com.jpg
@@ -870,9 +909,19 @@ assets/images/guide/getting-started/why-design-for-bitcoin/why-design-for-bitcoi
assets/images/guide/getting-started/why-design-for-bitcoin/why-design-for-bitcoin.jpg: why-design-for-bitcoin.jpg
assets/images/guide/getting-started/why-design-for-bitcoin/why-design-for-bitcoin@2x.jpg: why-design-for-bitcoin@2x.jpg
assets/images/guide/getting-started@2x.png: getting-started@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-mobile.jpg: address-mobile.jpg
assets/images/guide/glossary/address/address-mobile@2x.jpg: address-mobile@2x.jpg
assets/images/guide/glossary/address/address-preview.jpg: address-preview.jpg
+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/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.jpg: address.jpg
assets/images/guide/glossary/address/address@2x.jpg: address@2x.jpg
assets/images/guide/glossary/block.jpg: block.jpg
@@ -991,6 +1040,83 @@ assets/images/guide/how-it-works/lightning-service-providers/watchtowers.jpg: wa
assets/images/guide/how-it-works/lightning-service-providers/watchtowers@2x.jpg: watchtowers@2x.jpg
assets/images/guide/how-it-works/lightning-service-providers/zero-reserve.jpg: zero-reserve.jpg
assets/images/guide/how-it-works/lightning-service-providers/zero-reserve@2x.jpg: zero-reserve@2x.jpg
+assets/images/guide/how-it-works/lightning-services/Backups-mobile.png: Backups-mobile.png
+assets/images/guide/how-it-works/lightning-services/Backups-mobile@2x.png: Backups-mobile@2x.png
+assets/images/guide/how-it-works/lightning-services/Backups.png: Backups.png
+assets/images/guide/how-it-works/lightning-services/Backups@2x.png: Backups@2x.png
+assets/images/guide/how-it-works/lightning-services/Collaborative-funding-mobile.png: Collaborative-funding-mobile.png
+assets/images/guide/how-it-works/lightning-services/Collaborative-funding-mobile@2x.png: Collaborative-funding-mobile@2x.png
+assets/images/guide/how-it-works/lightning-services/Collaborative-funding.png: Collaborative-funding.png
+assets/images/guide/how-it-works/lightning-services/Collaborative-funding@2x.png: Collaborative-funding@2x.png
+assets/images/guide/how-it-works/lightning-services/Combining-channel-opens-mobile.png: Combining-channel-opens-mobile.png
+assets/images/guide/how-it-works/lightning-services/Combining-channel-opens-mobile@2x.png: Combining-channel-opens-mobile@2x.png
+assets/images/guide/how-it-works/lightning-services/Combining-channel-opens.png: Combining-channel-opens.png
+assets/images/guide/how-it-works/lightning-services/Combining-channel-opens@2x.png: Combining-channel-opens@2x.png
+assets/images/guide/how-it-works/lightning-services/How-is-service-offered-mobile.png: How-is-service-offered-mobile.png
+assets/images/guide/how-it-works/lightning-services/How-is-service-offered-mobile@2x.png: How-is-service-offered-mobile@2x.png
+assets/images/guide/how-it-works/lightning-services/How-is-service-offered.png: How-is-service-offered.png
+assets/images/guide/how-it-works/lightning-services/How-is-service-offered@2x.png: How-is-service-offered@2x.png
+assets/images/guide/how-it-works/lightning-services/Inbound-liquidity-as-a-service-mobile.png: Inbound-liquidity-as-a-service-mobile.png
+assets/images/guide/how-it-works/lightning-services/Inbound-liquidity-as-a-service-mobile@2x.png: Inbound-liquidity-as-a-service-mobile@2x.png
+assets/images/guide/how-it-works/lightning-services/Inbound-liquidity-as-a-service.png: Inbound-liquidity-as-a-service.png
+assets/images/guide/how-it-works/lightning-services/Inbound-liquidity-as-a-service@2x.png: Inbound-liquidity-as-a-service@2x.png
+assets/images/guide/how-it-works/lightning-services/Lightning-address-mobile.png: Lightning-address-mobile.png
+assets/images/guide/how-it-works/lightning-services/Lightning-address-mobile@2x.png: Lightning-address-mobile@2x.png
+assets/images/guide/how-it-works/lightning-services/Lightning-address.png: Lightning-address.png
+assets/images/guide/how-it-works/lightning-services/Lightning-address@2x.png: Lightning-address@2x.png
+assets/images/guide/how-it-works/lightning-services/lightning-services-mobile.jpg: lightning-services-mobile.jpg
+assets/images/guide/how-it-works/lightning-services/lightning-services-mobile@2x.jpg: lightning-services-mobile@2x.jpg
+assets/images/guide/how-it-works/lightning-services/lightning-services-preview.jpg: lightning-services-preview.jpg
+assets/images/guide/how-it-works/lightning-services/lightning-services.jpg: lightning-services.jpg
+assets/images/guide/how-it-works/lightning-services/lightning-services@2x.jpg: lightning-services@2x.jpg
+assets/images/guide/how-it-works/lightning-services/Offline-payment-mobile.png: 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/how-it-works/lightning-services/On-demand-channel-mobile.png: On-demand-channel-mobile.png
+assets/images/guide/how-it-works/lightning-services/On-demand-channel-mobile@2x.png: On-demand-channel-mobile@2x.png
+assets/images/guide/how-it-works/lightning-services/On-demand-channel.png: On-demand-channel.png
+assets/images/guide/how-it-works/lightning-services/On-demand-channel@2x.png: On-demand-channel@2x.png
+assets/images/guide/how-it-works/lightning-services/OnChain-funding-mobile.png: OnChain-funding-mobile.png
+assets/images/guide/how-it-works/lightning-services/OnChain-funding-mobile@2x.png: OnChain-funding-mobile@2x.png
+assets/images/guide/how-it-works/lightning-services/OnChain-funding.png: OnChain-funding.png
+assets/images/guide/how-it-works/lightning-services/OnChain-funding@2x.png: OnChain-funding@2x.png
+assets/images/guide/how-it-works/lightning-services/Spend-unconfirmed-mobile.png: Spend-unconfirmed-mobile.png
+assets/images/guide/how-it-works/lightning-services/Spend-unconfirmed-mobile@2x.png: Spend-unconfirmed-mobile@2x.png
+assets/images/guide/how-it-works/lightning-services/Spend-unconfirmed.png: Spend-unconfirmed.png
+assets/images/guide/how-it-works/lightning-services/Spend-unconfirmed@2x.png: Spend-unconfirmed@2x.png
+assets/images/guide/how-it-works/lightning-services/Submarine-swaps-mobile.png: Submarine-swaps-mobile.png
+assets/images/guide/how-it-works/lightning-services/Submarine-swaps-mobile@2x.png: Submarine-swaps-mobile@2x.png
+assets/images/guide/how-it-works/lightning-services/Submarine-swaps.png: Submarine-swaps.png
+assets/images/guide/how-it-works/lightning-services/Submarine-swaps@2x.png: Submarine-swaps@2x.png
+assets/images/guide/how-it-works/lightning-services/Watchtowers-mobile.png: Watchtowers-mobile.png
+assets/images/guide/how-it-works/lightning-services/Watchtowers-mobile@2x.png: Watchtowers-mobile@2x.png
+assets/images/guide/how-it-works/lightning-services/Watchtowers.png: Watchtowers.png
+assets/images/guide/how-it-works/lightning-services/Watchtowers@2x.png: Watchtowers@2x.png
+assets/images/guide/how-it-works/lightning-services/what-are-lightning-wallet-servers-mobile.png: what-are-lightning-wallet-servers-mobile.png
+assets/images/guide/how-it-works/lightning-services/what-are-lightning-wallet-servers-mobile@2x.png: what-are-lightning-wallet-servers-mobile@2x.png
+assets/images/guide/how-it-works/lightning-services/what-are-lightning-wallet-servers.png: what-are-lightning-wallet-servers.png
+assets/images/guide/how-it-works/lightning-services/what-are-lightning-wallet-servers@2x.png: what-are-lightning-wallet-servers@2x.png
+assets/images/guide/how-it-works/lightning-services/where-is-this-serviced-offered-mobile.png: where-is-this-serviced-offered-mobile.png
+assets/images/guide/how-it-works/lightning-services/where-is-this-serviced-offered-mobile@2x.png: where-is-this-serviced-offered-mobile@2x.png
+assets/images/guide/how-it-works/lightning-services/where-is-this-serviced-offered.png: where-is-this-serviced-offered.png
+assets/images/guide/how-it-works/lightning-services/where-is-this-serviced-offered@2x.png: where-is-this-serviced-offered@2x.png
+assets/images/guide/how-it-works/liquidity/channel-reserve-01-mobile.png: channel-reserve-01-mobile.png
+assets/images/guide/how-it-works/liquidity/channel-reserve-01-mobile@2x.png: channel-reserve-01-mobile@2x.png
+assets/images/guide/how-it-works/liquidity/channel-reserve-01.png: channel-reserve-01.png
+assets/images/guide/how-it-works/liquidity/channel-reserve-01@2x.png: channel-reserve-01@2x.png
+assets/images/guide/how-it-works/liquidity/channel-reserve-02-mobile.png: channel-reserve-02-mobile.png
+assets/images/guide/how-it-works/liquidity/channel-reserve-02-mobile@2x.png: channel-reserve-02-mobile@2x.png
+assets/images/guide/how-it-works/liquidity/channel-reserve-02.png: channel-reserve-02.png
+assets/images/guide/how-it-works/liquidity/channel-reserve-02@2x.png: channel-reserve-02@2x.png
+assets/images/guide/how-it-works/liquidity/channel-reserve-03-mobile.png: channel-reserve-03-mobile.png
+assets/images/guide/how-it-works/liquidity/channel-reserve-03-mobile@2x.png: channel-reserve-03-mobile@2x.png
+assets/images/guide/how-it-works/liquidity/channel-reserve-03.png: channel-reserve-03.png
+assets/images/guide/how-it-works/liquidity/channel-reserve-03@2x.png: channel-reserve-03@2x.png
+assets/images/guide/how-it-works/liquidity/channel-reserve-notification.png: channel-reserve-notification.png
+assets/images/guide/how-it-works/liquidity/channel-reserve-notification@2x.png: channel-reserve-notification@2x.png
+assets/images/guide/how-it-works/liquidity/channel-reserve-screen.png: channel-reserve-screen.png
+assets/images/guide/how-it-works/liquidity/channel-reserve-screen@2x.png: channel-reserve-screen@2x.png
assets/images/guide/how-it-works/liquidity/lightning-node-types.png: lightning-node-types.png
assets/images/guide/how-it-works/liquidity/lightning-node-types@2x.png: lightning-node-types@2x.png
assets/images/guide/how-it-works/liquidity/liquidity-01-mobile.png: liquidity-01-mobile.png
@@ -1042,6 +1168,8 @@ assets/images/guide/how-it-works/liquidity/node-rachel.png: node-rachel.png
assets/images/guide/how-it-works/liquidity/node-rachel@2x.png: node-rachel@2x.png
assets/images/guide/how-it-works/liquidity/node-wagner.png: node-wagner.png
assets/images/guide/how-it-works/liquidity/node-wagner@2x.png: node-wagner@2x.png
+assets/images/guide/how-it-works/liquidity/send-limit-screen.png: send-limit-screen.png
+assets/images/guide/how-it-works/liquidity/send-limit-screen@2x.png: send-limit-screen@2x.png
assets/images/guide/how-it-works/node/archival-node.png: archival-node.png
assets/images/guide/how-it-works/node/archival-node@2x.png: archival-node@2x.png
assets/images/guide/how-it-works/node/bloom-filter-node.png: bloom-filter-node.png
@@ -1138,12 +1266,16 @@ assets/images/guide/resources/design-files/bitcoin-design-community-seal.jpg: bi
assets/images/guide/resources/design-files/bitcoin-design-community-seal@2x.jpg: bitcoin-design-community-seal@2x.jpg
assets/images/guide/resources/design-files/bitcoin-design-site.jpg: bitcoin-design-site.jpg
assets/images/guide/resources/design-files/bitcoin-design-site@2x.jpg: bitcoin-design-site@2x.jpg
+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/resources/design-files/bitcoin-hardware-illustrations.jpg: bitcoin-hardware-illustrations.jpg
assets/images/guide/resources/design-files/bitcoin-hardware-illustrations@2x.jpg: bitcoin-hardware-illustrations@2x.jpg
assets/images/guide/resources/design-files/bitcoin-icons.jpg: bitcoin-icons.jpg
assets/images/guide/resources/design-files/bitcoin-icons@2x.jpg: bitcoin-icons@2x.jpg
assets/images/guide/resources/design-files/bitcoin-ui-kit.jpg: bitcoin-ui-kit.jpg
assets/images/guide/resources/design-files/bitcoin-ui-kit@2x.jpg: bitcoin-ui-kit@2x.jpg
+assets/images/guide/resources/design-files/bitcoin-wallet-backup-print-template.jpg: bitcoin-wallet-backup-print-template.jpg
+assets/images/guide/resources/design-files/bitcoin-wallet-backup-print-template@2x.jpg: bitcoin-wallet-backup-print-template@2x.jpg
assets/images/guide/resources/design-files/design-resources-preview.jpg: design-resources-preview.jpg
assets/images/guide/resources/design-files/slide-template.jpg: slide-template.jpg
assets/images/guide/resources/design-files/slide-template@2x.jpg: slide-template@2x.jpg
@@ -1333,6 +1465,8 @@ assets/images/guide/wallet-components/output-selection/ouput-selection-btcpay.pn
assets/images/guide/wallet-components/output-selection/ouput-selection-wasabi.png: ouput-selection-wasabi.png
assets/images/guide/wallet-components/output-selection/outputs-diagram.png: outputs-diagram.png
assets/images/guide/wallet-components/output-selection/spending-selected-outputs-flow.png: spending-selected-outputs-flow.png
+assets/images/home/banner/bits-and-pieces-fallback.png: bits-and-pieces-fallback.png
+assets/images/home/banner/bits-and-pieces-fallback@2x.png: bits-and-pieces-fallback@2x.png
assets/images/home/banner/bits-and-pieces-mobile.png: bits-and-pieces-mobile.png
assets/images/home/banner/bits-and-pieces-mobile@2x.png: bits-and-pieces-mobile@2x.png
assets/images/home/banner/bits-and-pieces.png: bits-and-pieces.png
diff --git a/assets/images/guide/how-it-works/liquidity/channel-reserve-01-mobile.png b/assets/images/guide/how-it-works/liquidity/channel-reserve-01-mobile.png
new file mode 100644
index 000000000..9f8427ee0
Binary files /dev/null and b/assets/images/guide/how-it-works/liquidity/channel-reserve-01-mobile.png differ
diff --git a/assets/images/guide/how-it-works/liquidity/channel-reserve-01-mobile@2x.png b/assets/images/guide/how-it-works/liquidity/channel-reserve-01-mobile@2x.png
new file mode 100644
index 000000000..253c7abe1
Binary files /dev/null and b/assets/images/guide/how-it-works/liquidity/channel-reserve-01-mobile@2x.png differ
diff --git a/assets/images/guide/how-it-works/liquidity/channel-reserve-01.png b/assets/images/guide/how-it-works/liquidity/channel-reserve-01.png
new file mode 100644
index 000000000..3b52d2f04
Binary files /dev/null and b/assets/images/guide/how-it-works/liquidity/channel-reserve-01.png differ
diff --git a/assets/images/guide/how-it-works/liquidity/channel-reserve-01@2x.png b/assets/images/guide/how-it-works/liquidity/channel-reserve-01@2x.png
new file mode 100644
index 000000000..6bdcea233
Binary files /dev/null and b/assets/images/guide/how-it-works/liquidity/channel-reserve-01@2x.png differ
diff --git a/assets/images/guide/how-it-works/liquidity/channel-reserve-02-mobile.png b/assets/images/guide/how-it-works/liquidity/channel-reserve-02-mobile.png
new file mode 100644
index 000000000..0b860287c
Binary files /dev/null and b/assets/images/guide/how-it-works/liquidity/channel-reserve-02-mobile.png differ
diff --git a/assets/images/guide/how-it-works/liquidity/channel-reserve-02-mobile@2x.png b/assets/images/guide/how-it-works/liquidity/channel-reserve-02-mobile@2x.png
new file mode 100644
index 000000000..c7c0a4ce5
Binary files /dev/null and b/assets/images/guide/how-it-works/liquidity/channel-reserve-02-mobile@2x.png differ
diff --git a/assets/images/guide/how-it-works/liquidity/channel-reserve-02.png b/assets/images/guide/how-it-works/liquidity/channel-reserve-02.png
new file mode 100644
index 000000000..7c248d7b0
Binary files /dev/null and b/assets/images/guide/how-it-works/liquidity/channel-reserve-02.png differ
diff --git a/assets/images/guide/how-it-works/liquidity/channel-reserve-02@2x.png b/assets/images/guide/how-it-works/liquidity/channel-reserve-02@2x.png
new file mode 100644
index 000000000..8f051a6f3
Binary files /dev/null and b/assets/images/guide/how-it-works/liquidity/channel-reserve-02@2x.png differ
diff --git a/assets/images/guide/how-it-works/liquidity/channel-reserve-03-mobile.png b/assets/images/guide/how-it-works/liquidity/channel-reserve-03-mobile.png
new file mode 100644
index 000000000..2563e4f5a
Binary files /dev/null and b/assets/images/guide/how-it-works/liquidity/channel-reserve-03-mobile.png differ
diff --git a/assets/images/guide/how-it-works/liquidity/channel-reserve-03-mobile@2x.png b/assets/images/guide/how-it-works/liquidity/channel-reserve-03-mobile@2x.png
new file mode 100644
index 000000000..ac73446c5
Binary files /dev/null and b/assets/images/guide/how-it-works/liquidity/channel-reserve-03-mobile@2x.png differ
diff --git a/assets/images/guide/how-it-works/liquidity/channel-reserve-03.png b/assets/images/guide/how-it-works/liquidity/channel-reserve-03.png
new file mode 100644
index 000000000..8adbdffc3
Binary files /dev/null and b/assets/images/guide/how-it-works/liquidity/channel-reserve-03.png differ
diff --git a/assets/images/guide/how-it-works/liquidity/channel-reserve-03@2x.png b/assets/images/guide/how-it-works/liquidity/channel-reserve-03@2x.png
new file mode 100644
index 000000000..3df871189
Binary files /dev/null and b/assets/images/guide/how-it-works/liquidity/channel-reserve-03@2x.png differ
diff --git a/assets/images/guide/how-it-works/liquidity/channel-reserve-notification.png b/assets/images/guide/how-it-works/liquidity/channel-reserve-notification.png
new file mode 100644
index 000000000..bedbcdda5
Binary files /dev/null and b/assets/images/guide/how-it-works/liquidity/channel-reserve-notification.png differ
diff --git a/assets/images/guide/how-it-works/liquidity/channel-reserve-notification@2x.png b/assets/images/guide/how-it-works/liquidity/channel-reserve-notification@2x.png
new file mode 100644
index 000000000..0005f5c26
Binary files /dev/null and b/assets/images/guide/how-it-works/liquidity/channel-reserve-notification@2x.png differ
diff --git a/assets/images/guide/how-it-works/liquidity/channel-reserve-screen.png b/assets/images/guide/how-it-works/liquidity/channel-reserve-screen.png
new file mode 100644
index 000000000..24aa5aba8
Binary files /dev/null and b/assets/images/guide/how-it-works/liquidity/channel-reserve-screen.png differ
diff --git a/assets/images/guide/how-it-works/liquidity/channel-reserve-screen@2x.png b/assets/images/guide/how-it-works/liquidity/channel-reserve-screen@2x.png
new file mode 100644
index 000000000..4e42632f1
Binary files /dev/null and b/assets/images/guide/how-it-works/liquidity/channel-reserve-screen@2x.png differ
diff --git a/assets/images/guide/how-it-works/liquidity/send-limit-screen.png b/assets/images/guide/how-it-works/liquidity/send-limit-screen.png
new file mode 100644
index 000000000..07d6624ff
Binary files /dev/null and b/assets/images/guide/how-it-works/liquidity/send-limit-screen.png differ
diff --git a/assets/images/guide/how-it-works/liquidity/send-limit-screen@2x.png b/assets/images/guide/how-it-works/liquidity/send-limit-screen@2x.png
new file mode 100644
index 000000000..7394d9806
Binary files /dev/null and b/assets/images/guide/how-it-works/liquidity/send-limit-screen@2x.png differ
diff --git a/guide/how-it-works/liquidity.md b/guide/how-it-works/liquidity.md
index d3373132d..87b267434 100644
--- a/guide/how-it-works/liquidity.md
+++ b/guide/how-it-works/liquidity.md
@@ -25,10 +25,21 @@ image: https://bitcoin.design/assets/images/guide/how-it-works/liquidity/liquidi
Editor's notes
Figma file: https://www.figma.com/file/ZwRT4mZZ4UNGtsfLz22m8M/Liquidity?node-id=0%3A1
+Figma file for channel reserve UI's: https://www.figma.com/file/6iJpftEbajA3y1ylXQxsrl/Channel-reserve
-->
# Lightning liquidity
+{:.no_toc}
+
+---
+
+
+* Table of contents
+{:toc}
+
+
+---
Liquidity is a core concept to understand when working with the lightning network, although tricky. Ideally, we are able to design products that are easy enough to use so that users do not need to concern themselves with liquidity. However, product designers need to understand liquidity in order to build effectively on lightning.
@@ -306,6 +317,105 @@ Consider how you can help the user with channel management without them even kno
By combining the business incentives of an LSP, clever engineering, and good design, you can build a bitcoin product that makes using the lightning network very easy for the user.
+## Channel reserve
+
+### What is a channel reserve?
+
+A channel reserve is an amount that is set aside by each channel participant which ensures neither have 'nothing at stake' if a cheating attempt occurs. This reserve can not be spent, and is held aside for the entirety of the channels lifetime.
+
+Channel reserves make cheating attempts less economical. When one channel party attempts to cheat the other and they are caught, a [penalty transaction](https://fiatjaf.com/73095980.html) can be used to steal all the cheating parties bitcoin as punishment. Channel reserves makes it so cheating attempts always have something at stake making this less likely to occur.
+
+### What is the reserve amount?
+
+The channel reserve amount is dynamic and unique to each channel participant. As defined in [BOLT 2](https://github.com/lightning/bolts/blob/master/02-peer-protocol.md), the channel reserve amount dynamically trends towards 1% of the users local channel capacity. The channel reserve can not be lower than the current 354 sats minimum ([dust limit](https://github.com/lightning/bolts/blob/master/03-transactions.md#dust-limits)).
+
+So if a user has 100,000 sats of local capacity, their channel reserve will be 1,000 sats (1% of 100,000). The user can only spend 99,000 sats of the local capacity. The channel counterparty also has their own channel reserve which aims for a 1% reserve. This means the total channels capacity will have around 2% put aside and unspendable as a reserve.
+
+{% include picture.html
+ image = "/assets/images/guide/how-it-works/liquidity/channel-reserve-01.png"
+ retina = "/assets/images/guide/how-it-works/liquidity/channel-reserve-01@2x.png"
+ mobile = "/assets/images/guide/how-it-works/liquidity/channel-reserve-01-mobile.png"
+ mobileRetina = "/assets/images/guide/how-it-works/liquidity/channel-reserve-01-mobile@2x.png"
+ alt-text = "Lori has 100,000 sats on her side of the channel with 1,000 sats in reserve"
+ width = 800
+ height = 348
+%}
+
+As users send and receive funds, the channel reserve will dynamically adjust so that it's always close to 1%.
+
+{% include picture.html
+ image = "/assets/images/guide/how-it-works/liquidity/channel-reserve-02.png"
+ retina = "/assets/images/guide/how-it-works/liquidity/channel-reserve-02@2x.png"
+ mobile = "/assets/images/guide/how-it-works/liquidity/channel-reserve-02-mobile.png"
+ mobileRetina = "/assets/images/guide/how-it-works/liquidity/channel-reserve-02-mobile@2x.png"
+ alt-text = "Lori routes a 100,000 sats payment through the channel"
+ width = 800
+ height = 348
+%}
+
+If a user spends 10,000 sats of their 100,000 sats local capacity, their new channel reserve will dynamically adjust from 1,000 sats (1% of 100,000 sats) to 900 sats (1% of 90,000 sats). This amount adjusts upwards if the user receives funds.
+
+{% include picture.html
+ image = "/assets/images/guide/how-it-works/liquidity/channel-reserve-03.png"
+ retina = "/assets/images/guide/how-it-works/liquidity/channel-reserve-03@2x.png"
+ mobile = "/assets/images/guide/how-it-works/liquidity/channel-reserve-03-mobile.png"
+ mobileRetina = "/assets/images/guide/how-it-works/liquidity/channel-reserve-03-mobile@2x.png"
+ alt-text = "Lori has 90,000 sats on her side of the channel with 900 sats in reserve"
+ width = 800
+ height = 348
+%}
+
+Each additional channel has its own channel reserve. For example, a user with 20 channels may have more funds locked in reserve than a user with only one channel.
+
+### How does this affect users?
+
+Users can be confused when having funded a channel, but being unable to spend the full amount they have put in.
+
+From a UX standpoint, we need to consider the following:
+
+#### Adding funds
+We should ensure that the user is educated so that:
+
+1. When they are adding funds they know that a small amount will be held as a reserve.
+2. They understand that although they cannot spend 100% of their balance they still own all of their funds.
+
+
+
+{% include picture.html
+ image = "/assets/images/guide/how-it-works/liquidity/channel-reserve-screen.png"
+ retina = "/assets/images/guide/how-it-works/liquidity/channel-reserve-screen@2x.png"
+ alt-text = "Channel status screen"
+ caption = "Channel reserve amount is indicated on the balance screen which includes a fee overview."
+ width = 250
+ height = 541
+%}
+
+{% include picture.html
+ image = "/assets/images/guide/how-it-works/liquidity/channel-reserve-notification.png"
+ retina = "/assets/images/guide/how-it-works/liquidity/channel-reserve-notification@2x.png"
+ alt-text = "Channel notification screen"
+ caption = "Channel reserve notification is indicated screen as a modal"
+ width = 250
+ height = 541
+%}
+
+{% include picture.html
+ image = "/assets/images/guide/how-it-works/liquidity/send-limit-screen.png"
+ retina = "/assets/images/guide/how-it-works/liquidity/send-limit-screen@2x.png"
+ alt-text = "Send limit screen"
+ caption = "Send limit is indicated on home screen"
+ width = 250
+ height = 541
+%}
+
+
+
+However, there are other much more fool-proof ways to prevent theft, such as:
+
+- [Using watchtowers](https://bitcoin.design/guide/how-it-works/lightning-services/).
+- Encouraging users to regularly open their lightning wallet, giving the wallet's node a chance to come online and check its channel state.
+
+
Avatar illustrations credit to [Vitaliy Gorbachev](https://www.flaticon.com/packs/avatars-93).
---