Toolbox
Mint Tokens
Last updated April 20, 2026
Summary
The mplx toolbox token mint command mints additional units of an existing SPL token to a recipient's wallet.
- Requires the current identity to hold mint authority for the specified mint.
- Creates the recipient's associated token account on the fly if it does not exist.
- Defaults the recipient to the current identity unless
--recipientis passed. - Amount is expressed in raw token units — divide by
10^decimalsfor display units.
Quick Reference
The table below summarizes the command's inputs and unit semantics.
| Item | Value |
|---|---|
| Command | mplx toolbox token mint <mint> <amount> |
| Required args | mint, amount (integer > 0) |
| Optional flag | --recipient <pubkey> |
| Amount unit | Raw token units (not display units) |
| Related | toolbox token create |
Basic Usage
Pass the mint address and the amount as positional arguments.
mplx toolbox token mint <mint> <amount>
Arguments
The command takes two positional arguments.
mint(required): Mint address of the token.amount(required): Number of tokens to mint. Must be greater than0.
Flags
Optional flag overrides the default recipient.
--recipient <pubkey>: Wallet that will receive the minted tokens. Defaults to the current identity.
Examples
These examples show minting to the current identity and to a specific recipient.
mplx toolbox token mint 7EYnhQoR9YM3c7UoaKRoA4q6YQ2Jx4VvQqKjB5x8XqWs 1000
mplx toolbox token mint 7EYnhQoR9YM3c7UoaKRoA4q6YQ2Jx4VvQqKjB5x8XqWs 1000 --recipient 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
Output
On success the command prints the mint address, recipient, minted amount, and transaction signature.
--------------------------------
Tokens minted successfully!
Mint Details:
Mint Address: <mint>
Recipient: <recipient>
Amount Minted: <amount>
Transaction Signature: <signature>
Explorer: <explorer_url>
--------------------------------
Notes
amountis expressed in raw token units. Divide by10^decimalsto express it in display units.- The recipient's associated token account is created on the fly if it doesn't exist.
- You must hold mint authority for the mint — otherwise the transaction will fail.
- Create a new token with
toolbox token create.
