Metaplex

Genesis命令

Presale

您将执行的操作

从 CLI 运行完整的 Presale 生命周期：

  • 添加带固定价格代币分配的 Presale bucket
  • 在销售窗口期间存入报价代币
  • 按预定价格领取基础代币

摘要

Presale 以由 quoteCap / allocation 决定的固定价格出售代币。本页涵盖完整的 Presale 生命周期——从创建 bucket 到领取代币。

  • 分发方式：固定价格——quoteCap / allocation 决定每个代币的成本
  • 命令：bucket add-presale、presale deposit、presale claim
  • 价格示例：100 SOL 报价上限 / 1,000,000 代币 = 每个代币 0.0001 SOL
  • 报价代币：默认为 Wrapped SOL——存入前请先包装 SOL

超出范围

Launch Pool bucket、unlocked bucket、end behavior、Genesis 账户创建、finalize、前端集成。

跳转至： 添加 Bucket · 存入 · 领取 · 完整生命周期 · 常见错误 · 常见问题

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

添加 Presale Bucket

mplx genesis bucket add-presale 命令向 Genesis 账户添加一个 Presale bucket。

Add a presale bucket
mplx genesis bucket add-presale <GENESIS_ADDRESS> \

  --allocation 1000000000000000 \

  --quoteCap 100000000000 \

  --bucketIndex 0 \

  --depositStart 1704067200 \

  --depositEnd 1704153600 \

  --claimStart 1704153601 \

  --claimEnd 1735689600

选项

标志简写描述必需
--allocation <string>-a基本单位的基础代币分配额是
--quoteCap <string>接受的报价代币总额——决定价格是
--bucketIndex <integer>-bBucket 索引是
--depositStart <string>存款开始的 Unix 时间戳是
--depositEnd <string>存款关闭的 Unix 时间戳是
--claimStart <string>领取开始的 Unix 时间戳是
--claimEnd <string>领取关闭的 Unix 时间戳（默认为遥远的未来）否
--minimumDeposit <string>每笔交易的最低存款额（报价代币基本单位）否
--depositLimit <string>每用户最大存款额（报价代币基本单位）否

定价

价格计算公式：

Price formula
price per token = quoteCap / allocation

示例：100 SOL 报价上限（100000000000 lamports）/ 1,000,000 代币（1000000000000000 基本单位）= 每个代币 0.0001 SOL

存入

mplx genesis presale deposit 命令在存款窗口期间将报价代币存入 Presale bucket。

Deposit into presale
mplx genesis presale deposit <GENESIS_ADDRESS> --amount 10000000000 --bucketIndex 0

选项

标志简写描述必需
--amount <string>-a基本单位的报价代币金额（例如 lamports）是
--bucketIndex <integer>-bPresale bucket 的索引（默认：0）否

示例

  1. 包装 SOL 并存入 10 SOL：
Wrap and deposit
mplx toolbox sol wrap 10

mplx genesis presale deposit <GENESIS_ADDRESS> --amount 10000000000 --bucketIndex 0

领取

mplx genesis presale claim 命令在领取期开始后从 Presale bucket 领取基础代币。

代币分配计算方式：

Claim formula
userTokens = (userDeposit / quoteCap) * allocation
Claim from presale
mplx genesis presale claim <GENESIS_ADDRESS> --bucketIndex 0

选项

标志简写描述必需
--bucketIndex <integer>-bPresale bucket 的索引（默认：0）否
--recipient <string>领取代币的接收地址（默认：签名者）否

示例

  1. 领取到自己的钱包：
Claim to self
mplx genesis presale claim <GENESIS_ADDRESS> --bucketIndex 0
  1. 领取到其他钱包：
Claim to another wallet
mplx genesis presale claim <GENESIS_ADDRESS> --bucketIndex 0 --recipient <WALLET_ADDRESS>

完整生命周期示例

Complete presale lifecycle
# 1. Create the token

mplx genesis create \

  --name "Example Token" \

  --symbol "EXM" \

  --totalSupply 1000000000000000 \

  --decimals 9



GENESIS=<GENESIS_ADDRESS>



# 2. Timestamps

NOW=$(date +%s)

DEPOSIT_END=$((NOW + 86400))

CLAIM_START=$((DEPOSIT_END + 1))

CLAIM_END=$((NOW + 31536000))



# 3. Add presale bucket: 1M tokens at 100 SOL cap

mplx genesis bucket add-presale $GENESIS \

  --allocation 1000000000000000 \

  --quoteCap 100000000000 \

  --bucketIndex 0 \

  --depositStart $NOW \

  --depositEnd $DEPOSIT_END \

  --claimStart $CLAIM_START \

  --claimEnd $CLAIM_END



# 4. Add unlocked bucket for team to receive SOL

mplx genesis bucket add-unlocked $GENESIS \

  --recipient $(solana address) \

  --claimStart $CLAIM_START \

  --allocation 0



# 5. Finalize

mplx genesis finalize $GENESIS



# 6. Verify

mplx genesis fetch $GENESIS

mplx genesis bucket fetch $GENESIS --bucketIndex 0 --type presale



# 7. Wrap SOL and deposit

mplx toolbox sol wrap 1

mplx genesis presale deposit $GENESIS --amount 1000000000 --bucketIndex 0



# 8. After deposit period, claim

mplx genesis presale claim $GENESIS --bucketIndex 0

常见错误

错误原因修复方法
Deposit period not active当前时间在 depositStart–depositEnd 之外使用 genesis bucket fetch --type presale 检查时间戳
Claim period not active在 claimStart 之前领取等待领取开始时间戳之后
Presale full总存款已达到 quoteCapPresale 已满额认购——不再接受存款
No wrapped SOL存入原生 SOL 而不是 Wrapped SOL先运行 mplx toolbox sol wrap <amount>
Below minimum deposit存款金额低于 minimumDeposit增加存款金额以满足最低要求
Exceeds deposit limit用户总存款超过 depositLimit减少存款金额——您已达到每用户上限
Nothing to claim用户在此 Presale bucket 中没有存款验证正确的 --bucketIndex 并确认您在窗口期间进行了存款

常见问题

Presale 价格如何确定？ 价格计算方式为 quoteCap / allocation。例如，100 SOL 报价上限和 1,000,000 代币分配 = 每个代币 0.0001 SOL。

如果 Presale 没有完全售罄会怎样？ 已存入的用户仍然按固定价格获得代币。未售出的代币保留在 bucket 中。

可以在 Presale 上设置存款限制吗？ 可以。使用 --minimumDeposit 设置每笔交易最低额度，使用 --depositLimit 设置每用户最大额度。

如何计算我从 Presale 中的代币分配？ 您的代币 = (您的存款 / quoteCap) * allocation。如果您向 100 SOL 上限、100 万代币分配的池中存入 1 SOL，您将获得 10,000 个代币。

Presale 和 Launch Pool 有什么区别？ Presale 有由 quoteCap / allocation 设定的固定价格。Launch Pool 有动态价格——代币根据每个用户在总存款中的份额按比例分发。

术语表

术语定义
Presale以由 quoteCap / allocation 决定的固定价格出售代币的 bucket 类型
Quote CapPresale 接受的最大报价代币总额——与 allocation 一起决定代币价格
Allocation此 Presale bucket 中可用的基础代币数量，以基本单位表示
Deposit Limit单个用户可以存入的最大报价代币数量
Minimum Deposit每笔存款交易的最低报价代币数量
Fixed Price每个代币的成本，计算方式为 quoteCap / allocation——不随需求变化
Next
管理