概述

摘要

mplx genesis 命令允许您从终端运行完整的 Genesis 代币发行——创建账户、配置 bucket、存入、领取和撤销权限。

• 工具：Metaplex CLI (mplx) 的 genesis 命令组
• Bucket 类型：Launch Pool（按比例）、Presale（固定价格）、unlocked（国库）
• 报价代币（手动流程）：默认为 Wrapped SOL，支持任何 SPL 代币 mint 地址
• 报价代币（API 流程）：目前仅支持 SOL 或 USDC
• 不可逆操作：finalize 和 revoke 无法撤销

超出范围

Genesis 智能合约内部实现、SDK/TypeScript 集成、前端开发、代币经济设计、发行后流动性池设置。

跳转至： 前置条件 · 一般流程 · 命令参考 · 常见错误 · 常见问题 · 术语表

由 Metaplex Foundation 维护 · 最近验证于 2026 年 2 月 · 需要 Metaplex CLI (mplx)

前置条件

• 已安装 Metaplex CLI 并添加到 PATH
• Solana 密钥对文件（例如 ~/.config/solana/id.json）
• 用于交易费用的 SOL
• 通过 mplx config rpc add 配置的 RPC 端点，或使用 -r 参数传入

检查您的设置：

mplx genesis --help

一般流程

使用 Genesis CLI 发行代币有两种方式：

API 流程（推荐）

使用 genesis launch create 进行一体化流程，该命令调用 Genesis API、构建并签署交易，并在 Metaplex 平台上注册您的发行——全部在一个命令中完成。通过 API 创建的发行与 metaplex.com 兼容，并将在平台上显示公开的发行页面。

mplx genesis launch create \
  --name "My Token" --symbol "MTK" \
  --image "https://gateway.irys.xyz/abc123" \
  --tokenAllocation 500000000 \
  --depositStartTime 2025-03-01T00:00:00Z \
  --raiseGoal 200 --raydiumLiquidityBps 5000 \
  --fundsRecipient <WALLET_ADDRESS>

详情请参阅 Launch (API)。

手动流程

如需完全控制每个步骤：

1. 创建 — genesis create 设置 Genesis 账户和代币 mint。
2. 添加 Bucket — 添加一个或多个 bucket 来定义代币的分发方式。使用 bucket add-launch-pool 进行按比例分发，使用 bucket add-presale 进行固定价格销售，或使用 bucket add-unlocked 进行团队/国库分配。
3. Finalize — genesis finalize 锁定配置。此步骤后不能再添加 bucket。
4. 存入 — 用户在存款窗口期间使用 genesis deposit 或 genesis presale deposit 将报价代币（例如 Wrapped SOL）存入 bucket。
5. 提取（可选） — 用户可以在存款期间使用 genesis withdraw 从 Launch Pool 中提取。
6. 转换（可选） — 如果 Launch Pool 设置了 end behavior，在存款关闭后调用 genesis transition 将收集的代币转发到目标 bucket。
7. 领取 — 领取期开始后，用户使用 genesis claim 或 genesis presale claim 领取基础代币。国库钱包使用 genesis claim-unlocked。
8. 撤销（可选） — genesis revoke 永久撤销代币的 mint 和/或 freeze 权限。

如果您使用了手动流程并希望获得公开的发行页面，请使用 genesis launch register 在 Metaplex 平台上注册您的 Genesis 账户。

您可以随时使用 genesis fetch 和 genesis bucket fetch 检查发行状态。

命令参考

注意事项

• totalSupply 和 allocation 以基本单位表示——对于 9 位小数，1000000000000000 = 1,000,000 个代币
• 存款和提取金额以报价代币的基本单位表示（SOL 的 lamports，其中 1 SOL = 1,000,000,000 lamports）
• 如果使用 SOL 作为报价代币，请先使用 mplx toolbox sol wrap <amount> 包装
• Finalize 是不可逆的——在运行 genesis finalize 之前请仔细检查所有 bucket 配置
• 运行 mplx genesis <command> --help 查看任何命令的完整标志文档
• 请参阅 Genesis 文档 了解概念、生命周期详情和 SDK 指南

常见错误

常见问题

什么是 mplx genesis 命令？ mplx genesis 命令组允许您从终端运行完整的 Genesis 代币发行——创建账户、配置 bucket、存入、领取和撤销权限。

Genesis 中有哪些不同的 bucket 类型？ Genesis 有三种 bucket 类型：Launch Pool（基于存款的按比例分发）、Presale（固定价格代币销售）和 unlocked（团队/国库分配，可直接领取）。

存入前需要包装 SOL 吗？ 是的。如果使用 SOL 作为报价代币，请先使用 mplx toolbox sol wrap <amount> 包装，然后再存入任何 bucket。

可以撤销 finalize 操作吗？ 不可以。Finalize 是不可逆的。一旦 finalize，就不能再添加 bucket，配置将被锁定。在运行 genesis finalize 之前请仔细检查所有内容。

代币数量如何指定？ 所有数量均以基本单位表示。对于 9 位小数，1,000,000 个代币 = 1000000000000000 基本单位。存款金额使用报价代币的基本单位（SOL 的 lamports，其中 1 SOL = 1,000,000,000 lamports）。

同一类型可以有多个 bucket 吗？ 可以。使用 --bucketIndex 标志为同一类型的每个 bucket 指定不同的索引。

术语表