primer · onchain

Five TON primitives, demystified.

Every idea in this repo leans on one of five onchain primitives. Each one runs against the TON testnet (a free, real testnet) so you can ship a verifiable demo with zero hosting and zero gas spent by your users.

Loading TON wallet…

in-app wallet · testnet only

A TON testnet wallet, in this page.

Tonkeeper and Gram only ship mainnet on mobile, so the demos are out of reach on a phone. This makes you a throwaway testnet wallet right here: the 24-word phrase is generated in your browser and never leaves it. Nothing of value is ever held in it.

testnet faucet

Get free test TON.

Two ways to get testnet coins: the Telegram bot, or the Acton CLI. Pick an address below, run one of them, and we watch the chain until the coins land.

Tonscan ↗

The secrets

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

TON_DEPLOYER_MNEMONIC24-word testnet wallet seed used by the deploy script. Fund it free from the Telegram test giver.open ↗
TONCENTER_API_KEYOptional. Higher indexer rate limits from @tonapibot.open ↗
TON_RECEIVER_ADDRESSWallet that collects Jetton paywall payments. Can equal the deployer.open ↗
PINATA_JWTPin to IPFS.open ↗
TON_JETTON_MASTEROptional. Leave empty to meter the paywall in Toncoin instead of a Jetton.

onchain logic

TON smart contract

250 ideas use this

kernel

a FunC contract compiled with @ton-community/func-js and deployed to the TON testnet from a 24-word deployer mnemonic, then read back through toncenter

how it drives the UI

a 'live on TON testnet' badge with the contract address and a tonscan 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

wallet UX

TON Connect wallet

249 ideas use this

kernel

TON Connect wired to Tonkeeper, MyTonWallet and Tonhub through a public tonconnect-manifest.json — one QR or deep link and the user is on-chain, with every transaction pinned to CHAIN.TESTNET

how it drives the UI

a single 'Connect Tonkeeper' button that swaps into the friendly address and a testnet badge

EXAMPLE IDEAS

onchain authorship

TON NFT provenance mint

250 ideas use this

kernel

a TEP-62 NFT item minted from a collection on TON testnet whose content URI points at an IPFS CID, so authorship and timestamp live on-chain

how it drives the UI

a 'mint to claim authorship' button that returns the item address and a tonscan link

EXAMPLE IDEAS

jetton native

TON Jetton paywall

996 ideas use this

kernel

an HTTP 402 paywall metered in Jettons (USDT-on-TON shape) — the client sends a transfer carrying a one-time memo through TON Connect and the server re-reads the TON indexer to match it before releasing the payload

how it drives the UI

a 'pay to unlock' button that shows the memo, the settled transfer, and a tonscan link

EXAMPLE IDEAS