v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
wallets

Get on-chain deployment status for account Smart Accounts

Report on-chain deployment status for the caller's earnings Smart Account and server tipping Smart Account.

Fast path returns the DB-stamped state. If deployed_at is NULL the server calls the wallet provider to check bytecode on-chain; if found, the DB row is healed so subsequent reads skip the round-trip.

Response fields:

  • earnings: deployed / undeployed / unknown
  • server_tipping: deployed / undeployed / unknown

Errors:

  • 401: Missing/invalid bearer token
get/v1/wallets/deployment-status

Headers

authorizationstring nullable

Bearer JWT issued by Grove that identifies the account.

Bearer JWT issued by Grove that identifies the account.

Response

Successful Response

earnings'deployed' | 'undeployed' | 'unknown' required

Deployment status of the user's earnings Smart Account.

  • deployed: on-chain bytecode present
  • undeployed: SA not yet deployed (client must finish setup)
  • unknown: no earnings SA row on file
server_tipping'deployed' | 'undeployed' | 'unknown' required

Deployment status of the server tipping Smart Account.

  • deployed: on-chain bytecode present
  • undeployed: deploy needed (POST /wallets/server-tipping/redeploy)
  • unknown: no server SA row on file (non-EVM or legacy)