Skip to main content
GET
Get a wallet authorization challenge
Request this challenge using your Ground API key. For an EOA, have that wallet sign the returned typedData.domain, typedData.types, and typedData.value. For a contract address, an authorized signer produces a signature that the contract accepts through ERC-1271 isValidSignature(bytes32,bytes). Send the signature with issuedAt and expiresAt to the allowlist endpoint. The challenge expires after five minutes. See Manage gtoken access for the full procedure.

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,
ground-tempo-prime-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