primer · onchain

Ten onchain primitives, demystified.

Every idea in this repo leans on one of ten web3 primitives — five EVVM fisher-signed payment flows and five zkVault shielded-note flows. All run against Ethereum Sepolia so you can ship a verifiable demo with zero hosting cost and zero gas paid by your users.

The four secrets

Add these in your Lovable project (Settings → Secrets) before running the deploy scripts:

  • METAMASK_PRIVATE_KEYSepolia deployer AND fisher wallet (single-EOA model). Fund via the Google Cloud faucet.open ↗
  • SEPOLIA_RPC_URLAlchemy Sepolia HTTPS URL. Public RPCs throttle under load.open ↗
  • ETHERSCAN_API_KEYFor forge verify-contract after deploy.open ↗
  • PRIVY_APP_IDGoogle sign-in + native gas sponsorship on Sepolia.open ↗