mcpField
U
use-circle-wallets

use-circle-wallets

github.com/circlefin開発160975 回インストール2 週間前に更新
リポジトリ

use-circle-wallets について

Circle ウォレットの種類を、カストディ、認証方法、アカウントタイプ、対象チェーンに基づいて選ぶエージェントスキルです。実装前に種類を推奨し、対応するスキルへ引き継ぎます。自身でオンチェーン操作は行いません。

主な機能

  1. 013種類の Circle ウォレットを比較
  2. 02カストディと認証方法で選択
  3. 03チェーンとアカウントタイプで絞り込み
  4. 04対応する実装スキルへ委任
  5. 05情報不足や操作上のリスクを提示

活用シーン

  1. 01新規アプリのカストディ方式を決定
  2. 02対象チェーンに応じてアカウントタイプを選択
  3. 03実装前に認証方法とユーザー承認を確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/circlefin/skills --skill use-circle-wallets

インストール後、Claude Code で/use-circle-walletsを入力して読み込まれたか確認します。

同梱ファイルreferences/example-scenarios.md

詳細

概要

Circle には、開発者管理型、ユーザー管理型、モジュラー型の 3 種類のウォレットがあり、それぞれカストディモデル、アカウント種別、鍵管理、機能が異なります。このスキルでは、適切な種類を選ぶ方法を説明します。

クイック比較

開発者管理型ユーザー管理型モジュラー型（パスキー）
カストディ開発者ユーザーユーザー
認証API キー + エンティティシークレット（バックエンド）ソーシャルログイン / メール OTP / PINパスキー（WebAuthn）
アカウント種別EOA、SCAEOA、SCAモジュラーウォレット SCA（ERC-6900）
ガス代のスポンサー提供Circle Paymaster 経由の SCACircle Paymaster 経由の SCACircle Paymaster またはサードパーティの paymaster
カスタムモジュールなしなしあり
アーキテクチャバックエンド SDK のみバックエンド + フロントエンド SDKフロントエンド SDK のみ

選択ガイド

各ブロックチェーンで最新の対応アカウント種別を確認するには：https://developers.circle.com/wallets/account-types

各ブロックチェーンで最新の対応機能を確認するには：https://developers.circle.com/wallets/supported-blockchains

  1. 鍵を管理するのは誰ですか？／カストディアンは誰ですか？
    • 開発者が管理する -> 開発者管理型ウォレット -> ステップ 3
    • エンドユーザーが管理する -> ステップ 2
  2. 認証方式は何ですか？
    • 拡張可能なモジュールを備えたパスキー（WebAuthn 生体認証） -> モジュラーウォレット -> ステップ 4
    • ソーシャルログイン、メール OTP、または PIN -> ユーザー管理型ウォレット -> ステップ 3
  3. アカウント種別は何ですか？
    • Solana、Aptos、または NEAR -> EOA（唯一の選択肢）
    • Ethereum メインネット -> EOA（SCA はガス代が高額で、モジュラーウォレットは非対応）
    • L2（Arbitrum、Base、Polygon、Optimism など） -> 最大 TPS が必要なら EOA、ガス代のスポンサー提供またはバッチ処理が必要なら SCA、パスキーやその他のモジュラープラグインが必要ならモジュラーウォレット
  4. チェーンの確認（モジュラーウォレット）
    • 対応：Arbitrum、Avalanche、Base、Monad、Optimism、Polygon、Unichain
    • 非対応：Ethereum、Solana、Aptos、NEAR。SCA を使用するユーザー管理型ウォレットに切り替えてください。
シナリオ例

一般的なシナリオと、それに対応するウォレット種別および実装に使用するスキルについては、references/example-scenarios.md を READ してください。

実装パターン

ウォレット種別を決定したら、対応するスキルを TRIGGER してください。

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

厳格なルール

  • 実装を始める前に、必ず比較表と上記の選択ガイドを使用してウォレット種別を選択してください。
  • Ethereum メインネット（SCA はガス代が高額で、モジュラーウォレットは非対応）および Solana、Aptos、NEAR（SCA／モジュラーウォレットは利用不可）では、必ず EOA を使用してください。
  • ガス代のスポンサー提供やバッチ処理が必要な場合は、L2 チェーン（Arbitrum、Base、Polygon、Optimism など）で必ず SCA またはモジュラーウォレットを優先してください。
  • 1 つのユーザーフローでウォレット種別を混在させないでください。1 種類を選び、対応するスキルを使用してください。
  • 実装は必ず、該当するウォレットスキル（use-developer-controlled-wallets、use-user-controlled-wallets、または use-modular-wallets）に委任してください。

安全性とエスカレーション

このスキルはウォレットの種類を推奨するだけです。オンチェーンへの書き込み、送金、署名、鍵操作は行いません。ウォレットの作成、署名、資金の送金、コントラクトのデプロイなど、すべての副作用は委任先の実装スキルで発生し、それらの操作に関する確認はそのスキルが担当します。

次の場合は、委任する前にエスカレーションしてください。

  • コンテキスト不足 — カストディモデル、対象チェーン、または認証方法が不明確な場合。ユーザーに尋ね、ウォレットの種類を推測しないでください。
  • アクセス不足 — ユーザーがCircleアカウント、APIキーとエンティティシークレット（開発者が管理）、または設定済みのパスキードメイン（モジュラー）を持っていない場合。まず設定するよう案内してください。
  • 安全でない影響 — 選択した方法でメインネット上の実際の資金が移動する場合。メインネットでの取引の前に、実装スキルがユーザーから明示的な確認を得る必要があることを伝えてください。
  • ユーザーの承認 — 実装スキルに引き継ぐ前に、選択したウォレットの種類をユーザーに確認してください。

参考リンク

免責事項：このスキルは「現状有姿」で提供され、保証はありません。また、Circle開発者規約が適用されます。生成された出力には誤りが含まれる場合や、手数料の設定オプション（Circleに支払われる手数料を含む）が含まれる場合があります。詳細は、リポジトリのREADMEをご覧ください。

コメント

Markdown 対応