GRgrove
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

Request

  • Base URL
    https://api.grove.city (the document declares no server; this is the origin it was published from)
  • URL
    https://api.grove.city/v1/account/wallets/challenge
  • Auth
    none declared

Headers

authorizationstring nullable

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.

Changes

No recorded changes to this operation across all 1 revision of this API.