GRgrove
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

CaseResultis_new_account
New walletCreates account, server wallet, returns new JWTtrue
Existing accountReturns existing JWT + account detailsfalse
Invalid signature401 Unauthorized—
post/v1/auth/wallet/connect

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/auth/wallet/connect
  • Auth
    none declared

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

Changes

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