Getting started

تُوصلك هذه الصفحة بالـ launchpad وتشرح حفنة المفاهيم التي تظهر في كل مكان آخر: عقد الـ launchpad، والـ ABI، والأدوار، والرسوم.

الاتصال بالـ launchpad

CheesePad هي عقد واحد لكل سلسلة. الـ pools والـ microsales وMelt Pools كلها مسارات على ذلك العقد نفسه، وليست عمليات نشر منفصلة، لذا هناك عنوان واحد لإعداده. خذ عنوان شبكتك من نظرة عامة، وأنشئ نسخة منه بـ Launchpad ABI.

import { ethers } from "ethers";
// https://docs.cheesepad.ai/abi/Launchpad.json
import LaunchpadABI from "./abi/Launchpad.json";

const provider = new ethers.JsonRpcProvider(RPC_URL);
const LAUNCHPAD = "0x0AA21d47b600B04527c09BbD9A30aF32cb64f6cF"; // bnbTestnet

// Read-only
const launchpad = new ethers.Contract(LAUNCHPAD, LaunchpadABI, provider);

// Write (attach a signer)
const signer = await provider.getSigner();
const launchpadRW = launchpad.connect(signer);

من أين يأتي الـ ABI

نزّله من هنا: Launchpad.json.

الـ launchpad هو diamond، لذا فإن دواله وأحداثه موزّعة عبر نحو 39 عقد facet خلف عنوان واحد. ذلك الملف هو جميعها مسطّحة في ABI واحد: كل دالة وحدث وخطأ موصوف في هذه الوثائق. وجّه نسخة عقدك إلى عنوان الـ launchpad واستخدمها كما هي.

الشبكات

Network	Chain ID	RPC	Explorer
BNB Chain	56	any BSC RPC	bscscan.com
BNB testnet	97	any BSC testnet RPC	testnet.bscscan.com
Robinhood Chain	4663	`https://rpc.mainnet.chain.robinhood.com/`	robinhoodchain.blockscout.com

يخفّف BNB testnet قاعدة واحدة: الحد الأدنى لقفل السيولة (LP) ينخفض إلى 5 دقائق حتى تتمكن من تجربة إلغاء القفل أثناء ضمان الجودة (QA). على كلتا الشبكتين الرئيسيتين يكون الحد الأدنى 30 يومًا للـ pool و365 يومًا للـ microsale. لاحظ أن Robinhood Chain شبكة رئيسية، لذا فهي لا تحصل على تخفيف الـ testnet. كل ما عدا ذلك يتصرف بالطريقة نفسها عبر الشبكات الثلاث؛ راجع جدول الثوابت للقيم الدقيقة.

من يمكنه فعل ماذا

معظم الاستدعاءات مفتوحة بلا إذن. الاستدعاءات التي تدير بيعًا محددًا مقيّدة بمالك ذلك البيع:

أي شخص. إنشاء بيع، والمساهمة، وتداول Melt Pool، والمطالبة، والاسترداد، وكل دوال العرض مفتوحة لأي عنوان.
مالك البيع. العنوان الذي أنشأ بيعًا معيّنًا. يمكنه إنهاء ذلك البيع وإلغاؤه وتعديل تفاصيله.
المسؤول. المنصة. تحدث بضع خطوات على جانب المنصة بدلًا من جانبك: نشر قوالب الـ microsale وإعدادات Melt Pool التي تطلق مقابلها، وحساب مخصصات pool من نوع Subscription. تُذكَر هذه حيث تظهر؛ ولن تحتاج أبدًا صلاحيات مسؤول للإطلاق أو المشاركة.

الرسوم

رسمان يهمّان المُكامِل.

رسوم الإنشاء. قد يكلّف إنشاء بيع رسمًا أصليًا ثابتًا، ويقرأه نمطا الإطلاق من حقلين مختلفين: الـ pools تستخدم masterConfig.creationFee، والـ microsales تستخدم masterConfig.microSaleCreationFee. أرسله كـ msg.value في استدعاء الإنشاء؛ ويُوجَّه إلى عنوان رسوم المنصة. الـ pools تتطلب المبلغ بالضبط، والـ microsales تتطلب على الأقل ذلك المبلغ. اقرأ القيمة قبل تسعير تكلفة:

const cfg = await launchpad.getMasterConfig();
const poolFee = cfg.creationFee;             // for pool launches
const microFee = cfg.microSaleCreationFee;   // for microsale launches

رسوم المنصة عند الإنهاء. عند إنهاء بيع، تُقتطع حصة من التمويل من الأعلى وتُرسَل إلى عنوان رسوم المنصة؛ ويُقرَن الباقي بتوكنات السيولة ويُضاف إلى DEX. الـ microsales تستخدم نسبة ثابتة قدرها 5%. الـ pools تستخدم nativeFeePercent الخاص بالمنصة. في كلتا الحالتين أنت لا تدفعها مباشرةً؛ فهي تُقتطع من التمويل، ولهذا تُطبَّق حسابات الإدراج على المبلغ بعد الرسوم.

رسم صفقة Melt Pool. كل صفقة على منحنى Melt Pool تدفع رسمًا ثابتًا بنسبة 1%، يُقتطع من أعلى كل عملية شراء وبيع. يُطبَّق أثناء مرحلة المنحنى ويتوقف بمجرد تخرج الـ pool إلى DEX.

رسوم المنصة على التوكن الضريبي. يجمع التوكن الضريبي (CheeseTaxTokenV2) ضريبة الشراء/البيع الخاصة بالمُنشئ، وفوقها تأخذ CheesePad رسوم منصة إضافية بنسبة 10% على ضريبة المُنشئ تلك — أثناء مرحلة منحنى Melt Pool وبعد الإدراج على حد سواء. المعدّل مخزّن on-chain؛ اقرأه بـ getPlatformCutBps() (تُرجع preBps، postBps — معدّلا مرحلة المنحنى وما بعد الإدراج بوحدة BPS). راجع نموذج رسوم التوكن للصورة الكاملة.

رسم آخر ينبغي الانتباه إليه: السحب الطارئ (مغادرة بيع حيّ مبكرًا) يكلّف المساهم 10% من مساهمته.

قراءة إعدادات المنصة

تُرجع getMasterConfig() الإعدادات على مستوى المنصة. الحقول التي من المرجّح أن تقرأها:

Field	Meaning
`feeTo`	أين تذهب رسوم المنصة ورسوم الإنشاء
`locker`	قافل السيولة المستخدم عندما يقفل بيعٌ السيولة
`microSaleCreationFee`	رسم أصلي ثابت لإنشاء microsale (قد يكون 0)
`platformRole`	عنوان دعامة الإنقاذ الطارئ الاحتياطية للـ vault
`giftRelayerSigner`	المُوقِّع الذي يشهد على روابط هوية GiftVault

البنية الكاملة موجودة في events-and-data.md.

اختر نمط إطلاقك: pools.md، أو microsale.md، أو melt-pool.md. إذا كنت تهتم بالمكان الذي تصل إليه إيرادات توكن ضريبي، راجع vaults.md.

الاتصال بالـ launchpad​

من أين يأتي الـ ABI​

الشبكات​

من يمكنه فعل ماذا​

الرسوم​

قراءة إعدادات المنصة​

التالي​