Zen7-Payment-Agent MCP Server

chính thức

Zen7 Payment Agent là dự án triển khai đầu tiên của DePA (Đại lý thanh toán phi tập trung), tiên phong trong hạ tầng thanh toán thông minh thế hệ tiếp theo.

GitHub
176

Tài liệu

Zen7 Payment Agent

License Python Built with uv 中文版本

Có thể xem tiến độ cập nhật theo thời gian thực tại trang Tiến độ thời gian thực Để được hỗ trợ về giao thức x402, vui lòng nhấp vào đây

Zen7 Payment Agent là triển khai thực tế đầu tiên của DePA (Tác nhân Thanh toán Phi tập trung), tiên phong cho thế hệ cơ sở hạ tầng thanh toán thông minh tiếp theo. Nó không chỉ triển khai đầy đủ các chức năng cốt lõi của DePA mà còn triển khai thành công các ca ứng dụng sáng tạo trong lĩnh vực thương mại tác tử.

Là dự án thực tế đầu tiên trong hệ sinh thái DePA, Zen7 triển khai một số tính năng chính: thanh toán mã hóa tự động giữa các tác tử, cơ chế "ủy quyền không cần cấp phép", và nhận diện ý định cũng như tương tác dựa trên LLM.

Zen7 Payment Agent áp dụng kiến trúc cộng tác đa tác tử, hỗ trợ cả giao thức A2A và MCP, cũng như các mô hình thanh toán lưu ký và không lưu ký. Nó cung cấp giải pháp thanh toán toàn diện cho các Tác tử AI và ứng dụng Dapp gốc với hỗ trợ đa chuỗi, đa tiền tệ, đa ví, giao dịch tần suất cao, vận hành không tốn phí gas và xác thực không mật khẩu.

Zen7 Payment Agent Architecture

Điều hướng Kho lưu trữ

Kho lưu trữ này chứa toàn bộ bản triển khai của Zen7 Payment Agent, giới thiệu các thành phần cốt lõi và thiết kế kiến trúc dựa trên giao thức Zen7 Payment Agent (Tác nhân Thanh toán Phi tập trung).

Cấu trúc Thư mục Cốt lõi

Phần triển khai cốt lõi của dự án nằm trong các thư mục chính sau:

host_agent - Phần triển khai cốt lõi của kiến trúc cộng tác đa tác tử. Tác tử chủ sử dụng mô hình gemini-2.0-flash-lite làm bộ điều phối trung tâm, chịu trách nhiệm hiểu truy vấn, quản lý trạng thái và điều phối phản hồi. Hệ thống tác tử con (sub_agents/) chứa năm tác tử chuyên biệt: payer_agent xử lý việc tạo đơn hàng cho người trả tiền, tạo chữ ký EIP-712 và xác minh số dư ví; settlement_agent tập trung vào quy trình quyết toán, xác nhận chi tiết thanh toán, thực thi giao dịch trên chuỗi và giám sát trạng thái giao dịch; payee_agent xử lý các thao tác liên quan đến người nhận tiền, nhận thông báo quyết toán, xác nhận tạo đơn hàng và thông báo hoàn tất thanh toán; order_agent quản lý xử lý đơn hàng và nhận diện ý định, tự động định tuyến đến các tác tử khác nhau; allowance_agent cung cấp chức năng truy vấn hạn mức ủy quyền, hỗ trợ truy vấn ủy quyền token đa chuỗi.

a2a_server & mcp_server - Triển khai lớp thích ứng giao thức, cung cấp các phương thức tích hợp đa dạng. a2a_server triển khai giao thức Agent-to-Agent của Google sử dụng framework A2AStarletteApplication, phơi bày năng lực tác tử thông qua AgentCard, hỗ trợ giao tiếp cộng tác giữa các tác tử, và mặc định chạy trên cổng 10000. mcp_server triển khai tích hợp Model Context Protocol dựa trên framework FastMCP, đóng gói chức năng thanh toán thành các API công cụ, cung cấp công cụ cốt lõi proceed_payment_and_settlement_detail_info, hỗ trợ truyền tải SSE (Server-Sent Events), và mặc định chạy trên cổng 8015.

dao - Triển khai lớp truy cập dữ liệu, tích hợp PostgreSQL + SQLModel để lưu trữ dữ liệu bền vững. Bao gồm các định nghĩa mô hình cơ sở dữ liệu (model.py), quản lý kết nối cơ sở dữ liệu (database.py), và các giao diện truy cập dữ liệu (app.py), hỗ trợ quản lý dữ liệu nghiệp vụ toàn diện cho đơn hàng, thanh toán, quyết toán, ý định và sự kiện kiểm toán.

task_manager - Triển khai lớp quản lý tác vụ với thiết kế mẫu factory. payment_service.py cung cấp giao diện thống nhất cho các dịch vụ thanh toán, task_scoped_manager.py triển khai quản lý phạm vi tác vụ, đảm bảo sự cô lập và quản lý vòng đời cho các tác vụ thanh toán khác nhau.

