Auth
POST /v1/auth/siwe/verify
Verify a SIWE message + signature. Issues a session cookie on success.
Verify a SIWE message + signature. Issues a session cookie on success.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/auth/siwe/verify" \ -H "Content-Type: application/json" \ -d '{ "message": "string", "signature": "string" }'{ "ok": true, "user_id": "string", "eoa": "string", "expires_at": "string", "is_new": true}{ "error": "string", "message": "string", "feature": "string", "field": "string", "plan": "string", "retry_after_sec": 0, "retry_after_seconds": 0, "reason": "string", "issues": [ null ], "trace_id": "string"}{ "error": "string", "message": "string", "feature": "string", "field": "string", "plan": "string", "retry_after_sec": 0, "retry_after_seconds": 0, "reason": "string", "issues": [ null ], "trace_id": "string"}{ "error": "string", "message": "string", "feature": "string", "field": "string", "plan": "string", "retry_after_sec": 0, "retry_after_seconds": 0, "reason": "string", "issues": [ null ], "trace_id": "string"}{ "error": "string", "message": "string", "feature": "string", "field": "string", "plan": "string", "retry_after_sec": 0, "retry_after_seconds": 0, "reason": "string", "issues": [ null ], "trace_id": "string"}{ "error": "string", "message": "string", "feature": "string", "field": "string", "plan": "string", "retry_after_sec": 0, "retry_after_seconds": 0, "reason": "string", "issues": [ null ], "trace_id": "string"}{ "error": "string", "message": "string", "feature": "string", "field": "string", "plan": "string", "retry_after_sec": 0, "retry_after_seconds": 0, "reason": "string", "issues": [ null ], "trace_id": "string"}{ "error": "string", "message": "string", "feature": "string", "field": "string", "plan": "string", "retry_after_sec": 0, "retry_after_seconds": 0, "reason": "string", "issues": [ null ], "trace_id": "string"}POST /v1/auth/siwe/nonce POST
Issue a SIWE nonce. Single-use, 5-minute TTL.
POST /v1/auth/terms/accept POST
Record that the signed-in account accepts the terms. `version` must be the current one (GET /v1/auth/me `terms.current`); another value is a 400 `terms_version_mismatch` carrying `current`. Accepting twice keeps the first timestamp. Nothing is blocked on acceptance.