Zen7-Payment-Agent MCP Server

公式

Zen7 Payment Agentは、DePA（分散型決済エージェント）の最初の実装プロジェクトであり、次世代のインテリジェント決済インフラを先駆けます。

ドキュメント

Zen7 Payment Agent

リアルタイムの進捗状況は Real-time progress ページで確認できます。 x402プロトコルのサポートについては、こちらをクリックしてください。

Zen7 Payment Agentは、DePA（分散型決済エージェント）の初の実用的実装であり、次世代のインテリジェント決済インフラストラクチャを切り開くものです。DePAのコア機能を完全に実装するだけでなく、エージェントコマース領域における革新的なアプリケーションケースの展開にも成功しています。

DePAエコシステムにおける最初の実用的プロジェクトとして、Zen7はエージェント間の自動暗号化決済、「パーミッションレス認証」メカニズム、LLM駆動の意図認識とインタラクションといった、いくつかの主要機能を実装しています。

Zen7 Payment Agentはマルチエージェント協調アーキテクチャを採用し、A2AおよびMCPプロトコル、カストディ型およびノンカストディ型の決済モデルをサポートしています。マルチチェーン、マルチ通貨、マルチウォレット対応、高頻度取引、ガスレスオペレーション、パスワードレス認証を備えた、AIエージェントおよびネイティブDappアプリケーション向けの包括的な決済ソリューションを提供します。

リポジトリの概要

このリポジトリには、Zen7 Payment Agentの完全な実装が含まれており、Zen7 Payment Agent（分散型決済エージェント）プロトコルに基づくコアコンポーネントとアーキテクチャ設計を示しています。

コアディレクトリ構造

プロジェクトのコア実装は、以下の主要ディレクトリに配置されています。

host_agent - マルチエージェント協調アーキテクチャのコア実装。ホストエージェントは gemini-2.0-flash-lite モデルをコアコーディネーターとして使用し、クエリ理解、状態管理、応答調整を担当します。サブエージェントシステム（sub_agents/）には、5つの専門エージェントが含まれます。payer_agent は支払者の注文作成、EIP-712署名生成、ウォレット残高検証を処理します。settlement_agent は決済プロセスに焦点を当て、支払詳細の確認、オンチェーン取引の実行、取引ステータスの監視を行います。payee_agent は受取人関連の操作を処理し、決済通知の受信、注文作成の確認、支払完了の通知を行います。order_agent は注文処理と意図認識を管理し、異なるエージェントに自動ルーティングします。allowance_agent は認可クォータ照会機能を提供し、マルチチェーントークンの認可照会をサポートします。

a2a_server & mcp_server - プロトコル適応レイヤーの実装で、多様な統合方法を提供します。a2a_server は A2AStarletteApplication フレームワークを使用してGoogleのAgent-to-Agentプロトコルを実装し、AgentCard を通じてエージェント機能を公開し、エージェント間の協調通信をサポートし、デフォルトでポート10000で実行されます。mcp_server は FastMCP フレームワークに基づくModel Context Protocol統合を実装し、決済機能をツールAPIとしてカプセル化し、コア proceed_payment_and_settlement_detail_info ツールを提供し、SSE（Server-Sent Events）トランスポートをサポートし、デフォルトでポート8015で実行されます。

dao - データアクセスレイヤーの実装で、PostgreSQL + SQLModelを統合してデータ永続化を行います。データベースモデル定義（model.py）、データベース接続管理（database.py）、データアクセスインターフェース（app.py）を含み、注文、支払、決済、意図、監査イベントの完全なビジネスデータ管理をサポートします。

task_manager - ファクトリパターン設計によるタスク管理レイヤーの実装。payment_service.py は決済サービスの統一インターフェースを提供し、task_scoped_manager.py はタスクスコープ管理を実装し、異なる決済タスクの分離とライフサイクル管理を保証します。

