Zen7-Payment-Agent MCP Server

आधिकारिक

Zen7 Payment Agent, DePA (विकेंद्रीकृत भुगतान एजेंट) का पहला कार्यान्वयन परियोजना है, जो अगली पीढ़ी के बुद्धिमान भुगतान बुनियादी ढांचे का अग्रणी है।

GitHub
176

दस्तावेज़

Zen7 भुगतान एजेंट

License Python Built with uv 中文版本

रीयल-टाइम प्रगति अपडेट रीयल-टाइम प्रगति पृष्ठ पर देखे जा सकते हैं x402 प्रोटोकॉल पर समर्थन के लिए, कृपया यहाँ क्लिक करें

Zen7 भुगतान एजेंट DePA (विकेंद्रीकृत भुगतान एजेंट) का पहला व्यावहारिक कार्यान्वयन है, जो अगली पीढ़ी के बुद्धिमान भुगतान बुनियादी ढांचे का मार्ग प्रशस्त करता है। यह न केवल DePA की मुख्य कार्यक्षमताओं को पूरी तरह से लागू करता है बल्कि एजेंटिक कॉमर्स डोमेन में नवीन अनुप्रयोग मामलों को भी सफलतापूर्वक तैनात करता है।

DePA इकोसिस्टम में पहली व्यावहारिक परियोजना के रूप में, Zen7 कई प्रमुख विशेषताओं को लागू करता है: एजेंटों के बीच स्वचालित एन्क्रिप्टेड भुगतान, एक "अनुमति रहित प्राधिकरण" तंत्र, और LLM-संचालित इरादा पहचान और सहभागिता।

Zen7 भुगतान एजेंट एक बहु-एजेंट सहयोगी आर्किटेक्चर अपनाता है, जो A2A और MCP दोनों प्रोटोकॉल, साथ ही कस्टोडियल और नॉन-कस्टोडियल भुगतान मॉडल का समर्थन करता है। यह AI एजेंटों और मूल Dapp अनुप्रयोगों के लिए बहु-श्रृंखला, बहु-मुद्रा, बहु-वॉलेट समर्थन, उच्च-आवृत्ति लेनदेन, गैस रहित संचालन और पासवर्ड रहित प्रमाणीकरण के साथ एक व्यापक भुगतान समाधान प्रदान करता है।

Zen7 Payment Agent Architecture

रिपॉजिटरी का नेविगेशन

इस रिपॉजिटरी में Zen7 भुगतान एजेंट का पूर्ण कार्यान्वयन शामिल है, जो Zen7 भुगतान एजेंट (विकेंद्रीकृत भुगतान एजेंट) प्रोटोकॉल पर आधारित मुख्य घटकों और आर्किटेक्चरल डिज़ाइन को प्रदर्शित करता है।

मुख्य निर्देशिका संरचना

परियोजना का मुख्य कार्यान्वयन निम्नलिखित प्रमुख निर्देशिकाओं में स्थित है:

host_agent - बहु-एजेंट सहयोगी आर्किटेक्चर का मुख्य कार्यान्वयन। होस्ट एजेंट gemini-2.0-flash-lite मॉडल का उपयोग मुख्य समन्वयक के रूप में करता है, जो क्वेरी समझ, स्थिति प्रबंधन और प्रतिक्रिया समन्वय के लिए जिम्मेदार है। उप-एजेंट प्रणाली (sub_agents/) में पाँच विशिष्ट एजेंट शामिल हैं: payer_agent भुगतानकर्ता के लिए ऑर्डर निर्माण, EIP-712 हस्ताक्षर निर्माण और वॉलेट शेष सत्यापन को संभालता है; settlement_agent निपटान प्रक्रिया पर ध्यान केंद्रित करता है, भुगतान विवरण की पुष्टि करता है, ऑन-चेन लेनदेन निष्पादित करता है और लेनदेन की स्थिति की निगरानी करता है; payee_agent प्राप्तकर्ता-संबंधी संचालन को संभालता है, निपटान सूचनाएं प्राप्त करता है, ऑर्डर निर्माण की पुष्टि करता है और भुगतान पूर्णता की सूचना देता है; order_agent ऑर्डर प्रसंस्करण और इरादा पहचान का प्रबंधन करता है, स्वचालित रूप से विभिन्न एजेंटों को रूट करता है; allowance_agent प्राधिकरण कोटा क्वेरी कार्यक्षमता प्रदान करता है, बहु-श्रृंखला टोकन प्राधिकरण प्रश्नों का समर्थन करता है।

