name	web3-thirdweb-siwe
description	Implement and debug wallet connection and authentication in this repo using thirdweb v5 and the SIWE-style flow in `app/hooks/useWalletAuth.ts` and `app/hooks/server_actions.ts`. Use for ConnectButton setup, account state, signature/auth verification, Base/USDC config, and CSP issues with embedded wallet.

Web3 (thirdweb v5) + SIWE Auth (Stacked Poker)

Name: web3-thirdweb-siwe
Author: Stacked-Labs

Repo entry points

thirdweb client + wallets: app/thirdwebclient.ts
Provider wiring: app/providers.tsx
Connect UI: app/components/WalletButton.tsx
Auth orchestration: app/hooks/useWalletAuth.ts, app/contexts/AuthContext.tsx
Backend calls: app/hooks/server_actions.ts
Security headers / embedded wallet frames: next.config.js

thirdweb LLM docs (per repo rules): https://portal.thirdweb.com/llms.txt
thirdweb full LLM docs: https://portal.thirdweb.com/llms-full.txt
thirdweb API docs: https://api.thirdweb.com/llms.txt
Use the thirdweb-api MCP server (see .cursor/mcp.json) for up-to-date references.

Confirm env is set:
- NEXT_PUBLIC_THIRDWEB_CLIENT_ID
- NEXT_PUBLIC_API_URL
- NEXT_PUBLIC_WS_URL
Confirm CSP allows thirdweb embedded wallet frames and network:
- frame-src includes https://embedded-wallet.thirdweb.com
- connect-src allows required hosts
Trace auth flow:
- getAuthPayload(address) → returns { payload, message }
- account.signMessage({ message }) (sign the message string)
- verifySignedPayload({ payload, signature })
- On failure, disconnect wallet and clear attempt ref

For the repo’s exact auth sequence and edge cases: read references/auth-flow.md.
For CSP gotchas (embedded wallet / Turnstile / Tenor): read references/csp-and-headers.md.
To quickly sanity-check env vars: run scripts/check-web3-env.sh.