Documentation
UI guidelines
Address verification and sharing

Address verification and sharing

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.

App architecture

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

You can provide a visual representation of an address as a QR code. This lets your users easily share their addresses:

  • for self-transfers to their Ledger Stax (from an exchange, a mobile wallet app, etc.);
  • for peer-to-peer sharing.

App architecture

A snippet of the address is repeated under the QR code to confirm that the data shown in the QR is indeed the address.

⚠️

This QR feature could be proposed more widely throughout the SDK, outside of the receive flow (no design exists for this yet).

Notifying the users of successful or failed verifications

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

App architecture

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

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:

App architecture

⚠️

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

Key Takeaway

💡
  • - 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.

Stax Graphic Library APIs

  • Use nbgl_useCaseAddressConfirmation() to make an address confirmation page, with the possibility to display it as QR Code.
  • For specific cases (display derivation path for example), use nbgl_useCaseAddressConfirmationExt() to make an address confirmation page, with the possibility to display it as QR Code and some extra tag/value pairs.

More info here.

Ledger
Copyright © Ledger SAS. All rights reserved. Ledger, Ledger Nano S, Ledger Vault, Bolos are registered trademarks of Ledger SAS