primer · solana

Four Solana primitives, demystified.

Every idea in this repo leans on one of four Solana primitives. Each one runs against Solana Devnet (a free, real testnet cluster) so you can ship a verifiable demo with zero hosting and near-zero fees.

The keys you'll need

Add these in your Lovable project (Settings → Secrets) before pasting any mega-prompt:

LOVABLE_API_KEYAI calls via the Lovable AI Gateway.open ↗
PRIVY_APP_IDGoogle sign-in + embedded Solana wallet on Devnet.open ↗
PINATA_JWTPin artefacts to IPFS.open ↗
SOLANA_RPC_URLAlchemy Solana Devnet RPC.open ↗
PHANTOM_PRIVATE_KEYBase58 key exported from Phantom. Used once by scripts/deploy.ts to deploy your bespoke program on Devnet — never exposed to the browser.open ↗
SOLANA_RPC_URLAlchemy Solana Devnet RPC — https://solana-devnet.g.alchemy.com/v2/<KEY>. The public api.devnet.solana.com is rate-limited and CORS-blocked in the browser.

onchain

Solana Program Call

250 ideas use this

kernel

Send a transaction to a Solana program on Devnet — the SPL Memo program (or your own tiny Anchor program) records a payload against the user's Devnet address.

how it drives the UI

After a creative action, the app calls the program and shows a 'Verified on Solana Devnet' badge with a one-tap Solana Explorer link to the signed transaction.

EXAMPLE IDEAS

auth

Privy Solana Login

249 ideas use this

kernel

Privy signs users in with Google and provisions an embedded Solana wallet — no seed phrase, no Phantom extension required.

how it drives the UI

One-tap 'Continue with Google' drops users straight into the workspace with a funded Devnet address ready to sign program calls.

EXAMPLE IDEAS

storage

Pinata IPFS Pin

247 ideas use this

kernel

User-generated artefacts are pinned to IPFS via a Pinata JWT and referenced by CID inside the Solana transaction memo.

how it drives the UI

Every submission surfaces its CID with a live `gateway.pinata.cloud/ipfs/<cid>` preview alongside the Solana Explorer link.

EXAMPLE IDEAS

nft

Metaplex NFT Provenance

250 ideas use this

kernel

Mint the artefact as a compressed or classic Metaplex NFT on Solana Devnet with metadata pointing at the IPFS CID.

how it drives the UI

After minting, the UI shows the mint address, the owner (their Privy Solana wallet), the IPFS preview, and the Solana Explorer link.

EXAMPLE IDEAS

x402 native

Solana + x402 paywall

996 ideas use this

kernel

A protected creative endpoint returns HTTP 402 with an x402 challenge; the browser signs a Solana USDC TransferChecked with the Privy embedded wallet, PayAI's Solana Devnet facilitator verifies + settles it, and the endpoint replies with the payload plus a PAYMENT-RESPONSE tx receipt.

how it drives the UI

A 4-step flow log (Challenge → Sign → Retry → Settle) that ends with a live Solana Explorer tx link proving the 0.01 USDC micropayment cleared on Devnet.

EXAMPLE IDEAS