Every Console field that asks for a wallet or contract address opens a list you can search by name, and also takes an address you paste or type. A field that asks for several addresses, such as an allow list, a block list, an offering's presale list, a venue's zero-rated VAT participants or the identities a venue admits, keeps the chosen addresses as a list under the same search.
Search by name or paste an address
Open the field and type part of a name, a token symbol or part of an address. The list shows your recent choices first, then the best matches among the participants, tokens and contacts you can see. A field that takes only tokens lists only recent tokens. Select one, or move with the arrow keys and press Enter.
When more addresses match than the list shows, it says so, such as “Showing 25 of 140. Keep typing to narrow the list.”, and “Show more” lists more. In a field for a token in a large organisation the list may say only “Showing the first 25. Keep typing to narrow the list.” because it did not count every eligible participant.
In a field for a token, a row also says “Holds” and the amount when that wallet already holds some of the token, and “Verification pending” when the wallet's on-chain identity exists but is not registered yet. A user who may not read identities sees the holding only.
To use an address that is not in the list, paste the full 0x address. You can paste into the closed field, which opens with the pasted text as the search. A known address shows the name your directory holds for it. An address that matches no participant, token or contact you can see shows “Not in your directory” in a field that accepts outside addresses, and “This address is not one of the choices for this field.” in a field that only takes a known choice. A well-formed address can still be the wrong one, so check the name the field shows before you save.
A one-line filter in a table's toolbar, such as Client on a venue's Orders tab, shows only the warning icon, and the words when you point at it.
Refused addresses and what to do
The field flags a malformed address before you choose it:
Add several addresses
A list field shows the addresses it holds above an “Add an address” control. Add one by searching and choosing it. To add many, paste them: text split by commas, semicolons, new lines or spaces adds every address in it at once, so a column copied from a spreadsheet works. The line under the field says how many it added, how many it skipped because they were already in the list, and how many need fixing.
Each address in the list shows its name when it is known, and its own problem next to it when there is one:
- “Not an address. An address is 0x followed by 40 characters.” for text that is not an address.
- The messages from the table above.
- “This address is already in the list. Remove this copy.” for a second copy. A button above the list, such as “Remove 2 duplicates”, removes every copy in one step.
You cannot save the form while an address has a problem. Remove an address with its remove button, or the whole list with “Remove all”. Every removal shows Undo on the line under the field.
A list of more than five addresses shows the first five and every address with a problem. “Show more” reveals the rest fifty at a time.
Keyboard and screen readers
An address field works from the keyboard. In an open list, the arrow keys move, Enter chooses and Esc closes. In a list field, Tab reaches each remove button in turn, and after a removal focus moves to the next address. A screen reader reads the number of addresses, the problems and each change the field makes.
Table views covers the tables these fields filter, and Compliance Modules the allow and block lists they fill.