Programs
Fetch
Last updated August 27, 2026
What You'll Do
Read an MPL-Distro account from the terminal:
- Confirm the mint, Merkle root, claim window, and access mode
- See whether the distribution has not started, is active, or has ended
Summary
The mplx distro fetch command loads a distribution account and prints its configuration.
- Required argument: distribution public key
- Optional flag:
--jsonfor machine-readable output - Status:
Not Started,Active, orEndedfrom the local clock versusstartTime/endTime
Jump to: Quick Reference · Usage · Output · Notes
Quick Reference
| Item | Value |
|---|---|
| Command | mplx distro fetch <DISTRIBUTION> |
| Required argument | Distribution PDA as a base58 public key |
| Optional flags | --json |
Usage
Pass only the distribution address.
mplx distro fetch <DISTRIBUTION>
mplx distro fetch <DISTRIBUTION> --json
Output
Human-readable output lists identity, amounts, window, and root.
Distribution: <DISTRIBUTION>
Distribution Details:
Name: Community Airdrop
Authority: <WALLET>
Mint: <TOKEN_MINT>
Total Claimants: <n>
Tree Height: <n>
Distribution Type: Wallet | Legacy NFT
Allowed Distributor: Permissionless | Recipient | Permissioned
Total Amount: 1 tokens (1000000 basis)
Claim Amount: 0 tokens (0 basis)
Claim Count: <n>
Subsidize Receipts: true | false
Start Time: <ISO-8601>
End Time: <ISO-8601>
Status: Not Started | Active | Ended
Merkle Root: <base58>
Name is the UTF-8 string stored on-chain (trailing nulls stripped). Amounts use mint decimals when the mint can be fetched; otherwise they print as <n> basis. Allowed Distributor prints Permissioned when that mode is set on-chain, and fetch then also prints Permissioned Distributor. The CLI cannot create Permissioned distributions, so those fields appear only for SDK-created accounts.
Notes
Fetch is a read-only command. It does not change on-chain state.
- Status uses the local clock, not Solana cluster time.
- If the mint account cannot be fetched,
Total AmountandClaim Amountfall back to raw basis units. - Pass the PDA printed by
distro create. A malformed address fails withInvalidPublicKeyError.
