Metaplex Integration

Etch uses Metaplex Token Metadata for rich token information.

Overview

Metaplex Token Metadata provides:

On-chain name, symbol, and description
Image and attribute display in wallets
Standard recognized by all Solana explorers
NFT-compatible metadata structure

How Etch Uses Metaplex

When you launch with metadata:


{
  "name": "MyToken",
  "ticker": "MTK",
  "description": "A community token for builders",
  "imageUrl": "https://arweave.net/your-image"
}

Etch creates:

SPL Token Mint — The fungible token
Metadata Account — On-chain name, symbol, URI
JSON Metadata — Off-chain details (image, description)

Metadata Structure

On-Chain (Metaplex Account)


Name: MyToken
Symbol: MTK
URI: https://arweave.net/metadata-hash
Seller Fee: 0%
Creators: null

Off-Chain (JSON at URI)


{
  "name": "MyToken",
  "symbol": "MTK",
  "description": "A community token for builders",
  "image": "https://arweave.net/your-image",
  "attributes": []
}

Image Requirements

Property	Recommendation
Format	PNG, JPG, WebP, GIF
Size	500x500 to 1000x1000 px
Hosting	Arweave, IPFS, or permanent URL

Metadata Storage

Etch uploads metadata JSON to:

Pinata IPFS (if PINATA_JWT configured)
NFT.Storage (if NFT_STORAGE_KEY configured)
Custom endpoint (if METADATA_API_URL configured)

Example with Pinata


PINATA_JWT=your-pinata-jwt-token

Metadata uploaded to:


https://gateway.pinata.cloud/ipfs/{hash}

Wallet Display

After launch, wallets show your token with:

Token name and symbol
Token image (from metadata)
Description (in some wallets)

Supported wallets:

Phantom
Solflare
Backpack
Glow

Explorer Display

View on:

Etch uses createFungible() which creates mint + metadata atomically. This is more reliable than creating them separately.

Technical Notes

Uses mpl-token-metadata program
creators field set to null (avoids serialization issues)
isMutable: true allows future metadata updates
Decimal places: 9 (standard for Solana tokens)