Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Web app

clc-app workspace, apps/web. PWA. Vite+.

vp install
vp dev apps/web     # :3000
vp build
vp test

Node version is .node-version in that repo.

Auth model

Public market is the default route. A connected wallet is not enough.

Authenticated ⇔ wagmi connected and GET /auth/session returns that same address.

Client stateMeaning
loadingreconnect / session in flight
guestno wallet
connectedNoSessionwallet up, no matching cookie
authenticatedwallet + session match
sessionCheckError5xx / network. Do not demote mounted private UI

Connectors:

  • private-key: paper wallet, SIWE
  • calibur-webauthn: passkey, POST /auth/webauthn/verify

Gnosis wiring

Point the app at:

https://gnosis-staging.cosmolocal.credit     # API
https://gnosis-storage.cosmolocal.credit     # uploads

Chain ID 100. Calibur 0x48A910C8e9FF0b14051b78d0c96dB069E57f0729.

CORE_RELAYER__ALLOWED_ORIGINS on the API host must include the Pages hostname (https://app.gnosis.cosmolocal.credit, https://clc-app-gnosis.pages.dev, preview https://*.clc-app-gnosis.pages.dev).

Passkeys bind to CORE_RELAYER__RELYING_PARTY_ID (gnosis.cosmolocal.credit on staging).