Zen7-Payment-Agent MCP Server

offiziell

Zen7 Payment Agent ist das erste Implementierungsprojekt von DePA (Decentralized Payment Agent) und ebnet den Weg für eine intelligente Zahlungsinfrastruktur der nächsten Generation.

GitHub
176

Dokumentation

Zen7 Payment Agent

License Python Built with uv 中文版本

Echtzeit-Fortschrittsaktualisierungen können auf der Seite Echtzeit-Fortschritt eingesehen werden. Für Unterstützung zum x402-Protokoll klicken Sie bitte hier

Zen7 Payment Agent ist die erste praktische Implementierung von DePA (Decentralized Payment Agent) und ebnet den Weg für die nächste Generation intelligenter Zahlungsinfrastruktur. Es implementiert nicht nur vollständig die Kernfunktionalitäten von DePA, sondern setzt auch erfolgreich innovative Anwendungsfälle im Bereich des agentenbasierten Handels um.

Als erstes praktisches Projekt im DePA-Ökosystem implementiert Zen7 mehrere Schlüsselfunktionen: automatisierte verschlüsselte Zahlungen zwischen Agenten, einen „permissionless authorization“-Mechanismus sowie LLM-gesteuerte Absichtserkennung und Interaktion.

Zen7 Payment Agent verwendet eine kollaborative Multi-Agenten-Architektur, die sowohl A2A- als auch MCP-Protokolle sowie verwahrte und nicht-verwahrte Zahlungsmodelle unterstützt. Es bietet eine umfassende Zahlungslösung für KI-Agenten und native Dapp-Anwendungen mit Multi-Chain-, Multi-Währungs- und Multi-Wallet-Unterstützung, Hochfrequenztransaktionen, gaslosen Operationen und passwortloser Authentifizierung.

Zen7 Payment Agent Architecture

Navigation durch das Repository

Dieses Repository enthält die vollständige Implementierung des Zen7 Payment Agent und zeigt die Kernkomponenten und das architektonische Design basierend auf dem Zen7 Payment Agent (Decentralized Payment Agent)-Protokoll.

Kernverzeichnisstruktur

Die Kernimplementierung des Projekts befindet sich in den folgenden Schlüsselverzeichnissen:

host_agent – Die Kernimplementierung der kollaborativen Multi-Agenten-Architektur. Der Host-Agent verwendet das gemini-2.0-flash-lite-Modell als zentralen Koordinator, der für das Verständnis von Anfragen, die Zustandsverwaltung und die Antwortkoordination verantwortlich ist. Das Sub-Agenten-System (sub_agents/) enthält fünf spezialisierte Agenten: payer_agent übernimmt die Auftragserstellung für den Zahler, die EIP-712-Signaturerstellung und die Überprüfung des Wallet-Guthabens; settlement_agent konzentriert sich auf den Abwicklungsprozess, bestätigt Zahlungsdetails, führt On-Chain-Transaktionen aus und überwacht den Transaktionsstatus; payee_agent bearbeitet empfängerbezogene Vorgänge, empfängt Abwicklungsbenachrichtigungen, bestätigt die Auftragserstellung und meldet den Zahlungsabschluss; order_agent verwaltet die Auftragsverarbeitung und Absichtserkennung und leitet automatisch an verschiedene Agenten weiter; allowance_agent bietet Funktionen zur Abfrage von Autorisierungskontingenten und unterstützt Multi-Chain-Token-Autorisierungsabfragen.

a2a_server & mcp_server – Implementierung der Protokollanpassungsschicht, die vielfältige Integrationsmöglichkeiten bietet. a2a_server implementiert das Agent-to-Agent-Protokoll von Google unter Verwendung des A2AStarletteApplication-Frameworks, stellt Agentenfähigkeiten über AgentCard bereit, unterstützt die kollaborative Kommunikation zwischen Agenten und läuft standardmäßig auf Port 10000. mcp_server implementiert die Model Context Protocol-Integration basierend auf dem FastMCP-Framework, kapselt Zahlungsfunktionen als Tool-APIs, stellt das zentrale proceed_payment_and_settlement_detail_info-Tool bereit, unterstützt SSE (Server-Sent Events)-Transport und läuft standardmäßig auf Port 8015.

dao – Implementierung der Datenzugriffsschicht, die PostgreSQL + SQLModel für die Datenpersistenz integriert. Enthält Datenbankmodelldefinitionen (model.py), Datenbankverbindungsverwaltung (database.py) und Datenzugriffsschnittstellen (app.py) und unterstützt die vollständige Geschäftsdatenverwaltung für Aufträge, Zahlungen, Abwicklungen, Absichten und Audit-Ereignisse.

task_manager – Implementierung der Aufgabenverwaltungsschicht mit Factory-Pattern-Design. payment_service.py bietet eine einheitliche Schnittstelle für Zahlungsdienste, task_scoped_manager.py implementiert die Verwaltung des Aufgabenbereichs und gewährleistet Isolation und Lebenszyklusmanagement für verschiedene Zahlungsaufgaben.

