Master Metaboss CLI on Solana: Full Guide.

Okay, here's your first power move with Metaboss. Once everything's set up, you can spit out a full SPL token with metadata in literally one command: metaboss create token -m your metadata.json. Why does this rock? Because old school ways need like 5 steps just to slap on a name and image. Metaboss bundles it all-token mint, metadata upload-bam, done. Costs you around 0.01 SOL total on mainnet. I've burned hours skipping the spl token CLI dance this way.

But hold up. You gotta prep that JSON first. More on that soon. Sound familiar if you've fumbled with Raydium pools before?

Get Your Machine Ready - No BS Install

Look, installing Solana CLI and Metaboss ain't rocket science, but people trip on PATH exports every time. I usually just copy paste these and restart my terminal. Twice.

First, Solana tools. On Mac/Linux, smash this:

  1. sh -c "$(curl -sSfL https://release.solana.com/stable/install)"
  2. It spits out an export PATH line. Paste it. Like: export PATH="/home/yourname/.local/share/solana/install/active_release/bin:$PATH"
  3. Close terminal. Reopen. Check: solana --version. Should show something like 1.18.x.

Windows? Use WSL or the admin cmd trick from Solana docs. Trust me, WSL saves headaches.

Now Rust, cuz Metaboss is a Cargo crate. curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh. Hit enter for defaults. Restart terminal again. Annoying? Yeah. Necessary? Totally.

Extra deps if you're on Ubuntu/Debian: sudo apt install libudev dev llvm libclang dev libssl dev pkg config build essential protobuf compiler -y. Skip this, compiles fail. In my experience, that's 90% of "why won't Metaboss build?" errors.

Grab SPL Token CLI Too (Optional but Handy)

While you're at it, cargo install spl token cli. Takes 5 mins. Lets you do token stuff without Metaboss sometimes, like burning authorities later.

Wallet Setup - Don't Use Your Main One Yet

So, new wallet time. solana keygen new --derivation path "m/44'/501'/0'/0'" --force --no bip39-passphrase. Outputs your keypair at ~/.config/solana/id.json. Fund it with like 0.5 SOL from Phantom or exchange. Why separate? Dev wallets get rekt testing.

What's next? Set RPC. Devnet for practice: solana config set --url https://api.devnet.solana.com. Mainnet: solana config set --url https://api.mainnet beta.solana.com. Check config: solana config get.

Pro tip: Airdrop on devnet cuz free. solana airdrop 2. Repeat if needed. Mainnet? Buy SOL, fees are ~0.000005 SOL per tx. Peanuts.

Install Metaboss - The Star of the Show

This is it. cargo install metaboss. Brews for 10-20 mins first time. Patience. Verify: metaboss --version.

Why Metaboss over spl token? It's the Swiss Army knife for Metaplex stuff. Decode mints, update metadata, even freeze authorities. SPL token is basic; Metaboss handles NFTs/tokens like a boss. Honestly, once installed, you'll use it daily.

Prep Metadata - Arweave or Bust

Tokens need bling: name, symbol, image. But on chain metadata points to off chain JSON on IPFS/Arweave. I use Arweave cuz permanent, cheap (~0.01 SOL per upload via bundlr or akord.com).

First, upload image. Grab your PNG/JPG (under 100KB). Go to arweave.app or akord.com, upload, copy HTTPS URL. Say https://arweave.net/abc123.

Now, full metadata JSON. Create metadata.json:

{ "name": "YourTokenName", "symbol": "YTKN", "description": "Dope token desc here.", "image": "https://arweave.net/abc123"
}

Extensions? Add this for socials:

"extensions": { "website": "https://your.site", "twitter": "@yourhandle", "telegram": "t.me/yourgroup"
}

Upload this JSON to Arweave too. Copy its URL: https://arweave.net/def456.

Now the mint pointer JSON (super simple):

{ "name": "YourTokenName", "symbol": "YTKN", "uri": "https://arweave.net/def456"
}

Save as token metadata.json. That's your ammo.

Create Token + Metadata in One Go

