Auth

Get SIWE message

Generate an EIP-4361 message and single-use nonce valid for 5 minutes. Programmatic clients omit Origin; browsers send their console Origin. Sign the returned message verbatim with an Ethereum mainnet EOA using EIP-191 personal_sign. Contract wallets and smart accounts are unsupported. purpose=login requires no session; purpose=link requires the current session.

post/auth/siwe/challenge

Request

  • Base URL: https://console-api.blockvectra.com/v1
  • URL: https://console-api.blockvectra.com/v1/auth/siwe/challenge
  • Auth: one of:
    • none
    • HTTP bearer

Request body

addressstring required

EOA address. Must be a valid EIP-55 checksum if mixed case.

purpose'login' | 'link' required

login for login / sign-up; link to link wallet to current session user (requires session).

Response

Message and nonce.

noncestring required
messagestring required

EIP-4361 message (LF line endings, no trailing newline), up to 2048 bytes.

expires_atstring date-time required

RFC 3339 UTC, second precision, ending in Z (2026-09-26T08:00:00Z); no fractional seconds, without +00:00 timezone offsets.

Example response

{
  "expires_at": "2026-09-26T08:00:00Z"
}

Changes

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