Zen7-Payment-Agent MCP Server

resmi

Zen7 Payment Agent, DePA (Merkeziyetsiz Ödeme Ajanı) projesinin ilk uygulama projesidir ve yeni nesil akıllı ödeme altyapısına öncülük eder.

GitHub

176

Dokümantasyon

Zen7 Payment Agent

中文版本

Gerçek zamanlı ilerleme güncellemeleri Gerçek zamanlı ilerleme sayfasında görüntülenebilir x402 protokolü desteği için lütfen buraya tıklayın

Zen7 Payment Agent, DePA'nın (Merkeziyetsiz Ödeme Ajanı) ilk pratik uygulaması olup, yeni nesil akıllı ödeme altyapısına öncülük etmektedir. Yalnızca DePA'nın temel işlevlerini tam olarak uygulamakla kalmaz, aynı zamanda ajan tabanlı ticaret alanında yenilikçi uygulama örneklerini başarıyla devreye alır.

DePA ekosistemindeki ilk pratik proje olan Zen7, birkaç temel özelliği hayata geçirir: ajanlar arası otomatik şifreli ödemeler, "izinsiz yetkilendirme" mekanizması ve LLM güdümlü niyet tanıma ve etkileşim.

Zen7 Payment Agent, çoklu ajan iş birliği mimarisini benimser, hem A2A hem de MCP protokollerini ve ayrıca emanetli ve emanetsiz ödeme modellerini destekler. Çok zincirli, çok para birimli, çok cüzdanlı destek, yüksek frekanslı işlemler, gas'siz operasyonlar ve parolasız kimlik doğrulama ile AI Ajanları ve yerel Dapp uygulamaları için kapsamlı bir ödeme çözümü sunar.

Depoda Gezinme

Bu depo, Zen7 Payment Agent'ın tam uygulamasını içerir ve Zen7 Payment Agent (Merkeziyetsiz Ödeme Ajanı) protokolüne dayalı temel bileşenleri ve mimari tasarımı sergiler.

Temel Dizin Yapısı

Projenin temel uygulaması aşağıdaki anahtar dizinlerde bulunur:

host_agent - Çoklu ajan iş birliği mimarisinin temel uygulaması. Ana ajan, sorgu anlama, durum yönetimi ve yanıt koordinasyonundan sorumlu çekirdek koordinatör olarak gemini-2.0-flash-lite modelini kullanır. Alt ajan sistemi (sub_agents/) beş özel ajan içerir: payer_agent ödeyen için sipariş oluşturma, EIP-712 imza üretimi ve cüzdan bakiye doğrulamasını yönetir; settlement_agent mutabakat sürecine odaklanır, ödeme detaylarını onaylar, zincir üstü işlemleri yürütür ve işlem durumunu izler; payee_agent alacaklı ile ilgili işlemleri yönetir, mutabakat bildirimlerini alır, sipariş oluşturmayı onaylar ve ödeme tamamlandığını bildirir; order_agent sipariş işleme ve niyet tanımayı yönetir, farklı ajanlara otomatik olarak yönlendirir; allowance_agent çok zincirli token yetkilendirme sorgularını destekleyerek yetkilendirme kotası sorgulama işlevselliği sağlar.

a2a_server & mcp_server - Protokol uyarlama katmanı uygulaması, çeşitli entegrasyon yöntemleri sunar. a2a_server, A2AStarletteApplication çerçevesini kullanarak Google'ın Ajanlar Arası protokolünü uygular, ajan yeteneklerini AgentCard aracılığıyla sunar, ajanlar arası iş birliği iletişimini destekler ve varsayılan olarak 10000 portunda çalışır. mcp_server, FastMCP çerçevesine dayalı Model Bağlam Protokolü entegrasyonunu uygular, ödeme işlevselliğini araç API'leri olarak kapsüller, temel proceed_payment_and_settlement_detail_info aracını sağlar, SSE (Sunucu Tarafından Gönderilen Olaylar) taşımasını destekler ve varsayılan olarak 8015 portunda çalışır.

dao - Veri erişim katmanı uygulaması, veri kalıcılığı için PostgreSQL + SQLModel entegrasyonu yapar. Veritabanı model tanımlarını (model.py), veritabanı bağlantı yönetimini (database.py) ve veri erişim arayüzlerini (app.py) içerir, siparişler, ödemeler, mutabakatlar, niyetler ve denetim olayları için eksiksiz iş verisi yönetimini destekler.

task_manager - Fabrika deseni tasarımı ile görev yönetim katmanı uygulaması. payment_service.py ödeme hizmetleri için birleşik bir arayüz sağlar, task_scoped_manager.py farklı ödeme görevleri için izolasyon ve yaşam döngüsü yönetimini sağlayarak görev kapsam yönetimini uygular.

