Zen7-Payment-Agent MCP Server

oficial

Zen7 Payment Agent es el primer proyecto de implementación de DePA (Agente de Pago Descentralizado), pionero en la infraestructura de pagos inteligentes de próxima generación.

GitHub
176

Documentación

Zen7 Payment Agent

License Python Built with uv 中文版本

Las actualizaciones de progreso en tiempo real se pueden ver en la página Progreso en tiempo real Para soporte sobre el protocolo x402, por favor haga clic aquí

Zen7 Payment Agent es la primera implementación práctica de DePA (Agente de Pago Descentralizado), pionero en la próxima generación de infraestructura de pago inteligente. No solo implementa completamente las funcionalidades centrales de DePA, sino que también despliega con éxito casos de aplicación innovadores en el dominio del comercio agéntico.

Como el primer proyecto práctico en el ecosistema DePA, Zen7 implementa varias características clave: pagos cifrados automatizados entre agentes, un mecanismo de "autorización sin permisos" y reconocimiento de intenciones e interacción impulsados por LLM.

Zen7 Payment Agent adopta una arquitectura colaborativa multi-agente, compatible con los protocolos A2A y MCP, así como con modelos de pago con custodia y sin custodia. Proporciona una solución de pago integral para Agentes de IA y aplicaciones Dapp nativas con soporte multi-cadena, multi-moneda, multi-billetera, transacciones de alta frecuencia, operaciones sin gas y autenticación sin contraseña.

Zen7 Payment Agent Architecture

Navegando por el Repositorio

Este repositorio contiene la implementación completa de Zen7 Payment Agent, mostrando los componentes centrales y el diseño arquitectónico basado en el protocolo Zen7 Payment Agent (Agente de Pago Descentralizado).

Estructura de Directorios Principal

La implementación central del proyecto se encuentra en los siguientes directorios clave:

host_agent - La implementación central de la arquitectura colaborativa multi-agente. El agente anfitrión utiliza el modelo gemini-2.0-flash-lite como coordinador central, responsable de la comprensión de consultas, gestión de estado y coordinación de respuestas. El sistema de sub-agentes (sub_agents/) contiene cinco agentes especializados: payer_agent maneja la creación de órdenes para el pagador, generación de firmas EIP-712 y verificación de saldo de billetera; settlement_agent se enfoca en el proceso de liquidación, confirmando detalles de pago, ejecutando transacciones en cadena y monitoreando el estado de la transacción; payee_agent maneja operaciones relacionadas con el beneficiario, recibiendo notificaciones de liquidación, confirmando la creación de órdenes y notificando la finalización del pago; order_agent gestiona el procesamiento de órdenes y el reconocimiento de intenciones, enrutando automáticamente a diferentes agentes; allowance_agent proporciona funcionalidad de consulta de cuota de autorización, soportando consultas de autorización de tokens multi-cadena.

a2a_server & mcp_server - Implementación de la capa de adaptación de protocolo, proporcionando diversos métodos de integración. a2a_server implementa el protocolo Agente-a-Agente de Google utilizando el marco A2AStarletteApplication, exponiendo las capacidades del agente a través de AgentCard, soportando comunicación colaborativa entre agentes y ejecutándose en el puerto 10000 por defecto. mcp_server implementa la integración del Protocolo de Contexto de Modelo basado en el marco FastMCP, encapsulando la funcionalidad de pago como APIs de herramientas, proporcionando la herramienta central proceed_payment_and_settlement_detail_info, soportando transporte SSE (Eventos Enviados por el Servidor) y ejecutándose en el puerto 8015 por defecto.

dao - Implementación de la capa de acceso a datos, integrando PostgreSQL + SQLModel para la persistencia de datos. Incluye definiciones de modelos de base de datos (model.py), gestión de conexiones de base de datos (database.py) e interfaces de acceso a datos (app.py), soportando la gestión completa de datos de negocio para órdenes, pagos, liquidaciones, intenciones y eventos de auditoría.

task_manager - Implementación de la capa de gestión de tareas con diseño de patrón de fábrica. payment_service.py proporciona una interfaz unificada para servicios de pago, task_scoped_manager.py implementa la gestión del alcance de tareas, asegurando el aislamiento y la gestión del ciclo de vida para diferentes tareas de pago.

