Zen7 Payment Agent

Zen7 Payment Agent

中文版本

可在实时进展页面查看实时进展。 如需了解对 x402 协议的支持，请点击此处。

Zen7 Payment Agent 是 DePA（去中心化支付 Agent）的首个实用实现，开创了新一代智能支付基础设施。它不仅全面实现了 DePA 的核心功能，还成功在 Agent 商业领域部署了创新应用案例。

作为 DePA 生态系统中的首个实践项目，Zen7 实现了多项关键功能：Agent 之间自动加密支付、“无需许可的授权”机制，以及由大模型驱动的意图识别与交互。

Zen7 Payment Agent 采用多 Agent 协作架构，同时支持 A2A 和 MCP 协议，以及托管式和非托管式支付模式。它为 AI Agent 和原生 Dapp 应用提供全面的支付解决方案，支持多链、多币种、多钱包、高频交易、免 Gas 操作和无密码身份验证。

浏览代码库

此代码库包含 Zen7 Payment Agent 的完整实现，展示了基于 Zen7 Payment Agent（去中心化支付 Agent）协议构建的核心组件和架构设计。

核心目录结构

项目的核心实现位于以下关键目录中：

host_agent - 多 Agent 协作架构的核心实现。主 Agent 使用 gemini-2.0-flash-lite 模型作为核心协调器，负责查询理解、状态管理和响应协调。子 Agent 系统（sub_agents/）包含五个专用 Agent：payer_agent 负责付款方的订单创建、EIP-712 签名生成和钱包余额验证；settlement_agent 专注于结算流程，包括确认付款详情、执行链上交易和监控交易状态；payee_agent 负责收款方相关操作，包括接收结算通知、确认订单创建和通知付款完成；order_agent 负责订单处理和意图识别，并自动将请求路由至不同的 Agent；allowance_agent 提供授权额度查询功能，支持多链代币授权查询。

a2a_server & mcp_server - 协议适配层实现，提供多种集成方式。a2a_server 使用 A2AStarletteApplication 框架实现 Google 的 Agent-to-Agent 协议，通过 AgentCard 暴露 Agent 能力，支持 Agent 间协作通信，默认运行于端口 10000。mcp_server 基于 FastMCP 框架实现 Model Context Protocol 集成，将支付功能封装为工具 API，提供核心 proceed_payment_and_settlement_detail_info 工具，支持 SSE（服务器发送事件）传输，默认运行于端口 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 仓库中，为用户提供完整的交互界面和支付流程演示，让开发者能够直观地体验整个支付系统的工作流。它包含适用于电商场景的 A2A 和 MCP 客户端完整支付流程。

• 购物 Agent 客户端演示如何在电商场景中使用支付 Agent 服务，实现商品浏览、下单和支付等功能。

技术栈与兼容性

支持的区块链网络：

• 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 类型化数据签名
• 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 Agent 技术简化区块链支付体验，开创 Agent 经济时代的全新支付范式，让 Agent 之间的商业交互更加高效、安全和智能。

---

引用

如果您发现 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