v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB

auth

Connect wallet (signup or recover)

Connect a wallet to Grove by proving ownership via signature.

New wallet: Creates account + server wallet + EOA wallet and returns JWT. Existing wallet: Regenerates the deterministic JWT and returns account details.

The JWT is deterministic: same signing_address + same JWT_SECRET = same token.

Possible outcomes

Case	Result	is_new_account
New wallet	Creates account, server wallet, returns new JWT	true
Existing account	Returns existing JWT + account details	false
Invalid signature	401 Unauthorized	—

post/v1/auth/wallet/connect

Request body

signing_addressstring required

signaturestring required

messagestring required

referral_codestring nullable

networkstring nullable

Response

Successful Response

account_idstring required

api_keystring required

tipping_addressstring required

earning_addressstring nullable

eoa_owner_addressstring nullable

smart_account_addressstring nullable

ERC-4337 Smart Account address (the earning wallet)

metadataobject nullable

is_new_accountboolean

referral_codestring required

referred_by_account_idstring nullable

eoa_wallet_requiredboolean

True when the account has no EOA wallet and must complete one-time wallet provisioning.

onchain_addressstring required

client_addressstring nullable required

earnings_addressstring nullable required