web3-thirdweb-siwe

实现和调试此仓库中钱包连接和认证,使用第三web v5和SIWE风格流程在`app/hooks/useWalletAuth.ts`和`app/hooks/server_actions.ts`中。用于连接按钮设置、账户状态、签名/认证验证、基础/USDC配置以及嵌入式钱包的CSP问题。

📖 中文导读:实现和调试此仓库中钱包连接和认证,使用第三web v5和SIWE风格流程在`app/hooks/useWalletAuth.ts`和`app/hooks/server_actions.ts`中。用于连接按钮设置、账户状态、签名/认证验证、基础/USDC配置以及嵌入式钱包的CSP问题。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

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)

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)

Debug workflow (common issues)

  1. Confirm env is set:
    • NEXT_PUBLIC_THIRDWEB_CLIENT_ID
    • NEXT_PUBLIC_API_URL
    • NEXT_PUBLIC_WS_URL
  2. Confirm CSP allows thirdweb embedded wallet frames and network:
    • frame-src includes https://embedded-wallet.thirdweb.com
    • connect-src allows required hosts
  3. 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.