كيفية استخراج قائمة holders على Arc، سواء لأي token أو لمجموعة كاملة

قبل تنفيذ airdrop، أو إعداد allowlist، أو تقييد الوصول لمن هم بالداخل بالفعل، هناك سؤال يجب الإجابة عليه أولاً: من يملك token أو مجموعتك في هذه اللحظة. ولهذا من المفيد معرفة كيفية استخراج قائمة holders على Arc بحيث يمكنك تحميل ملف يضم جميع holders لأي token أو NFT.

سواء كان الأمر يتعلق بـ token أو بـ NFT، العملية هي نفسها. ما يجب أن يكون واضحًا لديك هو أي snapshot تحتاج إلى تنفيذه وما هي الطريقة الأبسط للاستفادة منه. في هذا الدليل سأشرح لك كيف يتم ذلك. لنبدأ مباشرة.

خطوات استخراج قائمة holders لأي token على Arc بالتفصيل

يقوم Token Snapshot من Smithii لشبكة Arc بالاستعلام on-chain مباشرة، دون الاعتماد على أي مُفهرِس خارجي ودون الحاجة إلى أن يكون token مُدرجًا في أي قائمة. يكفيه عنوان العقد فقط، لذلك يعمل مع أي ERC-20 على الشبكة، سواء كان لك أو لغيرك. هذه هي واجهته:

بعد الحصول على عنوان العقد، تبقى خمس خطوات:

1. اربط wallet بالشبكة. هذا ضروري لدفع الرسوم وحتى تتمكن الأداة من حفظ السجل الخاص بك.
2. ابقَ في تبويب Token Snapshot، وهو الذي يعمل مع ERC-20.
3. أدخل العقد: الصق العنوان أو ابحث عنه بالاسم. أسفل الحقل تجد اختصارات مباشرة لأكثر tokens نشاطًا على الشبكة.
4. اضغط Take Snapshot ووافق على الدفع. يظهر المبلغ فوق الزر مباشرة قبل أن توقّع.
5. انتظر حتى تنتهي عملية القراءة ثم حمّل ملف CSV مع العناوين.

كيفية استخراج قائمة holders لأي مجموعة على Arc دون كتابة أي كود

التبويب الثاني هو NFT Snapshot لمجموعات Arc، ويمكنك التبديل بينه وبين التبويب السابق من الأعلى. يطلب نفس البيانات: عنوان العقد، مع فارق أن الأمر هنا يتعلق بـ ERC-721. وبما أن ملكية NFT معلومة عامة، فإنه يعمل مع أي مجموعة موجودة على Arc. هكذا يبدو:

التسلسل لا يختلف كثيراً عن السابق:

1. اربط wallet الخاصة بك بـ Arc. بدونها لن تتمكن من دفع الرسوم ولا من تسجيل عملية الاستخراج.
2. انتقل إلى تبويب NFT Snapshot، وهو الثاني من الاثنين. الأول مخصص لـ ERC-20 ولا يتعرّف على المجموعات.
3. الصق عنوان contract الخاص بـ ERC-721 في حقل البحث، أو اكتب اسم المجموعة لاختيارها من القائمة.
4. اضغط Take Snapshot ووقّع على الدفع. المبلغ الإجمالي يظهر تحت الزر قبل أن تؤكد أي شيء.
5. نزّل ملف CSV بمجرد انتهاء القراءة. يبقى أيضاً مرتبطاً بـ wallet التي دفعت بها، في حال احتجت لاستعادته لاحقاً.

ماذا تعطيك كل قائمة

هنا يبدأ الاختلاف الحقيقي بين التبويبين. كلاهما يصدّر عناوين فقط لا غير، لكن المعيار الذي يُبنى عليه كل صف ليس واحداً، وهذا ما يحدد الغرض الذي سيخدمه الملف.

يستحق هذا التصفية في العمود الثاني الوقوف عندها، لأنها تفاجئ كثيرين. أي wallet تحتفظ بأربعين قطعة من المجموعة تحتل سطراً واحداً، تماماً مثل تلك التي تحتفظ بقطعة واحدة، ولا يوجد في الملف أي مؤشر يخبرك أياً منهما تنظر إليها.

