Create a whitelist

This article is for Administrators only.

Overview

  • Create lists of addresses you can then link to accounts.
  • A list can contain up to 300 addresses .
  • Whitelists can only be edited in batches of 90 addresses. If you need to create a whitelist with more than 90 addresses, you must add these by batches of 90 addresses maximum at a time.

Before you start

  • Your Personal Security Device must be connected to your computer, switched on, and the Ledger Vault app opened.

Instructions

Step 1. Name the whitelist

  1. Click Whitelist on the left panel.
  2. Click + New whitelist in the top right corner.

whitelistboard

  1. Enter the Whitelist name .
Whitelist names must be unique. Two whitelists can't have the same name.

createwhitelist

  1. Select the Whitelist type .
Note that Transaction type whitelists can only be used in the context of Transaction rules and Smart Contract whitelists in Smart Contract rules, to avoid errors and enable your organization to better manage and control the use of Transaction and Smart Contract rules.

scWLtype

  1. Provide a Description (optional).
  2. Click Next .

Step 2. Enter addresses (Transaction type Whitelists)

Transaction type whitelists can include any type of addresses (i.e. for EVM networks, you can whitelist both Externally Owned Account addresses and Smart Contract addresses).
  1. Select a blockchain from the Currency drop-down list.

createwhitelist step2 1

It's not possible to add ERC20 token addresses. For more information, see Whitelists.
  1. Enter the Name of the address. It must be less than 45 characters long and must not contain special characters.
Address names must be unique per currency. For example, you can have a Bitcoin and Ethereum address named Coinplace, but two Bitcoin addresses can't hold the same name.

createwhitelist step2 2

  1. Enter the public Address , then click the + icon to add it to the list.
The public address must be unique per currency.

createwhitelist step2 3

  1. Repeat the above steps for each address you want to add.
  2. Click Next .

createwhitelist step2 4

Step 2. Enter addresses (Smart Contract type Whitelists)

Smart Contract type whitelists should only include Smart Contract addresses.
  1. Select a blockchain from the Currency drop-down list.
It's not possible to add ERC20 token addresses. For more information, see Whitelists.
  1. Enter the Name of the address. It must be less than 45 characters long and must not contain special characters.
Address names must be unique per currency. For example, you can have a Polygon and Ethereum address named Coinplace, but two Ethereum addresses can't hold the same name.

scWLblockchain

  1. Enter the public Address , then click the Save icon to add it to the list.
The public address must be unique per currency.

scWLcustomaddr

  1. Alternatively, you can easily whitelist Ledger Enterprise Clear Signed contracts by clicking on the icon, and selecting the contracts you want to add in the dropdown. Note that you filter contracts by name for better visibility.

scWLdappaddr

  1. Click Next .

createwhitelist step2 4

Step 3. Confirm the whitelist creation on your device

  1. Click Create whitelist .

createwhitelist step2 5

  1. Verify that the information displayed on your device is accurate. If it's not, either try again or contact Support .
  2. Tap Confirm .

createwhitelistPSD

  1. Click Done .

createwhitelistDONE

Results

A Create Whitelist request is submitted to all Administrators for approval.

What's next?

The whitelist will be created once the request is approved by the number of Administrators defined in the admin rule. Once approved, the whitelist can be added to the transaction or Smart Contract rules of accounts. For more information, see Workspace administration.

Extra functionalities

Whitelist a destination tag for an XRP address

You can now add a destination for an XRP address in a whitelist.

  1. Complete step 1 of this article
  2. Select the XRP blockchain from the Currency drop-down list.

createwhitelist step2 1 XRP

  1. Enter the Name of the address. It must be less than 19 characters long and must not contain special characters.
Address names must be unique per currency. For example, you can have a Bitcoin and XRP address named Coinplace, but two XRP addresses can't hold the same name.

createwhitelist step2 2 XRP

  1. Enter the public Address , then add up to three destination tags for the adress. The destination tags are optional.
The public address must be unique per currency.

createwhitelist step2 3 XRP

Click the Save button to add the address and destination tags (if you have added some) to the list.

  1. Repeat the above steps for each address you want to add.
  2. Click Next and refer to step three: Confirm the whitelist creation on your device at the beginning of the article to confirm the creation of the whitelist.