Ready? From your working dir:

  1. metaboss create token -m token metadata.json

Mints a 9-decimal token (change with --decimals 6 if needed), sets metadata. Grabs your keypair from Solana config. Output: mint address like 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU.

Cost? ~0.01-0.02 SOL. Check on solscan.io/mint/[address]. Metadata shows up in 30s. Wallets like Phantom pull it fast.

Issues? "Account not found"? Wrong RPC or unfunded wallet. "Signature failed"? Low SOL, top up 0.1 more.

Update Metadata - Easy Peasy

Screwed up the desc? No freeze.

  • Update URI only: metaboss update uri --account [MINT_ADDRESS] --new uri https://arweave.net/newjson
  • Full update: Edit JSON, reupload, then metaboss update metadata -a [MINT_ADDRESS] -m new metadata.json

Takes 1 tx, ~0.000005 SOL. Why bother? Listings on Dexscreener/Jupiter need fresh metadata or they ghost you.

Burn Authorities - Build Trust, Kill FUD

Buyers hate revocable mints. Revoke 'em.

ActionCommandWhy?
Mint Authorityspl token authorize [MINT] mint --disableNo more supply prints. Total supply locked.
Freeze Authorityspl token authorize [MINT] freeze --disableCan't freeze holder accounts. Safe.
Burn LP Laterspl token burn [LP_ACCOUNT] 100Removes liquidity tokens post pool.

Get addresses from solscan. Or Metaboss decode: metaboss decode mint -m [MINT]. Shows all deets.

In my experience, do this before liquidity. Markets pump harder without rug risks.

Decode and Inspect - What's Under the Hood?

Curious? metaboss decode mint -m [MINT_ADDRESS]. Dumps JSON with supply, authorities, URI. Super useful debugging.

Or all your tokens: metaboss wallet all -km (lists mints you own). Add --raw output for JSON parsing.

Potential Gotchas Here

RPC congestion? Switch to Helius or Quicknode (free tiers rock). Command hangs? --yes flag skips confirms.

Add Liquidity - Raydium or Meteora?

Token live? Pool it. Raydium classic, but Meteora faster/cheaper now.

Raydium steps (CLI way):

  1. Create OpenBook market: Use openbook explorer.xyz or metaboss market create if supported.
  2. Pool: raydium.io/liquidity/create. Base: your mint. Quote: SOL (So111..1112). Start with 10-50 SOL, match your supply.

Meteora? App.meteora.ag. One click. Fees ~0.3% total. Burn LP after: Find LP account on solscan, spl token burn [LP_ADDR] ALL.

Question: Why burn LP? Infinite rugs otherwise. Buyers see "LP burned" and ape in.

Advanced Tricks - Candy Machine Style

Batch mint? Metaboss shines. Create from CSV of JSON URIs: metaboss create from csv input.csv. Each row a NFT/token.

Verify collection: metaboss verify collection -c [COLLECTIONMINT] -k [YOURKEYPAIR]. Proves verified.

Freeze all: metaboss freeze all --keypair [KEYPAIR] --account [MINT]. Seller power move.

Troubleshoot Like a Pro

Common fails:

  • Build errors: Missing deps. Rerun apt/brew installs.
  • Low balance: Airdrop or fund. Check solana balance.
  • Metadata not showing: Wrong URI format. Validate JSON at jsonlint.com.
  • CLI not found: PATH issue. Source ~/.profile or restart.
  • Mainnet tx fails: Priority fees. Add --with compute unit price 10000 or use Jito.

The thing is, test on devnet first. Burns zero real SOL. Once smooth, mainnet flies.

Real World Workflow I Use

Friday night meme coin? 1) Setup (10min). 2) JSON + Arweave (5min). 3) metaboss create token (1min). 4) Revoke auths (2min). 5) Meteora pool 20 SOL (3min). 6) Tweet. Total: 20min, under 1 SOL spent. Pumped 10x last one.

Scale up? Script it. Metaboss --help for flags. Docs at metaboss.rs if stuck.

Got questions mid process? Drop the error, I'll debug. You've got this.