Address verification and sharing

Estimated reading time: 2 minutes

Sections in this page

• Standard address verification
• Sharing an address as a QR code
• Notifying the users of successful or failed verifications
• Displaying additional fields
• Key Takeaway

In addition to signing transactions, your app should let your users verify their receive addresses securely, leveraging the trusted display of Ledger Stax. This chapter goes over the best practices to show, share, and verify an address.

Standard address verification

Just like for transactions, address verification starts with a prompt that attracts the user’s attention and let them know what action they’re going to perform.

To validate the address, users simply tap the black button. This action doesn’t leverage the “Hold to sign” gesture because it is reserved for signing transactions and messages.

Sharing an address as a QR code

As for transactions and messages, a user action must be followed by a notification:

As opposed to transactions, cancelling the verification is not destructive and we recommend not using a confirmation prompt.

Notifying the users of successful or failed verifications

You may want to show more information to advanced users, such as derivations paths.

In these cases, the content will not likely fit in one page with the confirmation button. Use a transaction-like flow with pagination, an operation prompt, and an operation verification. Start with the address on the first page.

Here’s an example with advanced Cardano address verification:

Displaying additional fields

You may want to show more information to advanced users, such as derivations paths.

In these cases, the content will not likely fit in one page with the confirmation button. Use a transaction-like flow with pagination, an operation prompt, and an operation verification. Start with the address on the first page.

Here’s an example with advanced Cardano address verification:

  Important
Don’t show more fields than necessary for the majority of your users, in order to keep address verification simple and fast.

Key Takeaway

  Tip

• Make address verification simple and fast by conforming to the standard templates.
• Let your users show their address as a QR code for convenient sharing.

---

Did you find this page helpful?

How would you improve this page for developers?

I am a developer.
Contributors will be chosen randomly to receive rewards. Check this box to send your email and participate.

Ledger collects your email address to send you rewards for your contribution to improve the Developer Portal documentation. Learn more about how we manage your data and your rights.

By providing your email address, you consent that Ledger may contact you for rewards delivery purposes. If you are part of the randomly selected contributors, we will send you an email to ask for your physical address and if necessary, ask you for additional information on the suggestion you made. Your information will only be available to Ledger and will be retained for no longer than 90 days. It may be transferred to non-European countries that ensure an adequate level of protection or under the standard contractual clauses adopted by the EU Commission.

Please note that you may withdraw your consent at any time, access your data and request their rectification or deletion. You may also request the limitation of the processing of your data. To exercise your rights or for any question on the processing of your data, please contact LEDGER’s Data Protection Officer here. If nevertheless you believe LEDGER did not adequately address your concerns and mishandled your data, you may lodge a complaint with the personal data protection authority of your country.

Transactions

← Previous

Messages and advanced signing

Next →