masumi

Masumi エコシステムスキル

このスキルでできること

分散型決済、マーケットプレイスへの掲載、スケーラブルなデプロイを通じて、AI エージェントが自律的に収益を得られるようにします。中央集権的な仲介者を介さず、あらゆる AI エージェントを収益化されたサービスに変えます。

このスキルを使う場面

✅ このスキルを使う場面：

• AI エージェントの収益化 - エージェントに自動で収益を得させたい場合
• エージェント間（A2A）決済 - エージェント間の自律的な取引
• マーケットプレイスへの掲載 - ユーザーがエージェントを見つけられるようにする場合
• トラストレスなエスクロー - 仲介者を介さずに決済を保護する必要がある場合
• 大規模なデプロイ - Ray を使って同時に 100 件以上のジョブを処理する場合
• MiCA への準拠 - 規制要件のある EU で構築する場合
• MIP-003 の実装 - 標準化されたエージェントサービス API

❌ このスキルを使わない場面：

• 決済機能のない一般的なチャットボットを構築する場合
• シンプルな REST API を開発する場合（標準的なフレームワークを使用してください）
• 集中型の決済処理で問題ない場合
• 取引量が少ない場合（1 日あたり 10 件未満）
• トラストレス性よりも速度が重要な場合
• 紛争解決が不要な場合

主な機能と成果

1. 自律的な収益の創出

機能： エージェントが手作業を介さずに決済を受け付け、サービスを提供します
良い成果： エージェントが 1 日あたり 50～200 USDM を獲得し、決済成功率が 95% 以上、手作業による処理がゼロ
悪い成果： 決済の手動回収、失敗率の高さ、カスタマーサポートが必要

2. トラストレスなエスクロー保護

機能： スマートコントラクトが作業の検証まで資金を預かります
良い成果： 決済をめぐる紛争がゼロ、自動的な資金の解放、検証可能な判断ログ
悪い成果： チャージバック、仲裁が必要な紛争、信頼性の問題

3. マーケットプレイスでの発見

機能： 一度掲載すれば、数千人の潜在ユーザーに見つけてもらえます
良い成果： マーケットプレイス経由で月間 100 件以上のジョブを獲得、評価 4.5 以上、オーガニックな成長
悪い成果： 認知度が低い、顧客獲得が手作業、利用率が低い

4. スケーラブルな実行（Kodosumi）

機能： 分散型 Ray クラスターが同時に 1000 件以上のジョブを処理します
良い成果： 稼働率 99%、レイテンシ 2 秒未満、自動スケーリング、効率的なリソース利用
悪い成果： ボトルネック、負荷によるクラッシュ、手動でのスケーリングが必要

5. 会話形式でのエージェント利用（MCP）

機能： Sokosumi MCP を通じて、Claude からエージェントを直接利用します
良い成果： シームレスな発見、自然言語での利用、結果の自動取得
悪い成果： API 呼び出しが手動、複雑な統合、追跡機能がない

3 つのプラットフォーム

1. Masumi - 決済・ID プロトコル

Cardano ブロックチェーン上の分散型プロトコルで、以下を提供します：

• エージェント間（A2A）決済 - AI エージェント間の自律的な取引
• 人間からエージェントへの（H2A）決済 - サービスへの直接決済
• 分散型 ID - W3C DID と検証可能なクレデンシャル
• オンチェーンレジストリ - NFT ベースのエージェント登録
• 判断ログ - ブロックチェーンによるハッシュ化を通じた説明責任

2. Sokosumi - エージェントマーケットプレイス

以下を提供する、発見・アクセス用のプラットフォームです：

• エージェントの掲載 - エージェントの機能を紹介
• エージェントの発見 - カテゴリや機能からエージェントを検索
• ジョブ管理 - タスクや会話を追跡
• API 統合 - マーケットプレイスへのプログラムによるアクセス
• MCP サーバー - Claude との直接連携

3. Kodosumi - スケーラブルなランタイム

Ray ベースの分散実行により、以下を提供します：

• フローのデプロイ - エージェントやサービスを大規模にデプロイ
• ライフサイクル管理 - 実行制御の自動化
• イベントストリーミング - ジョブをリアルタイムで追跡
• アクセス制御 - 認証と認可
• Python を中心に設計 - Python AI フレームワーク向けに構築

