关于 use-circle-wallets
此 Agent 技能依据托管方式、认证方法、账户类型和目标链，帮助选择 Circle 钱包类型。它先推荐钱包，再将实现交给对应技能；本身不执行链上操作。
主要功能
- 01比较三种 Circle 钱包类型
- 02按托管方式与认证方法决策
- 03依据链和账户类型筛选
- 04将实现委派给对应技能
- 05提示缺失信息与操作风险
适用场景
- 01为新应用确定钱包托管模式
- 02依据目标链选择账户类型
- 03在实施前确认认证方式与用户批准
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/use-circle-wallets确认已加载。
附带文件references/example-scenarios.md
详细介绍
概述
Circle 提供三种钱包类型——开发者控制型、用户控制型和模块化型——它们的托管模式、账户类型、密钥管理方式和功能各不相同。本技能可帮助你选择合适的钱包。
快速对比
| 开发者控制型 | 用户控制型 | 模块化型（Passkey） | |
|---|---|---|---|
| 托管方 | 开发者 | 用户 | 用户 |
| 认证方式 | API key + entity secret（后端） | 社交登录 / 邮箱 OTP / PIN | Passkey（WebAuthn） |
| 账户类型 | EOA、SCA | EOA、SCA | 模块化钱包 SCA（ERC-6900） |
| Gas 赞助 | 通过 Circle Paymaster 提供 SCA | 通过 Circle Paymaster 提供 SCA | Circle Paymaster 或第三方 Paymaster |
| 自定义模块 | 否 | 否 | 是 |
| 架构 | 仅后端 SDK | 后端 + 前端 SDK | 仅前端 SDK |
决策指南
不同区块链上支持的最新账户类型：https://developers.circle.com/wallets/account-types
不同区块链上支持的最新功能：https://developers.circle.com/wallets/supported-blockchains
- 谁控制密钥 / 谁是托管方？
- 开发者控制 -> 开发者控制型钱包 -> 转至步骤 3
- 最终用户控制 -> 转至步骤 2
- 认证方式？
- 带可扩展模块的 Passkey（WebAuthn 生物识别）-> 模块化钱包 -> 转至步骤 4
- 社交登录、邮箱 OTP 或 PIN -> 用户控制型钱包 -> 转至步骤 3
- 账户类型？
- Solana、Aptos 或 NEAR -> EOA（唯一选项）
- Ethereum 主网 -> EOA（SCA 的 Gas 成本过高，且不支持模块化钱包）
- L2（Arbitrum、Base、Polygon、Optimism 等）-> 需要最高 TPS 时选择 EOA；需要 Gas 赞助或批量处理时选择 SCA；需要 Passkey 或其他模块化插件时选择模块化钱包
- 检查链支持情况（模块化钱包）
- 支持：Arbitrum、Avalanche、Base、Monad、Optimism、Polygon、Unichain
- 不支持：Ethereum、Solana、Aptos、NEAR。请改用带 SCA 的用户控制型钱包。
示例场景
阅读 references/example-scenarios.md，了解常见场景对应的钱包类型决策和实现技能。
实现模式
确定钱包类型后，触发相应技能：
- 开发者控制型 ->
use-developer-controlled-wallets技能 - 用户控制型 ->
use-user-controlled-wallets技能 - 模块化型（Passkey）->
use-modular-wallets技能
严格规则
- 开始实现前，始终使用上方的对比表和决策指南选择钱包类型。
- 在 Ethereum 主网（SCA 的 Gas 成本过高，且不支持模块化钱包）以及 Solana、Aptos、NEAR 上（不支持 SCA / 模块化钱包），始终使用 EOA。
- 在 L2 链（Arbitrum、Base、Polygon、Optimism 等）上，如果需要 Gas 赞助或批量操作，始终优先选择 SCA 或模块化钱包。
- 切勿在同一用户流程中混用钱包类型——选定一种，并使用对应的技能。
- 实现时始终委托给特定的钱包技能（
use-developer-controlled-wallets、use-user-controlled-wallets或use-modular-wallets）。
安全与升级处理
此技能仅推荐钱包类型；它本身不会执行任何链上写入、转账、签名或密钥操作。所有副作用——创建钱包、签名、发送资金、部署合约——都由受委派的实现技能执行，该技能负责为这些操作获取确认。
在委派前，遇到以下情况时应升级处理：
- 缺少上下文——托管模式、目标链或身份验证方式不明确。请询问用户，不要猜测钱包类型。
- 缺少访问权限——用户没有 Circle 账户、API 密钥和实体密钥（由开发者控制），或尚未配置通行密钥域（模块化）。请引导用户先完成设置。
- 不安全的影响——所选路径会在主网上转移真实资金。请明确指出，实现技能必须在执行任何主网交易前获得用户的明确确认。
- 用户批准——在移交给实现技能前，请与用户确认所选的钱包类型。
参考链接
- 账户类型
- 选择钱包类型
- 密钥管理
- Circle 开发者文档 -- 查找源网站上的相关文档时，请务必先阅读此文档。
免责声明：此技能按“原样”提供，不提供任何保证，并受 Circle 开发者条款约束；生成的输出可能包含错误和/或费用配置选项（包括支付给 Circle 的费用）；更多详情请参阅仓库中的 README。
评论
支持 Markdown