primer · onchain

Four onchain primitives, demystified.

Every idea in this repo leans on one of four web3 primitives. Each one runs against Flow EVM Testnet (chainId 545) — a real EVM chain with a free faucet, verified on Flowscan (Blockscout), so you can ship a provable demo with zero hosting and a fractional-cent per-user gas budget.

The three secrets

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

FLOW_EVM_PRIVATE_KEYHardhat deployer key. Fund it (free) on Flow EVM Testnet via the faucet.open ↗
PRIVY_APP_IDGoogle sign-in + embedded wallet (user pays fractional-cent gas).open ↗
PINATA_JWTPin to IPFS.open ↗
FLOW_EVM_RPC_URLOptional. The public Flow EVM RPC (https://testnet.evm.nodes.onflow.org) works fine.

onchain logic

Flow EVM smart contract

250 ideas use this

kernel

a Solidity contract deployed to Flow EVM Testnet (chainId 545) via Hardhat, then verified on Flowscan (Blockscout)

how it drives the UI

a 'verified onchain' badge with the live contract address and a Flowscan 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 Flow EVM Testnet that mints a creator-owned token pointing at an IPFS CID, verified on Flowscan

how it drives the UI

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

EXAMPLE IDEAS

Four onchain primitives, demystified.

The three secrets

Flow EVM smart contract

IPFS via Pinata

Privy social sign-in

NFT provenance mint