البدء السريع: إنشاء رمز مميز باستخدام واجهة سطر الأوامر

يستعرض هذا الدليل السريع دورة حياة الرمز المميز الكاملة باستخدام واجهة سطر الأوامر spl-token. ستقوم بإنشاء mint account، وإنشاء حساب يمكنه الاحتفاظ بالرمز المميز، وسك 100 رمز مميز، ونقل بعضها إلى محفظة أخرى.

استخدم سولانا Playground لتشغيل الأوامر في متصفحك، أو ثبّت واجهة سطر الأوامر محلياً باستخدام cargo install spl-token-cli. ستختلف العناوين في مخرجاتك عن الأمثلة الواردة أدناه.

1. الاتصال بـ devnet

أنشئ محفظة أو اتصل بمحفظة موجودة في سولانا Playground، ثم اختر devnet واطلب SOL لإيداعات الحسابات ورسوم المعاملات:

Terminal

$ solana config set --url devnet
$ solana airdrop 2

استخدم رموز devnet للاختبار فقط. ليس لها أي قيمة مالية.

2. إنشاء رمز مميز

أنشئ mint account الذي يُعرّف رمزك المميز:

Terminal

$ spl-token create-token

انسخ عنوان الرمز المميز من المخرجات. هذا هو عنوان mint الذي ستستخدمه في الأوامر المتبقية. يبدأ كل mint جديد بإمداد صفري.

Terminal

$ spl-token supply <MINT_ADDRESS>

3. إنشاء token account

تحتاج محفظتك إلى token account لهذا الـ mint قبل أن تتمكن من الاحتفاظ برصيد:

Terminal

$ spl-token create-account <MINT_ADDRESS>

يؤدي هذا إلى إنشاء associated token account الخاص بك، الذي يُشتق عنوانه من محفظتك والـ mint.

4. سك الرموز المميزة

اسك 100 رمز مميز في associated token account الخاص بك:

Terminal

$ spl-token mint <MINT_ADDRESS> 100
$ spl-token balance <MINT_ADDRESS>

يجب أن توقّع سلطة الـ mint على هذه العملية. يزيد السك من رصيد token account الخاص بك ومن إجمالي الإمداد المسجّل في الـ mint.

5. نقل الرموز المميزة

أرسل 10 رموز مميزة إلى محفظة devnet أخرى. يقوم الخيار --fund-recipient بإنشاء associated token account الخاص بالمستلم إذا لم يكن موجوداً:

Terminal

$ spl-token transfer <MINT_ADDRESS> 10 <RECIPIENT_WALLET_ADDRESS> --fund-recipient

يُغيّر النقل الأرصدة في token account الخاص بالمرسل والمستلم؛ ولا يُغيّر إجمالي إمداد الـ mint.

اختياري: إضافة بيانات وصفية لـ Token-2022

لتخزين اسم ورمز وURI مباشرةً على mint جديد من نوع Token-2022، أنشئه مع تمكين امتداد البيانات الوصفية:

Terminal

$ spl-token create-token \
  --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb \
  --enable-metadata

ثم استخدم عنوان الـ mint الجديد الذي طبعه ذلك الأمر:

Terminal

$ spl-token initialize-metadata \
  <MINT_ADDRESS> \
  "Example Token" \
  "EXAMPLE" \
  "https://example.com/token.json"

يجب أن يُعيد الـ URI مستند بيانات وصفية JSON عاماً. راجع بيانات Token-2022 الوصفية للاطلاع على نموذج الحساب وأمثلة الكود.

إلى أين تتجه بعد ذلك

أساسيات الرموز المميزة - تنفيذ العمليات ذاتها بـ TypeScript أو Rust
Token Extensions - إضافة رسوم النقل والبيانات الوصفية والإيقاف المؤقت وميزات Token-2022 الأخرى
إصدار الأصول والترميز - تصميم الأصول المرمّزة للإنتاج وتشغيلها

جدول المحتويات