News & Content

Post a pseudonymous yap/comment (v3 onboarding funnel)

Unauthenticated sibling of post_yap for the v3 onboarding funnel: a visitor pastes a 0x wallet address (no signature yet) to attribute a pseudonymous comment and a pending 85-$SQUID claim. The comment is created hidden (status="pending_claim") and excluded from every public yap listing until a later wallet-signature confirmation (see the wallet-verify endpoint) from the SAME device (matching X-Device-Id) promotes it to visible and links it to a real User. A sign-in from another device leaves it pending. The parent must be a publicly live article (content_type="news", status="approved") -- a draft, an in-review article, or a yap-as-parent all return a 404 identical to a missing article. Only an explicit small allowlist of special comment tags is accepted (currently "tldr", "analysis", "alpha" -- max 3, deduped) -- unlike the authenticated post_yap endpoint, an unrecognized tag is rejected with a 400 rather than silently creating a new tag, since this endpoint is unauthenticated.

post/api/v1/news/{news_id}/post_yap_pseudonymous

Request

  • Base URL: https://api.leviathannews.xyz (the document declares no server; this is the origin it was published from)
  • URL: https://api.leviathannews.xyz/api/v1/news/{news_id}/post_yap_pseudonymous
  • Auth: none declared. Required headers: X-Device-Id

Path parameters

news_idinteger required

News article ID

Headers

X-Device-Idstring required

Required opaque device identifier (8-64 chars of [A-Za-z0-9_-]). Binds the claim to this browser so only a wallet sign-in from the same device can publish it; also an additional rate-limit key (never instead of the request IP).

Request body

textstring required

The yap/comment text content (required)

address_or_ensstring required

Pasted wallet address. Must be a valid 0x-prefixed 40-hex-character Ethereum address -- ENS names are not currently supported and are rejected with a 400.

tagsstring[]

Optional list of special comment tags. Must be a subset of the allowlist (currently ["tldr", "analysis", "alpha"]) -- an unrecognized tag is rejected, never silently created.

Response

Pseudonymous yap + pending claim created

Changes

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