Getting started

Trang này giúp bạn kết nối tới launchpad và giải thích một nhúm khái niệm xuất hiện ở mọi nơi khác: launchpad contract, ABI, các role, và phí.

Kết nối tới launchpad

CheesePad là một contract trên mỗi chain. Pools, microsale, và Melt Pool đều là các luồng trên cùng contract đó, không phải các deployment riêng biệt, nên chỉ có một địa chỉ để cấu hình. Lấy địa chỉ cho network của bạn từ overview, và instantiate nó với 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 đến từ đâu

Tải nó về ở đây: Launchpad.json.

Launchpad là một diamond, nên các hàm và event của nó được trải ra trên khoảng 39 facet contract phía sau một địa chỉ duy nhất. File đó là tất cả chúng được làm phẳng thành một ABI: mọi hàm, event, và error được mô tả trong bộ docs này. Trỏ instance contract của bạn tới địa chỉ launchpad và dùng nó nguyên trạng.

Networks

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 nới lỏng một quy tắc: mức lock LP tối thiểu giảm xuống 5 phút để bạn có thể thử nghiệm việc unlock trong quá trình QA. Trên cả hai mainnet, mức sàn là 30 ngày cho một pool và 365 ngày cho một microsale. Lưu ý rằng Robinhood Chain là một mainnet, nên nó không nhận được sự nới lỏng của testnet. Mọi thứ khác đều hoạt động giống nhau trên cả ba network; xem bảng constant để biết các giá trị chính xác.

Ai có thể làm gì

Hầu hết các lệnh gọi đều permissionless. Những lệnh quản lý một sale cụ thể bị gate cho chủ sở hữu của sale đó:

• Bất kỳ ai. Tạo một sale, contribute, giao dịch một Melt Pool, claim, refund, và mọi hàm view đều mở cho bất kỳ địa chỉ nào.
• Chủ sở hữu sale. Địa chỉ đã tạo một sale cho trước. Nó có thể finalize, cancel, và chỉnh sửa thông tin của sale đó.
• Admin. Platform. Một vài bước xảy ra ở phía platform thay vì phía bạn: công bố các microsale template và Melt Pool config bạn launch dựa trên, và tính toán allocation của một Subscription pool. Những điều này được nêu ra ở nơi chúng xuất hiện; bạn không bao giờ cần quyền admin để launch hoặc tham gia.

Phí

Hai khoản phí quan trọng đối với một bên tích hợp.

Phí tạo. Tạo một sale có thể tốn một khoản phí native cố định, và hai kiểu launch đọc nó từ các trường khác nhau: pools dùng masterConfig.creationFee, microsale dùng masterConfig.microSaleCreationFee. Gửi nó dưới dạng msg.value trong lệnh create; nó được chuyển tới địa chỉ phí platform. Pools yêu cầu đúng số lượng, microsale yêu cầu ít nhất bằng nó. Đọc giá trị trước khi báo giá một chi phí:

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

Phí platform lúc finalize. Khi một sale finalize, một phần của khoản raise bị trừ ra ở đầu và gửi tới địa chỉ phí platform; phần còn lại được ghép cặp với token LP và thêm vào DEX. Microsale dùng mức 5% cố định. Pools dùng nativeFeePercent của platform. Dù cách nào, bạn không trả nó trực tiếp; nó được trừ ra khỏi khoản raise, đó là lý do phép tính listing được áp dụng lên số tiền sau phí.

Phí giao dịch Melt Pool. Mỗi giao dịch curve của Melt Pool trả một khoản phí 1% cố định, trừ ra ở đầu mỗi lệnh mua và bán. Nó áp dụng trong giai đoạn curve và dừng lại một khi pool graduate lên một DEX.

Phí platform cho tax-token. Một tax token (CheeseTaxTokenV2) thu thuế mua/bán của người tạo, và trên đó CheesePad thu thêm một khoản phí platform 10% trên creator tax đó — cả trong giai đoạn curve của một Melt Pool và sau khi listing. Mức được lưu on-chain; đọc nó bằng getPlatformCutBps() (trả về preBps, postBps — mức giai đoạn curve và mức sau listing, tính bằng BPS). Xem mô hình phí token để có bức tranh đầy đủ.

Một khoản phí nữa cần lưu ý: một lần emergency withdrawal (rời một sale đang chạy sớm) tốn của contributor 10% khoản contribute của họ.

Đọc platform config

getMasterConfig() trả về các cài đặt toàn platform. Các trường bạn có nhiều khả năng đọc nhất:

Trường	Ý nghĩa
feeTo	nơi phí platform và phí tạo đến
locker	LP locker được dùng khi một sale lock liquidity
microSaleCreationFee	phí native cố định để tạo một microsale (có thể là 0)
platformRole	địa chỉ backstop rescue khẩn cấp cho vault
giftRelayerSigner	signer chứng thực các identity bind của GiftVault

Struct đầy đủ nằm trong events-and-data.md.

Tiếp theo

Chọn kiểu launch của bạn: pools.md, microsale.md, hoặc melt-pool.md. Nếu bạn quan tâm tới nơi doanh thu của một tax token đến, xem vaults.md.