Zen7-Payment-Agent MCP Server

officiel

Zen7 Payment Agent est le premier projet d'implémentation de DePA (Decentralized Payment Agent), pionnier de l'infrastructure de paiement intelligent de nouvelle génération.

GitHub
176

Documentation

Agent de Paiement Zen7

License Python Built with uv 中文版本

Les mises à jour de progression en temps réel peuvent être consultées sur la page Progression en temps réel Pour obtenir de l'aide sur le protocole x402, veuillez cliquer ici

L'Agent de Paiement Zen7 est la première implémentation pratique de DePA (Agent de Paiement Décentralisé), pionnier de la prochaine génération d'infrastructure de paiement intelligente. Il implémente non seulement pleinement les fonctionnalités de base de DePA, mais déploie également avec succès des cas d'application innovants dans le domaine du commerce agentique.

En tant que premier projet pratique de l'écosystème DePA, Zen7 implémente plusieurs fonctionnalités clés : les paiements chiffrés automatisés entre agents, un mécanisme « d'autorisation sans permission » et la reconnaissance d'intention et l'interaction pilotées par LLM.

L'Agent de Paiement Zen7 adopte une architecture collaborative multi-agents, prenant en charge à la fois les protocoles A2A et MCP, ainsi que les modèles de paiement avec et sans garde. Il fournit une solution de paiement complète pour les agents IA et les applications Dapp natives avec prise en charge multi-chaînes, multi-devises, multi-portefeuilles, transactions à haute fréquence, opérations sans gaz et authentification sans mot de passe.

Zen7 Payment Agent Architecture

Navigation dans le Dépôt

Ce dépôt contient l'implémentation complète de l'Agent de Paiement Zen7, présentant les composants de base et la conception architecturale basés sur le protocole Zen7 Payment Agent (Agent de Paiement Décentralisé).

Structure de Base des Répertoires

L'implémentation de base du projet se trouve dans les répertoires clés suivants :

host_agent - L'implémentation de base de l'architecture collaborative multi-agents. L'agent hôte utilise le modèle gemini-2.0-flash-lite comme coordinateur central, responsable de la compréhension des requêtes, de la gestion d'état et de la coordination des réponses. Le système de sous-agents (sub_agents/) contient cinq agents spécialisés : payer_agent gère la création de commandes pour le payeur, la génération de signatures EIP-712 et la vérification du solde du portefeuille ; settlement_agent se concentre sur le processus de règlement, confirmant les détails du paiement, exécutant les transactions sur la chaîne et surveillant l'état des transactions ; payee_agent gère les opérations liées au bénéficiaire, recevant les notifications de règlement, confirmant la création de commandes et notifiant l'achèvement du paiement ; order_agent gère le traitement des commandes et la reconnaissance d'intention, routant automatiquement vers différents agents ; allowance_agent fournit une fonctionnalité de requête de quota d'autorisation, prenant en charge les requêtes d'autorisation de jetons multi-chaînes.

a2a_server & mcp_server - Implémentation de la couche d'adaptation de protocole, fournissant diverses méthodes d'intégration. a2a_server implémente le protocole Agent-to-Agent de Google en utilisant le framework A2AStarletteApplication, exposant les capacités des agents via AgentCard, prenant en charge la communication collaborative inter-agents et s'exécutant sur le port 10000 par défaut. mcp_server implémente l'intégration du Model Context Protocol basée sur le framework FastMCP, encapsulant la fonctionnalité de paiement sous forme d'API d'outils, fournissant l'outil de base proceed_payment_and_settlement_detail_info, prenant en charge le transport SSE (Server-Sent Events) et s'exécutant sur le port 8015 par défaut.

dao - Implémentation de la couche d'accès aux données, intégrant PostgreSQL + SQLModel pour la persistance des données. Inclut les définitions de modèles de base de données (model.py), la gestion de la connexion à la base de données (database.py) et les interfaces d'accès aux données (app.py), prenant en charge la gestion complète des données métier pour les commandes, les paiements, les règlements, les intentions et les événements d'audit.

task_manager - Implémentation de la couche de gestion des tâches avec conception de motif de fabrique. payment_service.py fournit une interface unifiée pour les services de paiement, task_scoped_manager.py implémente la gestion de la portée des tâches, assurant l'isolation et la gestion du cycle de vie pour différentes tâches de paiement.

