SKILLOfficialdevelopment

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ウォレットを選択するとき
異なるウォレットタイプを比較検討するとき
ウォレット管理方式を決定するときき
オンチェーンアプリ開発にウォレット統合するとき

本文（日本語訳）

概要

Circle は3つのウォレット（暗号資産の管理ツール）タイプを提供しています。それぞれ異なる管理方式、アカウント種別、鍵管理、機能を備えています。このスキルはあなたに最適なウォレットを選ぶのを助けます。

開発者管理型：開発者が鍵を管理
ユーザー管理型：ユーザーが鍵を管理
モジュール型（パスキー）：ユーザーが生体認証で鍵を管理できる拡張可能なウォレット

機能比較表

	開発者管理型	ユーザー管理型	モジュール型（パスキー）
管理者	開発者	ユーザー	ユーザー
認証方式	APIキー + エンティティシークレット（バックエンド）	ソーシャルログイン / メールOTP / PIN	パスキー（WebAuthn）
アカウント種別	EOA、SCA	EOA、SCA	モジュール型SCA（ERC-6900）
ガス代補助	SCA（Circle Paymaster経由）	SCA（Circle Paymaster経由）	Circle Paymaster または第三者Paymaster
カスタムモジュール	不可	不可	可能
実装方式	バックエンドSDKのみ	バックエンド + フロントエンドSDK	フロントエンドSDKのみ

ウォレット選択ガイド

最新の対応アカウント種別と対応ブロックチェーンについては、公式ドキュメントをご確認ください。

選択フロー

1. 鍵の管理者は誰か？

開発者が管理 → 開発者管理型ウォレット → ステップ3へ
エンドユーザーが管理 → ステップ2へ

2. 認証方式は？

パスキー（生体認証）で拡張可能 → モジュール型ウォレット → ステップ4へ
ソーシャルログイン、メールOTP、またはPIN → ユーザー管理型ウォレット → ステップ3へ

3. アカウント種別は？

Solana、Aptos、NEAR → EOA（唯一の選択肢）
Ethereumメインネット → EOA推奨（SCAはガス代が高い、モジュール型は非対応）
L2チェーン（Arbitrum、Base、Polygon、Optimism等）
- 最高速が必要 → EOA
- ガス代補助やトランザクションまとめ処理が必要 → SCA
- パスキーや他のモジュール拡張が必要 → モジュール型

4. チェーン確認（モジュール型ウォレット用）

対応: Arbitrum、Avalanche、Base、Monad、Optimism、Polygon、Unichain
非対応: Ethereum、Solana、Aptos、NEAR → ユーザー管理型（SCA対応）にフォールバック

実装例

よくあるユースケースと、各ケースに適したウォレットタイプの選択方法については、参考資料をご覧ください。

実装の流れ

ウォレットタイプが決定したら、対応するスキルを実行してください：

開発者管理型 → use-developer-controlled-wallets スキル
ユーザー管理型 → use-user-controlled-wallets スキル
モジュール型（パスキー） → use-modular-wallets スキル

重要なルール

必ず最初に上記の比較表と選択ガイドを使ってウォレットタイプを確定してください
必ずEthereumメインネット、Solana、Aptos、NEARではEOAを使用してください（SCAはガス代が高い、またはそもそも利用不可）
必ずL2チェーン（Arbitrum、Base、Polygon、Optimism等）でガス代補助やバッチ処理が必要な場合はSCAまたはモジュール型ウォレットを優先してください
決して1つのユーザーフローで複数のウォレットタイプを混ぜないでください。1つに決めて対応するスキルを使用してください
必ず具体的な実装は対応するウォレットスキル（use-developer-controlled-wallets、use-user-controlled-wallets、use-modular-wallets）に委譲してください

安全性と対応のポイント

このスキルはウォレットタイプの推奨のみを行い、ブロックチェーンへの書き込み、送金、署名、鍵操作は一切実行しません。ウォレット作成、署名、送金、契約デプロイなどすべての実際の操作は、委譲先の実装スキルで行われ、そのスキルが確認を管理します。

次の場合は委譲前に確認が必要です：

情報不足：管理方式、対象チェーン、認証方式が明確でない場合 → ユーザーに確認して、推測でウォレットタイプを選ばないでください
アクセス権限がない：Circle アカウント、APIキー + エンティティシークレット、またはパスキードメイン設定がない場合 → ユーザーにセットアップを促してください
実際の資金が動く：選択したパスはメインネットで実際の資金を移動させる可能性がある場合 → 実装スキルはメインネットトランザクション前に必ず明示的なユーザー確認を取得するよう注意してください
ユーザー承認：選択したウォレットタイプを実装スキルへ渡す前にユーザーに確認してください

参考リンク

アカウント種別
ウォレットタイプの選択
鍵管理
Circle開発者ドキュメント — 公式サイトから関連ドキュメントを探すときは、まずこちらをご確認ください

免責事項：このスキルは「現状のまま」提供され、いかなる保証も伴いません。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

Who controls the keys / who is the custodian?
- Developer controls -> Developer-controlled wallets -> step 3
- End user controls -> 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
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
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

READ references/example-scenarios.md for common scenarios mapped to a wallet-type decision and the skill to implement it.

Implementation Patterns

Once a wallet type has been determined, TRIGGER the corresponding skill:

Developer-controlled -> use-developer-controlled-wallets skill
User-controlled -> use-user-controlled-wallets skill
Modular (Passkey) -> use-modular-wallets skill

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, or use-modular-wallets) for implementation.

Safety & Escalation

This skill only recommends a wallet type; it performs no on-chain writes, transfers, signing, or key operations itself. Every side effect — creating a wallet, signing, sending funds, deploying a contract — happens in the delegated implementation skill, which owns confirmation for those actions.

Escalate before delegating when:

Missing context — the custody model, target chain, or auth method is unclear. Ask the user; do not guess a wallet type.
Missing access — the user lacks a Circle account, an API key + entity secret (developer-controlled), or a configured passkey domain (modular). Direct them to set that up first.
Unsafe effects — the selected path will move real funds on mainnet. Flag that the implementation skill must obtain explicit user confirmation before any mainnet transaction.
User approval — confirm the chosen wallet type with the user before handing off to the implementation skill.

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 による自動翻訳です。