Get a Session Grant Challenge

Build an unsigned EIP-712 SessionGrant for a wallet to sign. The signed grant is replayed verbatim in the X-EM-Session header. Stateless: this endpoint stores nothing and grants nothing.

post/api/v1/auth/session/challenge

Request

Base URL: https://api.execution.market
URL: https://api.execution.market/api/v1/auth/session/challenge
Auth: none required

Request body

walletstring required

Wallet that will sign the grant and act as principal

audiencestring nullable

Host the grant is bound to. Must be one of the deployment's authorities (see GET /auth/erc8128/info). Defaults to the first.

ttl_secondsinteger nullable

Requested lifetime in seconds. Capped at 900 by the server.

Response

Unsigned SessionGrant ready to be signed

typed_dataobject required

Complete EIP-712 payload: types, primaryType, domain, message

expires_atinteger required

Unix seconds when the grant stops being accepted

headerstring required

Header name to send the signed grant in

header_templateobject required

Header value shape: the message verbatim plus the signature

Changes

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