services - 完全なブロックチェーンサービス実装。署名サービスはEVMチェーン（execute_sign.py）とSolanaチェーン（execute_sign_solana.py）の両方をサポートし、EVMはEIP-712型付きデータ署名を提供し、USDCとDAIの許可署名をサポートします。転送ハンドラは基本クラス抽象設計（base_handler.py）を採用し、custodial/ モード（バックエンドがウォレットを管理しユーザーエクスペリエンスを簡素化）と non_custodial/ モード（ユーザーが秘密鍵を制御しセキュリティを強化）に分かれており、EVM（evm_transfer_handler.py）とSolana（solana_transfer_handler.py）の両方のブロックチェーンをサポートします。データサービスレイヤーには、意図記録（intent.py）、監査イベント（audit_event.py）、決済バッチ（settlement_batch.py）、決済詳細（settlement_detail.py）が含まれ、完全な取引ライフサイクル追跡を可能にします。定数設定（constants.py）は、ブロックチェーンネットワーク設定、コントラクトアドレス、チェーンIDを一元管理します。許可実行（execute_permit.py）は、ERC-20トークンの認可と許可実行を処理します。

コンパニオンコンソールデモアプリケーション

コンパニオンコンソールデモアプリケーションは、別の Zen7-Console-Demo リポジトリにあり、ユーザーに完全なインタラクティブインターフェースと支払フローのデモンストレーションを提供し、開発者が支払システム全体のワークフローを直感的に体験できるようにします。EコマースシナリオにおけるA2AおよびMCPクライアントの完全な支払フローが含まれています。

Shopping Agent Client は、Eコマースシナリオで決済エージェントサービスを使用する方法を示し、商品閲覧、注文、支払などの機能を実装しています。

テクノロジースタックと互換性

サポートされているブロックチェーンネットワーク:

EVM互換チェーン: Ethereum Sepolia、Base Sepolia、Polygon Amoy、BNB Chain Testnet
Solana: Devnet、Testnet

互換性のあるトークン標準:

EVM: USDC (バージョン2)、DAI (バージョン1)
Solana: SPLトークン

署名標準:

EVM: EIP-712型付きデータ署名
Solana: Ed25519署名

ウォレット統合: MetaMask、Coinbase Wallet、Phantom Wallet

データ永続性: PostgreSQL + SQLModel ORM

この設計により、開発者に柔軟なテスト環境が提供され、マルチチェーンおよびマルチ通貨機能を備えた完全な決済ソリューションをサポートし、主要なウォレットおよびブロックチェーンネットワークとの良好な互換性を確保します。

クイックスタート

クイックスタートガイド - プロジェクトのセットアップと実行に関する詳細なガイド

環境セットアップ

基本環境のインストール - Python 3.13+、uvツール、Gitのインストール
ブロックチェーン環境の設定 - ブロックチェーン環境のセットアップとテストウォレットの準備

開発ガイド

開発ガイド - 開発者向けの拡張とカスタマイズガイド

セキュリティに関する考慮事項

秘密鍵のセキュリティ: テスト環境の秘密鍵は開発専用です。本番環境では安全な鍵管理ソリューションを使用してください。
ネットワーク環境: 現在はテストネットをサポートしています。本番環境では対応するメインネット設定が必要です。
トークン管理: テストウォレットに取引用の十分なテストトークンがあることを確認してください。
APIセキュリティ: 本番環境では適切な認証および認可メカニズムを設定してください。

サポート

問題が発生した場合やサポートが必要な場合は、以下を参照してください。

ドキュメントディレクトリの関連ガイドを確認する
GitHub Issuesで問題を報告する
開発チームに連絡する

Zen7 Labsについて

Zen7 Labsは、次世代の分散型決済インフラストラクチャの構築に専念し、エージェントコマース向けの革新的な決済ソリューションの提供に焦点を当てています。AIエージェント技術を通じてブロックチェーン決済体験を簡素化することで、エージェント経済時代における決済の新しいパラダイムを切り開き、エージェント間の商取引をより効率的、安全、かつインテリジェントにします。

引用

Zen7 Payment Agentがあなたの研究やプロジェクトに役立った場合は、以下のように引用してください。

@misc{zen7paymentagent,
  author = {Zen7 Labs},
  title = {Zen7 Payment Agent: A Dedicated Payment Network for Every Intelligent Agent.},
  year = {2025},
  publisher = {GitHub},
  url = {https://github.com/Zen7-Labs/Zen7-Payment-Agent}
}

ライセンス

Apache License Version 2.0