Authentication

Complete wallet sign-in and get a JWT

Verifies the signature over the challenge message and returns an ordinary user JWT — the same token social login and email-OTP produce.

First sign-in for an address creates a user and org. That user's email starts synthetic (email_pending: true) and unverified: a wallet signature proves possession of a key, not a reachable person. Staking redemption refuses until a real address is added and confirmed.

The wallet recovered from the signature is stored on the account and is the identity staking points are counted against. It is never accepted from a request body anywhere.

post/v1/auth/siwe/verify

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/auth/siwe/verify
  • Auth: none required

Request body

messagestring required

The challenge message, unmodified

signaturestring required

Hex signature over the message

Response

Authenticated

tokenstring
user_idstring uuid
org_idstring uuid
wallet_addressstring
is_new_userboolean
email_pendingboolean

True while the account email is still the synthetic wallet address. Redemption is blocked until a real one is verified.

Changes

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