Metaplex

Genesis命令

创建 Genesis 账户

您将执行的操作

创建 Genesis 账户和代币 mint——这是任何代币发行的第一步：

  • 初始化一个管理整个发行的 Genesis PDA
  • 创建新的代币 mint（或关联现有的）
  • 配置代币名称、符号、小数位数和供应量

摘要

mplx genesis create 命令创建新的 Genesis 账户和代币 mint。这是任何代币发行的第一步。

  • 创建内容：一个 Genesis Account PDA 和一个代币 mint
  • 必需标志：--name、--symbol、--totalSupply
  • 默认小数位数：9（1 个代币 = 1,000,000,000 基本单位）

超出范围

Bucket 配置、存款/领取流程、代币元数据托管、流动性池设置。

跳转至： 基本用法 · 选项 · 示例 · 输出 · 常见错误 · 常见问题

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

基本用法

Create a Genesis account
mplx genesis create --name "My Token" --symbol "MTK" --totalSupply 1000000000000000 --decimals 9

选项

标志简写描述必需
--name <string>-n代币名称是
--symbol <string>-s代币符号是
--totalSupply <string>基本单位的总供应量是
--uri <string>-u代币元数据 JSON 的 URI否
--decimals <integer>-d小数位数（默认：9）否
--quoteMint <string>报价代币 mint 地址（默认：Wrapped SOL）否
--fundingMode <new-mint|transfer>创建新 mint 或使用现有的（默认：new-mint）否
--baseMint <string>基础代币 mint 地址（当 fundingMode 为 transfer 时必需）条件性
--genesisIndex <integer>同一 mint 上多次发行的 Genesis 索引（默认：0）否

示例

  1. 创建一个 9 位小数、总供应量 100 万的代币：
Basic creation
mplx genesis create \

  --name "My Token" \

  --symbol "MTK" \

  --totalSupply 1000000000000000 \

  --decimals 9
  1. 创建带元数据 URI 的代币：
With metadata URI
mplx genesis create \

  --name "My Token" \

  --symbol "MTK" \

  --totalSupply 1000000000000000 \

  --decimals 9 \

  --uri "https://example.com/metadata.json"
  1. 使用现有的代币 mint：
Existing mint
mplx genesis create \

  --name "Existing Token" \

  --symbol "EXT" \

  --totalSupply 1000000000000000 \

  --fundingMode transfer \

  --baseMint <EXISTING_MINT_ADDRESS>

输出

Expected output
--------------------------------

  Genesis Account: <genesis_address>

  Signature: <transaction_signature>

  Explorer: <explorer_url>

--------------------------------

保存 Genesis Account 地址——您将在后续每个命令中使用它。

常见错误

错误原因修复方法
Missing required flag未提供 --name、--symbol 或 --totalSupply添加所有三个必需标志
Invalid totalSupply非数字或零值提供基本单位的正整数
baseMint required--fundingMode transfer 但未提供 --baseMint使用 transfer 模式时添加 --baseMint <address>
Insufficient SOL没有足够的 SOL 支付交易费为钱包充入 SOL 用于支付费用

注意事项

  • totalSupply 以基本单位表示。对于 9 位小数，1000000000000000 = 1,000,000 个代币
  • 默认报价代币为 Wrapped SOL。使用 --quoteMint 指定不同的 SPL 代币
  • 使用 --fundingMode transfer 时，还必须提供 --baseMint 及现有的代币 mint 地址
  • 如果需要为同一代币 mint 创建多次 Genesis 发行，请使用 --genesisIndex

常见问题

mplx genesis create 做什么？ 它在 Solana 上创建一个新的 Genesis Account PDA 和代币 mint。这是任何 Genesis 代币发行的第一步——所有后续命令都会引用此步骤中的 Genesis 地址。

如何计算基本单位的 totalSupply？ 将所需的代币数量乘以 10 的小数位数次方。对于 100 万个带 9 位小数的代币：1,000,000 × 10^9 = 1,000,000,000,000,000。

可以使用现有的代币 mint 而不是创建新的吗？ 可以。设置 --fundingMode transfer 并使用 --baseMint 提供现有的 mint 地址。现有 mint 的权限必须可以转移给 Genesis 账户。

genesisIndex 是做什么用的？ 它允许为同一代币 mint 进行多次 Genesis 发行。每次发行需要一个唯一的索引。默认值为 0。

术语表

术语定义
Genesis Account管理代币发行的 PDA，由此命令创建
Base Units最小单位——对于 9 位小数，1 个代币 = 1,000,000,000 基本单位
Quote Mint存款期间接受的支付代币（默认：Wrapped SOL）
Genesis Index允许同一代币 mint 进行多次发行的数字索引
Next
发行池