عند إنشاء توكن على سولانا، يخزن برنامج توكنات SPL الأساسي فقط الأرصدة والكسور العشرية. ولا يخزن اسم التوكن، أو الرمز، أو الوصف، أو الموقع الإلكتروني، أو صورة الشعار بشكل أصلي.
ولعرض بيانات التوكن عبر المحافظ (مثل Phantom وSolflare) وواجهات المنصات اللامركزية (مثل Raydium وDexScreener)، تستخدم سولانا معيار البيانات الوصفية من Metaplex.
ويضمن فهم كيفية ربط حسابات البيانات الوصفية على السلسلة بملفات JSON الخارجية عرض شعار التوكن وتفاصيله بشكل موثوق دون صور مكسورة.
حسابات المؤشرات على السلسلة مقابل البيانات الوصفية الخارجية
يقسم معيار Metaplex معلومات التوكن إلى طبقتين منفصلتين:
حساب مخصص مخزن مباشرة في ذاكرة مصدقي سولانا، مشتق من عنوان سك التوكن. ويخزن حقولاً نصية ثابتة:
- الاسم (Name): اسم التوكن (حتى 32 حرفاً).
- الرمز (Symbol): رمز التداول (حتى 10 أحرف).
- URI: رابط URL (حتى 200 حرف) يشير إلى ملف JSON الخارجي.
- سلطة التحديث (Update Authority): المفتاح العام المسموح له بتحديث البيانات.
2. ملف البيانات الوصفية JSON خارج السلسلة (Off-Chain)
ملف JSON منظم مستضاف على تخزين لا مركزي دائم (مثل Arweave أو IPFS). ويحتوي هذا الملف على تفاصيل المشروع الممتدة:
image: رابط مباشر لصورة الشعار بصيغة PNG أو JPEG أو SVG.description: ملخص تفصيلي للمشروع.external_url: رابط الموقع الرسمي.properties.files: مصفوفة أصول الوسائط وأنواع المحتوى.
وتتوفر المواصفات الرسمية في وثائق مطوري Metaplex.
الأسباب الشائعة لتعطل شعارات التوكنات
يلاحظ منشئو التوكنات غالبا أن شعار التوكن يظهر في محفظة Phantom ولكنه يفشل في التحميل على Solscan (أو العكس). ويحدث هذا بسبب أخطاء التنسيق:
- روابط الصور غير المباشرة: الربط بصفحة ويب تحتوي على صورة بدلاً من رابط صورة مباشر ينتهي بـ
.png أو .svg.
- قيود CORS: استضافة الصورة على خادم مركزي يحظر طلبات CORS من المحافظ والمنصات.
- أبعاد الصور غير المربعة: رفع صور غير مربعة. حيث تتوقع المحافظ أبعادا مربعة (مثل 512×512 بكسل).
- مزودو الاستضافة المؤقتة: رفع الصور على مواقع مؤقتة تحذف الملفات بعد 30 يوما.
معايير تنسيق البيانات الوصفية الموصى بها
لضمان العرض على جميع محافظ سولانا ومجمعات DEX، اتبع هذه الإرشادات:
- صيغة الصورة: PNG أو SVG (يفضل خلفية شفافة).
- الأبعاد: مربع 512×512 بكسل (حجم أقل من 1 ميجابايت).
- استضافة JSON: تخزين لا مركزي دائم (بوابة Arweave أو IPFS).
- استخدام HTTPS: يجب أن تستخدم جميع الروابط بروتوكولات آمنة
https:// أو ar://.
كيف يؤتمت PumpBolt إنشاء البيانات الوصفية
يتطلب إنشاء ملفات JSON وربطها يدويا إعداد محافظ Arweave وأدوات تطوير.
ويؤتمت منشئ توكنات سولانا من PumpBolt سير عمل البيانات الوصفية بالكامل في خطوة واحدة:
- ترفع صورة الشعار المربعة مباشرة في النموذج.
- يحسن PumpBolt الصورة ويرفعها إلى تخزين Arweave الدائم.
- ينشئ PumpBolt ملف JSON مطابقا لمعايير Metaplex.
- عند السك، يربط PumpBolt رابط Arweave بحساب البيانات الوصفية على السلسلة في المعاملة نفسها.
ويضمن اتباع معيار Metaplex واستخدام التخزين الدائم بقاء شعار التوكن الخاص بك ظاهرا وغير قابل للتعديل عبر كامل منظومة سولانا.