Paper 042: JazzCigarettes Devnet Test Plan - Mint Verification Before Mainnet

Date: 2026-04-03

Category: Technical Validation

Status: Building

Objective

Test mint-nft.js on Solana devnet before mainnet deployment. Verify:

1. Wallet connection works

2. Metadata uploads to decentralized storage

3. NFT mints successfully

4. On-chain verification passes

5. Marketplace compatibility (OpenSea/MagicEden)

Devnet Configuration

Change in mint-nft.js:


const SOLANA_NETWORK = 'devnet'; // Was: 'mainnet-beta'
const RPC_ENDPOINT = clusterApiUrl('devnet');

Devnet wallet:

Use test wallet (not production EAq4x...)
Get devnet SOL from faucet: https://solfaucet.com
Need ~2 SOL for testing (minting + fees)

Test Sequence

Test 1: Wallet Connection

Command:


node -e "
const { Connection, clusterApiUrl, Keypair } = require('@solana/web3.js');
const connection = new Connection(clusterApiUrl('devnet'), 'confirmed');
const testWallet = Keypair.generate();
console.log('Test wallet:', testWallet.publicKey.toString());
connection.getBalance(testWallet.publicKey).then(bal => console.log('Balance:', bal));
"

Expected: Test wallet address, balance 0 (before funding)

Test 2: Metadata Upload

Command:


cd /var/www/jazzcigarettes
node -e "
const { generateJazzMetadata } = require('./mint-nft.js');
const testArt = {
  key: 'Bb',
  tempo: '180 BPM',
  style: 'Bebop',
  complexity: 'High',
  imageURI: 'https://placeholder.com/test.png'
};
const metadata = generateJazzMetadata(testArt);
console.log(JSON.stringify(metadata, null, 2));
"

Expected: Valid JSON metadata with all fields

Test 3: Full Mint (Devnet)

Script: test-mint-devnet.js


const { Connection, clusterApiUrl, Keypair } = require('@solana/web3.js');
const { mintJazzNFT } = require('./mint-nft.js');

async function test() {
  const connection = new Connection(clusterApiUrl('devnet'), 'confirmed');
  const testWallet = Keypair.generate();
  
  // Fund wallet from faucet first (manual step)
  console.log('Fund this wallet with devnet SOL:', testWallet.publicKey.toString());
  console.log('Faucet: https://solfaucet.com');
  console.log('Waiting 30 seconds for funding...');
  
  await new Promise(resolve => setTimeout(resolve, 30000));
  
  const artData = {
    key: 'Bb',
    tempo: '180 BPM', 
    style: 'Bebop',
    complexity: 'High',
    imageURI: 'https://via.placeholder.com/800x800.png?text=Jazz+Test'
  };
  
  console.log('Minting test NFT...');
  const result = await mintJazzNFT(connection, testWallet, artData);
  
  console.log('Result:', result);
  
  if (result.success) {
    console.log('✅ MINT SUCCESS');
    console.log('Mint address:', result.mintAddress);
    console.log('Explorer:', result.explorerUrl);
  } else {
    console.log('❌ MINT FAILED');
    console.log('Error:', result.error);
  }
}

test().catch(console.error);

Run:


cd /var/www/jazzcigarettes
node test-mint-devnet.js

Expected output:


Fund this wallet with devnet SOL: [address]
Waiting 30 seconds...
Minting test NFT...
Metadata uploaded: arweave.net/...
NFT minted successfully!
✅ MINT SUCCESS
Mint address: [Solana address]
Explorer: https://explorer.solana.com/address/[address]?cluster=devnet

Test 4: On-Chain Verification

Command:


# After mint succeeds, verify on Solana explorer
# Visit: https://explorer.solana.com/address/[MINT_ADDRESS]?cluster=devnet
# Check:
# - NFT exists
# - Metadata URI correct
# - Owner = test wallet
# - Creator = treasury wallet

Test 5: Metadata Rendering

Check:

Visit metadata URI from explorer
Verify JSON structure matches Metaplex standard
Verify image URI works
Check attributes display correctly

Known Issues to Watch

Issue 1: @metaplex-foundation/js deprecated

npm warning: "Package no longer supported"
Mitigation: Code may work but unsupported long-term
Alternative: Migrate to @metaplex-foundation/mpl-token-metadata (newer)

Issue 2: Arweave upload cost

Bundlr requires SOL for storage
Cost: ~0.00001 SOL per 100KB
Devnet: Free (Bundlr provides devnet credits)
Mainnet: Real cost (~$0.002 per NFT)

Issue 3: Wallet adapter integration

mint-nft.js assumes Node.js environment
Frontend (mint-wallet.js) needs browser wallet adapter
Gap: mint-nft.js server-side, mint-wallet.js client-side
Solution: mint-nft.js should be called from backend API

Architecture Gap Identified

Current setup:

mint-wallet.js = frontend (browser, wallet adapter)
mint-nft.js = backend (Node.js, Metaplex SDK)

Missing piece: Backend API to call mint-nft.js

Flow should be:

1. Customer connects wallet (frontend, mint-wallet.js)

2. Customer generates art preview (frontend, gen-mint-art.js)

3. Customer clicks "Mint" → sends payment (frontend)

4. Backend detects payment → calls mint-nft.js → mints NFT

5. NFT sent to customer wallet

Current flow (broken):

mint-nft.js requires wallet keypair (private key)
Can't run in browser (security)
Can't run on backend (customer doesn't give us their private key)

Solution: Use Metaplex Candy Machine OR manual two-step:

1. Customer pays treasury

2. Backend mints NFT and transfers to customer

Decision Point

Option A: Fix architecture now (1-2 days)

Build backend API (Express.js)
Payment detection webhook
Automated minting + transfer
Professional, scalable

Option B: Manual minting for first sales (tonight)

Customer DMs wallet address after payment
I manually run mint-nft.js
Transfer NFT to their wallet
Proves concept, not scalable

Option C: Use Candy Machine (3-5 days)

Deploy Candy Machine v3
Customers mint directly (on-chain)
Payment + minting atomic
Standard approach, more setup

Recommendation

For first $10 sale: Option B (manual)

Fastest path to first receipt
Test entire flow end-to-end
Get customer feedback
Iterate on UX

For scale: Option A (backend API)

After first 5-10 manual sales
Build automated minting backend
Professional customer experience

Next Steps

1. Tonight: Run devnet test (Test 3)

2. Verify: Mint succeeds, NFT on-chain

3. Deploy: Change to mainnet, test with own wallet

4. Distribute: Post to Discord/Reddit with "DM me your wallet after payment"

5. First sale: Manual mint + transfer

6. Iterate: Build backend after 5 manual sales prove demand

Receipt: Devnet test plan complete. Architecture gap identified (frontend ↔ backend). Manual minting recommended for first sales. Backend API for scale.

Testing now.