Zen7 Payment Agent

🚀 Zen7支付代理

Zen7支付代理是去中心化支付代理（DePA）的首個實際應用，開創了下一代智能支付基礎設施的先河。它不僅全面實現了DePA的核心功能，還在代理商務領域成功部署了創新應用案例。

倉庫導航

本倉庫包含了Zen7支付代理的完整實現，展示了基於Zen7支付代理（去中心化支付代理）協議的核心組件和架構設計。

核心目錄結構

項目的核心實現位於以下關鍵目錄：

• host_agent：多代理協作架構的核心實現。主代理使用gemini - 2.0 - flash - lite模型作為核心協調器，負責查詢理解、狀態管理和響應協調。子代理系統（sub_agents/）包含三個專業代理：payer_agent處理付款人的訂單創建、EIP - 712簽名生成和錢包餘額驗證；settlement_agent專注於結算流程，確認付款細節、執行鏈上交易並監控交易狀態；payee_agent處理收款人相關操作，接收結算通知、確認訂單創建並通知付款完成。
• a2a_server 與 mcp_server：協議適配層實現，提供多種集成方法。a2a_server使用A2AStarletteApplication框架實現Google的代理到代理協議，通過AgentCard暴露代理能力，支持代理間協作通信，默認運行在10000端口。mcp_server基於FastMCP框架實現模型上下文協議集成，將支付功能封裝為工具API，提供核心proceed_payment_and_settlement_detail_info工具，支持SSE（服務器發送事件）傳輸，默認運行在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客戶端的完整支付流程。

• 購物代理客戶端 展示瞭如何在電子商務場景中使用支付代理服務，實現產品瀏覽、下單和支付等功能。

技術棧與兼容性

這種設計為開發者提供了靈活的測試環境，同時確保與主流錢包和區塊鏈網絡具有良好的兼容性。

🚀 快速開始

• 快速開始指南 — 詳細的項目設置和運行指南

環境設置

• 基本環境安裝 — 安裝Python 3.13+、uv工具和Git
• 區塊鏈環境配置 — 區塊鏈環境設置和測試錢包準備

開發指南

• 開發指南 — 開發者擴展和定製指南

✨ 主要特性

• 作為DePA生態系統中的首個實際項目，實現了多項關鍵功能：代理之間的自動加密支付、“無許可授權”機制以及由大語言模型驅動的意圖識別和交互。
• 採用多代理協作架構，支持A2A和MCP協議，以及託管和非託管支付模型。
• 為AI代理和原生Dapp應用提供全面的支付解決方案，支持多鏈、多貨幣、多錢包，具備高頻交易、免手續費操作和無密碼認證等特性。

🔧 技術細節

Zen7支付代理基於多代理協作架構，以gemini - 2.0 - flash - lite模型為核心協調器。主代理負責整體的查詢理解、狀態管理和響應協調，子代理系統中的三個專業代理分別負責付款人、結算和收款人相關的操作。在協議適配層，a2a_server和mcp_server分別實現了不同的協議集成，為系統提供了多樣化的交互方式。區塊鏈服務實現部分，涵蓋了簽名服務、轉賬處理、常量配置和許可執行等功能，確保了支付流程的安全和高效。

⚠️ 安全注意事項

• 私鑰安全：測試環境中的私鑰僅用於開發；生產環境中請使用安全的密鑰管理解決方案。
• 網絡環境：目前支持測試網；生產環境需要相應的主網配置。
• 代幣管理：確保測試錢包中有足夠的測試代幣用於交易。
• API安全：在生產環境中配置適當的認證和授權機制。

🛠️ 支持

如果您遇到問題或需要幫助，請：

• 查看 文檔目錄 中的相關指南。
• 在GitHub Issues上提交問題。
• 聯繫開發團隊。

🌟 關於Zen7 Labs

Zen7 Labs致力於構建下一代去中心化支付基礎設施，專注於為代理商務提供創新的支付解決方案。通過人工智能代理技術簡化區塊鏈支付體驗，我們正在開創代理經濟時代支付的新範式，使代理之間的商業交互更加高效、安全和智能。

📖 引用

如果您發現Zen7支付代理在您的研究或項目中很有幫助，請按以下方式引用：

@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許可證2.0版本。