Skip to content

internet-court/internet-court-skill / vendored/metaplex/metaplex

metaplex

Verified

Metaplex 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.

references/cli-troubleshooting.md

View on GitHub
# Metaplex CLI — Localnet Limitations & Troubleshooting

## Localnet Limitations

When running on localhost/localnet, several CLI features are unavailable or require workarounds:

- **Storage uploads (Irys) do not work on localhost.** Any command that uploads to Irys will fail.
- **Commands using `--image` without `--uri` will fail** because they attempt to upload to Irys under the hood. This affects `mplx toolbox token create`, `mplx core asset create --files`, and `mplx tm create --image`.
- **For localnet, always use `--uri`** with any URL (even a placeholder) for create commands: `mplx core asset create --name "Test" --uri "https://example.com/meta.json"`
- **For fungible tokens on localnet**, use the SPL Token CLI and then attach metadata:
  ```bash
  spl-token create-token
  # Note the mint address, then:
  mplx toolbox token add-metadata <MINT> --name <NAME> --symbol <SYM> --uri <URI>
  ```
- **`mplx core asset update` and `mplx tm update`** also require Irys if re-uploading metadata (e.g., updating `--image`). On localnet, only update fields that do not trigger an upload (e.g., `--name`, `--uri` with a pre-existing URL).
- **`mplx toolbox token mint` and `mplx toolbox token transfer`** may fail if the mpl-toolbox program is not deployed on your localnet. Use `spl-token mint` and `spl-token transfer` as fallbacks.

## Troubleshooting

| Error | Solution |
|-------|----------|
| `InvalidTokenStandard` | Check asset's actual token standard |
| `InvalidAuthority` | Verify update/mint authority matches signer |
| `CollectionNotVerified` | Call `verifyCollectionV1` (TM collections need verification) |
| `PluginNotFound` | Add plugin first or check type name spelling |
| `InsufficientFunds` | Fund wallet with more SOL |
| `Invalid data enum variant` | Check plugin JSON format (array, correct types) |
| Upload fails / timeout | Check `mplx toolbox storage balance`, fund if needed |

## 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 / setup: https://metaplex.com/docs/dev-tools/cli/installation
- RPCs: https://metaplex.com/docs/dev-tools/cli/config/rpcs
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall