Zen7-Payment-Agent MCP Server

resmi

Zen7 Payment Agent adalah proyek implementasi pertama dari DePA (Decentralized Payment Agent), yang menjadi pionir infrastruktur pembayaran cerdas generasi berikutnya.

GitHub

176

Dokumentasi

Zen7 Payment Agent

中文版本

Pembaruan progres waktu nyata dapat dilihat di halaman Progres waktu nyata Untuk dukungan protokol x402, silakan klik di sini

Zen7 Payment Agent adalah implementasi praktis pertama dari DePA (Decentralized Payment Agent), memelopori infrastruktur pembayaran cerdas generasi berikutnya. Ini tidak hanya sepenuhnya mengimplementasikan fungsionalitas inti DePA tetapi juga berhasil menerapkan kasus aplikasi inovatif dalam domain perdagangan agentik.

Sebagai proyek praktis pertama dalam ekosistem DePA, Zen7 mengimplementasikan beberapa fitur utama: pembayaran terenkripsi otomatis antar agen, mekanisme "otorisasi tanpa izin", dan pengenalan maksud serta interaksi yang digerakkan oleh LLM.

Zen7 Payment Agent mengadopsi arsitektur kolaboratif multi-agen, mendukung protokol A2A dan MCP, serta model pembayaran kustodial dan non-kustodial. Ini menyediakan solusi pembayaran komprehensif untuk Agen AI dan aplikasi Dapp asli dengan dukungan multi-rantai, multi-mata uang, multi-dompet, transaksi frekuensi tinggi, operasi tanpa gas, dan autentikasi tanpa kata sandi.

Menjelajahi Repositori

Repositori ini berisi implementasi lengkap Zen7 Payment Agent, menampilkan komponen inti dan desain arsitektur berdasarkan protokol Zen7 Payment Agent (Decentralized Payment Agent).

Struktur Direktori Inti

Implementasi inti proyek terletak di direktori kunci berikut:

host_agent - Implementasi inti arsitektur kolaboratif multi-agen. Agen host menggunakan model gemini-2.0-flash-lite sebagai koordinator inti, bertanggung jawab atas pemahaman kueri, manajemen status, dan koordinasi respons. Sistem sub-agen (sub_agents/) berisi lima agen khusus: payer_agent menangani pembuatan pesanan untuk pembayar, pembuatan tanda tangan EIP-712, dan verifikasi saldo dompet; settlement_agent fokus pada proses penyelesaian, mengonfirmasi detail pembayaran, mengeksekusi transaksi on-chain, dan memantau status transaksi; payee_agent menangani operasi terkait penerima pembayaran, menerima notifikasi penyelesaian, mengonfirmasi pembuatan pesanan, dan memberi tahu penyelesaian pembayaran; order_agent mengelola pemrosesan pesanan dan pengenalan maksud, secara otomatis merutekan ke agen yang berbeda; allowance_agent menyediakan fungsionalitas kueri kuota otorisasi, mendukung kueri otorisasi token multi-rantai.

a2a_server & mcp_server - Implementasi lapisan adaptasi protokol, menyediakan metode integrasi yang beragam. a2a_server mengimplementasikan protokol Agent-to-Agent Google menggunakan kerangka kerja A2AStarletteApplication, mengekspos kemampuan agen melalui AgentCard, mendukung komunikasi kolaboratif antar agen, dan berjalan di port 10000 secara default. mcp_server mengimplementasikan integrasi Model Context Protocol berdasarkan kerangka kerja FastMCP, mengenkapsulasi fungsionalitas pembayaran sebagai API alat, menyediakan alat inti proceed_payment_and_settlement_detail_info, mendukung transport SSE (Server-Sent Events), dan berjalan di port 8015 secara default.

dao - Implementasi lapisan akses data, mengintegrasikan PostgreSQL + SQLModel untuk persistensi data. Termasuk definisi model basis data (model.py), manajemen koneksi basis data (database.py), dan antarmuka akses data (app.py), mendukung manajemen data bisnis lengkap untuk pesanan, pembayaran, penyelesaian, maksud, dan peristiwa audit.

task_manager - Implementasi lapisan manajemen tugas dengan desain pola pabrik. payment_service.py menyediakan antarmuka terpadu untuk layanan pembayaran, task_scoped_manager.py mengimplementasikan manajemen cakupan tugas, memastikan isolasi dan manajemen siklus hidup untuk tugas pembayaran yang berbeda.

