Zen7-Payment-Agent MCP Server

oficial

O Zen7 Payment Agent é o primeiro projeto de implementação do DePA (Agente de Pagamento Descentralizado), pioneiro na infraestrutura inteligente de pagamentos de próxima geração.

GitHub
176

Documentação

Zen7 Payment Agent

License Python Built with uv 中文版本

Atualizações de progresso em tempo real podem ser visualizadas na página Progresso em tempo real Para suporte sobre o protocolo x402, por favor clique aqui

O Zen7 Payment Agent é a primeira implementação prática do DePA (Agente de Pagamento Descentralizado), pioneiro na próxima geração de infraestrutura de pagamento inteligente. Ele não apenas implementa completamente as funcionalidades principais do DePA, mas também implanta com sucesso casos de aplicação inovadores no domínio do comércio agêntico.

Como o primeiro projeto prático no ecossistema DePA, o Zen7 implementa várias funcionalidades-chave: pagamentos criptografados automatizados entre agentes, um mecanismo de "autorização sem permissão" e reconhecimento de intenção e interação orientados por LLM.

O Zen7 Payment Agent adota uma arquitetura colaborativa multiagente, suportando tanto os protocolos A2A quanto MCP, bem como modelos de pagamento custodial e não custodial. Ele fornece uma solução de pagamento abrangente para Agentes de IA e aplicações Dapp nativas com suporte a múltiplas cadeias, múltiplas moedas, múltiplas carteiras, transações de alta frequência, operações sem gás e autenticação sem senha.

Zen7 Payment Agent Architecture

Navegando pelo Repositório

Este repositório contém a implementação completa do Zen7 Payment Agent, exibindo os componentes principais e o design arquitetural baseado no protocolo Zen7 Payment Agent (Agente de Pagamento Descentralizado).

Estrutura de Diretórios Principal

A implementação central do projeto está localizada nos seguintes diretórios-chave:

host_agent - A implementação central da arquitetura colaborativa multiagente. O agente host usa o modelo gemini-2.0-flash-lite como coordenador central, responsável pela compreensão de consultas, gerenciamento de estado e coordenação de respostas. O sistema de subagentes (sub_agents/) contém cinco agentes especializados: payer_agent lida com a criação de pedidos para o pagador, geração de assinatura EIP-712 e verificação de saldo da carteira; settlement_agent foca no processo de liquidação, confirmando detalhes de pagamento, executando transações on-chain e monitorando o status da transação; payee_agent lida com operações relacionadas ao recebedor, recebendo notificações de liquidação, confirmando a criação do pedido e notificando a conclusão do pagamento; order_agent gerencia o processamento de pedidos e reconhecimento de intenção, roteando automaticamente para diferentes agentes; allowance_agent fornece funcionalidade de consulta de cota de autorização, suportando consultas de autorização de tokens em múltiplas cadeias.

a2a_server & mcp_server - Implementação da camada de adaptação de protocolo, fornecendo métodos de integração diversos. a2a_server implementa o protocolo Agent-to-Agent do Google usando o framework A2AStarletteApplication, expondo capacidades do agente através de AgentCard, suportando comunicação colaborativa entre agentes e executando na porta 10000 por padrão. mcp_server implementa a integração do Model Context Protocol baseada no framework FastMCP, encapsulando a funcionalidade de pagamento como APIs de ferramenta, fornecendo a ferramenta central proceed_payment_and_settlement_detail_info, suportando transporte SSE (Server-Sent Events) e executando na porta 8015 por padrão.

dao - Implementação da camada de acesso a dados, integrando PostgreSQL + SQLModel para persistência de dados. Inclui definições de modelo de banco de dados (model.py), gerenciamento de conexão de banco de dados (database.py) e interfaces de acesso a dados (app.py), suportando gerenciamento completo de dados de negócios para pedidos, pagamentos, liquidações, intenções e eventos de auditoria.

task_manager - Implementação da camada de gerenciamento de tarefas com design de padrão factory. payment_service.py fornece uma interface unificada para serviços de pagamento, task_scoped_manager.py implementa o gerenciamento de escopo de tarefas, garantindo isolamento e gerenciamento de ciclo de vida para diferentes tarefas de pagamento.

