Sign in with Denpa — step 1: challenge

POST

/api/protocol/v1/auth/challenge

• Protocol hub (Next.js) — federation, writes, receipts, market context

Creates an authorization request (10 min). Public clients must send PKCE S256. Financial scopes (wallet:*) are refused. Returns the authorizeUrl the user must visit. 30/min per IP.

Request Body ^required

object

client_id

required

string

Example

dapp_basetv

redirect_uri

required

string

Example

https://basetv.tv/auth/denpa/callback

scope

required

string

Example

profile:read signal:create

state

string

code_challenge

string

code_challenge_method

string

Allowed values: S256

Responses

201

Challenge

object

challengeId

string

authorizeUrl

string

Example

https://denpa.ai/authorize?challenge=…

expiresAt

string

scopes

Array<string>

400

invalid_request / invalid_scope / invalid_grant

object

error

required

Stable machine-readable code (snake_case) or a short reason.

string

message

string

key

additional properties

any

403

Origin not allowed

object

error

required

Stable machine-readable code (snake_case) or a short reason.

string

message

string

key

additional properties

any

429

Rate_limited

object

error

required

Stable machine-readable code (snake_case) or a short reason.

string

message

string

key

additional properties

any