services - Implémentation complète du service blockchain. Les services de signature prennent en charge à la fois les chaînes EVM (execute_sign.py) et la chaîne Solana (execute_sign_solana.py), avec EVM fournissant la signature de données typées EIP-712 et prenant en charge les signatures de permis pour USDC et DAI ; les gestionnaires de transfert adoptent une conception d'abstraction de classe de base (base_handler.py), divisés en mode custodial/ (le backend gère les portefeuilles pour simplifier l'expérience utilisateur) et mode non_custodial/ (les utilisateurs contrôlent les clés privées pour une sécurité renforcée), prenant en charge à la fois les blockchains EVM (evm_transfer_handler.py) et Solana (solana_transfer_handler.py) ; la couche de service de données inclut l'enregistrement des intentions (intent.py), les événements d'audit (audit_event.py), les lots de règlement (settlement_batch.py) et les détails de règlement (settlement_detail.py), permettant un suivi complet du cycle de vie des transactions ; la configuration des constantes (constants.py) gère de manière centralisée les configurations de réseau blockchain, les adresses de contrat et les identifiants de chaîne ; l'exécution des permis (execute_permit.py) gère l'autorisation de jetons ERC-20 et l'exécution des permis.

Application de Démonstration Console Compagnon

L'application de démonstration console compagnon se trouve dans un dépôt séparé Zen7-Console-Demo, fournissant aux utilisateurs une interface interactive complète et une démonstration du flux de paiement, permettant aux développeurs de découvrir intuitivement le flux de travail de l'ensemble du système de paiement. Elle inclut des flux de paiement complets pour les clients A2A et MCP dans des scénarios de commerce électronique.

  • Client Agent d'Achat montre comment utiliser les services d'agent de paiement dans des scénarios de commerce électronique, implémentant des fonctionnalités telles que la navigation de produits, la commande et le paiement.

Pile Technologique et Compatibilité

Réseaux Blockchain Pris en Charge :

  • Chaînes Compatibles EVM : Ethereum Sepolia, Base Sepolia, Polygon Amoy, BNB Chain Testnet
  • Solana : Devnet, Testnet

Normes de Jetons Compatibles :

  • EVM : USDC (Version 2), DAI (Version 1)
  • Solana : Jeton SPL

Normes de Signature :

  • EVM : Signature de Données Typées EIP-712
  • Solana : Signature Ed25519

Intégration de Portefeuille : MetaMask, Coinbase Wallet, Phantom Wallet

Persistance des Données : PostgreSQL + SQLModel ORM

Cette conception fournit aux développeurs un environnement de test flexible, prenant en charge une solution de paiement complète avec des capacités multi-chaînes et multi-devises, tout en assurant une bonne compatibilité avec les portefeuilles et réseaux blockchain courants.

Démarrage Rapide

Configuration de l'Environnement

Guide de Développement

Considérations de Sécurité

  • Sécurité des Clés Privées : Les clés privées dans l'environnement de test sont uniquement destinées au développement ; utilisez des solutions de gestion de clés sécurisées en production
  • Environnement Réseau : Prend actuellement en charge les réseaux de test ; les environnements de production nécessitent les configurations de réseau principal correspondantes
  • Gestion des Jetons : Assurez-vous que les portefeuilles de test disposent de suffisamment de jetons de test pour les transactions
  • Sécurité des API : Configurez des mécanismes d'authentification et d'autorisation appropriés dans les environnements de production

Support

Si vous rencontrez des problèmes ou avez besoin d'aide, veuillez :

  • Consulter les guides pertinents dans le répertoire de documentation
  • Soumettre des problèmes sur GitHub Issues
  • Contacter l'équipe de développement

À Propos de Zen7 Labs

Zen7 Labs se consacre à la construction de la prochaine génération d'infrastructure de paiement décentralisée, en se concentrant sur la fourniture de solutions de paiement innovantes pour le Commerce Agentique. En simplifiant les expériences de paiement blockchain grâce à la technologie d'agent IA, nous sommes les pionniers d'un nouveau paradigme de paiements à l'ère de l'économie agentique, rendant les interactions commerciales entre agents plus efficaces, sécurisées et intelligentes.

Citation

Si vous trouvez l'Agent de Paiement Zen7 utile dans vos recherches ou votre projet, veuillez le citer comme suit :

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

Licence

Licence Apache Version 2.0