internet-court/internet-court-skill / vendored/metaplex/metaplex
metaplex
VerifiedMetaplex development on Solana — NFTs, tokens, compressed NFTs, candy machines, token launches, autonomous agents. Use when working with Token Metadata, Core, Bubblegum, Candy Machine, Genesis, Agent Registry, or the mplx CLI.
| File | Kind | Size |
|---|---|---|
| LICENSE | other | 1.6 KB |
| SKILL.md | skill md | 9.7 KB |
| references/cli-agent.md | markdown | 8.8 KB |
| references/cli-bubblegum.md | markdown | 5.8 KB |
| references/cli-candy-machine.md | markdown | 10.2 KB |
| references/cli-config.md | markdown | 1.5 KB |
| references/cli-core.md | markdown | 8.9 KB |
| references/cli-genesis.md | markdown | 24.6 KB |
| references/cli-initial-setup.md | markdown | 2.7 KB |
| references/cli-token-metadata.md | markdown | 3.3 KB |
| references/cli-toolbox.md | markdown | 4.3 KB |
| references/cli-troubleshooting.md | markdown | 2.2 KB |
| references/cli.md | markdown | 5.4 KB |
| references/concepts.md | markdown | 12.0 KB |
| references/metadata-json.md | markdown | 1.8 KB |
| references/sdk-agent.md | markdown | 21.7 KB |
| references/sdk-bubblegum.md | markdown | 11.3 KB |
| references/sdk-core.md | markdown | 20.5 KB |
| references/sdk-genesis-low-level.md | markdown | 21.7 KB |
| references/sdk-genesis.md | markdown | 24.4 KB |
| references/sdk-token-metadata-kit.md | markdown | 8.4 KB |
| references/sdk-token-metadata.md | markdown | 13.7 KB |
| references/sdk-umi.md | markdown | 6.1 KB |
references/cli.md
View on GitHub# Metaplex CLI Reference
## Installation
```bash
npm install -g @metaplex-foundation/cli
```
## Command Discovery
```bash
mplx --help # List all topics
mplx <topic> --help # e.g., mplx core --help
mplx <topic> <cmd> --help # e.g., mplx core asset create --help
```
Topics: `config`, `toolbox`, `core`, `tm`, `cm`, `bg`, `agents`, `genesis`
---
## Quick Command Index
| Topic | Detail File |
|-------|-------------|
| Initial Setup | `./cli-initial-setup.md` |
| Core Assets/Collections | `./cli-core.md` |
| Token Metadata NFTs/pNFTs | `./cli-token-metadata.md` |
| Bubblegum (compressed NFTs) | `./cli-bubblegum.md` |
| Candy Machine (NFT drops) | `./cli-candy-machine.md` |
| Genesis (Token Launches) | `./cli-genesis.md` |
| Agent Registry (Identity, Delegation) | `./cli-agent.md` |
| Config & RPC Management | `./cli-config.md` |
| Toolbox (Storage, SOL, Tokens) | `./cli-toolbox.md` |
| Localnet & Troubleshooting | `./cli-troubleshooting.md` |
---
## JSON Output (Agent Use)
All commands support `--json` for structured machine-readable output:
```bash
mplx core asset create --name "My NFT" --uri "https://..." --json
mplx genesis launch create --name "My Token" ... --json
mplx toolbox sol balance --json
```
Returns a JSON object instead of formatted text. Use this when running the CLI programmatically or from an agent — the output shape is consistent and parseable.
> **Note**: `--offchain <file>` is the flag for passing a local offchain metadata JSON file to upload. This is separate from `--json` (which controls output format).
---
## Wizard Mode
Several commands support `--wizard` for interactive guided creation:
| Command | Wizard |
|---------|--------|
| `mplx toolbox token create --wizard` | Token name, symbol, decimals, image, mint amount |
| `mplx tm create --wizard` | NFT type, metadata, collection, royalties |
| `mplx bg tree create --wizard` | Tree depth, buffer size, canopy |
| `mplx bg nft create --wizard` | cNFT metadata, tree selection, collection |
| `mplx cm create --wizard` | Full candy machine setup, upload, and insert |
Wizards are recommended for first-time operations or when unsure about required parameters.
> **Agent note**: Wizards are interactive (require user input at prompts). When running programmatically or as an agent, prefer explicit flags instead of `--wizard`.
---
## Local Files Workflow (`--files`)
Some commands can upload files and create assets in one step, as an alternative to manual upload -> create:
```bash
# Core asset from local files (uploads image + JSON, then creates)
# Prepare metadata.json first — follow the NFT schema in metadata-json.md
mplx core asset create --files --image ./image.png --offchain ./metadata.json
# TM NFT from local files (no --files flag needed for tm)
mplx tm create --image ./image.png --offchain ./metadata.json
# Fungible token always uses local image (no --files flag needed)
mplx toolbox token create --name "My Token" --symbol "MTK" --decimals 9 --image ./image.png
```
If `--files` fails (e.g., upload timeout), fall back to the manual workflow:
1. `mplx toolbox storage upload <PATH>` to upload separately
2. Then create with `--uri` pointing to the uploaded URI
---
## Batching Principle
> **CRITICAL**: Always chain commands with `&&` to minimize user approvals. One approval per logical step.
```bash
# Setup checks - ONE command
mplx config get rpcUrl && mplx config get keypair && mplx toolbox sol balance
# File creation - ONE command (each file must follow the NFT JSON schema — see metadata-json.md)
# Create one .json file per NFT with the correct schema before running uploads
# Uploads - use --directory for folders
mplx toolbox storage upload ./assets --directory
# Multiple asset creates - ONE command
mplx core asset create --name "NFT #1" --uri "<URI_1>" --collection <ADDR> && \
mplx core asset create --name "NFT #2" --uri "<URI_2>" --collection <ADDR> && \
mplx core asset create --name "NFT #3" --uri "<URI_3>" --collection <ADDR>
```
**NEVER** run multiple uploads or creates as separate commands - that requires one approval per command.
---
## Explorer Links
```
# Core assets/collections
https://core.metaplex.com/explorer/<ADDRESS>?env=devnet # Devnet
https://core.metaplex.com/explorer/<ADDRESS> # Mainnet
# Token Metadata NFTs / Tokens
https://explorer.solana.com/address/<MINT_ADDRESS>?cluster=devnet # Devnet
https://explorer.solana.com/address/<MINT_ADDRESS> # Mainnet
# Transactions
https://explorer.solana.com/tx/<SIGNATURE>?cluster=devnet # Devnet
https://explorer.solana.com/tx/<SIGNATURE> # Mainnet
```
> **IMPORTANT**: Always add `?env=devnet` or `?cluster=devnet` when on devnet.
> **Localnet note**: The CLI generates devnet explorer links even when connected to localhost. For localnet, use Solana Explorer with a custom cluster URL: `https://explorer.solana.com/address/<ADDRESS>?cluster=custom&customUrl=http://localhost:8899`
## For more info
Consult these Metaplex docs when you need deeper detail than this reference provides:
- CLI overview: https://metaplex.com/docs/dev-tools/cli
- Installation: https://metaplex.com/docs/dev-tools/cli/installation
- Core CLI: https://metaplex.com/docs/dev-tools/cli/core/create-asset
- Agents CLI: https://metaplex.com/docs/dev-tools/cli/agents
- Genesis CLI: https://metaplex.com/docs/dev-tools/cli/genesis
- Bubblegum CLI: https://metaplex.com/docs/dev-tools/cli/bubblegum
- Candy Machine CLI: https://metaplex.com/docs/dev-tools/cli/cm
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Unverified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |