Sign in

v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
account

Verify signature and link wallet

Verify your wallet signature and complete the linking process.

Prerequisites:

  1. Must have called /account/wallets/challenge first
  2. Must sign the challenge message with the wallet being linked
  3. Signature must be submitted within 5 minutes

On success:

  • The wallet is linked to your account and can receive tips
  • The wallet is also added as an identity for login (unified linking)
  • If the wallet has an ENS name, it's automatically linked too

This is a unified operation - one link enables both earnings AND login.

Authentication: Authorization: Bearer <CLIENT_JWT>

post/v1/account/wallets/verify

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 being linked (must match challenge)

signaturestring required

Signature of the challenge message (EVM: hex 0x..., Solana: base58)

networkstring

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

Example request

{
  "address": "0x1234567890abcdef1234567890abcdef12345678"
}

Response

Successful Response

idstring required

Wallet ID

addressstring required

Wallet address

networkstring required

Network (base, base-sepolia, etc.)

wallet_typestring required

Type of wallet (smart_account, eoa_embedded, server, external_linked)

ens_namestring nullable

ENS name associated with this wallet (e.g., vitalik.eth)

base_namestring nullable

Base name associated with this wallet (e.g., jesse.base.eth)

display_namestring nullable

User-provided display name for the wallet

is_earning_walletboolean required

Whether this wallet can earn tips (true for smart_account wallets)

is_protectedboolean required

Whether this wallet can be unlinked (EOA/smart_account/server wallets cannot)

verified_atstring required

When wallet ownership was verified (ISO 8601)

verification_methodstring required

How ownership was verified (signature, cdp_auth, x402_payment)

created_atstring required

When the wallet was linked (ISO 8601)