👛use-circle-wallets
- プラグイン
- circle-skills
- ソース
- GitHub で見る ↗
説明
アプリケーションに適したCircleウォレットの種類を選択し、実装します。 開発者管理型、ユーザー管理型、モジュラー型(パスキー)ウォレットを、カストディモデル、鍵管理、アカウントタイプ、対応ブロックチェーン、ユースケースの観点から比較します。 次のような場合に使用: オンチェーンアプリケーション開発においてブロックチェーンウォレットの統合が必要な場合。 トリガーワード: ウォレットの選定、ウォレット選択、ウォレット比較、EOA vs SCA vs モジュラーウォレット、カストディモデル、プログラマブルウォレット。
原文を表示
Choose and implement the right Circle wallet type for your application. Compares developer-controlled, user-controlled, and modular (passkey) wallets across custody model, key management, account types, blockchain support, and use cases. Use whenever blockchain wallet integrations are required for onchain application development. Triggers on: which wallet, choose wallet, wallet comparison, EOA vs SCA vs Modular Wallet, custody model, programmable wallets.
ユースケース
- ✓オンチェーンアプリケーション開発でウォレット統合が必要なとき
- ✓複数のウォレットタイプから最適なものを選定するとき
- ✓カストディモデルと鍵管理を比較検討する場面
- ✓ブロックチェーン対応状況を確認する必要があるとき
本文(日本語訳)
概要
Circleは3種類のウォレットタイプを提供しています。 デベロッパーコントロール型、ユーザーコントロール型、モジュラー型の3種類で、それぞれカストディモデル、アカウントタイプ、鍵管理、機能が異なります。 このスキルは、最適なウォレットタイプの選択をサポートします。
クイック比較
| デベロッパーコントロール型 | ユーザーコントロール型 | モジュラー型(Passkey) | |
|---|---|---|---|
| カストディ | デベロッパー | ユーザー | ユーザー |
| 認証 | APIキー + エンティティシークレット(バックエンド) | ソーシャルログイン / メールOTP / PIN | Passkey(WebAuthn) |
| アカウントタイプ | EOA、SCA | EOA、SCA | モジュラーウォレット SCA(ERC-6900) |
| ガススポンサーシップ | 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
ステップ1 -- 鍵を管理するのは誰か?(カストディアンの確認)
- デベロッパーが管理する -> デベロッパーコントロール型ウォレット -> ステップ3へ
- エンドユーザーが管理する -> ステップ2へ
ステップ2 -- 認証方式は?
- 拡張可能なモジュールを備えたPasskey(WebAuthn生体認証)-> モジュラーウォレット -> ステップ4へ
- ソーシャルログイン、メールOTP、またはPIN -> ユーザーコントロール型ウォレット -> ステップ3へ
ステップ3 -- アカウントタイプは?
- Solana、Aptos、またはNEAR -> EOA(唯一の選択肢)
- Ethereumメインネット -> EOA(SCAはガスコストが高すぎるため非推奨、モジュラーウォレットは非対応)
- L2(Arbitrum、Base、Polygon、Optimismなど)->
- 最大スループット(TPS)が必要な場合は EOA
- ガススポンサーシップまたはバッチ処理が必要な場合は SCA
- Passkeyやその他のモジュラープラグインが必要な場合はモジュラーウォレット
ステップ4 -- チェーン確認(モジュラーウォレット)
- 対応チェーン: Arbitrum、Avalanche、Base、Monad、Optimism、Polygon、Unichain
- 非対応チェーン: Ethereum、Solana、Aptos、NEAR → 非対応の場合は、SCA付きのユーザーコントロール型ウォレットにフォールバックしてください。
シナリオ別の選択例
| シナリオ | 選択 | スキル |
|---|---|---|
| 決済バックエンド、プログラムによる送金、高スループット | デベロッパーコントロール型 + EOA | use-developer-controlled-wallets |
| Google/Appleログイン対応のコンシューマーアプリ、ガスレスUX | ユーザーコントロール型 + L2上のSCA | use-user-controlled-wallets |
| 生体認証とカスタムモジュールを使ったDeFiアプリ | L2上のモジュラーウォレット | use-modular-wallets |
| Ethereum L1上のNFTマーケットプレイス | ユーザーコントロール型 + EOA | use-user-controlled-wallets |
| AIエージェント、自律的なマルチチェーントランザクション | デベロッパーコントロール型 + EOA | use-developer-controlled-wallets |
実装パターン
ウォレットタイプが決定したら、対応するスキルをトリガーしてください:
- デベロッパーコントロール型 ->
use-developer-controlled-walletsスキル - ユーザーコントロール型 ->
use-user-controlled-walletsスキル - モジュラー型(Passkey)->
use-modular-walletsスキル
厳守ルール
- 実装を開始する前に、上記の比較表と選択ガイドを用いて必ずウォレットタイプを選定すること。
- Ethereumメインネット(SCAはガストコストが高すぎるため非推奨、モジュラーウォレットは非対応)、およびSolana・Aptos・NEAR(SCA・モジュラーウォレットが利用不可)では、必ずEOAを使用すること。
- ガススポンサーシップまたはバッチ処理が必要な場合、L2チェーン(Arbitrum、Base、Polygon、Optimismなど)では必ずSCAまたはモジュラーウォレットを優先すること。
- 単一のユーザーフロー内でウォレットタイプを混在させないこと。1つのタイプを選択し、対応するスキルのみを使用すること。
- 実装には必ず対応するウォレットスキル(
use-developer-controlled-wallets、use-user-controlled-wallets、またはuse-modular-wallets)に委譲すること。
参考リンク
- アカウントタイプ
- ウォレットタイプの選び方
- 鍵管理
- Circle デベロッパードキュメント -- 公式サイトのドキュメントを参照する際は、必ず最初にこちらを参照すること。
免責事項: このスキルは現状のまま("as is")提供され、いかなる保証も伴いません。Circle デベロッパー利用規約が適用されます。また、生成されるアウトプットにはエラーが含まれる場合や、手数料設定オプション(Circleへの手数料を含む)が含まれる場合があります。詳細はリポジトリのREADMEをご確認ください。
原文(English)を表示
Overview
Circle offers three wallet types -- developer-controlled, user-controlled, and modular -- each with different custody models, account types, key management, and capabilities. This skill helps you pick the right one.
Quick Comparison
| Developer-Controlled | User-Controlled | Modular (Passkey) | |
|---|---|---|---|
| Custody | Developer | User | User |
| Auth | API key + entity secret (backend) | Social login / email OTP / PIN | Passkey (WebAuthn) |
| Account types | EOA, SCA | EOA, SCA | Modular Wallet SCA (ERC-6900) |
| Gas sponsorship | SCA via Circle Paymaster | SCA via Circle Paymaster | Circle Paymaster or third-party paymaster |
| Custom modules | No | No | Yes |
| Architecture | Backend SDK only | Backend + frontend SDKs | Frontend SDK only |
Decision Guide
For the latest supported account types on different blockchains: https://developers.circle.com/wallets/account-types
For the latest supported features on different blockchains: https://developers.circle.com/wallets/supported-blockchains
Step 1 -- Who controls the keys / who is the custodian?
- Developer controls -> Developer-controlled wallets -> Step 3
- End user controls -> Step 2
Step 2 -- Auth method?
- Passkey (WebAuthn biometric) with extensible modules -> Modular wallets -> Step 4
- Social login, email OTP, or PIN -> User-controlled wallets -> Step 3
Step 3 -- Account type?
- Solana, Aptos, or NEAR -> EOA (only option)
- Ethereum mainnet -> EOA (SCA gas costs prohibitive, Modular Wallet not supported)
- L2 (Arbitrum, Base, Polygon, Optimism, etc.) -> EOA if max TPS needed; SCA if gas sponsorship or batching needed; Modular Wallet if passkey or other modular plugins needed
Step 4 -- Chain check (Modular wallets)
- Supported: Arbitrum, Avalanche, Base, Monad, Optimism, Polygon, Unichain
- NOT supported: Ethereum, Solana, Aptos, NEAR. Fall back to user-controlled wallets with SCA.
Example Scenarios
| Scenario | Decision | Skill |
|---|---|---|
| Payment backend, programmatic payouts, high TPS | Developer-controlled + EOA | use-developer-controlled-wallets |
| Consumer app with Google/Apple login, gasless UX | User-controlled + SCA on L2 | use-user-controlled-wallets |
| DeFi app with biometric auth, custom modules | Modular Wallet on L2 | use-modular-wallets |
| NFT marketplace on Ethereum L1 | User-controlled + EOA | use-user-controlled-wallets |
| AI agent, autonomous multi-chain transactions | Developer-controlled + EOA | use-developer-controlled-wallets |
Implementation Patterns
Once a wallet type has been determined, TRIGGER the corresponding skill:
- Developer-controlled ->
use-developer-controlled-walletsskill - User-controlled ->
use-user-controlled-walletsskill - Modular (Passkey) ->
use-modular-walletsskill
Strict Rules
- ALWAYS select the wallet type before starting implementation using the comparison table and decision guide above.
- ALWAYS use EOA on Ethereum mainnet (SCA gas prohibitive, Modular Wallet not supported) and on Solana, Aptos, NEAR (SCA/Modular Wallet not available).
- ALWAYS prefer SCA or Modular Wallet on L2 chains (Arbitrum, Base, Polygon, Optimism, etc.) when gas sponsorship or batch operations are needed.
- NEVER mix wallet types in a single user flow -- pick one and use its corresponding skill.
- ALWAYS delegate to the specific wallet skill (
use-developer-controlled-wallets,use-user-controlled-wallets, oruse-modular-wallets) for implementation.
Reference Links
- Account Types
- Choosing Your Wallet Type
- Key Management
- Circle Developer Docs -- Always read this first when looking for relevant documentation from the source website.
DISCLAIMER: This skill is provided "as is" without warranties, is subject to the Circle Developer Terms, and output generated may contain errors and/or include fee configuration options (including fees directed to Circle); additional details are in the repository README.
原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。