Zen7-Payment-Agent MCP Server

официальный

Zen7 Payment Agent — это первый реализационный проект DePA (Decentralized Payment Agent), открывающий новое поколение интеллектуальной платежной инфраструктуры.

GitHub

176

Документация

Zen7 Payment Agent

中文版本

Обновления о ходе выполнения в реальном времени можно посмотреть на странице Real-time progress Для поддержки протокола x402, пожалуйста, нажмите здесь

Zen7 Payment Agent — это первая практическая реализация DePA (Децентрализованного платежного агента), открывающая новое поколение интеллектуальной платежной инфраструктуры. Он не только полностью реализует основные функции DePA, но и успешно внедряет инновационные прикладные решения в сфере агентной коммерции.

Как первый практический проект в экосистеме DePA, Zen7 реализует несколько ключевых функций: автоматизированные зашифрованные платежи между агентами, механизм «авторизации без разрешений» и распознавание намерений и взаимодействие на основе LLM.

Zen7 Payment Agent использует мультиагентную коллаборативную архитектуру, поддерживая протоколы A2A и MCP, а также кастодиальные и некастодиальные модели платежей. Он предоставляет комплексное платежное решение для AI-агентов и нативных Dapp-приложений с поддержкой множества сетей, валют и кошельков, высокочастотных транзакций, операций без газа и беспарольной аутентификации.

Навигация по репозиторию

Этот репозиторий содержит полную реализацию Zen7 Payment Agent, демонстрируя основные компоненты и архитектурный дизайн на основе протокола Zen7 Payment Agent (Децентрализованный платежный агент).

Основная структура каталогов

Основная реализация проекта находится в следующих ключевых каталогах:

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 реализует протокол Agent-to-Agent от Google с использованием фреймворка A2AStarletteApplication, предоставляя возможности агентов через AgentCard, поддерживая коллаборативное взаимодействие между агентами и работая по умолчанию на порту 10000. mcp_server реализует интеграцию Model Context Protocol на основе фреймворка FastMCP, инкапсулируя платежную функциональность в виде API инструментов, предоставляя основной инструмент proceed_payment_and_settlement_detail_info, поддерживая транспорт SSE (Server-Sent Events) и работая по умолчанию на порту 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) централизованно управляет конфигурациями блокчейн-сетей, адресами контрактов и идентификаторами сетей; выполнение разрешений (execute_permit.py) обрабатывает авторизацию токенов ERC-20 и выполнение разрешений.

Сопутствующее демонстрационное консольное приложение

Сопутствующее демонстрационное консольное приложение находится в отдельном репозитории Zen7-Console-Demo, предоставляя пользователям полный интерактивный интерфейс и демонстрацию платежного процесса, позволяя разработчикам наглядно ознакомиться с рабочим процессом всей платежной системы. Оно включает полные платежные процессы для клиентов A2A и MCP в сценариях электронной коммерции.

Shopping Agent Client демонстрирует, как использовать сервисы платежного агента в сценариях электронной коммерции, реализуя такие функции, как просмотр товаров, оформление заказа и оплата.

Технологический стек и совместимость

Поддерживаемые блокчейн-сети:

EVM-совместимые сети: Ethereum Sepolia, Base Sepolia, Polygon Amoy, BNB Chain Testnet
Solana: Devnet, Testnet

Совместимые стандарты токенов:

EVM: USDC (Версия 2), DAI (Версия 1)
Solana: SPL Token

Стандарты подписей:

EVM: Типизированное подписание данных EIP-712
Solana: Подпись Ed25519

Интеграция кошельков: MetaMask, Coinbase Wallet, Phantom Wallet

Персистентность данных: PostgreSQL + SQLModel ORM

Такая архитектура предоставляет разработчикам гибкую среду тестирования, поддерживая комплексное платежное решение с возможностями работы в нескольких сетях и с несколькими валютами, обеспечивая при этом хорошую совместимость с популярными кошельками и блокчейн-сетями.

Быстрый старт

Руководство по быстрому старту — Подробное руководство по настройке и запуску проекта

Настройка окружения

Установка базового окружения — Установка Python 3.13+, инструмента uv и Git
Настройка блокчейн-окружения — Настройка блокчейн-окружения и подготовка тестового кошелька

Руководство по разработке

Руководство по разработке — Руководство по расширению и настройке для разработчиков

Вопросы безопасности

Безопасность приватных ключей: Приватные ключи в тестовой среде предназначены только для разработки; в производственной среде используйте безопасные решения для управления ключами
Сетевое окружение: В настоящее время поддерживаются тестовые сети; для производственных сред требуются соответствующие конфигурации основных сетей
Управление токенами: Убедитесь, что на тестовых кошельках достаточно тестовых токенов для проведения транзакций
Безопасность API: Настройте соответствующие механизмы аутентификации и авторизации в производственных средах

Поддержка

Если у вас возникли проблемы или вам нужна помощь, пожалуйста:

Ознакомьтесь с соответствующими руководствами в каталоге документации
Сообщите о проблемах на GitHub Issues
Свяжитесь с командой разработчиков

О Zen7 Labs

Zen7 Labs занимается созданием децентрализованной платежной инфраструктуры следующего поколения, фокусируясь на предоставлении инновационных платежных решений для агентной коммерции. Упрощая опыт блокчейн-платежей с помощью технологий AI-агентов, мы создаем новую парадигму платежей в эпоху агентной экономики, делая коммерческие взаимодействия между агентами более эффективными, безопасными и интеллектуальными.

Цитирование

Если вы находите Zen7 Payment Agent полезным в своих исследованиях или проекте, пожалуйста, цитируйте его как:

@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