程序
存入
Last updated August 27, 2026
你将完成的操作
将 SPL 代币从钱包转入 MPL-Distro 金库：
- 使用人类可读数量或原始最小单位存入
- 确认分发上的新
totalAmount
摘要
mplx distro deposit 命令将代币从当前 identity 的 associated token account 转入分发金库。
- 必需参数：分发公钥
- 必需标志：
--amount或--basisAmount（互斥） - 存款不受时间限制：领取窗口不必处于活动状态
identity 必须持有足够代币。命令会获取 mint decimals 以转换 --amount。
跳转至： 基本用法 · 选项 · 示例 · 输出 · 常见错误 · 常见问题
基本用法
传入分发地址和一个数量标志。
存入 1.0 代币
mplx distro deposit <DISTRIBUTION> --amount 1.0
存入 1,000,000 最小单位
mplx distro deposit <DISTRIBUTION> --basisAmount 1000000
选项
必须恰好设置 --amount 或 --basisAmount 之一。
| 标志 | 简写 | 说明 | 必需 |
|---|---|---|---|
--amount <number> | -a | 使用 mint decimals 的人类可读数量 | 二者之一 |
--basisAmount <integer> | -b | 代币最小单位数量 | 二者之一 |
对于 6 位小数的 mint，--amount 1.0 与 --basisAmount 1000000 存入相同数量。
示例
在 distro create 之后存入：
为新分发注资
mplx distro deposit <DISTRIBUTION> --amount 1.0
输出
成功时，命令打印小数和最小单位数量。
预期输出
Deposited 1 tokens (1000000 basis) to distribution
Distribution: <DISTRIBUTION>
Mint: <TOKEN_MINT>
Amount deposited: 1 tokens (1000000 basis)
New total deposited: 1 tokens (1000000 basis)
Transaction: <SIGNATURE>
用此输出查看带 decimals 的总额。在可以获取 mint 时，distro fetch 会打印相同的代币数量。
常见错误
这些失败发生在无法为金库注资时。
| 错误 | 原因 | 解决方法 |
|---|---|---|
Either --amount or --basisAmount must be provided | 未设置任一数量标志 | 传入两个标志之一 |
| Insufficient balance | identity ATA 代币少于请求数量 | 先铸造或转入代币 |
| You do not have a token account for this mint | 没有此 mint 的 ATA | 先接收或铸造该代币 |
InvalidPublicKeyError | 分发参数不是 base58 公钥 | 传入 distro create 打印的 PDA |
| Distribution not found | PDA 或集群错误 | 在同一 RPC 上运行 distro fetch |
注意事项
deposit 不会检查金库是否覆盖 Merkle 分配总和。
- 在领取开始前至少存入树中每个
amount的总和。见 注资与回收。 - 存款在领取窗口之前、期间和之后都允许。
- 用
toolbox token create创建代币 mint，用toolbox token mint增加供应（mint数量为原始最小单位）。
常见问题
存入是否必须在领取窗口处于活动状态时进行？ 不必。存款在领取窗口之前、期间和之后都允许。
--amount 和 --basisAmount 有什么区别？ --amount 是使用 mint decimals 的小数（1.0 为一枚代币）。--basisAmount 是原始最小单位（decimals 为 6 时 1000000 为一枚代币）。