services - Implementasi layanan blockchain lengkap. Layanan tanda tangan mendukung rantai EVM (execute_sign.py) dan rantai Solana (execute_sign_solana.py), dengan EVM menyediakan penandatanganan data terstruktur EIP-712 dan mendukung tanda tangan izin untuk USDC dan DAI; penangan transfer mengadopsi desain abstraksi kelas dasar (base_handler.py), dibagi menjadi mode custodial/ (backend mengelola dompet untuk menyederhanakan pengalaman pengguna) dan mode non_custodial/ (pengguna mengontrol kunci pribadi untuk keamanan yang ditingkatkan), mendukung blockchain EVM (evm_transfer_handler.py) dan Solana (solana_transfer_handler.py); lapisan layanan data mencakup pencatatan maksud (intent.py), peristiwa audit (audit_event.py), batch penyelesaian (settlement_batch.py), dan detail penyelesaian (settlement_detail.py), memungkinkan pelacakan siklus hidup transaksi penuh; konfigurasi konstan (constants.py) secara terpusat mengelola konfigurasi jaringan blockchain, alamat kontrak, dan ID rantai; eksekusi izin (execute_permit.py) menangani otorisasi token ERC-20 dan eksekusi izin.

Aplikasi Demo Konsol Pendamping

Aplikasi demo konsol pendamping terletak di repositori Zen7-Console-Demo yang terpisah, menyediakan antarmuka interaktif lengkap dan demonstrasi alur pembayaran kepada pengguna, memungkinkan pengembang untuk secara intuitif mengalami alur kerja seluruh sistem pembayaran. Ini mencakup alur pembayaran lengkap untuk klien A2A dan MCP dalam skenario e-commerce.

Klien Agen Belanja mendemonstrasikan cara menggunakan layanan agen pembayaran dalam skenario e-commerce, mengimplementasikan fitur seperti penelusuran produk, pemesanan, dan pembayaran.

Tumpukan Teknologi dan Kompatibilitas

Jaringan Blockchain yang Didukung:

Rantai Kompatibel EVM: Ethereum Sepolia, Base Sepolia, Polygon Amoy, BNB Chain Testnet
Solana: Devnet, Testnet

Standar Token yang Kompatibel:

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

Standar Tanda Tangan:

EVM: Penandatanganan Data Terstruktur EIP-712
Solana: Tanda Tangan Ed25519

Integrasi Dompet: MetaMask, Coinbase Wallet, Phantom Wallet

Persistensi Data: PostgreSQL + SQLModel ORM

Desain ini menyediakan lingkungan pengujian yang fleksibel bagi pengembang, mendukung solusi pembayaran lengkap dengan kemampuan multi-rantai dan multi-mata uang, sambil memastikan kompatibilitas yang baik dengan dompet arus utama dan jaringan blockchain.

Mulai Cepat

Panduan Mulai Cepat - Panduan pengaturan dan menjalankan proyek terperinci

Pengaturan Lingkungan

Instalasi Lingkungan Dasar - Instal Python 3.13+, alat uv, dan Git
Konfigurasi Lingkungan Blockchain - Pengaturan lingkungan blockchain dan persiapan dompet uji

Panduan Pengembangan

Panduan Pengembangan - Panduan ekstensi dan kustomisasi pengembang

Pertimbangan Keamanan

Keamanan Kunci Pribadi: Kunci pribadi di lingkungan pengujian hanya untuk pengembangan; gunakan solusi manajemen kunci yang aman di produksi
Lingkungan Jaringan: Saat ini mendukung testnet; lingkungan produksi memerlukan konfigurasi mainnet yang sesuai
Manajemen Token: Pastikan dompet uji memiliki token uji yang cukup untuk transaksi
Keamanan API: Konfigurasikan mekanisme autentikasi dan otorisasi yang sesuai di lingkungan produksi

Dukungan

Jika Anda mengalami masalah atau membutuhkan bantuan, silakan:

Periksa panduan terkait di direktori dokumentasi
Kirim masalah di GitHub Issues
Hubungi tim pengembangan

Tentang Zen7 Labs

Zen7 Labs berdedikasi untuk membangun infrastruktur pembayaran terdesentralisasi generasi berikutnya, berfokus pada penyediaan solusi pembayaran inovatif untuk Perdagangan Agentik. Dengan menyederhanakan pengalaman pembayaran blockchain melalui teknologi agen AI, kami memelopori paradigma baru pembayaran di era ekonomi agen, membuat interaksi komersial antar agen lebih efisien, aman, dan cerdas.

Sitasi

Jika Anda merasa Zen7 Payment Agent membantu dalam penelitian atau proyek Anda, silakan sitasi sebagai:

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

Lisensi

Apache License Version 2.0