services - Eksiksiz blok zinciri hizmet uygulaması. İmza hizmetleri hem EVM zincirlerini (execute_sign.py) hem de Solana zincirini (execute_sign_solana.py) destekler, EVM EIP-712 tipli veri imzalama sağlar ve USDC ile DAI için izin imzalarını destekler; transfer işleyicileri temel sınıf soyutlama tasarımını benimser (base_handler.py), custodial/ modu (kullanıcı deneyimini basitleştirmek için arka uç cüzdanları yönetir) ve non_custodial/ modu (gelişmiş güvenlik için kullanıcılar özel anahtarları kontrol eder) olarak ayrılır, hem EVM (evm_transfer_handler.py) hem de Solana (solana_transfer_handler.py) blok zincirlerini destekler; veri hizmeti katmanı niyet kaydı (intent.py), denetim olayları (audit_event.py), mutabakat grupları (settlement_batch.py) ve mutabakat detaylarını (settlement_detail.py) içerir, tam işlem yaşam döngüsü takibini sağlar; sabit yapılandırma (constants.py) blok zinciri ağ yapılandırmalarını, sözleşme adreslerini ve zincir kimliklerini merkezi olarak yönetir; izin yürütme (execute_permit.py) ERC-20 token yetkilendirme ve izin yürütmeyi yönetir.

Yardımcı Konsol Demo Uygulaması

Yardımcı konsol demo uygulaması ayrı bir Zen7-Console-Demo deposunda bulunur, kullanıcılara eksiksiz bir etkileşimli arayüz ve ödeme akışı gösterimi sunarak geliştiricilerin tüm ödeme sisteminin iş akışını sezgisel olarak deneyimlemelerini sağlar. E-ticaret senaryolarında hem A2A hem de MCP istemcileri için eksiksiz ödeme akışlarını içerir.

Alışveriş Ajanı İstemcisi e-ticaret senaryolarında ödeme ajanı hizmetlerinin nasıl kullanılacağını gösterir, ürün tarama, sipariş verme ve ödeme gibi özellikleri uygular.

Teknoloji Yığını ve Uyumluluk

Desteklenen Blok Zinciri Ağları:

EVM Uyumlu Zincirler: Ethereum Sepolia, Base Sepolia, Polygon Amoy, BNB Chain Testnet
Solana: Devnet, Testnet

Uyumlu Token Standartları:

EVM: USDC (Sürüm 2), DAI (Sürüm 1)
Solana: SPL Token

İmza Standartları:

EVM: EIP-712 Tipli Veri İmzalama
Solana: Ed25519 İmza

Cüzdan Entegrasyonu: MetaMask, Coinbase Wallet, Phantom Wallet

Veri Kalıcılığı: PostgreSQL + SQLModel ORM

Bu tasarım, geliştiricilere esnek bir test ortamı sağlar, çok zincirli ve çok para birimli yeteneklere sahip eksiksiz bir ödeme çözümünü desteklerken, ana akım cüzdanlar ve blok zinciri ağlarıyla iyi uyumluluk sağlar.

Hızlı Başlangıç

Hızlı Başlangıç Kılavuzu - Detaylı proje kurulumu ve çalıştırma kılavuzu

Ortam Kurulumu

Temel Ortam Kurulumu - Python 3.13+, uv aracı ve Git kurulumu
Blok Zinciri Ortam Yapılandırması - Blok zinciri ortam kurulumu ve test cüzdanı hazırlığı

Geliştirme Kılavuzu

Geliştirme Kılavuzu - Geliştirici genişletme ve özelleştirme kılavuzu

Güvenlik Hususları

Özel Anahtar Güvenliği: Test ortamındaki özel anahtarlar yalnızca geliştirme içindir; üretimde güvenli anahtar yönetim çözümleri kullanın
Ağ Ortamı: Şu anda test ağlarını destekler; üretim ortamları ilgili ana ağ yapılandırmalarını gerektirir
Token Yönetimi: Test cüzdanlarının işlemler için yeterli test tokenına sahip olduğundan emin olun
API Güvenliği: Üretim ortamlarında uygun kimlik doğrulama ve yetkilendirme mekanizmalarını yapılandırın

Destek

Sorunlarla karşılaşırsanız veya yardıma ihtiyacınız olursa, lütfen:

Dokümantasyon dizinindeki ilgili kılavuzları kontrol edin
GitHub Issues üzerinden sorun bildirin
Geliştirme ekibiyle iletişime geçin

Zen7 Labs Hakkında

Zen7 Labs, yeni nesil merkeziyetsiz ödeme altyapısını inşa etmeye kendini adamıştır ve Ajan Tabanlı Ticaret için yenilikçi ödeme çözümleri sunmaya odaklanmıştır. AI ajan teknolojisi aracılığıyla blok zinciri ödeme deneyimlerini basitleştirerek, ajan ekonomisi çağında yeni bir ödeme paradigmasına öncülük ediyor, ajanlar arasındaki ticari etkileşimleri daha verimli, güvenli ve akıllı hale getiriyoruz.

Atıf

Zen7 Payment Agent'ı araştırmanızda veya projenizde yararlı bulursanız, lütfen şu şekilde atıfta bulunun:

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

Lisans

Apache Lisansı Sürüm 2.0