atomic-metadata

Uploads pump.fun token metadata and images to IPFS and returns a metadata URI.

15|2|Updated May 19, 2026
One-click install
npx skills add https://github.com/nirholas/atomic --skill atomic-metadata-nirholas
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: atomic-metadata
Source: https://github.com/nirholas/atomic/tree/main/skills/metadata
Command: npx skills add https://github.com/nirholas/atomic --skill atomic-metadata-nirholas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Launching a token on pump.fun requires a metadata URI pointing to IPFS-hosted JSON containing the token's name, symbol, and image. Manually uploading images and metadata JSON to IPFS and wiring the resulting CID into the launch flow is error-prone and slows down coordinated launches. ## Core Features & Use Cases - Image and metadata upload: Uploads a local PNG/JPG/WebP image plus a metadata JSON (name, symbol, optional description and social links) to pump.fun's IPFS endpoint. - URI output for launch flows: Prints a https://ipfs.io/ipfs/<CID> URI ready to pass as the URI env var to fire-jito.js or fire-atomic-create.js. - Pre-flight endpoint check: Verifies pump.fun's IPFS endpoint is reachable before a coordinated launch. - Use Case: Before launching a token called PumpKitty, upload its logo and metadata, capture the returned IPFS URI, and feed it directly into the atomic launch script. ## Quick Start Upload my token metadata with name PumpKitty, symbol KITTY, and the image at ./pumpkitty.png to pump.fun IPFS and give me the URI for the launch.

Frequently Asked Questions about atomic-metadata

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upload pump.fun token metadata to IPFS?▼

Run the metadata script with NAME, SYMBOL, and IMAGE_PATH environment variables set. It uploads the image and a metadata JSON to pump.fun's IPFS endpoint and prints a https://ipfs.io/ipfs/<CID> URI for use in the create instruction.

What image formats and sizes does pump.fun metadata upload support?▼

The upload accepts PNG, JPG, or WebP images from a local path. Images over 5 MB are rejected, so keep logos under about 1 MB; 256x256 or 512x512 pixel images are typical for token logos.

Do I need Solana keys to upload token metadata to IPFS?▼

No signing keys are needed for the metadata upload. It is a plain HTTP upload to pump.fun's IPFS endpoint, not a Solana transaction, so only NAME, SYMBOL, and IMAGE_PATH environment variables are required.

Why does my uploaded token image not load on pump.fun?▼

The IPFS gateway may not have propagated the content yet. Wait 30 to 60 seconds and retry, or try an alternate gateway such as https://gateway.pinata.cloud/ipfs/<CID> to confirm the content is pinned.

Can I use Pinata or another IPFS pinner instead of pump.fun?▼

This script targets pump.fun's IPFS endpoint specifically and does not support other pinners. If you upload via Pinata or Filebase, you must construct the metadata JSON and URI yourself before passing it to the launch flow.