primer · sui testnet

Four Sui primitives, demystified.

Every idea in this repo leans on one of four Sui-native primitives. Each runs against Sui Testnet (free, real, publicly inspectable) so you can ship a verifiable demo with zero hosting and zero wallet install; users fund a custodial Testnet address from the faucet.

The four secrets

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

SUI_DEPLOYER_KEYSui keypair (base64) used by `sui client publish`. Fund the address at the Sui Testnet faucet.open ↗
SUI_WALLET_SALT64-char random string, generated once via Lovable Cloud secrets. Used with HKDF to derive a per-user Ed25519 Sui keypair server-side.open ↗
WALRUS_PUBLISHER_URLDefault: https://publisher.walrus-testnet.walrus.space — used only when the idea pins media.open ↗
WALRUS_AGGREGATOR_URLOptional. Defaults to https://aggregator.walrus-testnet.walrus.space.

onchain logic

Sui Move package

250 ideas use this

kernel

a Move package published to Sui Testnet from the sandbox via `sui client publish`, emitting a typed event on every action

how it drives the UI

a 'published on Sui' badge with the live packageId and a Suiscan link

EXAMPLE IDEAS

wallet UX

Google sign-in + custodial wallet

250 ideas use this

kernel

Google sign-in via Lovable-managed OAuth; the server derives a per-user Ed25519 Sui keypair (HKDF from SUI_WALLET_SALT + user.id) and signs transactions inside a createServerFn. Testnet-only custodial demo pattern.

how it drives the UI

a one-click 'Sign in with Google' that reveals the user's custodial Sui address and a Testnet faucet link

EXAMPLE IDEAS

decentralised storage

Walrus decentralised storage

250 ideas use this

kernel

artefacts uploaded to Walrus Testnet via the publisher endpoint, returning a permanent blobId that is stored on-chain in a Move object

how it drives the UI

a 'stored on Walrus' chip with the blobId and an aggregator preview link

EXAMPLE IDEAS

onchain authorship

Sui object NFT

250 ideas use this

kernel

a Move `key + store` object minted to the creator's address, holding a Walrus blobId and a timestamp, viewable on Suiscan as a native Sui object

how it drives the UI

a 'mint to claim authorship' button that returns the objectId, the creator address, and a Suiscan link

EXAMPLE IDEAS