KURV للمطوّرين

يمكن إدخال مجموعات KURV في تطبيقاتك ومواقعك وسير عمل وكلائك. تحتفظ العقود العامة بحالة المجموعة. وتتيح واجهة HTTP API إعدادات المجموعة وقراءات السلسلة، وتعرض أداة العرض المجموعة أينما تُضمَّن، ويسمح MCP لوكيل مخوَّل بتجهيز مجموعة توليدية لمبدعها.

اختيار طريقة التكامل

المطلوب	نقطة البداية
ربط وكيل وتجهيز المجموعات	ربط وكيل عبر MCP
قراءة المجموعات وأعداد السكّ ومعلومات العقود	واجهات API العامة
قراءة أرقام KURV بمفتاح API: الإطلاقات، وعمليات السكّ، وحجم التداول، والرسوم، والتسجيلات	واجهة بيانات KURV
وضع العمل الفني للمجموعة وزر سكّ على موقع آخر	تضمين المجموعات
وضع زر سكّ خاص بك على أي صفحة، على Base أو Solana	السكّ من صفحتك
بناء تجربة سكّ باستخدام أداة ربط المحفظة الخاصة بك	السكّ من موقعك

نقاط الوصول والشبكة

Base Sepolia (chain ID 84532) هي الشبكة الافتراضية. وتدعم المسودات التي تحدد version: 2 وnetwork صراحةً أيضًا عمليات النشر الموثّقة على Solana Devnet و localnet. يُستحسن قراءة kurv_builder_spec للشبكة المختارة قبل تجهيز مسودة. ولا تحتفظ أداة الربط أبدًا بالمفتاح الخاص للمبدع.

نقطة الدخول	العنوان
نقطة MCP البعيدة	https://mcp.kurv.fun/mcp
اكتشاف الواجهة العامة	https://testnet.kurv.fun/api/v1
فهرس المجموعات	https://testnet.kurv.fun/api/v1/collections
KurvDrop ABI	https://testnet.kurv.fun/api/v1/contracts/kurvdrop
بيئة تجربة التكامل	KURV للمطوّرين

mcp.kurv.fun هي نقطة خدمة الآلات. أما هذه الوثائق فهي مكان تعليمات الربط ودليل الأدوات وأمثلة التكامل. والقراءات عبر API و iframe عامة ولا تحتاج إلى حساب ولا مفتاح API. وتستخدم أداة ربط الوكيل OAuth لتخويل حساب KURV محدد.

الإنشاء بمساعدة وكيل

1. إضافة https://mcp.kurv.fun/mcp في عميل MCP بعيد يدعم OAuth.
2. تسجيل الدخول على KURV والموافقة على الأذونات التي يطلبها العميل. ويلزم وجود دعوة قائمة لكتابة المجموعات وتجهيز الإطلاق.
3. الطلب من الوكيل فحص مخطط البناء، والتحقق من المجموعة، وإنشاء مسودة مملوكة بمفتاح إعادة محاولة ثابت.
4. رفع عمل فني حقيقي ومتناسق للسمات: 240 صورة مصدر على الأكثر بما فيها العمل الفني الفريد، و20 MiB لكل صورة مصدر في ملف ZIP، أو 2 MiB لكل رفع مضمّن منفرد. ويدعم التوليد بالطبقات 1,000 قطعة بما فيها القطع الفريدة. ويستخدم العمل الفني الجاهز kurv_finished_art_limits لمعرفة الحدود الحالية للويب والمزوّد.
5. فتح review_url بصفة المالك، وفحص العمل الفني وشروط البيع بدقة، ثم اختيار النشر والإطلاق صراحةً قبل أي رفع عام. والموافقة على توقيع المحفظة لتلك النسخة المنشورة غير القابلة للتغيير. فتح الرابط لا ينشر ولا يوقّع أبدًا؛ وأي تعديل لاحق على المسودة يحتاج إلى مراجعة جديدة. ويفتح studio_url المحرر فقط.

لأداة الربط 21 أداة، والمورد kurv://builder-guide، والموجّه build-kurv-collection. والعميل الذي يعرض من ذاكرته المؤقتة 11 أداة يحتاج إلى إعادة الربط أو تحديث الاكتشاف. يجهّز الوكيل المسودات؛ ويوافق المالك على النشر وتوقيع المحفظة. والرابط الذي يأتي من kurv_prepare_launch ليس نشرًا مؤكدًا.

تشرح صفحة ربط وكيل عبر MCP الأذونات، ومدخلات الأدوات بدقة، وسلوك إعادة المحاولة، وطرق العمل الفني والبيع المدعومة.

العرض والسكّ في مكان آخر

تعرض أداة عرض المجموعة العمل الفني الحقيقي أو صورته التشويقية العامة، وتحدّث أعداد السكّ المؤكدة. ويفتح زر سكّ فيها نافذة KURV لحساب المشتري وموافقة محفظته. ويعمل هذا الانتقال دون الاعتماد على ملفات تعريف الارتباط الخاصة بالحساب داخل iframe. وزر السكّ يفعل الأمر نفسه من أي صفحة ويُعلم تلك الصفحة عند اكتمال السكّ.

للسكّ مباشرةً داخل موقعك، يُستخدم عنوان عقد المجموعة و ABI العام مع أداة ربط المحفظة الخاصة بك. يُقرأ عرض سعر حديث، وتتم الموافقة على عملة المجموعة المطلوبة وأي عملة إضافية، ثم محاكاة السكّ وانتظار إيصال معاملته. وتعرض صفحة السكّ من موقعك الاستدعاء بدقة وكيف يتعامل مع المراحل العامة وحدود التكلفة ووحدات المزاد.

تحمل أرقام المجموعة طابعًا زمنيًا للقراءة. والرقم القديم لقطة سبق تأكيدها. وتبقى البيانات الخاصة وجذور العمل الفني للمجموعة غير المكشوفة محجوبة. وتنطبق قواعد العقد والرسوم وشروط المجموعة على كل تكامل؛ التفاصيل في الرسوم والمخاطر وإخلاء المسؤولية.