How to use Address Book & Whitelisting on HS2

This guide will explain how to use the Address Book and Whitelisting features in Hex Safe v2 to manage transaction recipients and enhance security.

 

How to create a new address book

How to add/update addresses in an address book

How to Enable whitelist for a safe account

Prerequisites

The Admin Approver user role must be set up
The Account Admin or Initiator user role must be set up
An Admin Approval quorum is required (by default this is set as 1)

For more information on user roles please visit this page

Address Book

The Address Book allows you to organize a list of frequently used addresses for easy access.

Creating a New Address Book:

* Please note that only an account admin or an initiator can create a new address book.

  1. Navigate to Settings: In the Hex Safe v2 interface, click the Settings icon.
  2. Select Address Management: Locate and click "Address Management”.
  3. Create a new Address Book: Click the "Create Address Book" button.
  4. Name Your Address Book: Enter a name for your address book.
  5. Confirm Creation: Click "Create Address Book" to finalize the creation of your new address book.
  6. Address Book Created: After confirming the above, the address book is created.


Adding/Updating Addresses:

  1. Access Address Book: Select the address book that you want to update.
  2. Manage Addresses:
    • Empty Address Book: If your address book has no address(es) yet, click the "+ Add Address" button.
    • Existing Addresses: If you have existing entries, click the "..." button and choose "Update Address(es)".
  3. Adding Addresses:
    • Manual Input: Enter the recipient's address, select their network, and assign a label for easy identification.
    • CSV Import: Follow the format in the downloadable CSV template. Once uploaded, click "Add to Below Sheet" to include the addresses.
  4. Save Changes: Click "Update" to confirm the update of addresses in your address book.
  5. Two-Factor Authorisation: A notification will be sent to the Hex Safe Mobile App of the change initiator who will be required to confirm it.
  6. Mobile App Confirmation: A notification will be sent to the Hex Safe Mobile App of all admin approvers who need to approve these changes.



Whitelist

The Whitelisting feature restricts specific accounts to only send transactions to addresses within a designated Address Book. This enhances security by preventing accidental transfers to unauthorized recipients.

Enabling Whitelisting for a safe account:

*Please ensure you have one or more address books created before adding them to the account whitelist

  1. Access Settings: Open the Settings menu within the Hex Safe v2 interface.
  2. Select "Whitelisting": Locate and click on "Whitelisting".
  3. Enable Whitelisting: Click "Enable Account Whitelist".
  4. Choose Safe Accounts: Select the Safe Account(s) for which you want to activate whitelisting.
  5. Assign Address Book(s): Choose the Address Book(s) that will be applied for transactions from the selected Account(s). Click "Continue" to proceed.
  6. Two Factor Authorisation: A notification will be sent to the Hex Safe Mobile App of the change initiator who will be required to confirm it.
  7. Mobile App Confirmation: A notification will be sent to the Hex Safe Mobile App of all admin approvers who need to approve these changes.

 

Note: If you whitelist a safe account to an empty address book or multiple empty address books, you will not be able to withdraw from that account until you add at least one address to the address book(s) or disable whitelisting for that specific account.