技能介绍

要解决什么问题

在 Web3 或「链上 rails」产品里，认证和钱包往往拆成两套系统：登录走 OAuth/短信，交易又要接 wagmi、助记词或外部扩展。Privy 把自托管嵌入式钱包与多种登录方式放在同一套 SDK 里，并覆盖 EVM、Solana，以及面向 Agent 的 x402、MPP 与策略化钱包。本技能把官方文档里的决策路径和参考文档索引整理成 Agent 可执行的集成说明，减少在过时 URL 上踩坑。

技能如何组织内容

技能内带 Workflow Decision Tree：按场景分流——React 鉴权、接 wagmi/viem、Node 服务端校验、x402/MPP 支付、Agent 钱包、Solana 专项、钱包策略与 Wallet Actions 等，再指向 references/*.md 细读。

核心包与职责大致如下：

@privy-io/react-auth：React 侧登录、钱包与 x402（v3.7.0+）
@privy-io/wagmi：wagmi v2 连接器（需从此包引入 createConfig / WagmiProvider，而非直接从 wagmi）
@privy-io/node：服务端 SDK（替代已弃用的 @privy-io/server-auth）
mppx：MPP 客户端/服务端，在 Tempo 上结算

Quick Start 覆盖 Next.js/React 的典型链路：PrivyProvider、就绪检查、邮箱 OTP 登录、EVM 发交易；另有白标登录 Hook 对照表、服务端 Token 校验、x402/MPP/Agentic Wallet 的入门段落。官方机器可读索引为 https://docs.privy.io/llms-full.txt；文档结构常变，技能明确提醒不要猜测路径以免 404。

适用边界与注意点

白标登录（如 useLoginWithEmail）从应用域名直连 Privy；若 Dashboard 未配置 Allowed Origins/Domains（含本地 dev 端口），会静默失败，而托管弹窗 usePrivy().login() 仍可用，容易误判。
useLoginWithEmail 的 onError 返回的是完整错误对象，不是简单的 {message}，调试时需整对象打日志。
Agent 钱包分 agent-controlled 与 user-owned + agent signers 两种控制模型，策略与授权细节见 references/agent-auth.md。
更完整的 Hook、Gas 赞助、Smart Wallet（ERC-4337）、Webhook、MCP 授权等，以技能列出的 Key Documentation URLs 与 reference 文件为准。