primer · onchain

Four onchain primitives, demystified.

Every idea in this repo leans on one of four web3 primitives. Each one runs against World Chain Sepolia (a free, real testnet) so you can ship a verifiable demo with zero hosting and zero gas spent by your users.

The five secrets

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

METAMASK_PRIVATE_KEYExported from MetaMask. Fund on World Chain Sepolia via the Alchemy faucet.open ↗
ETHERSCAN_API_KEYFor npx hardhat verify after deploy.open ↗
PRIVY_APP_IDGoogle sign-in + sponsored transactions.open ↗
PINATA_JWTPin to IPFS.open ↗
SEPOLIA_RPC_URLOptional. A public RPC is used if omitted.

onchain logic

World Chain smart contract

250 ideas use this

kernel

a Solidity contract deployed to World Chain Sepolia via MetaMask private key, then verified on Worldscan (Etherscan v2, chainid=4801)

how it drives the UI

a 'verified onchain' badge with the live contract address and a Worldscan link

EXAMPLE IDEAS

decentralized storage

IPFS via Pinata

247 ideas use this

kernel

a Pinata JWT upload that pins images / JSON / manifests to IPFS and returns a permanent CID

how it drives the UI

a 'pinned to IPFS' chip with the CID and an ipfs.io gateway preview

EXAMPLE IDEAS

onchain authorship

NFT provenance mint

250 ideas use this

kernel

an ERC-721 contract on World Chain Sepolia that mints a creator-owned token pointing at an IPFS CID, verified on Worldscan

how it drives the UI

a 'mint to claim authorship' button that returns the tokenId, owner address, and Worldscan link

EXAMPLE IDEAS

sybil resistance

World ID proof-of-personhood

0 ideas use this

kernel

an IDKit widget that generates a World ID proof, verified server-side against the Worldcoin developer API before any onchain write is allowed

how it drives the UI

a 'verify you're human' step that unlocks the onchain action once verified — one proof per user per action

Four onchain primitives, demystified.

The five secrets

World Chain smart contract

IPFS via Pinata

Privy social + sponsored tx

NFT provenance mint

World ID proof-of-personhood