services - Implementación completa del servicio blockchain. Los servicios de firma soportan tanto cadenas EVM (execute_sign.py) como la cadena Solana (execute_sign_solana.py), con EVM proporcionando firma de datos tipados EIP-712 y soportando firmas de permiso para USDC y DAI; los manejadores de transferencia adoptan un diseño de abstracción de clase base (base_handler.py), divididos en modo custodial/ (el backend gestiona las billeteras para simplificar la experiencia del usuario) y modo non_custodial/ (los usuarios controlan las claves privadas para mayor seguridad), soportando tanto blockchains EVM (evm_transfer_handler.py) como Solana (solana_transfer_handler.py); la capa de servicio de datos incluye registro de intenciones (intent.py), eventos de auditoría (audit_event.py), lotes de liquidación (settlement_batch.py) y detalles de liquidación (settlement_detail.py), permitiendo el seguimiento completo del ciclo de vida de la transacción; la configuración de constantes (constants.py) gestiona centralizadamente las configuraciones de red blockchain, direcciones de contratos e IDs de cadena; la ejecución de permisos (execute_permit.py) maneja la autorización de tokens ERC-20 y la ejecución de permisos.

Aplicación de Demostración de Consola Complementaria

La aplicación de demostración de consola complementaria se encuentra en un repositorio separado Zen7-Console-Demo, proporcionando a los usuarios una interfaz interactiva completa y una demostración del flujo de pago, permitiendo a los desarrolladores experimentar intuitivamente el flujo de trabajo de todo el sistema de pago. Incluye flujos de pago completos para clientes A2A y MCP en escenarios de comercio electrónico.

  • Cliente Agente de Compras demuestra cómo usar los servicios del agente de pago en escenarios de comercio electrónico, implementando características como navegación de productos, realización de pedidos y pago.

Pila Tecnológica y Compatibilidad

Redes Blockchain Soportadas:

  • Cadenas Compatibles con EVM: Ethereum Sepolia, Base Sepolia, Polygon Amoy, BNB Chain Testnet
  • Solana: Devnet, Testnet

Estándares de Token Compatibles:

  • EVM: USDC (Versión 2), DAI (Versión 1)
  • Solana: SPL Token

Estándares de Firma:

  • EVM: Firma de Datos Tipados EIP-712
  • Solana: Firma Ed25519

Integración de Billeteras: MetaMask, Coinbase Wallet, Phantom Wallet

Persistencia de Datos: PostgreSQL + SQLModel ORM

Este diseño proporciona a los desarrolladores un entorno de prueba flexible, soportando una solución de pago completa con capacidades multi-cadena y multi-moneda, mientras asegura una buena compatibilidad con billeteras y redes blockchain convencionales.

Inicio Rápido

Configuración del Entorno

Guía de Desarrollo

Consideraciones de Seguridad

  • Seguridad de Claves Privadas: Las claves privadas en el entorno de prueba son solo para desarrollo; use soluciones seguras de gestión de claves en producción
  • Entorno de Red: Actualmente soporta redes de prueba; los entornos de producción requieren configuraciones de red principal correspondientes
  • Gestión de Tokens: Asegúrese de que las billeteras de prueba tengan suficientes tokens de prueba para transacciones
  • Seguridad de API: Configure mecanismos apropiados de autenticación y autorización en entornos de producción

Soporte

Si encuentra problemas o necesita ayuda, por favor:

Acerca de Zen7 Labs

Zen7 Labs se dedica a construir la próxima generación de infraestructura de pago descentralizada, enfocándose en proporcionar soluciones de pago innovadoras para el Comercio Agéntico. Al simplificar las experiencias de pago blockchain a través de la tecnología de agentes de IA, estamos siendo pioneros en un nuevo paradigma de pagos en la era de la economía de agentes, haciendo que las interacciones comerciales entre agentes sean más eficientes, seguras e inteligentes.

Citación

Si encuentra útil Zen7 Payment Agent en su investigación o proyecto, por favor cítelo como:

@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}
}

Licencia

Licencia Apache Versión 2.0