primer · onchain

Four onchain primitives, demystified.

Every idea in this repo leans on one of four web3 primitives. Each one runs against Circle's Arc Testnet — an EVM-compatible L1 where USDC is the gas token and USDC, EURC and cirBTC settle in under a second. Verification happens through arcscan (Blockscout), so no Etherscan API key is required.

The five secrets

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

  • CIRCLE_API_KEYYOU PASTE. Backend Circle Console key — bootstrap mints the rest.open ↗
  • PRIVY_APP_IDYOU PASTE. Google sign-in + embedded Arc wallet.open ↗
  • CIRCLE_ENTITY_SECRETAUTO — `node scripts/bootstrap-circle.mjs` generates and registers it (RSA-OAEP).open ↗
  • CIRCLE_TREASURY_WALLET_IDAUTO — bootstrap mints an ARC-TESTNET dev wallet, then you fund the address at the faucet.open ↗
  • CIRCLE_KIT_KEYOptional client-side App Kit / Swap Kit key for bridge + swap widgets.open ↗
  • ARC_RPC_URLOptional. Defaults to https://rpc.testnet.arc.network.
wallet UX

Privy social wallet on Arc

249 ideas use this
kernel
Privy embedded wallet bootstrapped with PRIVY_APP_ID — Google sign-in, embedded wallet, and Arc Testnet (chain 5042002) set as the default network so users pay gas in USDC without seeing it
how it drives the UI
a one-click 'Sign in with Google' that drops the user straight into the app with an Arc wallet already funded via Circle Faucet
multi-token mint

NFT priced in USDC / EURC / cirBTC

250 ideas use this
kernel
an ERC-721 contract on Arc that mints a creator-owned token, accepting payment in USDC, EURC or cirBTC via a small on-contract token registry, then verified on the Arc explorer
how it drives the UI
a 'mint with your favourite stablecoin' button that returns tokenId, owner address and an arcscan link