majiayu000 Web3 (thirdweb v5) + SIWE Auth (Stacked Poker)
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
Documentation sources (don’t paste full docs)
- 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-apiMCP server (see.cursor/mcp.json) for up-to-date references.
Debug workflow (common issues)
- Confirm env is set:
NEXT_PUBLIC_THIRDWEB_CLIENT_IDNEXT_PUBLIC_API_URLNEXT_PUBLIC_WS_URL
- Confirm CSP allows thirdweb embedded wallet frames and network:
frame-srcincludeshttps://embedded-wallet.thirdweb.comconnect-srcallows 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
What to load next
- 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.