Trusted Beneficiary

Initiate marking a USDC address as Trusted Beneficiary

Only USDC, USDC_POLYGON, and USDC_SOL addresses are eligible; other currencies are rejected with 30075 (CURRENCY_NOT_TRUSTABLE).

post/wallets/beneficiary/address/trust

Request body

userIdstring required

whitelistedAddressIdstring required

verificationMethod'sms' | 'totp' | 'passkey'

Defaults to sms when omitted.

Response

Challenge issued. Factor-specific fields populated based on verificationMethod (challengeId+dateExpires for sms, options+allowedOrigins+relyingPartyId for passkey, ok for totp).

verificationMethod'sms' | 'totp' | 'passkey' required

okboolean

challengeIdstring

dateExpiresstring

allowedOriginsstring[]

relyingPartyIdstring