primer · onchain

Four onchain primitives, demystified.

Every idea in this repo leans on one of four web3 primitives. Each one runs against ZKsync Era (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 ZKsync Sepolia via the Chainstack faucet.open ↗
ETHERSCAN_API_KEYFor npx hardhat verify after deploy.open ↗
PRIVY_APP_IDGoogle sign-in + sponsored transactions.open ↗
PINATA_JWTPin to IPFS.open ↗
ZKSYNC_SEPOLIA_RPC_URLOptional. A public RPC is used if omitted.

onchain logic

ZKsync Sepolia smart contract

250 ideas use this

kernel

a Solidity contract compiled with zksolc and deployed to ZKsync Sepolia (chain 300) via a MetaMask private key, then verified with the matterlabs verifier

how it drives the UI

a 'verified onchain' badge with the live contract address and a ZKsync explorer 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 ZKsync Sepolia that mints a creator-owned token pointing at an IPFS CID, verified in the ZKsync explorer

how it drives the UI

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

EXAMPLE IDEAS

Four onchain primitives, demystified.

The five secrets

ZKsync Sepolia smart contract

IPFS via Pinata

Privy social + ZKsync paymaster

NFT provenance mint