بالنسبة لأي allowlist، هذا هو الشكل الصحيح: الهدف حجز مكان واحد لكل شخص، ومن جمع أربعين قطعة لا ينبغي أن يأخذ أربعين مقعداً. أما إن كنت تريد المكافأة بحسب حجم ما يملكه كل شخص فهذا حد لا يمكن تجاوزه، ونفس المنطق ينطبق على تبويب tokens، حيث لا توجد أرصدة يمكن الاعتماد عليها للتدرّج.

العقود تظهر بدون أي وسم في القائمتين

المالك، بحسب البلوكتشين، هو العنوان المسجّل باعتباره كذلك. وليس دائماً خلف هذا العنوان شخص يمكنك التواصل معه.

في قائمة أي ERC-20، تظهر liquidity pool كعنوان عادي ضمن العناوين الأخرى، ومعها أي smart contract يحتجز tokens. أما في قائمة مجموعة NFT، فالحالة الشائعة مختلفة: عندما تكون قطعة معروضة للبيع في سوق يحتفظ بها طوال فترة الإعلان، فإن المالك خلال هذه الفترة هو contract الحفظ نفسه. الأمر ذاته يحدث مع الخزائن (vaults) و staking والقروض التي تقبل NFTs كضمان. الشخص لا يزال هو من يدير العملية، لكن من يظهر في الملف هو العقد.

وبما أن أياً من التصديرين لا يشمل أي وسم، فإن هذه الصفوف يستحيل تمييزها بمجرد النظر. التحقق سهل ورخيص: ابحث عن العناوين غير المألوفة لديك في مستكشف Arc وانظر إن كان هناك code مرتبط بها. إن ظهر code، فهو contract. يستحق الأمر التحقق قبل التوزيع، لأن الإرسال إلى contract لا يعرف ما يفعله بما يستقبله لن يعيده أحد لك.

حدّد لحظة القطع قبل تشغيل عملية القراءة

الملف صورة للحظة معينة من حالة الشبكة لحظة إطلاق الاستخراج. لا يتحدّث نفسه تلقائياً: كل عملية نقل لاحقة تغيّر الواقع، لكن ملف CSV يظل كما هو.

هذا الأمر يكون أثره أكبر في مجموعة NFT مقارنةً بأي token، لأن NFTs لا تتنقل بين الأيدي بوتيرة ثابتة بل على شكل موجات. إعلان أو ارتفاع في السعر أو سوق ثانوي يعود للنشاط، كل ذلك يحرّك في ساعة ما لا يتحرّك في أسابيع هادئة، لذا فإن قراءتين تفصل بينهما ساعة قد لا تتطابقان في جزء ملحوظ من العناوين.

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

تكلفة إنشاء snapshot على Arc

62.5 USDC لكل عملية، تعرفة ثابتة ومتطابقة في التبويبين، بالإضافة إلى gas الخاص بالمعاملة. وبما أن Arc يتقاضى gas أيضاً بـ USDC، فإن كامل المصروف يتم بعملة واحدة دون أي تحويلات. إن كانت wallet ما زالت فارغة، عليك أولاً جلب USDC إلى الشبكة قبل تشغيل القراءة.

ثابتة تعني أن الحجم لا يدخل في الحساب: token فيه خمسون wallets يكلّف مثل واحد فيه عشرون ألفاً، ومجموعة من مئتي قطعة تكلّف مثل مجموعة من عشرة آلاف. النتيجة مزدوجة. في قاعدة كبيرة، يخرج كل عنوان بتكلفة زهيدة جداً، وهذا يقلب حدس من اعتاد على أدوات تحاسب على كل سجل. أما في مشروع صغير فيحدث العكس، لذا يُستحسن أن يكون لكل عملية استخراج هدف محدد سلفاً بدلاً من إطلاقها لمجرد الفضول.

ملاحظة على الميزانية قبل المتابعة: إذا كان الهدف الوحيد من القائمة توزيعاً فورياً، فإن multisender يستطيع استخراجها بنفسه بالتكلفة ذاتها فتوفّر عليك خطوة. أما استخراجها هنا بشكل منفصل فيصبح منطقياً حين تريد الملف للاحتفاظ به أو إعادة استخدامه أو مقارنته لاحقاً.

فوائد تصدير قائمة holders لأي token على Arc

غياب الأرصدة والأعداد يبدو نقصاً حتى تنظر إلى الاستخدام الفعلي للملف. هذه الحالات الثلاث لا تحتاج إلى أكثر من العنوان:

