Contacts is your personal address book in the Console: a name saved next to one wallet address, so address pickers in issuance, transfer and settlement forms offer the counterparty by name instead of a pasted 42-character address. A contact is a label on an address. It creates no login, grants no permission and registers no on-chain identity. Every operation that later uses the address runs its own eligibility and compliance checks.
Every contact belongs to the account that saved it. No other user can list, read, change or delete it, and there is no shared organisation address book.
A contact is not tied to an organisation either: you see the same contacts in every organisation you belong to, and the Investor portal shows the same address book to an investor. Removing a member from an organisation does not remove their contacts. A contact is not a user, which is a person who signs in, and not an entity, which is a contract identity the organisation tracks.
The page lists your saved contacts, sorted by name.
Each row shows the contact name with the wallet's avatar and short address, and the created date. The updated date and the full wallet address are hidden columns that you turn on from the column picker. A contact whose wallet is one of your own wallets carries a Me badge. An empty list shows “No contacts yet” with “Add contacts to quickly reuse wallet addresses.” A failed load shows “Failed to load contacts. Please try again.” instead of an empty table.
Steps
Open Contacts
Open “Personal”, then Contacts. Before you add a contact, search the list with “Search by name or wallet…”, because each wallet can appear on only one of your contacts.
Add the contact
- Select Add contact to open its form page.
- Enter the “Contact name”, from 1 to 120 characters. The field counts the characters as you approach that limit and refuses a longer name instead of cutting it. Two contacts can share a name.
- In “Wallet address”, open the picker, then pick a known participant or contact by name, or paste the
0xaddress and select it from the list. Typing alone does not fill the field: you must select an entry. - Select Save contact. “Cancel” returns to Contacts without saving.
The “Add contact” page with the “Contact name” field and the “Wallet address” picker.
The page is described as “Store counterparty wallets you reuse during settlement or issuance.” The “Contact name” field shows a character count, and the form ends with “Cancel” and “Save contact” buttons. Save contact stays disabled until the name has a character other than a space and an address is selected.
The picker accepts a 0x address only. It refuses a name ending in “.eth” with “Names ending in .eth are not supported here. Paste the 0x address instead.” It also refuses a pasted address whose capitals do not match its checksum, with “The capitals in this address do not match its checksum, so it may be mistyped. Copy it again from the source.”, and offers nothing to select. The platform stores the address in lowercase, so the same address in different capitals is the same wallet. The picker also refuses the zero address, which belongs to no one and can only lose what is sent to it, and states the reason under the field.
Review the saved contact
The Console shows “Contact saved” and returns to Contacts. Open the contact from the list. The header shows the name with the wallet's avatar, the shortened wallet address with a copy button, “Edit”, and an Actions menu with “Copy address” and “Delete”. The menu also offers “View on explorer” when the network has a block explorer configured.
To compare the full address with your approved source, use the copy button or “Copy address”, or turn on the “Wallet address” column on Contacts. Below the header, the page brings together what the platform already shows you elsewhere about that wallet:
- Activity with this contact lists the latest ten events that name the wallet and that you can see in Activity, newest first. Select a row to open the event, or “View all in Activity” to search Activity for the wallet.
- Open settlements lists the XvP settlements, the exchanges where both sides' assets move together or not at all, with the wallet that are still pending, waiting for a secret or ready, when the organisation has the XvP add-on. You see the settlements the Settlements page would show you.
- Identity names the users and participants in the active organisation that hold the wallet, each linked to its own page. It shows the wallet's on-chain identity registration only when you hold the system manager, identity manager or verification issuer role, or when the wallet is your own. It also shows the date you added the contact.
- Holdings lists the wallet's balances when it belongs to a participant whose holdings you may read. When you may not read them, the section is not shown.
A contact page with its header, activity, open settlements, identity and holdings.
The header shows the name, the shortened wallet address with a copy button, “Edit” and the “Actions” menu. The “Activity with this contact”, “Open settlements”, “Identity” and “Holdings” sections follow.
Edit or delete a contact
Select Edit on the contact page to open the “Edit contact” page. Change the name or the wallet, then select “Save changes”. The Console shows “Contact updated” and returns to the contact. “Cancel” or the contact breadcrumb returns without saving. An edit overwrites the contact: the contact page keeps no history of earlier names or addresses. Turn on the “Updated” column to see when a contact last changed.
To delete a contact, open “Actions” and select Delete. The Console deletes it at once, returns you to the list, and shows “Contact deleted” with “Undo” for 8 seconds. Undo saves the contact again with the same name and wallet, and its created date starts over. After the message closes, add the contact again to restore it.
An operation that already used the address keeps its own record of it. Nobody is told when you save, edit or delete a contact, including the counterparty. Each save, edit and delete is still recorded in the audit trail as Create or update contact or “Delete contact”, with you as the actor.
Refresh a contact's avatar
A contact's avatar comes from the ENS avatar of its wallet, the image a wallet owner publishes through the Ethereum Name Service, when the deployment has ENS configured. Select Refresh the ENS avatar on the contact page to read it again. The control shows only when the deployment has ENS configured.
You can refresh one wallet's avatar once every ten minutes. Inside that window the control is disabled and says “Available again in about 4 minutes.”, with the remaining minutes. When the refresh stores nothing new, the control says why: the address has no ENS avatar, the stored avatar is already current, an administrator suppressed the avatar of this address, or the hourly avatar budget is spent and the next refresh reads the address.
Where the picker offers your contacts
When you pick a wallet that receives tokens, the address picker offers your contacts next to the organisation's participants. It does not offer contacts where a form asks for a participant. An entry that is both a contact and a participant appears once.
When the form names a token, the picker hides each contact the token would refuse as a recipient, and says how many it hid, such as “2 hidden, not eligible for NWC.”. It names the two causes it cannot tell apart: a required verification is missing, or the issuer of the verification is not trusted for the token. Verifying again does not help in the second case, because an issuer trusted for the topic has to issue the verification. Show all shows them anyway. The hiding uses the same recipient check the form runs on the recipient you pick: an active registration in the token's identity registry or in the identity registry of your organisation's system, its deployment on that network, plus the claims and allow lists the token's compliance requires. A token that your organisation's system did not deploy hides every contact. A hidden contact stays in your address book.
In a large organisation the picker checks participants one page at a time. When it lists only the first matches, it says “Showing the first 25. Keep typing to narrow the list.” and “Some participants may be hidden, not eligible for NWC.” instead of counts. Show all still shows them, and typing narrows the list until the counts return.
What a saved contact does not check
A picked contact and a pasted address reach the same operation check, because saving a contact checks nothing.
Picking a contact fills the address field. It does not review the address. Nothing in the platform compares the saved address with the source you copied it from, so compare the full address with that source before you send value to it.
A contact carries no compliance status. If the counterparty's wallet loses eligibility after you save it, the contact does not change and is not flagged. The next operation that uses the address evaluates it at that moment.
Troubleshooting
Saving refuses the wallet as a duplicate
The form shows “You already have a contact for this wallet. Open that contact to rename it.” Another of your contacts already holds the wallet, in any capitals. The platform saves nothing and leaves the existing contact unchanged. Open that contact and edit it instead.
The contact does not appear
Clear the search, or search for part of the wallet address instead of the name. Search matches any part of the name or the address. If the page shows “Failed to load contacts. Please try again.”, reload the page.
A contact link opens the contacts list instead
The contact no longer exists, or it belongs to another user. Contacts are private, so a link that another user shares with you never opens their contact.
The picker hides a contact for a token
The token's recipient check refuses the contact's wallet for that action. Ask the counterparty to complete registration and the verifications the token requires, which Verify a participant describes, or select Show all when you need the address for another reason.
The Refresh the ENS avatar control is missing
The deployment has no ENS configured, so the platform cannot read avatars. The contact keeps the avatar it has.