a2a_server और mcp_server - प्रोटोकॉल अनुकूलन परत कार्यान्वयन, विविध एकीकरण विधियाँ प्रदान करता है। a2a_server A2AStarletteApplication फ्रेमवर्क का उपयोग करके Google के एजेंट-टू-एजेंट प्रोटोकॉल को लागू करता है, AgentCard के माध्यम से एजेंट क्षमताओं को उजागर करता है, अंतर-एजेंट सहयोगी संचार का समर्थन करता है, और डिफ़ॉल्ट रूप से पोर्ट 10000 पर चलता है। mcp_server FastMCP फ्रेमवर्क पर आधारित मॉडल कॉन्टेक्स्ट प्रोटोकॉल एकीकरण लागू करता है, भुगतान कार्यक्षमता को टूल 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 के लिए परमिट हस्ताक्षर का समर्थन करता है; स्थानांतरण हैंडलर आधार वर्ग अमूर्त डिज़ाइन (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) केंद्रीय रूप से ब्लॉकचेन नेटवर्क कॉन्फ़िगरेशन, अनुबंध पते और श्रृंखला IDs का प्रबंधन करता है; परमिट निष्पादन (execute_permit.py) ERC-20 टोकन प्राधिकरण और परमिट निष्पादन को संभालता है।

सहयोगी कंसोल डेमो अनुप्रयोग

सहयोगी कंसोल डेमो अनुप्रयोग एक अलग Zen7-Console-Demo रिपॉजिटरी में स्थित है, जो उपयोगकर्ताओं को एक पूर्ण इंटरैक्टिव इंटरफ़ेस और भुगतान प्रवाह प्रदर्शन प्रदान करता है, जिससे डेवलपर्स पूरे भुगतान प्रणाली के वर्कफ़्लो का सहज अनुभव कर सकते हैं। इसमें ई-कॉमर्स परिदृश्यों में A2A और MCP क्लाइंट दोनों के लिए पूर्ण भुगतान प्रवाह शामिल हैं।

  • शॉपिंग एजेंट क्लाइंट दर्शाता है कि ई-कॉमर्स परिदृश्यों में भुगतान एजेंट सेवाओं का उपयोग कैसे करें, उत्पाद ब्राउज़िंग, ऑर्डरिंग और भुगतान जैसी सुविधाओं को लागू करता है।

प्रौद्योगिकी स्टैक और संगतता

समर्थित ब्लॉकचेन नेटवर्क:

  • EVM संगत श्रृंखलाएँ: Ethereum Sepolia, Base Sepolia, Polygon Amoy, BNB Chain Testnet
  • Solana: Devnet, Testnet

संगत टोकन मानक:

  • EVM: USDC (संस्करण 2), DAI (संस्करण 1)
  • Solana: SPL टोकन

हस्ताक्षर मानक:

  • EVM: EIP-712 टाइप्ड डेटा हस्ताक्षर
  • Solana: Ed25519 हस्ताक्षर

वॉलेट एकीकरण: MetaMask, Coinbase Wallet, Phantom Wallet

डेटा स्थायित्व: PostgreSQL + SQLModel ORM

यह डिज़ाइन डेवलपर्स को एक लचीला परीक्षण वातावरण प्रदान करता है, बहु-श्रृंखला और बहु-मुद्रा क्षमताओं के साथ एक पूर्ण भुगतान समाधान का समर्थन करता है, जबकि मुख्यधारा के वॉलेट और ब्लॉकचेन नेटवर्क के साथ अच्छी संगतता सुनिश्चित करता है।

त्वरित शुरुआत

पर्यावरण सेटअप

विकास गाइड

सुरक्षा विचार

  • निजी कुंजी सुरक्षा: परीक्षण वातावरण में निजी कुंजियाँ केवल विकास के लिए हैं; उत्पादन में सुरक्षित कुंजी प्रबंधन समाधान का उपयोग करें
  • नेटवर्क वातावरण: वर्तमान में टेस्टनेट का समर्थन करता है; उत्पादन वातावरण को संबंधित मेननेट कॉन्फ़िगरेशन की आवश्यकता होती है
  • टोकन प्रबंधन: सुनिश्चित करें कि परीक्षण वॉलेट में लेनदेन के लिए पर्याप्त परीक्षण टोकन हों
  • API सुरक्षा: उत्पादन वातावरण में उपयुक्त प्रमाणीकरण और प्राधिकरण तंत्र कॉन्फ़िगर करें

समर्थन

यदि आपको समस्याएँ आती हैं या सहायता की आवश्यकता है, तो कृपया:

Zen7 Labs के बारे में

Zen7 Labs अगली पीढ़ी के विकेंद्रीकृत भुगतान बुनियादी ढांचे के निर्माण के लिए समर्पित है, जो एजेंटिक कॉमर्स के लिए नवीन भुगतान समाधान प्रदान करने पर केंद्रित है। AI एजेंट प्रौद्योगिकी के माध्यम से ब्लॉकचेन भुगतान अनुभवों को सरल बनाकर, हम एजेंट अर्थव्यवस्था युग में भुगतान के एक नए प्रतिमान का मार्ग प्रशस्त कर रहे हैं, जिससे एजेंटों के बीच वाणिज्यिक संपर्क अधिक कुशल, सुरक्षित और बुद्धिमान हो जाते हैं।

उद्धरण

यदि आप अपने शोध या परियोजना में Zen7 भुगतान एजेंट को सहायक पाते हैं, तो कृपया इसे इस प्रकार उद्धृत करें:

@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