• توزيع متساوٍ يحصل فيه الجميع على الحصة ذاتها. يدخل ملف CSV مباشرة إلى الإرسال الجماعي للـ tokens على Arc دون أي إعادة تنسيق.
• allowlist لـ mint أو بيع مسبق أو وصول مبكر، حيث لا يهم سوى إن كان العنوان داخل القائمة أم خارجها.
• قياس تطور قاعدتك. قراءتان في وقتين مختلفين تكشفان لك كم عدد الداخلين، وكم عدد الخارجين، ومن بقي منذ البداية.

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

من باب الأمانة، لا بد من الإشارة إلى ما يبقى خارج الملف. لن تستطيع التوزيع على شرائح، ولا قياس تركّز الـ supply، ولا معرفة أي wallet يجمع نصف المجموعة. هذه الأسئلة الثلاثة يُجاب عنها في مستكشف الشبكة الذي يعرض الأرصدة ويسمح بفحص عنوان بعينه. snapshot يمنحك الاتساع، والمستكشف يمنحك التفاصيل.

الأسئلة الشائعة

كم يكلّف snapshot للـ holders على Arc؟

62.5 USDC لكل عملية استخراج، برسوم ثابتة، بالإضافة إلى gas fees الشبكة التي تُدفع أيضاً بـ USDC. السعر نفسه في تبويب الـ tokens وفي تبويب المجموعات، ولا يتغير بحسب عدد الـ holders ولا بحسب حجم السلسلة.

هل يتضمن ملف CSV الأرصدة أو عدد NFTs لكل wallet؟

لا، في كلتا الحالتين. تصدير ERC-20 يحتوي على عناوين دون رصيد ولا نسبة من الـ supply، وتصدير المجموعة لا يتضمن token IDs ولا عدد القطع لكل مالك. إذا كانت حملتك بحاجة إلى ترجيح المكافأة بحسب الحصة، فعليك جمع هذه البيانات من مصدر آخر قبل تصميمها.

هل يمكنني استخراج holders لـ token أو مجموعة ليست ملكي؟

نعم. المعلومات عن من يملك ماذا مفتوحة على blockchain، لذلك يكفي عنوان الـ smart contract ولا يُشترط أي ارتباط بالمشروع. هذه هي الطريقة المعتادة للوصول بتوزيع إلى مجتمع مشروع مشابه، أو لدراسة الحجم الحقيقي لقاعدة holders.

أي تبويب أحتاج، token أم NFT؟

التبويب الذي يناسب نوع العقد. إذا كان الأصل قابلاً للاستبدال ويملكه الناس بكميات، فهو ERC-20 ويوضع في Token Snapshot. أما إذا كانت كل وحدة مختلفة وتُملك قطعةً قطعة، فهو ERC-721 ويوضع في NFT Snapshot. وضع العقد في التبويب الخاطئ لا يعطي أي نتائج.

هل يصلح لتوزيع airdrop على holders؟

يصلح ما دام الجميع يستلمون الحصة ذاتها. بسطر واحد لكل عنوان، ينسجم الملف دون تعديل مع multisender الخاص بالشبكة. ما لا يسمح به هو تدرّج الحصص بحسب ما يملكه كل شخص، لأن هذا الرقم لا ينتقل في ملف CSV.

هل يمكنني استرجاع snapshot قديم؟

نعم، تحتفظ الأداة بسجل لعمليات الاستخراج مرتبط بـ wallet، فبمجرد ربطها ترى مرة أخرى ما أنجزته. ومع ذلك يفضّل حفظ كل ملف CSV بنفسك، خاصة إذا كنت تنوي مقارنة قائمتين في وقتين مختلفين.

الخلاصة

الآن وقد عرفت كيفية إجراء snapshot على Arc للـ tokens ومجموعات NFT، لا يبقى سوى تقرير ما ستفعله بهذه القائمة. إذا كنت تراقب wallets مشروعك، فستفيدك هذه المعلومات لمعرفة ما إذا كان عدد holders قد تغيّر أو ازداد، أو لتنفيذ airdrop للمكافآت داخل مجتمعك.

مع هذا التصور الواقعي، يغطي الملف ما يُطلب منه فعلياً في معظم الحالات: تصفية وصول، أو بناء allowlist، أو تغذية توزيع متساوٍ للجميع. حدّد نقطة القطع، ونفّذ القراءة، وراجع القائمة قبل استخدامها في أي توقيع.

Jose Araujo

صانع محتوى ومساهم SEO في Smithii. طالب هندسة أنظمة وعاشق لـ crypto والتكنولوجيا.