Zen7 Payment Agent

Zen7 Payment Agent

中文版本

リアルタイムの進捗状況は、リアルタイム進捗ページで確認できます。 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のpermit署名に対応します。トランスファーハンドラーは基底クラスによる抽象化設計（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を一元管理します。permit実行（execute_permit.py）は、ERC-20トークンの承認とpermitの実行を処理します。

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

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

• ショッピングエージェントクライアント は、eコマースのシナリオで決済エージェントサービスを使用する方法を実演し、商品閲覧、注文、決済などの機能を実装しています。

技術スタックと互換性

対応ブロックチェーンネットワーク：

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

対応トークン規格：

• EVM：USDC（Version 2）、DAI（Version 1）
• Solana：SPL Token

署名規格：

• EVM：EIP-712 Typed Data 署名
• Solana：Ed25519 署名

ウォレット連携：MetaMask、Coinbase Wallet、Phantom Wallet

データ永続化：PostgreSQL + SQLModel ORM

この設計により、開発者は柔軟なテスト環境を利用できます。また、マルチチェーンおよび複数通貨に対応した完全な決済ソリューションをサポートし、主要なウォレットやブロックチェーンネットワークとの優れた互換性を確保します。

クイックスタート

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

環境のセットアップ

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

開発ガイド

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

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

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

サポート

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

• ドキュメントディレクトリにある関連ガイドを確認する
• GitHub Issues に問題を報告する
• 開発チームに問い合わせる

Zen7 Labs について

Zen7 Labs は、次世代の分散型決済インフラストラクチャの構築に取り組み、Agentic Commerce 向けの革新的な決済ソリューションの提供に注力しています。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