Skip to main content
GET
Get a wallet authorization challenge
Request this challenge using your Ground API key. Have the wallet sign the returned typedData.domain, typedData.types, and typedData.value, then send its signature together with issuedAt and expiresAt to the allowlist endpoint. The challenge expires after five minutes.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

gVaultId
enum<string>
required

Source ID returned by the gtoken yield-source catalogue.

Available options:
ground-ustb-vault
Example:

"ground-ustb-vault"

address
string
required

Valid nonzero EVM EOA or contract address. Mixed-case values must use a valid EIP-55 checksum.

Required string length: 42
Pattern: ^0x(?!0{40}$)[0-9a-fA-F]{40}$
Example:

"0x3bf25a73a1f1033c2d50ac65f3c9d6a44123db81"

Response

Wallet authorization challenge.

issuedAt
integer
required

Issuance time in Unix seconds.

expiresAt
integer
required

Expiry time in Unix seconds.

typedData
object
required