প্রকল্প সম্পর্কে

Mergepay API হলো Mergepay-এর ব্যাকএন্ড সেবা, একটি Stellar-নেটিভ গ্রুপ সেটেলমেন্ট অ্যাপ্লিকেশন। এটি প্রমাণীকরণ, গ্রুপ ও খরচের লজিক, অন-চেইন সেটেলমেন্ট, Stellar ইন্টিগ্রেশন, ট্রেজারি মাল্টিসিগ এবং SEP-24 অ্যাঙ্কর ফ্লো পরিচালনা করে। সিস্টেমটি Stellar ব্লকচেইনে নির্মিত। প্রতিটি সেটেলমেন্ট একটি প্রকৃত অন-চেইন পেমেন্ট: লগইন SEP-10 ওয়ালেট প্রমাণীকরণ ব্যবহার করে, পেমেন্টে একটি `MP:<code>` মেমো থাকে যা সেগুলোকে নির্দিষ্ট খরচের সাথে সংযুক্ত করে, ব্যালেন্স trustline-এর মাধ্যমে XLM বা USDC-তে নিষ্পত্তি হয়, শেয়ার্ড ট্রেজারি Stellar মাল্টিসিগ ব্যবহার করে, এবং ফিয়াট অন/অফ-র্যাম্প SEP-24 অ্যাঙ্করের মাধ্যমে সম্পন্ন হয়। সার্ভার কখনোই ব্যবহারকারীর প্রাইভেট কী সংরক্ষণ করে না — এটি অস্বাক্ষরিত XDR লেনদেন এনভেলপ তৈরি করে যা Horizon-এ জমা দেওয়ার আগে ব্যবহারকারীর ওয়ালেট স্বাক্ষর করে। আর্কিটেকচার: API হলো একটি Fastify + TypeScript ব্যাকএন্ড যা PostgreSQL দ্বারা সমর্থিত। এটি Bearer JWT প্রমাণীকরণসহ REST-এর মাধ্যমে একটি Next.js ফ্রন্টএন্ডের সাথে যোগাযোগ করে। একটি ব্যাকগ্রাউন্ড ওয়ার্কার সেটেলমেন্ট জমা এবং SEP-24 অ্যাঙ্কর পোলিং পরিচালনা করে, claim-ভিত্তিক জব ট্র্যাকিং এবং ক্র্যাশ হওয়া প্রসেস থেকে পুনরুদ্ধারসহ। প্রধান বৈশিষ্ট্যগুলোর মধ্যে রয়েছে: - SEP-10 ওয়ালেট-ভিত্তিক প্রমাণীকরণ যেখানে ব্যবহারকারীর পাবলিক কী-ই তার পরিচয় - সেটেলমেন্ট ফ্লো: API সোর্স, ডেস্টিনেশন, অ্যাসেট, অ্যামাউন্ট এবং মেমোসহ একটি অস্বাক্ষরিত পেমেন্ট XDR তৈরি করে, এটিকে pending হিসেবে রেকর্ড করে, ওয়ালেট এটি স্বাক্ষর করে, এবং API Horizon-এ জমা দেওয়ার আগে সংরক্ষিত intent-এর বিপরীতে স্বাক্ষরিত XDR যাচাই করে - সার্ভার-নিয়ন্ত্রিত ডেডলাইন এবং সীমাবদ্ধ ক্লক-স্কিউ সহনশীলতাসহ লেনদেন intent-এর মেয়াদোত্তীর্ণতা - Stellar মাল্টিসিগ ব্যবহার করে শেয়ার্ড গ্রুপ ট্রেজারি, যেখানে উত্তোলনের জন্য একাধিক স্বাক্ষরকারী প্রয়োজন - ফিয়াট-থেকে-Stellar রূপান্তরের জন্য SEP-24 অ্যাঙ্কর ডিপোজিট এবং উইথড্র ব্রিজ - ডুপ্লিকেট জমা প্রতিরোধে সেটেলমেন্ট এক্সিকিউশনে idempotency সুরক্ষা - ইনস্ট্যান্স জুড়ে ডেটাবেস-সমর্থিত শেয়ার্ড কাউন্টারসহ প্রতি রুটে ব্যাপক রেট লিমিটিং - JSON বডি এবং মাল্টিপার্ট আপলোডে রিকোয়েস্ট সাইজ সীমা - সমগ্র কোডবেসে TypeScript strict মোড প্রয়োগ - সমস্ত API রিকোয়েস্ট বডি Zod দিয়ে যাচাইকৃত প্রকল্পটি চালাতে Node.js 20+ এবং PostgreSQL 14+ প্রয়োজন। Neon, Supabase বা RDS-এর মতো প্রোভাইডার থেকে প্রোভিশন করা Postgres-সহ এটি Render, Fly.io বা Railway-এ ডিপ্লয় করা যায়। পরীক্ষাগুলো মক করা Prisma এবং Horizon ব্যবহার করে ডেটাবেস বা নেটওয়ার্ক ছাড়াই চলে, যা সেটেলমেন্ট ইঞ্জিন, মানি ম্যাথ, SEP-10 challenge/verify, স্বাক্ষরিত-XDR যাচাইকরণ এবং auth রুট কভার করে। একটি কমিট করা `docs/api.http` ফাইল স্থানীয় API অন্বেষণের জন্য একটি REST Client কালেকশন প্রদান করে।