primer · onchain

Four onchain primitives, demystified.

Every idea in this repo leans on one of four Aptos primitives. Each one runs against Aptos Testnet (a free, real network running the Move VM) so you can ship a verifiable demo with zero hosting and gas measured in fractions of a cent.

The secrets

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

APTOS_DEPLOYER_PRIVATE_KEYExported from a Petra 'classic' account with the network set to Testnet. Fund it at the Aptos faucet.open ↗
APTOS_RPC_URLAlchemy Aptos Testnet fullnode. Public fullnodes throttle under load.open ↗
PRIVY_APP_IDGoogle sign-in + Aptos embedded wallet.open ↗
PRIVY_APP_SECRETServer-side raw signing — Aptos can't be signed in the browser.open ↗
PINATA_JWTPin to IPFS.open ↗
Aptos CLINeeded once, to publish the Move package. No Hardhat, no verify step.

onchain logic

Aptos Move module

250 ideas use this

kernel

a Move module published to Aptos Testnet with the Aptos CLI — source ships with the bytecode, so there is nothing to verify after the fact

how it drives the UI

a 'live onchain' badge with the module address and an Aptos 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

Aptos Digital Asset provenance mint

250 ideas use this

kernel

an Aptos Digital Asset (Token v2) collection whose tokens point at an IPFS CID, minted by the creator's own embedded wallet

how it drives the UI

a 'mint to claim authorship' button that returns the token object address, owner and Aptos Explorer link

EXAMPLE IDEAS

x402 native

Aptos Testnet + x402 paywall

996 ideas use this

kernel

an x402 v2 paywall metering access at 0.01 USDC per call — the payer submits a Circle USDC fungible-asset transfer on Aptos Testnet and a self-hosted facilitator verifies the committed transaction

how it drives the UI

a 'pay 0.01 USDC to unlock' button that returns the Aptos tx hash and links straight to Aptos Explorer

EXAMPLE IDEAS

Four onchain primitives, demystified.

The secrets

Aptos Move module

IPFS via Pinata

Privy social + Aptos embedded wallet

Aptos Digital Asset provenance mint

Aptos Testnet + x402 paywall