services - Triển khai dịch vụ blockchain hoàn chỉnh. Dịch vụ chữ ký hỗ trợ cả chuỗi EVM (execute_sign.py) và chuỗi Solana (execute_sign_solana.py), với EVM cung cấp ký dữ liệu có cấu trúc EIP-712 và hỗ trợ chữ ký permit cho USDC và DAI; các trình xử lý chuyển tiền áp dụng thiết kế trừu tượng lớp cơ sở (base_handler.py), được chia thành chế độ custodial/ (backend quản lý ví để đơn giản hóa trải nghiệm người dùng) và chế độ non_custodial/ (người dùng kiểm soát khóa riêng tư để tăng cường bảo mật), hỗ trợ cả blockchain EVM (evm_transfer_handler.py) và Solana (solana_transfer_handler.py); lớp dịch vụ dữ liệu bao gồm ghi nhận ý định (intent.py), sự kiện kiểm toán (audit_event.py), lô quyết toán (settlement_batch.py), và chi tiết quyết toán (settlement_detail.py), cho phép theo dõi toàn bộ vòng đời giao dịch; cấu hình hằng số (constants.py) quản lý tập trung cấu hình mạng blockchain, địa chỉ hợp đồng và ID chuỗi; thực thi permit (execute_permit.py) xử lý ủy quyền token ERC-20 và thực thi permit.

Ứng dụng Demo Bảng điều khiển Đi kèm

Ứng dụng demo bảng điều khiển đi kèm nằm trong một kho lưu trữ riêng biệt Zen7-Console-Demo, cung cấp cho người dùng giao diện tương tác và trình diễn luồng thanh toán hoàn chỉnh, cho phép các nhà phát triển trải nghiệm trực quan quy trình làm việc của toàn bộ hệ thống thanh toán. Nó bao gồm các luồng thanh toán hoàn chỉnh cho cả client A2A và MCP trong các kịch bản thương mại điện tử.

  • Shopping Agent Client minh họa cách sử dụng dịch vụ tác tử thanh toán trong các kịch bản thương mại điện tử, triển khai các tính năng như duyệt sản phẩm, đặt hàng và thanh toán.

Ngăn xếp Công nghệ và Khả năng Tương thích

Các Mạng Blockchain được Hỗ trợ:

  • Chuỗi Tương thích EVM: Ethereum Sepolia, Base Sepolia, Polygon Amoy, BNB Chain Testnet
  • Solana: Devnet, Testnet

Tiêu chuẩn Token Tương thích:

  • EVM: USDC (Phiên bản 2), DAI (Phiên bản 1)
  • Solana: SPL Token

Tiêu chuẩn Chữ ký:

  • EVM: Ký Dữ liệu có Cấu trúc EIP-712
  • Solana: Chữ ký Ed25519

Tích hợp Ví: MetaMask, Coinbase Wallet, Phantom Wallet

Lưu trữ Dữ liệu Bền vững: PostgreSQL + SQLModel ORM

Thiết kế này cung cấp cho các nhà phát triển một môi trường kiểm thử linh hoạt, hỗ trợ giải pháp thanh toán hoàn chỉnh với khả năng đa chuỗi và đa tiền tệ, đồng thời đảm bảo khả năng tương thích tốt với các ví và mạng blockchain phổ biến.

Bắt đầu Nhanh

Thiết lập Môi trường

Hướng dẫn Phát triển

Cân nhắc về Bảo mật

  • Bảo mật Khóa Riêng tư: Khóa riêng tư trong môi trường kiểm thử chỉ dành cho phát triển; hãy sử dụng các giải pháp quản lý khóa an toàn trong môi trường production
  • Môi trường Mạng: Hiện tại hỗ trợ các testnet; môi trường production yêu cầu cấu hình mainnet tương ứng
  • Quản lý Token: Đảm bảo ví kiểm thử có đủ token kiểm thử để thực hiện giao dịch
  • Bảo mật API: Cấu hình cơ chế xác thực và ủy quyền phù hợp trong môi trường production

Hỗ trợ

Nếu bạn gặp sự cố hoặc cần trợ giúp, vui lòng:

  • Kiểm tra các hướng dẫn liên quan trong thư mục tài liệu
  • Gửi vấn đề trên GitHub Issues
  • Liên hệ với nhóm phát triển

Về Zen7 Labs

Zen7 Labs tận tâm xây dựng thế hệ cơ sở hạ tầng thanh toán phi tập trung tiếp theo, tập trung vào việc cung cấp các giải pháp thanh toán sáng tạo cho Thương mại Tác tử. Bằng cách đơn giản hóa trải nghiệm thanh toán blockchain thông qua công nghệ tác tử AI, chúng tôi đang tiên phong một mô hình thanh toán mới trong kỷ nguyên kinh tế tác tử, làm cho các tương tác thương mại giữa các tác tử trở nên hiệu quả, an toàn và thông minh hơn.

Trích dẫn

Nếu bạn thấy Zen7 Payment Agent hữu ích trong nghiên cứu hoặc dự án của mình, vui lòng trích dẫn nó như sau:

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

Giấy phép

Apache License Version 2.0