Zen7 Payment Agent

🚀 Zen7 Payment Agent

Zen7 Payment Agentは、DePA（Decentralized Payment Agent）の最初の実用的な実装であり、次世代のインテリジェントな支払いインフラを先駆けています。DePAのコア機能を完全に実装するだけでなく、エージェント型コマース分野で革新的なアプリケーションケースを成功裡に展開しています。

🚀 クイックスタート

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

環境設定

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

開発ガイド

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

✨ 主な機能

Zen7 Payment Agentは、DePAエコシステムにおける最初の実用的なプロジェクトとして、いくつかの重要な機能を実装しています。エージェント間の自動暗号化支払い、「パーミッションレスな承認」メカニズム、およびLLMによる意図認識と対話機能を備えています。また、マルチエージェント協調アーキテクチャを採用し、A2AおよびMCPプロトコルをサポートし、保管型および非保管型の支払いモデルを提供します。マルチチェーン、マルチ通貨、マルチウォレットのサポート、高頻度トランザクション、ガスレス操作、パスワードレス認証を備えた包括的な支払いソリューションをAIエージェントおよびネイティブDappアプリケーションに提供します。

📚 ドキュメント

リポジトリのナビゲーション

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

コアディレクトリ構造

プロジェクトのコア実装は、以下の主要なディレクトリにあります。

host_agent - マルチエージェント協調アーキテクチャのコア実装です。ホストエージェントはgemini-2.0-flash-liteモデルをコアコーディネータとして使用し、クエリ理解、状態管理、およびレスポンス調整を担当します。サブエージェントシステム（sub_agents/）には、3つの専用エージェントが含まれています。payer_agentは支払者の注文作成、EIP - 712署名生成、およびウォレット残高検証を処理します。settlement_agentは決済プロセスに焦点を当て、支払い詳細の確認、オンチェーントランザクションの実行、およびトランザクションステータスの監視を行います。payee_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で実行されます。

services - 完全なブロックチェーンサービスの実装です。署名サービス（execute_sign.py）はEIP - 712タイプのデータ署名機能を提供し、USDCおよびDAIのパーミット署名をサポートします。転送ハンドラはcustodial/モード（バックエンドがウォレットを管理してユーザー体験を簡素化）とnon_custodial/モード（ユーザーが秘密鍵を管理して安全性を強化）に分かれています。定数設定（constants.py）はブロックチェーンネットワークの設定、コントラクトアドレス、およびチェーンIDを集中管理します。パーミット実行（execute_permit.py）はERC - 20トークンの承認とパーミット実行を処理します。

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

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

• Shopping Agent Clientは、電子商取引シナリオで支払いエージェントサービスを使用する方法を示し、商品閲覧、注文、および支払いなどの機能を実装しています。

技術スタックと互換性

この設計は、開発者に柔軟なテスト環境を提供しながら、主流のウォレットとブロックチェーンネットワークとの良好な互換性を確保しています。

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

⚠️ 重要提示

• テスト環境での秘密鍵は開発用のみです。本番環境では安全な鍵管理ソリューションを使用してください。
• 現在はテストネットをサポートしています。本番環境では対応するメインネットの設定が必要です。
• トークン管理：トランザクションに十分なテストトークンがテストウォレットにあることを確認してください。
• 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