services - Implementação completa de serviços blockchain. Serviços de assinatura suportam tanto cadeias EVM (execute_sign.py) quanto a cadeia Solana (execute_sign_solana.py), com EVM fornecendo assinatura de dados tipados EIP-712 e suportando assinaturas de permissão para USDC e DAI; manipuladores de transferência adotam design de abstração de classe base (base_handler.py), divididos em modo custodial/ (backend gerencia carteiras para simplificar a experiência do usuário) e modo non_custodial/ (usuários controlam chaves privadas para maior segurança), suportando blockchains EVM (evm_transfer_handler.py) e Solana (solana_transfer_handler.py); a camada de serviço de dados inclui registro de intenção (intent.py), eventos de auditoria (audit_event.py), lotes de liquidação (settlement_batch.py) e detalhes de liquidação (settlement_detail.py), permitindo rastreamento completo do ciclo de vida da transação; configuração de constantes (constants.py) gerencia centralizadamente configurações de rede blockchain, endereços de contratos e IDs de cadeia; execução de permissão (execute_permit.py) lida com autorização de tokens ERC-20 e execução de permissão.

Aplicação Demo de Console Complementar

A aplicação demo de console complementar está localizada em um repositório separado Zen7-Console-Demo, fornecendo aos usuários uma interface interativa completa e demonstração do fluxo de pagamento, permitindo que desenvolvedores experimentem intuitivamente o fluxo de trabalho de todo o sistema de pagamento. Inclui fluxos de pagamento completos para clientes A2A e MCP em cenários de comércio eletrônico.

  • Cliente Agente de Compras demonstra como usar serviços de agente de pagamento em cenários de comércio eletrônico, implementando funcionalidades como navegação de produtos, pedidos e pagamento.

Stack Tecnológica e Compatibilidade

Redes Blockchain Suportadas:

  • Cadeias Compatíveis com EVM: Ethereum Sepolia, Base Sepolia, Polygon Amoy, BNB Chain Testnet
  • Solana: Devnet, Testnet

Padrões de Token Compatíveis:

  • EVM: USDC (Versão 2), DAI (Versão 1)
  • Solana: SPL Token

Padrões de Assinatura:

  • EVM: Assinatura de Dados Tipados EIP-712
  • Solana: Assinatura Ed25519

Integração de Carteira: MetaMask, Coinbase Wallet, Phantom Wallet

Persistência de Dados: PostgreSQL + SQLModel ORM

Este design fornece aos desenvolvedores um ambiente de teste flexível, suportando uma solução de pagamento completa com capacidades de múltiplas cadeias e múltiplas moedas, garantindo ao mesmo tempo boa compatibilidade com carteiras e redes blockchain convencionais.

Início Rápido

Configuração do Ambiente

Guia de Desenvolvimento

Considerações de Segurança

  • Segurança da Chave Privada: Chaves privadas no ambiente de teste são apenas para desenvolvimento; use soluções seguras de gerenciamento de chaves em produção
  • Ambiente de Rede: Atualmente suporta testnets; ambientes de produção requerem configurações de mainnet correspondentes
  • Gerenciamento de Tokens: Garanta que as carteiras de teste tenham tokens de teste suficientes para transações
  • Segurança da API: Configure mecanismos apropriados de autenticação e autorização em ambientes de produção

Suporte

Se você encontrar problemas ou precisar de ajuda, por favor:

  • Verifique os guias relevantes no diretório de documentação
  • Envie issues no GitHub Issues
  • Entre em contato com a equipe de desenvolvimento

Sobre a Zen7 Labs

A Zen7 Labs é dedicada a construir a próxima geração de infraestrutura de pagamento descentralizada, focando em fornecer soluções de pagamento inovadoras para o Comércio Agêntico. Ao simplificar as experiências de pagamento blockchain através da tecnologia de agentes de IA, estamos sendo pioneiros em um novo paradigma de pagamentos na era da economia agêntica, tornando as interações comerciais entre agentes mais eficientes, seguras e inteligentes.

Citação

Se você achar o Zen7 Payment Agent útil em sua pesquisa ou projeto, por favor cite-o 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}
}

Licença

Licença Apache Versão 2.0