Skip to content

fetchUserContacts

This method provides a list of contact objects identifying all entities who previously granted authorization to a specified entity to send them email messages. Each contact contains the contact's ETH address as well as the ETH address for the protectedData containing their email address.

Usage

ts
const 
contactsList
= await
web3mail
.
fetchUserContacts
({
userAddress
: '0x789cba...',
});

Parameters

ts
import { type 
FetchUserContactsParams
} from '@iexec/web3mail';

userAddress Required *

Type: Address

The user for which you wish to obtain the list of contacts.

ts
const 
contactsList
= await
web3mail
.
fetchUserContacts
({
userAddress
: '0x789cba...',
});

isUserStrict Optional

Type: boolean

This parameter enables fetching contacts who granted access exclusively to the user and no one else.

TIP

When someone grants access, you can choose to grant access to a specific user (a wallet) or to any user (0x0000000000000000000000000000000000000000).

ts
const 
contactsList
= await
web3mail
.
fetchUserContacts
({
userAddress
: '0x789cba...',
isUserStrict
: true,
});

Return value

The result object contains a list of contact objects. Each contact represents one user who previously granted authorization for the user identified with userAddress to send them messages.

ts
import { type 
Contact
} from '@iexec/web3mail';

Contract[]