Sign in

v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
account

Get a challenge to link a new wallet

Request a challenge message to link a new wallet to your account.

Flow:

  1. Call this endpoint with the wallet address you want to link and the network it belongs to
  2. Sign the returned message with your wallet
  3. Call /account/wallets/verify with the signature

The challenge expires after 5 minutes.

Note: The wallet must not already be linked to another account. Account merging is not yet supported.

Authentication: Authorization: Bearer <CLIENT_JWT>

post/v1/account/wallets/challenge

Headers

authorizationstring nullable

Bearer JWT issued by Grove that identifies the account.

Bearer JWT issued by Grove that identifies the account.

Request body

addressstring required

Wallet address to link (EVM: 0x..., Solana: base58)

networkstring

Network for this wallet (base, base-sepolia, solana-devnet, etc.)

Example request

{
  "address": "0x1234567890abcdef1234567890abcdef12345678"
}

Response

Successful Response

addressstring required

Wallet address being linked

messagestring required

Message to sign with your wallet to prove ownership

expires_atstring required

When the challenge expires (ISO 8601). Sign before this time.