services – Vollständige Implementierung der Blockchain-Dienste. Signaturdienste unterstützen sowohl EVM-Chains (execute_sign.py) als auch die Solana-Chain (execute_sign_solana.py), wobei EVM EIP-712 typisierte Datensignierung bietet und Permit-Signaturen für USDC und DAI unterstützt; Transfer-Handler verwenden ein Basisklassen-Abstraktionsdesign (base_handler.py), unterteilt in den custodial/-Modus (Backend verwaltet Wallets zur Vereinfachung der Benutzererfahrung) und den non_custodial/-Modus (Benutzer kontrollieren private Schlüssel für erhöhte Sicherheit) und unterstützen sowohl EVM- (evm_transfer_handler.py) als auch Solana- (solana_transfer_handler.py) Blockchains; die Datendienstschicht umfasst Absichtsaufzeichnung (intent.py), Audit-Ereignisse (audit_event.py), Abwicklungschargen (settlement_batch.py) und Abwicklungsdetails (settlement_detail.py) und ermöglicht die vollständige Nachverfolgung des Transaktionslebenszyklus; die Konstantenkonfiguration (constants.py) verwaltet zentral Blockchain-Netzwerkkonfigurationen, Vertragsadressen und Chain-IDs; die Permit-Ausführung (execute_permit.py) behandelt die ERC-20-Token-Autorisierung und Permit-Ausführung.

Begleitende Konsolen-Demo-Anwendung

Die begleitende Konsolen-Demo-Anwendung befindet sich in einem separaten Zen7-Console-Demo-Repository und bietet Benutzern eine vollständige interaktive Oberfläche und Demonstration des Zahlungsablaufs, sodass Entwickler den Arbeitsablauf des gesamten Zahlungssystems intuitiv erleben können. Sie umfasst vollständige Zahlungsabläufe für sowohl A2A- als auch MCP-Clients in E-Commerce-Szenarien.

  • Shopping Agent Client demonstriert, wie Zahlungsagentendienste in E-Commerce-Szenarien genutzt werden können, und implementiert Funktionen wie Produktdurchsicht, Bestellung und Zahlung.

Technologie-Stack und Kompatibilität

Unterstützte Blockchain-Netzwerke:

  • EVM-kompatible Chains: Ethereum Sepolia, Base Sepolia, Polygon Amoy, BNB Chain Testnet
  • Solana: Devnet, Testnet

Kompatible Token-Standards:

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

Signaturstandards:

  • EVM: EIP-712 Typisierte Datensignierung
  • Solana: Ed25519-Signatur

Wallet-Integration: MetaMask, Coinbase Wallet, Phantom Wallet

Datenpersistenz: PostgreSQL + SQLModel ORM

Dieses Design bietet Entwicklern eine flexible Testumgebung, die eine vollständige Zahlungslösung mit Multi-Chain- und Multi-Währungs-Fähigkeiten unterstützt und gleichzeitig eine gute Kompatibilität mit gängigen Wallets und Blockchain-Netzwerken gewährleistet.

Schnellstart

Umgebungseinrichtung

Entwicklungsleitfaden

Sicherheitshinweise

  • Sicherheit privater Schlüssel: Private Schlüssel in der Testumgebung sind nur für die Entwicklung bestimmt; verwenden Sie in der Produktion sichere Schlüsselverwaltungslösungen
  • Netzwerkumgebung: Unterstützt derzeit Testnetze; Produktionsumgebungen erfordern entsprechende Mainnet-Konfigurationen
  • Token-Verwaltung: Stellen Sie sicher, dass Test-Wallets über ausreichende Test-Token für Transaktionen verfügen
  • API-Sicherheit: Konfigurieren Sie in Produktionsumgebungen geeignete Authentifizierungs- und Autorisierungsmechanismen

Unterstützung

Wenn Sie auf Probleme stoßen oder Hilfe benötigen, gehen Sie bitte wie folgt vor:

  • Überprüfen Sie die entsprechenden Anleitungen im Dokumentationsverzeichnis
  • Reichen Sie Probleme auf GitHub Issues ein
  • Kontaktieren Sie das Entwicklungsteam

Über Zen7 Labs

Zen7 Labs widmet sich dem Aufbau der nächsten Generation dezentraler Zahlungsinfrastruktur und konzentriert sich darauf, innovative Zahlungslösungen für Agentic Commerce bereitzustellen. Durch die Vereinfachung von Blockchain-Zahlungserlebnissen mittels KI-Agententechnologie gestalten wir ein neues Paradigma für Zahlungen im Zeitalter der Agentenökonomie und machen kommerzielle Interaktionen zwischen Agenten effizienter, sicherer und intelligenter.

Zitierung

Wenn Sie Zen7 Payment Agent als hilfreich für Ihre Forschung oder Ihr Projekt empfinden, zitieren Sie es bitte wie folgt:

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

Lizenz

Apache License Version 2.0