Skip to content

Test transactions while sending #1182

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 4 commits into
base: master
Choose a base branch
from
Draft
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
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.
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.
33 changes: 33 additions & 0 deletions guide/daily-spending-wallet/sending.md
Original file line number Diff line number Diff line change
Expand Up @@ -135,6 +135,24 @@ imagesLightning:
modalImage: onchain-warning-big
alt: Information screen that details the payment taking 10 minutes to an hour to confirm with a fee of 1,023 sats, and suggests asking the recipient for a lightning compatible format.
caption: The user may choose to proceed with the on-chain payment anyways, but has been informed they may be able to save time and fees by asking for a different payment format.
imagesTestTransactions:
- file: send-review-with-test-toggle
modalImage: send-review-with-test-toggle-big
alt: Wallet home screen with amount input, pay and request options
caption: Home screens provide quick access to entering payment flows.
- file: send-test-transaction-confirmation
modalImage: send-test-transaction-confirmation-big
alt: Wallet home screen with amount input, pay and request options
caption: Home screens provide quick access to entering payment flows.
- file: home-test-transaction-reminder
modalImage: home-test-transaction-reminder-big
alt: Wallet home screen with amount input, pay and request options
caption: Home screens provide quick access to entering payment flows.
- file: finalise-test-transaction
modalImage: finalise-test-transaction-big
alt: Wallet home screen with amount input, pay and request options
Comment on lines +141 to +153
Copy link
Preview

Copilot AI Jun 27, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[nitpick] The alt text for multiple images in the test transactions block is identical, which could hinder accessibility. Consider providing unique, descriptive alt texts for each image to better convey their distinct content.

Suggested change
alt: Wallet home screen with amount input, pay and request options
caption: Home screens provide quick access to entering payment flows.
- file: send-test-transaction-confirmation
modalImage: send-test-transaction-confirmation-big
alt: Wallet home screen with amount input, pay and request options
caption: Home screens provide quick access to entering payment flows.
- file: home-test-transaction-reminder
modalImage: home-test-transaction-reminder-big
alt: Wallet home screen with amount input, pay and request options
caption: Home screens provide quick access to entering payment flows.
- file: finalise-test-transaction
modalImage: finalise-test-transaction-big
alt: Wallet home screen with amount input, pay and request options
alt: Review screen showing a toggle to enable test transactions
caption: Home screens provide quick access to entering payment flows.
- file: send-test-transaction-confirmation
modalImage: send-test-transaction-confirmation-big
alt: Confirmation screen for sending a test transaction
caption: Home screens provide quick access to entering payment flows.
- file: home-test-transaction-reminder
modalImage: home-test-transaction-reminder-big
alt: Reminder on the home screen about an ongoing test transaction
caption: Home screens provide quick access to entering payment flows.
- file: finalise-test-transaction
modalImage: finalise-test-transaction-big
alt: Finalization screen for completing a test transaction

Copilot uses AI. Check for mistakes.

caption: Home screens provide quick access to entering payment flows.

---

<!--
Expand Down Expand Up @@ -241,6 +259,21 @@ If using a security step here, it should come after the user has selected all ot

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

### Test transactions
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I notice this section isn't showing up in the table of contents on the preview. Could we fix that?


Users often experience anxiety when transacting with large amounts, or using new payment methods/information. This anxiety can be higher with bitcoin payments due to its novelty, irreversible nature and the possibility of permanent loss if funds are sent to an invalid address. One way users manage this is by sending a small payment first, and have the recipient confirm they received it.

Offering an automated test transactions feature can help users minimise the risk as well as manual effort. This feature can be useful in the case of on-chain as well as lightning payments, provided that the transacting parties can communicate with one another.

Technically, this feature can utilise [replace-by-fee](https://bitcoinops.org/en/topics/replace-by-fee/) (RBF) or a simple small-value transaction.

There are three main interactions in this feature:
1. **application presents this option user on review screen**: in the appropriate scenario, such as large amount or new silent payments address is being used.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Capitalize the A in application.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. Application presents this option user on review screen: in the appropriate scenario, such as large amount or new silent payments address is being used.

2. **user chooses & sends the test transaction**: they may ignore it if they have no way of communicating with the receiver. Inform users about relevant fees, if any.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. User chooses & sends the test transaction: they may ignore it if they have no way of communicating with the receiver. Inform users about relevant fees, if any.

3. **user finalises the original payment**: allow the user to easily find and finalise the transaction. Applications can even remind the user about this after appropriate time.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. User finalises the original payment: allow the user to easily find and finalise the transaction. Applications can even remind the user about this after appropriate time.


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

## Transaction processing

Processing times may also differ between on-chain and lightning network payments. On-chain, pending transactions are bundled into a [new block]({{ '/guide/getting-started/technology-primer/#what-is-a-blockchain' | relative_url }}) roughly every 10 minutes. On the lightning network, [payment routing]({{ '/guide/getting-started/technology-primer/#how-are-payments-routed' | relative_url }}) happens instantly and is largely dependent on the number of nodes involved, as well as their liquidity and processing speeds.
Expand Down