Zen7-Payment-Agent MCP Server

ทางการ

Zen7 Payment Agent เป็นโครงการนำร่องแรกของ DePA (Decentralized Payment Agent) ผู้บุกเบิกโครงสร้างพื้นฐานการชำระเงินอัจฉริยะยุคถัดไป

GitHub
176

เอกสาร

Zen7 Payment Agent

License Python Built with uv 中文版本

สามารถดูการอัปเดตความคืบหน้าแบบเรียลไทม์ได้ที่หน้า ความคืบหน้าแบบเรียลไทม์ สำหรับการสนับสนุนโปรโตคอล x402 โปรด คลิกที่นี่

Zen7 Payment Agent เป็นการใช้งานจริงครั้งแรกของ DePA (Decentralized Payment Agent) ซึ่งบุกเบิกโครงสร้างพื้นฐานการชำระเงินอัจฉริยะยุคใหม่ ไม่เพียงแต่ใช้ฟังก์ชันหลักของ DePA อย่างเต็มรูปแบบ แต่ยังประสบความสำเร็จในการปรับใช้กรณีการใช้งานนวัตกรรมในโดเมนการพาณิชย์แบบเอเจนต์

ในฐานะโครงการที่ใช้งานได้จริงโครงการแรกในระบบนิเวศ DePA Zen7 ได้ใช้คุณสมบัติหลักหลายประการ: การชำระเงินแบบเข้ารหัสอัตโนมัติระหว่างเอเจนต์, กลไก "การอนุญาตแบบไม่ต้องขอสิทธิ์" และการรู้จำเจตนาและการโต้ตอบที่ขับเคลื่อนด้วย LLM

Zen7 Payment Agent ใช้สถาปัตยกรรมการทำงานร่วมกันแบบหลายเอเจนต์ รองรับทั้งโปรโตคอล A2A และ MCP รวมถึงรูปแบบการชำระเงินแบบคัสโตเดียลและไม่ใช่คัสโตเดียล มอบโซลูชันการชำระเงินที่ครอบคลุมสำหรับ AI Agents และแอปพลิเคชัน Dapp ดั้งเดิม ด้วยการรองรับหลายเชน หลายสกุลเงิน หลายกระเป๋าเงิน ธุรกรรมความถี่สูง การดำเนินการแบบไม่ต้องใช้แก๊ส และการตรวจสอบสิทธิ์แบบไม่ต้องใช้รหัสผ่าน

Zen7 Payment Agent Architecture

การนำทางใน Repository

Repository นี้ประกอบด้วยการใช้งาน Zen7 Payment Agent อย่างสมบูรณ์ แสดงให้เห็นถึงองค์ประกอบหลักและการออกแบบสถาปัตยกรรมตามโปรโตคอล Zen7 Payment Agent (Decentralized 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 ห่อหุ้มฟังก์ชันการชำระเงินเป็น tool API ให้เครื่องมือหลัก proceed_payment_and_settlement_detail_info รองรับการขนส่ง SSE (Server-Sent Events) และทำงานบนพอร์ต 8015 ตามค่าเริ่มต้น

dao - การใช้งานเลเยอร์การเข้าถึงข้อมูล ผสานรวม PostgreSQL + SQLModel สำหรับการคงอยู่ของข้อมูล รวมถึงการกำหนดโมเดลฐานข้อมูล (model.py) การจัดการการเชื่อมต่อฐานข้อมูล (database.py) และอินเทอร์เฟซการเข้าถึงข้อมูล (app.py) รองรับการจัดการข้อมูลธุรกิจที่สมบูรณ์สำหรับคำสั่งซื้อ การชำระเงิน การชำระราคา เจตนา และเหตุการณ์การตรวจสอบ

task_manager - การใช้งานเลเยอร์การจัดการงานด้วยการออกแบบรูปแบบ factory payment_service.py ให้อินเทอร์เฟซแบบรวมสำหรับบริการชำระเงิน task_scoped_manager.py ใช้การจัดการขอบเขตงาน รับประกันการแยกส่วนและการจัดการวงจรชีวิตสำหรับงานชำระเงินต่างๆ

services - การใช้งานบริการบล็อกเชนที่สมบูรณ์ บริการลายเซ็นรองรับทั้ง EVM chains (execute_sign.py) และ Solana chain (execute_sign_solana.py) โดย EVM ให้การลงนามข้อมูลแบบมีโครงสร้าง EIP-712 และรองรับลายเซ็น permit สำหรับ 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) จัดการการกำหนดค่าเครือข่ายบล็อกเชน ที่อยู่สัญญา และ chain ID จากส่วนกลาง; การดำเนินการ permit (execute_permit.py) จัดการการอนุญาตโทเค็น ERC-20 และการดำเนินการ permit

