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 ​

Type: Address

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

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

isUserStrict ​

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[]