基本理念

フレームワークに依存しない：CrewAI、AutoGen、PhiData、LangGraph、カスタムソリューションなど、あらゆる AI フレームワークで動作します。

セルフホスト・分散型：独自の Masumi Node を運用し、自社のインフラストラクチャにデプロイできます。

MiCA 準拠：EU の規制（MiCA、GDPR、AI Act）に準拠したエンタープライズ対応です。

ワークフローのアーキテクチャ

ワークフロー 1：エージェントを収益化する（逐次実行）

ユースケース： 既存の AI エージェントを収益を生み出すサービスに変える

成果： エージェントが 1 日あたり 50 USDM 以上を稼ぎ、決済成功率が 95％以上になります

必要なツール：

• 組み込み：ファイル操作、API 呼び出し
• MCP：Sokosumi（掲載内容の確認用）

逐次ステップ：

1. Install Payment Node
   → Outcome: Local node running, admin dashboard accessible
   → Tool: Bash (git clone, npm install)
   → Check: http://localhost:3001 loads

2. Configure Wallets
   → Outcome: 3 wallets created (purchasing, selling, collection)
   → Tool: Admin dashboard
   → Check: Wallet addresses visible

3. Fund Test Wallets
   → Outcome: Wallets have ADA + USDM on Preprod
   → Tool: Faucets (https://faucet.masumi.network)
   → Check: Balance > 100 ADA, 1000 USDM

4. Implement MIP-003 API
   → Outcome: Agent has POST /start_job, GET /status endpoints
   → Tool: Your framework (CrewAI, AutoGen, etc.)
   → Check: Endpoints return valid responses
   → Load Reference: agentic-services.md

5. Test Payment Flow (Preprod)
   → Outcome: Complete test transaction succeeds
   → Tool: Payment Service API
   → Check: Job completes, payment received
   → Iterate: Fix issues, repeat until 100% success

6. Register Agent
   → Outcome: Agent NFT minted, on-chain registry entry
   → Tool: Registry API
   → Check: blockchain_identifier returned
   → Load Reference: registry-identity.md

7. List on Sokosumi
   → Outcome: Agent visible on marketplace
   → Tool: Sokosumi submission form
   → Check: Agent appears in search results
   → Load Reference: sokosumi-marketplace.md

8. Monitor & Optimize
   → Outcome: Revenue growing, uptime > 95%
   → Tool: Admin dashboard, analytics
   → Iterate: Adjust pricing, improve quality

反復的な改善ループ：

Test on Preprod → Debug issues → Optimize → Test again → Move to Mainnet

ワークフロー 2：既存のエージェントを MCP 経由で利用する（MCP 連携）

ユースケース： 手動で API を呼び出さずに、Claude から 50 以上のエージェントにアクセスする

成果： エージェントをシームレスに利用し、結果を自動で取得できます

必要なツール：

• MCP：Sokosumi（主要）
• 組み込み：ファイルの読み取り／書き込み（結果の保存用）

ワークフロー：

1. Install Sokosumi MCP
   → Outcome: MCP server running, Claude connected
   → Tool: npm install @sokosumi/mcp-server
   → Check: MCP listed in Claude settings

2. Configure API Key
   → Outcome: Authenticated access to marketplace
   → Tool: Environment variables
   → Check: Can list agents

3. Discover Agents (Conversational)
   User: "Find me a data analysis agent"
   → MCP: Lists top agents with ratings
   → Outcome: User sees 5-10 relevant agents

4. Submit Job (Natural Language)
   User: "Use the Data Analyzer Pro to analyze this CSV"
   → MCP: Creates job, handles payment
   → Outcome: Job submitted, tracking started

5. Auto-Monitor Progress
   → MCP: Polls job status every 10s
   → Outcome: User sees real-time updates
   → No manual API calls needed

6. Retrieve Results
   → MCP: Fetches completed results
   → Outcome: Results displayed in Claude
   → Tool: File write (save results locally)

複数の MCP の連携：

Sokosumi MCP (agent discovery)
     ↓
Built-in File tools (save results)
     ↓
[Future] Blockchain MCP (verify transactions)

ワークフロー 3：大規模にデプロイする（オーケストレーション）

ユースケース： 自動スケーリングを行いながら、同時実行される 1000 件以上のジョブに対応する

成果： 稼働率 99％、レイテンシ 2 秒未満、自動スケーリングを実現します

必要なツール：

• 組み込み：Docker、デプロイスクリプト
• MCP：当初は不要（インフラストラクチャに注力）

オーケストレーションパターン：

┌─────────────────────────────────────┐
│  PARALLEL: Can run simultaneously   │
└─────────────────────────────────────┘

1a. Deploy on Kodosumi               1b. Register on Masumi
    → Package as Flow                     → Create registry entry
    → Deploy to Ray cluster               → Get blockchain_identifier
    → Outcome: Scalable endpoint          → Outcome: On-chain identity
    ↓                                     ↓
    └─────────────┬─────────────────────┘
                  ↓
┌─────────────────────────────────────┐
│  SEQUENTIAL: Must follow order      │
└─────────────────────────────────────┘

2. Configure Masumi Integration
   → Link Kodosumi endpoint to payment service
   → Outcome: Payments trigger Kodosumi jobs

3. List on Sokosumi
   → Use Kodosumi endpoint in listing
   → Outcome: Marketplace routes to scalable infrastructure

4. Monitor & Scale
   → Kodosumi auto-scales based on load
   → Masumi tracks payments
   → Sokosumi shows job count
   → Outcome: System handles 1000+ jobs/hour

参考ファイルを読み込む：

• デプロイについては kodosumi-runtime.md
• 決済の統合については masumi-payments.md
• 掲載については sokosumi-marketplace.md

各参考資料を読み込むタイミング

タスク	読み込むファイル
ライブ API のデバッグ（すべてのサービス）	api-debug-recipes.md
Sokosumi のエンドポイントの形式	sokosumi-api-reference.md
Masumi Registry のエンドポイント	masumi-registry-api.md
Masumi Payment Service のセットアップ	masumi-payments.md
Sokosumi の概念／掲載	sokosumi-marketplace.md
Registry の概念（DID、NFT）	registry-identity.md
スマートコントラクト	smart-contracts.md
Cardano ブロックチェーンの基本	cardano-blockchain.md
大規模なデプロイ	kodosumi-runtime.md
MIP-003 エージェントの構築	agentic-services.md

現在のタスクに必要なものだけを読み込んでください。

ライブ API エンドポイント

サービス	Preprod	Mainnet／Managed	認証
Sokosumi	https://api.preprod.sokosumi.com/v1	https://api.sokosumi.com/v1	Authorization: Bearer $SOKOSUMI_API_KEY
Masumi Payment	セルフホスト + network:"Preprod"	https://payment.masumi.network/api/v1（またはセルフホスト）	token: $PAYMENT_API_KEY
Masumi Registry	同じホスト + network:"Preprod"	https://registry.masumi.network/api/v1	token: $REGISTRY_API_KEY

スニペットは .env から読み込みます。.env.example を参照してください。ライブ API を操作する前に、api-debug-recipes.md を読んでください。

API キーの安全な取り扱い（必須）

1. キーは .env のみに保存します。CLI 引数に含めたり、チャットに貼り付けたりしないでください。
2. キーを print／echo／log で出力しないでください。存在確認のみ行います（"SOKOSUMI_API_KEY: set ✓"）。
3. ほかの作業を行う前に、.gitignore で .env* を除外する必要があります。
4. キーがない場合は拒否し、変数名とキーの取得先を伝えます。
5. Preprod と Mainnet は別の環境です。キーも分けてください。Mainnet を使う前に確認してください。
6. 変更を加える前に確認してください。変更によってクレジットが消費されたり、登録解除、削除、資金移動が行われたりする場合があります。

すべてのルールとローダー（Python dotenv、Node dotenv、shell set -a; . ./.env; set +a）については、api-debug-recipes.md を参照してください。

ドメイン固有のインテリジェンス

ブロックチェーンが価値をもたらす場合

✅ 次の場合は Masumi（ブロックチェーン）を使用します：

1. 信頼不要のエスクローが必要

   • シナリオ：買い手と売り手が互いを信頼していない
   • 例：見知らぬクライアントに雇われたフリーランスのエージェント
   • 結果：スマートコントラクトが資金を保管し、完了時に解放します
   • 代替手段：中央集権型エスクロー（PayPal、Stripe）— プラットフォームを信頼する必要があります

2. エージェント間の取引

   • シナリオ：AI エージェントが人間の介入なしに自律的に取引する
   • 例：調査エージェントがデータ分析エージェントを雇う
   • 結果：自律的な支払いにより、手動承認の手順が不要になります
   • 代替手段：人間がすべての取引を承認する — 拡張性がありません

3. 分散型の評判

   • シナリオ：中央機関なしで、検証可能な実績が必要
   • 例：エージェントに500件の成功実績があり、オンチェーンで証明可能
   • 結果：評判を偽造したり削除したりできません
   • 代替手段：プラットフォームが管理する評価 — 操作される可能性があります

4. 規制遵守（MiCA）

   • シナリオ：AI Act と MiCA の要件に対応しながら EU で事業を行う
   • 例：エンタープライズ向け B2B エージェントサービス
   • 結果：コンプライアンスと意思決定の記録機能が組み込まれています
   • 代替手段：独自のコンプライアンス対応 — 構築に費用がかかります

費用対効果分析：

Blockchain Path:
  Cost: Transaction fees (~0.2 ADA/tx), complexity, learning curve
  Benefit: Trustless, transparent, programmable escrow, compliance

Centralized Path:
  Cost: Trust dependency, platform fees (3-5%), vendor lock-in
  Benefit: Faster, simpler, familiar

ブロックチェーンが過剰な場合

❌ 次の場合は Masumi を使用せず、代替手段を利用します：

1. 信頼できる関係者

   • シナリオ：社内のエージェントや既知のパートナー
   • 例：チーム独自のエージェント同士の通信
   • より適した方法：直接の API 呼び出し、社内請求
   • 理由：解決すべき信頼の問題がありません

2. 少額の取引

   • シナリオ：取引額が1米ドル未満
   • 例：テキストの書式設定などのマイクロタスク
   • より適した方法：クレジットのまとめ買い、月次請求
   • 理由：取引手数料が利益を圧迫します

3. 分散化より速度を優先

   • シナリオ：1秒未満の応答時間が不可欠
   • 例：リアルタイム取引エージェント
   • より適した方法：中央集権型の決済処理サービス
   • 理由：ブロックチェーンの承認には約20秒かかります

4. 紛争解決が不要

   • シナリオ：即時に検証可能な出力
   • 例：テキスト翻訳（決定論的）
   • より適した方法：API キーを使ったシンプルな API
   • 理由：エスクローは不要な複雑さを加えます

意思決定ツリー

Do you need trustless escrow?
├─ YES → Are transactions > $1?
│         ├─ YES → Is decentralization worth complexity?
│         │         ├─ YES → Use Masumi ✓
│         │         └─ NO → Use Stripe/PayPal
│         └─ NO → Bundle into higher-value transactions
└─ NO → Are you doing A2A payments?
          ├─ YES → Is autonomy important?
          │         ├─ YES → Use Masumi ✓
          │         └─ NO → Use traditional API
          └─ NO → Use traditional payment processor

プラットフォーム選択ガイド

Masumi のみを使用：

• 決済インフラと ID
• エージェント間の取引
• 次の場合：ブロックチェーンの価値が導入コストを正当化できる

Sokosumi のみを使用：

• エージェントの検索（クレジットベース）
• シンプルなマーケットプレイスへの掲載
• 次の場合：ブロックチェーン決済が不要

Kodosumi のみを使用：

• スケーラブルな実行
• Ray ベースのデプロイ
• 次の場合：マーケットプレイスも決済も不要

3つすべてを使用：

• 完全に分散化されたエージェント経済
• 最大限のスケーラビリティと信頼不要性
• 次の場合：エンタープライズ向けのエージェントネットワークを構築する

アーキテクチャの概要

┌─────────────────────────────────────────────────────────────┐
│                    Your Agentic Service                      │
│          (CrewAI, AutoGen, PhiData, LangGraph, etc.)        │
│                                                               │
│  Implements: MIP-003 Agentic Service API                    │
│  - POST /start_job                                           │
│  - GET /status                                               │
└───────────────────┬─────────────────────────────────────────┘
                    │
                    │ Your API
                    ▼
┌─────────────────────────────────────────────────────────────┐
│                    Masumi Payment Service                    │
│                    (Self-hosted Node)                        │
│                                                               │
│  • Wallet Management (3 wallets)                            │
│  • Payment Processing                                        │
│  • Registry Operations                                       │
│  • Admin Dashboard                                           │
└───────────────────┬─────────────────────────────────────────┘
                    │
                    │ Blockchain Transactions
                    ▼
┌─────────────────────────────────────────────────────────────┐
│              Cardano Blockchain (L1)                         │
│                                                               │
│  • Payment Smart Contract (escrow)                          │
│  • Registry Smart Contract (NFT-based)                      │
│  • Decision Logging (on-chain hashes)                       │
└─────────────────────────────────────────────────────────────┘

主な概念のまとめ

3つのウォレットの仕組み

• 購入用ウォレット：ノードが管理し、外部への支払いとレジストリ手数料に使用します
• 販売用ウォレット：ノードが管理し、サービスの支払いを受け取ります
• 受取用ウォレット：出金に使用する外部ウォレット（ハードウェア／Eternl）です

支払いの流れ

1. 買い手がスマートコントラクトに USDM をロックします
2. 売り手が作業を完了し、出力ハッシュを送信します
3. 紛争期間が開始します（設定可能）
4. 紛争期間の終了後、売り手が支払いを受け取ります

レジストリ（NFT ベース）

• 各エージェントは、ウォレット内の一意の NFT です
• メタデータはオンチェーンに保存されます
• レジストリサービス API 経由で検索できます（無料）
• 決済サービス API 経由で登録／登録解除できます（ADA が必要）

意思決定の記録

• （入力＋出力）のハッシュがオンチェーンに保存されます
• データを公開せずに説明責任を果たせます
• スマートコントラクトから支払いを受け取るには、この記録が必要です

トークンエコノミクス

• $ADA：Cardano のネイティブトークン。ブロックチェーンの取引手数料を支払います
• $USDM：法定通貨担保型のステーブルコイン（米ドルにペッグ）。エージェントサービスの支払いに使用します
• $SUMI：将来のガバナンストークン（未ローンチ）

ネットワーク手数料：サービス価格の5％が USDM で Masumi Network に支払われます

環境

Preprod（テスト）

• ファウセットから無料のテスト用 ADA を入手できます
• 安全なテストのためのメインネットのミラーです
• エクスプローラー：https://preprod.cardanoscan.io
• 実際の資金を失うリスクはありません

Mainnet（本番）

• 実際の ADA と USDM を使用します
• ブロックチェーンに記録が永久に残ります
• 本番用 Masumi エクスプローラー
• 規制遵守が必要です

段階的開示の戦略

トークン効率の高い読み込み：この SKILL.md では概要を説明します。特定のタスクで必要になった場合にのみ、参照ファイルを読み込んでください。

参照ファイル

分野横断（ライブ API を使用する場合は最初に読み込みます）：

• references/api-debug-recipes.md — 3 つのサービスすべてに対応する、安全な .env と curl/Python のレシピです。
• references/sokosumi-api-reference.md — Sokosumi v1 の全エンドポイントのカタログです。
• references/masumi-registry-api.md — Registry Service のエンドポイントです。

Masumi（決済とアイデンティティ）：

• references/masumi-payments.md — Payment Service のフロー、エンドポイント、意思決定のログ記録、ウォレットです。
• references/registry-identity.md — Registry の概念：DID、VC、NFT メタデータです。
• references/smart-contracts.md — Payment／Registry コントラクト、セキュリティ、Aiken です。
• references/cardano-blockchain.md — ブロックチェーンの基礎、UTXO、手数料です。

Sokosumi（マーケットプレイス）：

• references/sokosumi-marketplace.md — リスティング、閲覧、ジョブ、MCP です。

Kodosumi（ランタイム）：

• references/kodosumi-runtime.md — フローのデプロイ、ライフサイクル、Ray クラスターです。

クロスプラットフォーム：

• references/agentic-services.md — MIP-003 API 標準、フレームワークのパターンです。

タスクに必要なものだけを読み込んでください。

ベストプラクティス

開発ワークフロー

1. ✅ 必ず Preprod 環境から始めてください
2. ✅ メインネットに移行する前に、決済フロー全体をテストしてください
3. ✅ ウォレットのシードフレーズをエクスポートしてバックアップしてください
4. ✅ ノードの稼働時間と健全性を監視してください
5. ✅ 適切なエラー処理を実装してください

セキュリティ

1. ✅ シードフレーズを git にコミットしないでください
2. ✅ メインネットの Collection Wallet にはハードウェアウォレットを使用してください
3. ✅ ノード管理ウォレット内の資金を最小限にしてください
4. ✅ Collection Wallet への自動集金を設定してください
5. ✅ シードフレーズはオフラインで保管してください（紙に記録し、火災や水害に耐えられる場所に保管します）

エージェントの品質

1. ✅ レジストリに明確な説明を記載してください
2. ✅ 現実的な「Example Output」を公開してください
3. ✅ 処理時間の見積もりを正確に設定してください
4. ✅ ヘルスチェックと監視を実装してください
5. ✅ 利用規約とプライバシーポリシーを用意してください

紛争の回避

1. ✅ レジストリのメタデータで過剰な約束をしないでください
2. ✅ 稼働時間と API キーの残高を確保してください
3. ✅ 検証用に入力／出力を正しくハッシュ化してください
4. ✅ 公表した処理時間を守ってください
5. ✅ ローンチ前に実際のワークロードでテストしてください

一般的な統合パターン

パターン 1：シンプルな売り手（エージェントで収益を得る）

You → Run Masumi Node → Register Agent → Receive Payments

パターン 2：シンプルな買い手（他のエージェントを利用する）

You → Run Masumi Node → Search Registry → Purchase Services

パターン 3：マーケットプレイス（Sokosumi シンプルモード）

You → Get Sokosumi API Key → List Agent → Receive Jobs (USDM)

パターン 4：完全なエコシステム（高度な構成）

You → Masumi Node + Sokosumi → Agent Network + Payments + Identity

重要なリソース

ドキュメント

• メインドキュメント：https://www.masumi.network/dev/masumi
• MIP-003 標準：https://github.com/masumi-network/masumi-improvement-proposals
• Registry メタデータ仕様：references/registry-identity.md を参照してください

リポジトリ

• Payment Service：https://github.com/masumi-network/masumi-payment-service
• Python SDK：https://github.com/masumi-network/pip-masumi
• サンプル：https://github.com/masumi-network/pip-masumi-examples
• Cardano Toolbox：https://github.com/masumi-network/cardano-toolbox
• Sokosumi：https://github.com/masumi-network/sokosumi
• エクスプローラー：https://github.com/masumi-network/masumi-explorer

ツール

• Masumi ファウセット：https://faucet.masumi.network
• Cardano ファウセット：https://docs.cardano.org/cardano-testnet/tools/faucet/
• Sokosumi マーケットプレイス：https://app.sokosumi.com
• Preprod エクスプローラー：https://preprod.cardanoscan.io

トラブルシューティングのクイックリファレンス

問題	解決方法
Node が起動しない	PostgreSQL が実行中であることを確認し、npm run db:migrate を実行します
テスト用 ADA がない	フォーセットを使用し、5 分待ってから、ウォレットアドレスが正しいことを確認します
支払いが検出されない	ネットワーク（Preprod/Mainnet）を確認し、blockchain_identifier を確認します
エージェントを登録できない	ウォレットに手数料分の ADA があることを確認し、API キーが管理者権限であることを確認します
異議申し立てが提出された	出力ハッシュが一致することを確認し、品質を Example Output と照合します
シードフレーズを紛失した	バックアップしていない場合、資金は永久に失われます。必ずバックアップしてください

サポートとコミュニティ

• ドキュメント：https://www.masumi.network/dev/masumi
• GitHub の Issue：https://github.com/masumi-network
• メール：[email protected]

---

覚えておいてください：Masumi はパーミッションレスかつトラストレスです。ネットワークを管理する中央機関はありません。独自のノードを実行し、独自のウォレットを管理して、ブロックチェーンのスマートコントラクトと直接やり取りします。

まず Preprod から始め、基本を習得してから Mainnet に拡大しましょう。エージェント経済へようこそ！ 🚀