แอปพลิเคชันสาธิตคอนโซลคู่กัน

แอปพลิเคชันสาธิตคอนโซลคู่กันอยู่ใน Repository Zen7-Console-Demo แยกต่างหาก มอบอินเทอร์เฟซแบบโต้ตอบที่สมบูรณ์และการสาธิตขั้นตอนการชำระเงินแก่ผู้ใช้ ช่วยให้นักพัฒนาสามารถสัมผัสประสบการณ์เวิร์กโฟลว์ของระบบการชำระเงินทั้งหมดได้อย่าง直观 รวมถึงขั้นตอนการชำระเงินที่สมบูรณ์สำหรับไคลเอนต์ A2A และ MCP ในสถานการณ์อีคอมเมิร์ซ

  • Shopping Agent Client สาธิตวิธีการใช้บริการ payment agent ในสถานการณ์อีคอมเมิร์ซ โดยใช้คุณสมบัติต่างๆ เช่น การเรียกดูสินค้า การสั่งซื้อ และการชำระเงิน

สแต็กเทคโนโลยีและความเข้ากันได้

เครือข่ายบล็อกเชนที่รองรับ:

  • EVM Compatible Chains: 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

การออกแบบนี้มอบสภาพแวดล้อมการทดสอบที่ยืดหยุ่นแก่นักพัฒนา รองรับโซลูชันการชำระเงินที่สมบูรณ์ด้วยความสามารถหลายเชนและหลายสกุลเงิน ในขณะที่รับประกันความเข้ากันได้ที่ดีกับกระเป๋าเงินหลักและเครือข่ายบล็อกเชน

เริ่มต้นอย่างรวดเร็ว

การตั้งค่าสภาพแวดล้อม

คู่มือการพัฒนา

ข้อควรพิจารณาด้านความปลอดภัย

  • ความปลอดภัยของคีย์ส่วนตัว: คีย์ส่วนตัวในสภาพแวดล้อมทดสอบมีไว้สำหรับการพัฒนาเท่านั้น ใช้โซลูชันการจัดการคีย์ที่ปลอดภัยในการใช้งานจริง
  • สภาพแวดล้อมเครือข่าย: ปัจจุบันรองรับเทสเน็ต สภาพแวดล้อมการใช้งานจริงต้องการการกำหนดค่าเมนเน็ตที่สอดคล้องกัน
  • การจัดการโทเค็น: ตรวจสอบให้แน่ใจว่ากระเป๋าเงินทดสอบมีโทเค็นทดสอบเพียงพอสำหรับการทำธุรกรรม
  • ความปลอดภัยของ API: กำหนดค่ากลไกการตรวจสอบสิทธิ์และการอนุญาตที่เหมาะสมในสภาพแวดล้อมการใช้งานจริง

การสนับสนุน

หากคุณพบปัญหาหรือต้องการความช่วยเหลือ โปรด:

เกี่ยวกับ Zen7 Labs

Zen7 Labs ทุ่มเทเพื่อสร้างโครงสร้างพื้นฐานการชำระเงินแบบกระจายศูนย์ยุคใหม่ โดยมุ่งเน้นที่การมอบโซลูชันการชำระเงินที่เป็นนวัตกรรมสำหรับ Agentic Commerce ด้วยการลดความซับซ้อนของประสบการณ์การชำระเงินบนบล็อกเชนผ่านเทคโนโลยี AI agent เรากำลังบุกเบิกกระบวนทัศน์ใหม่ของการชำระเงินในยุคเศรษฐกิจแบบเอเจนต์ ทำให้การโต้ตอบทางการค้าระหว่างเอเจนต์มีประสิทธิภาพ ปลอดภัย และชาญฉลาดยิ่งขึ้น

การอ้างอิง

หากคุณพบว่า 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 เวอร์ชัน 2.0